For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/api/latest/cloud-cost-management/list-cloud-cost-management-tag-metadata-months.md. A documentation index is available at /llms.txt.
homeHomedocsDocsapiAPI
Language
Datadog site

List Cloud Cost Management tag metadata months

WARNINGNote: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.
GEThttps://api.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.us3.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.us5.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.datadoghq.eu/api/v2/cost/tag_metadata/monthshttps://api.ap1.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.ap2.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.uk1.datadoghq.com/api/v2/cost/tag_metadata/monthshttps://api.ddog-gov.com/api/v2/cost/tag_metadata/monthshttps://api.us2.ddog-gov.com/api/v2/cost/tag_metadata/months

Overview

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

This endpoint requires the cloud_cost_management_read permission.

OAuth apps require the cloud_cost_management_read authorization scope to access this endpoint.

Arguments

Query Strings

Name
Type
Description
filter[provider] [required]
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.

Response

OK

List of months that have Cloud Cost Management tag metadata for the requested provider, ordered most-recent first and capped at 36 months.

Field
Type
Description
data [required]
[object]

List of months that have tag metadata available.

Code Example

# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"
# Required query arguments
export filter_provider="aws"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X GET "https://api.${DD_SITE}/api/v2/cost/tag_metadata/months?filter%5Bprovider%5D=${filter_provider}" \
-H "Accept: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}"