Datadog v4.59.0 published on Wednesday, Oct 22, 2025 by Pulumi
datadog.getCostBudget
Use this data source to retrieve information about an existing Datadog cost budget.
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(entries: Optional[Sequence[GetCostBudgetEntry]] = None,
                    id: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetCostBudgetResult
def get_cost_budget_output(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 dictionaryThe following arguments are supported:
- Id string
- The ID of the budget.
- Entries
List<GetCost Budget Entry> 
- The entries of the budget.
- Id string
- The ID of the budget.
- Entries
[]GetCost Budget Entry 
- The entries of the budget.
- id String
- The ID of the budget.
- entries
List<GetCost Budget Entry> 
- The entries of the budget.
- id string
- The ID of the budget.
- entries
GetCost Budget Entry[] 
- The entries of the budget.
- id str
- The ID of the budget.
- entries
Sequence[GetCost Budget Entry] 
- The entries of the budget.
- id String
- The ID of the budget.
- entries List<Property Map>
- The entries of the budget.
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.
- Entries
List<GetCost Budget Entry> 
- The entries of the budget.
- 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.
- Entries
[]GetCost Budget Entry 
- The entries of the budget.
- 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.
- entries
List<GetCost Budget Entry> 
- The entries of the budget.
- 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.
- entries
GetCost Budget Entry[] 
- The entries of the budget.
- 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.
- entries
Sequence[GetCost Budget Entry] 
- The entries of the budget.
- 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.
- entries List<Property Map>
- The entries of the budget.
Supporting Types
GetCostBudgetEntry   
- Amount float64
- Month int
- TagFilters []GetCost Budget Entry Tag Filter 
- amount Double
- month Integer
- tagFilters List<GetCost Budget Entry Tag Filter> 
- amount number
- month number
- tagFilters GetCost Budget Entry Tag Filter[] 
- amount Number
- month Number
- tagFilters List<Property Map>
GetCostBudgetEntryTagFilter     
Package Details
- Repository
- Datadog pulumi/pulumi-datadog
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the datadogTerraform Provider.
