Skip to main content
GET
List virtual machines

Authorizations

Authorization
string
header
required

Enter "Bearer {token}"

Headers

X-CostGraph-Tenant-ID
string
required

Tenant ID

Query Parameters

provider
string[]

Filter by cloud provider (repeat param or comma-separated)

region
string[]

Filter by region (repeat param or comma-separated)

availability_zone
string[]

Filter by availability zone (repeat param or comma-separated)

instance_type
string[]

Filter by instance type (repeat param or comma-separated)

architecture
string[]

Filter by architecture (repeat param or comma-separated)

operating_system
string[]

Filter by operating system (repeat param or comma-separated)

active
boolean

Filter by active heartbeat state

Search by VM name or hostname

limit
integer

Number of rows to return (default 50, max 200)

offset
integer

Rows to skip before returning results (default 0)

sort
string

Sort field and direction. Prefix with - for descending order. Available values: name, provider, region, availability_zone, instance_type, usage_type, operating_system, cpu_cores, ram_gb, cost.mtd, cost.projected_monthly_spend, cost.change_percent, cpu_utilization_percent, memory_utilization_percent, recommendation.savings_monthly_usd

Response

OK

message
string
required
Example:

"some message"

status
string
required
Example:

"success"

data
object