tag_metadatum_tag_sources
Creates, updates, deletes, gets or lists a tag_metadatum_tag_sources resource.
Overview
| Name | tag_metadatum_tag_sources |
| Type | Resource |
| Id | datadog.cloud_costs.tag_metadatum_tag_sources |
Fields
The following fields are returned by SELECT queries:
- list_cost_tag_key_sources
| Name | Datatype | Description |
|---|---|---|
id | string | The tag key identifier. Equal to the empty-tag sentinel __empty_tag_key__ when the tag key is empty. (example: env) |
attributes | object | Attributes of a Cloud Cost Management tag source. |
type | string | Type of the Cloud Cost Management tag source resource. (cost_tag_key_source) (default: cost_tag_key_source, example: cost_tag_key_source) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list_cost_tag_key_sources | select | filter[month] | filter[provider], filter[metric] | List Cloud Cost Management tag keys observed for the requested period, along with the origin sources that produced them (for example, aws-user-defined, custom). |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
filter[month] | string | The month to scope the query to, in YYYY-MM format. (example: 2026-02) |
site | string | The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both. |
filter[metric] | string | Filter results to tag keys that have data for a specific Cloud Cost Management metric (for example, aws.cost.net.amortized). When omitted, all tag keys for the requested period are returned. |
filter[provider] | string | Filter results to a specific provider. Common cloud values are aws, azure, gcp, Oracle (OCI), and custom. SaaS billing integrations (for example, Snowflake, MongoDB, Databricks) are also accepted using their display-name string. Values are case-sensitive. |
SELECT examples
- list_cost_tag_key_sources
List Cloud Cost Management tag keys observed for the requested period, along with the origin sources that produced them (for example, aws-user-defined, custom).
SELECT
id,
attributes,
type
FROM datadog.cloud_costs.tag_metadatum_tag_sources
WHERE filter[month] = '{{ filter[month] }}' -- required
AND filter[provider] = '{{ filter[provider] }}'
AND filter[metric] = '{{ filter[metric] }}'
;