Class CloudCostManagementApi

Create a Cloud Cost Management account for an AWS CUR config.

Create a Cloud Cost Management account for an Azure config.

Create a Cloud Cost Management account for an Google Cloud Usage Cost config.

Create a new custom allocation rule with the specified filters and allocation strategy.

Strategy Methods:

• PROPORTIONAL/EVEN: Allocates costs proportionally/evenly based on existing costs. Requires: granularity, allocated_by_tag_keys. Optional: based_on_costs, allocated_by_filters, evaluate_grouped_by_tag_keys, evaluate_grouped_by_filters.
• PROPORTIONAL_TIMESERIES/EVEN_TIMESERIES: Allocates based on timeseries data. Requires: granularity, based_on_timeseries. Optional: evaluate_grouped_by_tag_keys.
• PERCENT: Allocates fixed percentages to specific tags. Requires: allocated_by (array of percentage allocations).

Filter Conditions:

• Use value for single-value conditions: "is", "is not", "contains", "=", "!=", "like", "not like"
• Use values for multi-value conditions: "in", "not in"
• Cannot use both value and values simultaneously.

Supported operators: is, is not, contains, in, not in, =, !=, like, not like

Create a new tag pipeline ruleset with the specified rules and configuration

Delete a budget

Archive a Cloud Cost Management Account.

Archive a Cloud Cost Management Account.

Archive a Cloud Cost Management account.

Delete a Cloud Cost Management tag key description. When cloud is omitted, deletes every description for the tag key, falling back to Datadog's global default when available. When cloud is provided, deletes only the description scoped to that cloud provider.

Delete a custom allocation rule - Delete an existing custom allocation rule by its ID

Delete the specified Custom Costs file.

Delete a tag pipeline ruleset - Delete an existing tag pipeline ruleset by its ID

Use AI to draft a Cloud Cost Management tag key description based on associated cost data. The generated description is returned in the response and is not persisted by this endpoint; follow up with UpsertCostTagDescriptionByKey to save it.

Get a budget

Get a list of individual cloud commitments (Reserved Instances or Savings Plans) with their utilization details. The response schema varies based on the provider, product, and commitment type.

Get scalar coverage metrics for cloud commitment programs, including hours and cost coverage percentages.

Get timeseries coverage metrics for cloud commitment programs, broken down by coverage type (Reserved Instances, Savings Plans, On-Demand, and Spot) for both hours and cost.

Get scalar on-demand hot-spots data for cloud commitment programs, showing per-dimension breakdowns of on-demand spending with coverage metrics and potential savings.

Get scalar savings metrics for cloud commitment programs, including realized savings and effective savings rate.

Get timeseries savings metrics for cloud commitment programs, including actual cost, on-demand equivalent cost, realized savings, and effective savings rate over time.

Get scalar utilization metrics for cloud commitment programs, including utilization percentage and unused cost.

Get timeseries utilization metrics for cloud commitment programs, including used and unused cost series over time.

Get a specific AWS CUR config.

Get a detected Cloud Cost Management anomaly by UUID.

Get a specific Azure config.

Get a specific Google Cloud Usage Cost config.

Get the Cloud Cost Management description for a single tag key. Use filter[cloud] to scope the lookup to a specific cloud provider; when omitted, the response resolves the description in fallback order (cloud-specific organization override, then cloudless organization default, then Datadog's global default).

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

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.

Get a specific custom allocation rule - Retrieve a specific custom allocation rule by its ID

Fetch the specified Custom Costs file.

Get a specific tag pipeline ruleset - Retrieve a specific tag pipeline ruleset by its ID

List budgets.

List the AWS CUR configs.

List detected Cloud Cost Management anomalies for the organization.

List the Azure configs.

List the Google Cloud Usage Cost configs.

List the OCI configs.

List Cloud Cost Management tag key descriptions for the organization. Use filter[cloud] to scope the result to a single cloud provider; when omitted, both cross-cloud defaults and cloud-specific descriptions are returned.

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).

List Cloud Cost Management tag keys.

List Cloud Cost Management tag key metadata, including row counts, cost covered, cardinality, and a sample of top tag values per cloud account. Use filter[daily]=true to return daily rows instead of the default monthly roll-up.

List Cloud Cost Management metrics that have data for the requested period.

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

List container orchestrators (for example, kubernetes, ecs) detected in Cloud Cost Management data for the requested period.

List Cloud Cost Management tags for a given metric.

List all custom allocation rules - Retrieve a list of all custom allocation rules for the organization

List the processing status of all custom allocation rules. Returns only the ID and processing status for each rule.

List the Custom Costs files.

List all tag pipeline rulesets - Retrieve a list of all tag pipeline rulesets for the organization

List the processing status of all tag pipeline rulesets. Returns only the ID and processing status for each ruleset.

Reorder custom allocation rules - Change the execution order of custom allocation rules.

Important: You must provide the complete list of all rule IDs in the desired execution order. The API will reorder ALL rules according to the provided sequence.

Rules are executed in the order specified, with lower indices (earlier in the array) having higher priority.

Example: If you have rules with IDs [123, 456, 789] and want to change order from 123→456→789 to 456→123→789, send: [{"id": "456"}, {"id": "123"}, {"id": "789"}]

Reorder tag pipeline rulesets - Change the execution order of tag pipeline rulesets

List cost recommendations matching a filter, with pagination and sorting.

Update the status (active/archived) and/or account filtering configuration of an AWS CUR config.

Update the status of an Azure config (active/archived).

Update the status of an Google Cloud Usage Cost config (active/archived).

Update an existing custom allocation rule with new filters and allocation strategy.

Strategy Methods:

• PROPORTIONAL/EVEN: Allocates costs proportionally/evenly based on existing costs. Requires: granularity, allocated_by_tag_keys. Optional: based_on_costs, allocated_by_filters, evaluate_grouped_by_tag_keys, evaluate_grouped_by_filters.
• PROPORTIONAL_TIMESERIES/EVEN_TIMESERIES: Allocates based on timeseries data. Requires: granularity, based_on_timeseries. Optional: evaluate_grouped_by_tag_keys.
• PERCENT: Allocates fixed percentages to specific tags. Requires: allocated_by (array of percentage allocations).
• USAGE_METRIC: Allocates based on usage metrics (implementation varies).

Filter Conditions:

• Use value for single-value conditions: "is", "is not", "contains", "=", "!=", "like", "not like"
• Use values for multi-value conditions: "in", "not in"
• Cannot use both value and values simultaneously.

Supported operators: is, is not, contains, in, not in, =, !=, like, not like

Update a tag pipeline ruleset - Update an existing tag pipeline ruleset with new rules and configuration

Upload a Custom Costs file.

Create a new budget or update an existing one.

Create or update a Cloud Cost Management tag key description. The new description and optional cloud scoping are supplied in the request body. Omit cloud to set a cross-cloud default for the tag key.

Validate a budget configuration without creating or modifying it

Validate a tag pipeline query - Validate the syntax and structure of a tag pipeline query