Skip to content
Docs

Usage

Get Usage Record
$ nirvana usage get
GET/v1/usage/{resource_id}
List Usage Records
$ nirvana usage list
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: "us-sva-2"

Region the resource is in.

"us-sva-2"
resource_id: string
resource_type: "vm" or "volume" or "vpc" or 4 more

Kind of metered resource a ledger row belongs to.

"vm"
"volume"
"vpc"
"connect_connection"
"nks_cluster"
"nks_node_pool"
"nks_load_balancer"
started_at: string
usage_dimension: 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
usage_dimension_leaf: 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
usage_list: 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: "us-sva-2"

Region the resource is in.

"us-sva-2"
resource_id: string
resource_type: "vm" or "volume" or "vpc" or 4 more

Kind of metered resource a ledger row belongs to.

"vm"
"volume"
"vpc"
"connect_connection"
"nks_cluster"
"nks_node_pool"
"nks_load_balancer"
started_at: string
usage_resource_type: "vm" or "volume" or "vpc" or 4 more

Kind of metered resource a ledger row belongs to.

"vm"
"volume"
"vpc"
"connect_connection"
"nks_cluster"
"nks_node_pool"
"nks_load_balancer"