Skip to main content
GET
/
projects
/
{projectId}
/
vms
/
{id}
Get VM
curl --request GET \
  --url https://api.mkinf.io/v0.1/projects/{projectId}/vms/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "b3e571f6-c87d-4135-8081-ab219e92544e",
  "project_id": "3291380a-19e9-4892-a139-2fa92aa740e2",
  "type": "l40s-48gb.1x",
  "state": "STATE_RUNNING",
  "ssh_destination": ":0",
  "created_at": "2024-06-16T15:52:41Z",
  "updated_at": "2024-06-16T15:52:53Z",
  "name": "mkinf-node",
  "location": "us-east1-a",
  "commitment_period": 0,
  "commitment_end": "",
  "disks": [
    {
      "id": "52822513-e425-4be9-8dd8-5c21d561ce11",
      "name": "OS-disk-b3e571f6-c87d-4135-8081-ab219e92544e",
      "type": "persistent-ssd",
      "size": "128GiB",
      "location": "vaeq-cu",
      "block_size": 0,
      "created_at": "2024-06-16T15:52:43Z",
      "updated_at": "2024-06-16T15:52:44Z",
      "serial_number": "B74EEFE8EFA0988490E",
      "attachment_type": "os",
      "mode": "read-write"
    }
  ],
  "network_interfaces": [
    {
      "id": "fdf58fb1-0185-40f2-aa20-b620e8a8562d",
      "name": "default-network-interface",
      "network": "695b751c-2eaa-4e8b-8eb2-84cb367a69fe",
      "subnet": "7ceecd34-2631-4857-ad82-ceb9dfd09425",
      "interface_type": "Ethernet",
      "mac_address": "2e:2f:ae:ef:ae:16",
      "ips": [
        {
          "private_ipv4": {
            "address": "172.27.23.237"
          },
          "public_ipv4": {
            "address": "204.52.24.84",
            "id": "e130674a-c05e-4345-b8a4-7928c6649574",
            "type": "dynamic"
          }
        }
      ]
    }
  ],
  "host_channel_adapters": [],
  "virtualization_features": {
    "nested_virtualization": false
  },
  "instance_template_id": "",
  "instance_group_id": "",
  "reservation_id": ""
}
Get detailed information about a specific VM instance, including:
  • Instance configuration
  • Network interfaces
  • Attached disks
  • State information
  • SSH access details

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
projectId
string<uuid>
required

Project id

​
id
string<uuid>
required

VM id

Response

200 - application/json
​
id
string
required
​
project_id
string
required
​
type
string
required
​
state
string
required
​
ssh_destination
string
required
​
created_at
string
required
​
updated_at
string
required
​
name
string
required
​
location
string
required
​
commitment_period
integer
required
​
commitment_end
string
required
​
disks
object[]
required
​
network_interfaces
object[]
required
​
host_channel_adapters
string[]
required
​
virtualization_features
object
required
​
instance_template_id
string
required
​
instance_group_id
string
required
​
reservation_id
string
required