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"