Response
The virtual machine
idstringformat: "uuid"
Unique identifier for this virtual machine.
namestring
Human-readable name for the VM. Shown in dashboards and CLI output.
statusstring
Current lifecycle state of the VM. Observed values include CREATING, STARTING, CREATED, STARTED, STOPPING, STOPPED, and DESTROYED. Treat this as an open set — new states may be introduced over time.
regionstring
Region the VM is provisioned in. References a region label from /v1/compute/regions.
cpuinteger
Number of virtual CPUs allocated to the VM.
memoryMbinteger
Memory allocated to the VM, in megabytes.
rootDiskGbinteger
Root disk size, in gigabytes.
imagestring
Image label the VM was provisioned from. References /v1/compute/images.
ipAddressstringformat: "ipv4"
Primary IP address assigned to the VM on its network.
networkNamestring or null
Name of the network or VPC tier this VM is attached to. Null while the VM is still provisioning.
networkIdstring or nullformat: "uuid"
Identifier of the network or VPC tier this VM is attached to. Null while the VM is still provisioning.
rootVolumeIdstring or nullformat: "uuid"
Identifier of the VM root volume. Null while the VM is still provisioning.
createdAtdatetime
When the VM was first provisioned.
vmPackagestringOptional
Package label identifying the CPU/memory/disk preset this VM uses.
tagslist of stringsOptional
Tags assigned to this VM for grouping and filtering.
subscriptionPeriodstringOptional
Billing cadence applied to this VM. Absent for a few moments after the VM is created, while the billing term is still being recorded. Poll until it appears.
imageDisplayNamestringOptional
Friendly name of the source image.
versionStartedAtdatetimeOptional
When the current billing version started (set when the VM is scaled or its disk is resized). Only present if the VM has been modified since creation.
marketplaceAppobjectOptional
Source marketplace app, when the VM was deployed from one. Absent for OS-only deploys.