1. Packages
  2. Packages
  3. Datadog Provider
  4. API Docs
  5. getCostCustomForecast
Viewing docs for Datadog v5.9.0
published on Saturday, Jul 25, 2026 by Pulumi
datadog logo
Viewing docs for Datadog v5.9.0
published on Saturday, Jul 25, 2026 by Pulumi

    Use this data source to retrieve the custom forecast for an existing Datadog cost budget.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as datadog from "@pulumi/datadog";
    
    const example = datadog.getCostCustomForecast({
        budgetUid: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    });
    
    import pulumi
    import pulumi_datadog as datadog
    
    example = datadog.get_cost_custom_forecast(budget_uid="a1b2c3d4-e5f6-7890-abcd-ef1234567890")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-datadog/sdk/v5/go/datadog"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := datadog.GetCostCustomForecast(ctx, &datadog.LookupCostCustomForecastArgs{
    			BudgetUid: "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Datadog = Pulumi.Datadog;
    
    return await Deployment.RunAsync(() => 
    {
        var example = Datadog.GetCostCustomForecast.Invoke(new()
        {
            BudgetUid = "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.datadog.DatadogFunctions;
    import com.pulumi.datadog.inputs.GetCostCustomForecastArgs;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var example = DatadogFunctions.getCostCustomForecast(GetCostCustomForecastArgs.builder()
                .budgetUid("a1b2c3d4-e5f6-7890-abcd-ef1234567890")
                .build());
    
        }
    }
    
    variables:
      example:
        fn::invoke:
          function: datadog:getCostCustomForecast
          arguments:
            budgetUid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
    
    pulumi {
      required_providers {
        datadog = {
          source = "pulumi/datadog"
        }
      }
    }
    
    data "datadog_getcostcustomforecast" "example" {
      budget_uid = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
    

    Using getCostCustomForecast

    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 getCostCustomForecast(args: GetCostCustomForecastArgs, opts?: InvokeOptions): Promise<GetCostCustomForecastResult>
    function getCostCustomForecastOutput(args: GetCostCustomForecastOutputArgs, opts?: InvokeOptions): Output<GetCostCustomForecastResult>
    def get_cost_custom_forecast(budget_uid: Optional[str] = None,
                                 entries: Optional[Sequence[GetCostCustomForecastEntry]] = None,
                                 opts: Optional[InvokeOptions] = None) -> GetCostCustomForecastResult
    def get_cost_custom_forecast_output(budget_uid: pulumi.Input[Optional[str]] = None,
                                 entries: pulumi.Input[Optional[Sequence[pulumi.Input[GetCostCustomForecastEntryArgs]]]] = None,
                                 opts: Optional[InvokeOptions] = None) -> Output[GetCostCustomForecastResult]
    func LookupCostCustomForecast(ctx *Context, args *LookupCostCustomForecastArgs, opts ...InvokeOption) (*LookupCostCustomForecastResult, error)
    func LookupCostCustomForecastOutput(ctx *Context, args *LookupCostCustomForecastOutputArgs, opts ...InvokeOption) LookupCostCustomForecastResultOutput

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

    public static class GetCostCustomForecast 
    {
        public static Task<GetCostCustomForecastResult> InvokeAsync(GetCostCustomForecastArgs args, InvokeOptions? opts = null)
        public static Output<GetCostCustomForecastResult> Invoke(GetCostCustomForecastInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetCostCustomForecastResult> getCostCustomForecast(GetCostCustomForecastArgs args, InvokeOptions options)
    public static Output<GetCostCustomForecastResult> getCostCustomForecast(GetCostCustomForecastArgs args, InvokeOptions options)
    
    fn::invoke:
      function: datadog:index/getCostCustomForecast:getCostCustomForecast
      arguments:
        # arguments dictionary
    data "datadog_get_cost_custom_forecast" "name" {
        # arguments
    }

    The following arguments are supported:

    BudgetUid string
    The UUID of the budget that this custom forecast belongs to.
    Entries List<GetCostCustomForecastEntry>
    Monthly custom forecast entries.
    BudgetUid string
    The UUID of the budget that this custom forecast belongs to.
    Entries []GetCostCustomForecastEntry
    Monthly custom forecast entries.
    budget_uid string
    The UUID of the budget that this custom forecast belongs to.
    entries list(object)
    Monthly custom forecast entries.
    budgetUid String
    The UUID of the budget that this custom forecast belongs to.
    entries List<GetCostCustomForecastEntry>
    Monthly custom forecast entries.
    budgetUid string
    The UUID of the budget that this custom forecast belongs to.
    entries GetCostCustomForecastEntry[]
    Monthly custom forecast entries.
    budget_uid str
    The UUID of the budget that this custom forecast belongs to.
    entries Sequence[GetCostCustomForecastEntry]
    Monthly custom forecast entries.
    budgetUid String
    The UUID of the budget that this custom forecast belongs to.
    entries List<Property Map>
    Monthly custom forecast entries.

    getCostCustomForecast Result

    The following output properties are available:

    BudgetUid string
    The UUID of the budget that this custom forecast belongs to.
    CreatedAt int
    Timestamp the custom forecast was created, in Unix milliseconds.
    CreatedBy string
    The ID of the user that created the custom forecast.
    Id string
    The unique identifier of the custom forecast set.
    UpdatedAt int
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    UpdatedBy string
    The ID of the user that last updated the custom forecast.
    Entries List<GetCostCustomForecastEntry>
    Monthly custom forecast entries.
    BudgetUid string
    The UUID of the budget that this custom forecast belongs to.
    CreatedAt int
    Timestamp the custom forecast was created, in Unix milliseconds.
    CreatedBy string
    The ID of the user that created the custom forecast.
    Id string
    The unique identifier of the custom forecast set.
    UpdatedAt int
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    UpdatedBy string
    The ID of the user that last updated the custom forecast.
    Entries []GetCostCustomForecastEntry
    Monthly custom forecast entries.
    budget_uid string
    The UUID of the budget that this custom forecast belongs to.
    created_at number
    Timestamp the custom forecast was created, in Unix milliseconds.
    created_by string
    The ID of the user that created the custom forecast.
    id string
    The unique identifier of the custom forecast set.
    updated_at number
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    updated_by string
    The ID of the user that last updated the custom forecast.
    entries list(object)
    Monthly custom forecast entries.
    budgetUid String
    The UUID of the budget that this custom forecast belongs to.
    createdAt Integer
    Timestamp the custom forecast was created, in Unix milliseconds.
    createdBy String
    The ID of the user that created the custom forecast.
    id String
    The unique identifier of the custom forecast set.
    updatedAt Integer
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    updatedBy String
    The ID of the user that last updated the custom forecast.
    entries List<GetCostCustomForecastEntry>
    Monthly custom forecast entries.
    budgetUid string
    The UUID of the budget that this custom forecast belongs to.
    createdAt number
    Timestamp the custom forecast was created, in Unix milliseconds.
    createdBy string
    The ID of the user that created the custom forecast.
    id string
    The unique identifier of the custom forecast set.
    updatedAt number
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    updatedBy string
    The ID of the user that last updated the custom forecast.
    entries GetCostCustomForecastEntry[]
    Monthly custom forecast entries.
    budget_uid str
    The UUID of the budget that this custom forecast belongs to.
    created_at int
    Timestamp the custom forecast was created, in Unix milliseconds.
    created_by str
    The ID of the user that created the custom forecast.
    id str
    The unique identifier of the custom forecast set.
    updated_at int
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    updated_by str
    The ID of the user that last updated the custom forecast.
    entries Sequence[GetCostCustomForecastEntry]
    Monthly custom forecast entries.
    budgetUid String
    The UUID of the budget that this custom forecast belongs to.
    createdAt Number
    Timestamp the custom forecast was created, in Unix milliseconds.
    createdBy String
    The ID of the user that created the custom forecast.
    id String
    The unique identifier of the custom forecast set.
    updatedAt Number
    Timestamp the custom forecast was last updated, in Unix milliseconds.
    updatedBy String
    The ID of the user that last updated the custom forecast.
    entries List<Property Map>
    Monthly custom forecast entries.

    Supporting Types

    GetCostCustomForecastEntry

    Amount double
    The forecast override amount for the month.
    Month int
    The month the entry applies to, in YYYYMM format.
    TagFilters List<GetCostCustomForecastEntryTagFilter>
    Tag filters that scope this entry to a specific budget entry tag combination.
    Amount float64
    The forecast override amount for the month.
    Month int
    The month the entry applies to, in YYYYMM format.
    TagFilters []GetCostCustomForecastEntryTagFilter
    Tag filters that scope this entry to a specific budget entry tag combination.
    amount number
    The forecast override amount for the month.
    month number
    The month the entry applies to, in YYYYMM format.
    tag_filters list(object)
    Tag filters that scope this entry to a specific budget entry tag combination.
    amount Double
    The forecast override amount for the month.
    month Integer
    The month the entry applies to, in YYYYMM format.
    tagFilters List<GetCostCustomForecastEntryTagFilter>
    Tag filters that scope this entry to a specific budget entry tag combination.
    amount number
    The forecast override amount for the month.
    month number
    The month the entry applies to, in YYYYMM format.
    tagFilters GetCostCustomForecastEntryTagFilter[]
    Tag filters that scope this entry to a specific budget entry tag combination.
    amount float
    The forecast override amount for the month.
    month int
    The month the entry applies to, in YYYYMM format.
    tag_filters Sequence[GetCostCustomForecastEntryTagFilter]
    Tag filters that scope this entry to a specific budget entry tag combination.
    amount Number
    The forecast override amount for the month.
    month Number
    The month the entry applies to, in YYYYMM format.
    tagFilters List<Property Map>
    Tag filters that scope this entry to a specific budget entry tag combination.

    GetCostCustomForecastEntryTagFilter

    TagKey string
    TagValue string
    TagKey string
    TagValue string
    tag_key string
    tag_value string
    tagKey String
    tagValue String
    tagKey string
    tagValue string
    tagKey String
    tagValue String

    Package Details

    Repository
    Datadog pulumi/pulumi-datadog
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the datadog Terraform Provider.
    datadog logo
    Viewing docs for Datadog v5.9.0
    published on Saturday, Jul 25, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial