tag_metadatum_currencies

Creates, updates, deletes, gets or lists a tag_metadatum_currencies resource.

Overview

Name	tag_metadatum_currencies
Type	Resource
Id	datadog.cloud_costs.tag_metadatum_currencies

Fields

The following fields are returned by SELECT queries:

get_cost_tag_metadata_currency

Name	Datatype	Description
id	string	The currency code (for example, USD). (example: USD)
type	string	Type of the Cloud Cost Management billing currency resource. (cost_currency) (default: cost_currency, example: cost_currency)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_cost_tag_metadata_currency	select	filter[month]	filter[provider]	Get the dominant billing currency observed in Cloud Cost Management data for the requested period. The response wraps the currency in a JSON:API data array containing at most one entry; the array is empty when no currency data is available.

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[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

get_cost_tag_metadata_currency

Get the dominant billing currency observed in Cloud Cost Management data for the requested period. The response wraps the currency in a JSON:API data array containing at most one entry; the array is empty when no currency data is available.

SELECT
id,
type
FROM datadog.cloud_costs.tag_metadatum_currencies
WHERE filter[month] = '{{ filter[month] }}' -- required
AND filter[provider] = '{{ filter[provider] }}'
;