Skip to content
Docs

Usage

Get Usage Record
GET/v1/usage/{resource_id}
List Usage Records
GET/v1/usage
ModelsExpand Collapse
Usage object { dimensions, ended_at, project_id, 4 more }

Usage record for a single metered resource.

dimensions: array of UsageDimension { id, dimension, ended_at, 3 more }
id: string
dimension: string
ended_at: string
quantity: number
started_at: string
children: optional array of UsageDimensionLeaf { id, dimension, ended_at, 2 more }
id: string
dimension: string
ended_at: string
quantity: number
started_at: string
ended_at: string
project_id: string
region: RegionName

Region the resource is in.

resource_id: string
resource_type: UsageResourceType

Kind of metered resource a ledger row belongs to.

One of the following:
"vm"
"volume"
"vpc"
"connect_connection"
"nks_cluster"
"nks_node_pool"
"nks_load_balancer"
started_at: string
UsageDimension object { id, dimension, ended_at, 3 more }

Top-level dimension entry; bundle heads expand via children.

id: string
dimension: string
ended_at: string
quantity: number
started_at: string
children: optional array of UsageDimensionLeaf { id, dimension, ended_at, 2 more }
id: string
dimension: string
ended_at: string
quantity: number
started_at: string
UsageDimensionLeaf object { id, dimension, ended_at, 2 more }

One ledger segment for a (resource, dimension) pair.

id: string
dimension: string
ended_at: string
quantity: number
started_at: string
UsageList object { items, pagination }
items: array of Usage { dimensions, ended_at, project_id, 4 more }
dimensions: array of UsageDimension { id, dimension, ended_at, 3 more }
id: string
dimension: string
ended_at: string
quantity: number
started_at: string
children: optional array of UsageDimensionLeaf { id, dimension, ended_at, 2 more }
id: string
dimension: string
ended_at: string
quantity: number
started_at: string
ended_at: string
project_id: string
region: RegionName

Region the resource is in.

resource_id: string
resource_type: UsageResourceType

Kind of metered resource a ledger row belongs to.

One of the following:
"vm"
"volume"
"vpc"
"connect_connection"
"nks_cluster"
"nks_node_pool"
"nks_load_balancer"
started_at: string
UsageResourceType = "vm" or "volume" or "vpc" or 4 more

Kind of metered resource a ledger row belongs to.

One of the following:
"vm"
"volume"
"vpc"
"connect_connection"
"nks_cluster"
"nks_node_pool"
"nks_load_balancer"