getCostBudget

Datadog v4.68.0, Feb 25 26

Viewing docs for Datadog v4.68.0
published on Wednesday, Feb 25, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-datadog

Viewing docs for Datadog v4.68.0
published on Wednesday, Feb 25, 2026 by Pulumi

Schema (JSON)

pulumi/pulumi-datadog

Using getCostBudget

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getCostBudget(args: GetCostBudgetArgs, opts?: InvokeOptions): Promise<GetCostBudgetResult>
function getCostBudgetOutput(args: GetCostBudgetOutputArgs, opts?: InvokeOptions): Output<GetCostBudgetResult>

def get_cost_budget(budget_lines: Optional[Sequence[GetCostBudgetBudgetLine]] = None,
                    entries: Optional[Sequence[GetCostBudgetEntry]] = None,
                    id: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetCostBudgetResult
def get_cost_budget_output(budget_lines: Optional[pulumi.Input[Sequence[pulumi.Input[GetCostBudgetBudgetLineArgs]]]] = None,
                    entries: Optional[pulumi.Input[Sequence[pulumi.Input[GetCostBudgetEntryArgs]]]] = None,
                    id: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetCostBudgetResult]

func LookupCostBudget(ctx *Context, args *LookupCostBudgetArgs, opts ...InvokeOption) (*LookupCostBudgetResult, error)
func LookupCostBudgetOutput(ctx *Context, args *LookupCostBudgetOutputArgs, opts ...InvokeOption) LookupCostBudgetResultOutput

> Note: This function is named LookupCostBudget in the Go SDK.

public static class GetCostBudget 
{
    public static Task<GetCostBudgetResult> InvokeAsync(GetCostBudgetArgs args, InvokeOptions? opts = null)
    public static Output<GetCostBudgetResult> Invoke(GetCostBudgetInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetCostBudgetResult> getCostBudget(GetCostBudgetArgs args, InvokeOptions options)
public static Output<GetCostBudgetResult> getCostBudget(GetCostBudgetArgs args, InvokeOptions options)

fn::invoke:
  function: datadog:index/getCostBudget:getCostBudget
  arguments:
    # arguments dictionary

The following arguments are supported:

Id string: The ID of the budget.
BudgetLines List<GetCostBudgetBudgetLine>: Budget entries grouped by tag combination with amounts map (month > amount).
Entries List<GetCostBudgetEntry>: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

Id string: The ID of the budget.
BudgetLines []GetCostBudgetBudgetLine: Budget entries grouped by tag combination with amounts map (month > amount).
Entries []GetCostBudgetEntry: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

id String: The ID of the budget.
budgetLines List<GetCostBudgetBudgetLine>: Budget entries grouped by tag combination with amounts map (month > amount).
entries List<GetCostBudgetEntry>: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

id string: The ID of the budget.
budgetLines GetCostBudgetBudgetLine[]: Budget entries grouped by tag combination with amounts map (month > amount).
entries GetCostBudgetEntry[]: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

id str: The ID of the budget.
budget_lines Sequence[GetCostBudgetBudgetLine]: Budget entries grouped by tag combination with amounts map (month > amount).
entries Sequence[GetCostBudgetEntry]: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

id String: The ID of the budget.
budgetLines List<Property Map>: Budget entries grouped by tag combination with amounts map (month > amount).
entries List<Property Map>: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

getCostBudget Result

The following output properties are available:

EndMonth int: The month when the budget ends (YYYYMM).
Id string: The ID of the budget.
MetricsQuery string: The cost query used to track against the budget.
Name string: The name of the budget.
StartMonth int: The month when the budget starts (YYYYMM).
TotalAmount double: The sum of all budget entries' amounts.
BudgetLines List<GetCostBudgetBudgetLine>: Budget entries grouped by tag combination with amounts map (month > amount).
Entries List<GetCostBudgetEntry>: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

EndMonth int: The month when the budget ends (YYYYMM).
Id string: The ID of the budget.
MetricsQuery string: The cost query used to track against the budget.
Name string: The name of the budget.
StartMonth int: The month when the budget starts (YYYYMM).
TotalAmount float64: The sum of all budget entries' amounts.
BudgetLines []GetCostBudgetBudgetLine: Budget entries grouped by tag combination with amounts map (month > amount).
Entries []GetCostBudgetEntry: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

endMonth Integer: The month when the budget ends (YYYYMM).
id String: The ID of the budget.
metricsQuery String: The cost query used to track against the budget.
name String: The name of the budget.
startMonth Integer: The month when the budget starts (YYYYMM).
totalAmount Double: The sum of all budget entries' amounts.
budgetLines List<GetCostBudgetBudgetLine>: Budget entries grouped by tag combination with amounts map (month > amount).
entries List<GetCostBudgetEntry>: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

endMonth number: The month when the budget ends (YYYYMM).
id string: The ID of the budget.
metricsQuery string: The cost query used to track against the budget.
name string: The name of the budget.
startMonth number: The month when the budget starts (YYYYMM).
totalAmount number: The sum of all budget entries' amounts.
budgetLines GetCostBudgetBudgetLine[]: Budget entries grouped by tag combination with amounts map (month > amount).
entries GetCostBudgetEntry[]: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

end_month int: The month when the budget ends (YYYYMM).
id str: The ID of the budget.
metrics_query str: The cost query used to track against the budget.
name str: The name of the budget.
start_month int: The month when the budget starts (YYYYMM).
total_amount float: The sum of all budget entries' amounts.
budget_lines Sequence[GetCostBudgetBudgetLine]: Budget entries grouped by tag combination with amounts map (month > amount).
entries Sequence[GetCostBudgetEntry]: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

endMonth Number: The month when the budget ends (YYYYMM).
id String: The ID of the budget.
metricsQuery String: The cost query used to track against the budget.
name String: The name of the budget.
startMonth Number: The month when the budget starts (YYYYMM).
totalAmount Number: The sum of all budget entries' amounts.
budgetLines List<Property Map>: Budget entries grouped by tag combination with amounts map (month > amount).
entries List<Property Map>: The flat list of budget entries (deprecated - use budget_line instead).
Deprecated: Use budget_line instead. The entries block will be removed in a future version.

Supporting Types

GetCostBudgetBudgetLine

Amounts Dictionary<string, double>: Map of month (YYYYMM as string) to budget amount.
ChildTagFilters List<GetCostBudgetBudgetLineChildTagFilter>: Child tag filters for hierarchical budgets (second tag in 'by' clause).
ParentTagFilters List<GetCostBudgetBudgetLineParentTagFilter>: Parent tag filters for hierarchical budgets (first tag in 'by' clause).
TagFilters List<GetCostBudgetBudgetLineTagFilter>: Tag filters for non-hierarchical budgets (single tag or no tags).

Amounts map[string]float64: Map of month (YYYYMM as string) to budget amount.
ChildTagFilters []GetCostBudgetBudgetLineChildTagFilter: Child tag filters for hierarchical budgets (second tag in 'by' clause).
ParentTagFilters []GetCostBudgetBudgetLineParentTagFilter: Parent tag filters for hierarchical budgets (first tag in 'by' clause).
TagFilters []GetCostBudgetBudgetLineTagFilter: Tag filters for non-hierarchical budgets (single tag or no tags).

amounts Map<String,Double>: Map of month (YYYYMM as string) to budget amount.
childTagFilters List<GetCostBudgetBudgetLineChildTagFilter>: Child tag filters for hierarchical budgets (second tag in 'by' clause).
parentTagFilters List<GetCostBudgetBudgetLineParentTagFilter>: Parent tag filters for hierarchical budgets (first tag in 'by' clause).
tagFilters List<GetCostBudgetBudgetLineTagFilter>: Tag filters for non-hierarchical budgets (single tag or no tags).

amounts {[key: string]: number}: Map of month (YYYYMM as string) to budget amount.
childTagFilters GetCostBudgetBudgetLineChildTagFilter[]: Child tag filters for hierarchical budgets (second tag in 'by' clause).
parentTagFilters GetCostBudgetBudgetLineParentTagFilter[]: Parent tag filters for hierarchical budgets (first tag in 'by' clause).
tagFilters GetCostBudgetBudgetLineTagFilter[]: Tag filters for non-hierarchical budgets (single tag or no tags).

amounts Mapping[str, float]: Map of month (YYYYMM as string) to budget amount.
child_tag_filters Sequence[GetCostBudgetBudgetLineChildTagFilter]: Child tag filters for hierarchical budgets (second tag in 'by' clause).
parent_tag_filters Sequence[GetCostBudgetBudgetLineParentTagFilter]: Parent tag filters for hierarchical budgets (first tag in 'by' clause).
tag_filters Sequence[GetCostBudgetBudgetLineTagFilter]: Tag filters for non-hierarchical budgets (single tag or no tags).

amounts Map<Number>: Map of month (YYYYMM as string) to budget amount.
childTagFilters List<Property Map>: Child tag filters for hierarchical budgets (second tag in 'by' clause).
parentTagFilters List<Property Map>: Parent tag filters for hierarchical budgets (first tag in 'by' clause).
tagFilters List<Property Map>: Tag filters for non-hierarchical budgets (single tag or no tags).