v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Cloud Cost Management

Get a Cloud Cost Management tag key

Get details for a specific Cloud Cost Management tag key, including example tag values and description.

get/api/v2/cost/tag_keys/{tag_key}

Path parameters

tag_keystring required

The Cloud Cost Management tag key. Tag keys can contain forward slashes (for example, kubernetes/instance).

Query parameters

filter[metric]string

The Cloud Cost Management metric to scope the tag key details to. When omitted, returns details across all metrics.

page[size]integer

Controls the size of the internal tag value search scope. This does not restrict the number of example tag values returned in the response. Defaults to 50, maximum 10000.

Response

OK

Example response

{
  "data": {
    "attributes": {
      "details": {
        "description": "The cloud provider name reported for the cost line item.",
        "tag_values": [
          "aws",
          "gcp",
          "azure"
        ]
      },
      "sources": [
        "focus"
      ],
      "value": "providername"
    },
    "id": "providername",
    "type": "cost_tag_key"
  }
}