tag_metadatum_months

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

Overview

Name	tag_metadatum_months
Type	Resource
Id	datadog.cloud_costs.tag_metadatum_months

Fields

The following fields are returned by SELECT queries:

list_cost_tag_metadata_months

Name	Datatype	Description
id	string	The month, in YYYY-MM format. (example: 2026-04)
type	string	Type of the Cloud Cost Management tag metadata month resource. (cost_tag_metadata_month) (default: cost_tag_metadata_month, example: cost_tag_metadata_month)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_cost_tag_metadata_months	select	filter[provider]		List months that have Cloud Cost Management tag metadata for a given provider,<br />ordered most-recent first. The response is capped at 36 months.

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[provider]	string	Provider to scope the query to. Use the value of the providername tag in CCM (for example, aws, azure, gcp, Oracle, Confluent Cloud, Snowflake). For costs uploaded through the Custom Costs API, use custom. Values are case-sensitive. (example: aws)
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.

SELECT examples

list_cost_tag_metadata_months

List months that have Cloud Cost Management tag metadata for a given provider,<br />ordered most-recent first. The response is capped at 36 months.

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