1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. budgets
  6. getBudget
Viewing docs for AWS v7.48.0
published on Tuesday, Sep 22, 2026 by Pulumi
aws logo aws logo
Viewing docs for AWS v7.48.0
published on Tuesday, Sep 22, 2026 by Pulumi

    Data source for managing an AWS Web Services Budgets Budget.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const test = aws.budgets.getBudget({
        name: testAwsBudgetsBudget.name,
    });
    
    import pulumi
    import pulumi_aws as aws
    
    test = aws.budgets.get_budget(name=test_aws_budgets_budget["name"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/budgets"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := budgets.LookupBudget(ctx, &budgets.LookupBudgetArgs{
    			Name: testAwsBudgetsBudget.Name,
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var test = Aws.Budgets.GetBudget.Invoke(new()
        {
            Name = testAwsBudgetsBudget.Name,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.budgets.BudgetsFunctions;
    import com.pulumi.aws.budgets.inputs.GetBudgetArgs;
    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 test = BudgetsFunctions.getBudget(GetBudgetArgs.builder()
                .name(testAwsBudgetsBudget.name())
                .build());
    
        }
    }
    
    variables:
      test:
        fn::invoke:
          function: aws:budgets:getBudget
          arguments:
            name: ${testAwsBudgetsBudget.name}
    
    pulumi {
      required_providers {
        aws = {
          source = "pulumi/aws"
        }
      }
    }
    
    data "aws_budgets_getbudget" "test" {
      name = testAwsBudgetsBudget.name
    }
    

    Using getBudget

    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 getBudget(args: GetBudgetArgs, opts?: InvokeOptions): Promise<GetBudgetResult>
    function getBudgetOutput(args: GetBudgetOutputArgs, opts?: InvokeOutputOptions): Output<GetBudgetResult>
    def get_budget(account_id: Optional[str] = None,
                   name: Optional[str] = None,
                   name_prefix: Optional[str] = None,
                   tags: Optional[Mapping[str, str]] = None,
                   opts: Optional[InvokeOptions] = None) -> GetBudgetResult
    def get_budget_output(account_id: pulumi.Input[Optional[str]] = None,
                   name: pulumi.Input[Optional[str]] = None,
                   name_prefix: pulumi.Input[Optional[str]] = None,
                   tags: pulumi.Input[Optional[Mapping[str, pulumi.Input[str]]]] = None,
                   opts: Optional[InvokeOutputOptions] = None) -> Output[GetBudgetResult]
    func LookupBudget(ctx *Context, args *LookupBudgetArgs, opts ...InvokeOption) (*LookupBudgetResult, error)
    func LookupBudgetOutput(ctx *Context, args *LookupBudgetOutputArgs, opts ...InvokeOption) LookupBudgetResultOutput

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

    public static class GetBudget 
    {
        public static Task<GetBudgetResult> InvokeAsync(GetBudgetArgs args, InvokeOptions? opts = null)
        public static Output<GetBudgetResult> Invoke(GetBudgetInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetBudgetResult> Invoke(GetBudgetInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetBudgetResult> getBudget(GetBudgetArgs args, InvokeOptions options)
    public static Output<GetBudgetResult> getBudget(GetBudgetArgs args, InvokeOptions options)
    public static Output<GetBudgetResult> getBudget(GetBudgetArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws:budgets/getBudget:getBudget
      arguments:
        # arguments dictionary
    data "aws_budgets_get_budget" "name" {
        # arguments
    }

    The following arguments are supported:

    Name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    AccountId string
    ID of the target account for the budget. Defaults to the current account ID.
    NamePrefix string
    Prefix of the budget name. Unique within an account.
    Tags Dictionary<string, string>
    Map of tags assigned to the resource.
    Name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    AccountId string
    ID of the target account for the budget. Defaults to the current account ID.
    NamePrefix string
    Prefix of the budget name. Unique within an account.
    Tags map[string]string
    Map of tags assigned to the resource.
    name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    account_id string
    ID of the target account for the budget. Defaults to the current account ID.
    name_prefix string
    Prefix of the budget name. Unique within an account.
    tags map(string)
    Map of tags assigned to the resource.
    name String

    Name of the budget. Unique within an account.

    The following arguments are optional:

    accountId String
    ID of the target account for the budget. Defaults to the current account ID.
    namePrefix String
    Prefix of the budget name. Unique within an account.
    tags Map<String,String>
    Map of tags assigned to the resource.
    name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    accountId string
    ID of the target account for the budget. Defaults to the current account ID.
    namePrefix string
    Prefix of the budget name. Unique within an account.
    tags {[key: string]: string}
    Map of tags assigned to the resource.
    name str

    Name of the budget. Unique within an account.

    The following arguments are optional:

    account_id str
    ID of the target account for the budget. Defaults to the current account ID.
    name_prefix str
    Prefix of the budget name. Unique within an account.
    tags Mapping[str, str]
    Map of tags assigned to the resource.
    name String

    Name of the budget. Unique within an account.

    The following arguments are optional:

    accountId String
    ID of the target account for the budget. Defaults to the current account ID.
    namePrefix String
    Prefix of the budget name. Unique within an account.
    tags Map<String>
    Map of tags assigned to the resource.

    getBudget Result

    The following output properties are available:

    AccountId string
    Arn string
    ARN of the budget.
    AutoAdjustDatas List<GetBudgetAutoAdjustData>
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    BillingViewArn string
    ARN of the billing view.
    BudgetExceeded bool
    Whether the budget has been exceeded.
    BudgetLimits List<GetBudgetBudgetLimit>
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    BudgetType string
    Whether the budget tracks monetary cost or usage.
    CalculatedSpends List<GetBudgetCalculatedSpend>
    Spend objects associated with the budget. See calculatedSpend Block for details.
    CostFilters List<GetBudgetCostFilter>
    Cost filters applied to the budget. See costFilter Block for details.
    CostTypes List<GetBudgetCostType>
    Types of cost included in the budget. See costTypes Block for details.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Name of the cost filter.
    Notifications List<GetBudgetNotification>
    Notifications associated with the budget. See notification Block for details.
    PlannedLimits List<GetBudgetPlannedLimit>
    Budget limits planned for future periods. See plannedLimit Block for details.
    Tags Dictionary<string, string>
    Map of tags assigned to the resource.
    TimePeriodEnd string
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    TimePeriodStart string
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    TimeUnit string
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    NamePrefix string
    AccountId string
    Arn string
    ARN of the budget.
    AutoAdjustDatas []GetBudgetAutoAdjustData
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    BillingViewArn string
    ARN of the billing view.
    BudgetExceeded bool
    Whether the budget has been exceeded.
    BudgetLimits []GetBudgetBudgetLimit
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    BudgetType string
    Whether the budget tracks monetary cost or usage.
    CalculatedSpends []GetBudgetCalculatedSpend
    Spend objects associated with the budget. See calculatedSpend Block for details.
    CostFilters []GetBudgetCostFilter
    Cost filters applied to the budget. See costFilter Block for details.
    CostTypes []GetBudgetCostType
    Types of cost included in the budget. See costTypes Block for details.
    Id string
    The provider-assigned unique ID for this managed resource.
    Name string
    Name of the cost filter.
    Notifications []GetBudgetNotification
    Notifications associated with the budget. See notification Block for details.
    PlannedLimits []GetBudgetPlannedLimit
    Budget limits planned for future periods. See plannedLimit Block for details.
    Tags map[string]string
    Map of tags assigned to the resource.
    TimePeriodEnd string
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    TimePeriodStart string
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    TimeUnit string
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    NamePrefix string
    account_id string
    arn string
    ARN of the budget.
    auto_adjust_datas list(object)
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    billing_view_arn string
    ARN of the billing view.
    budget_exceeded bool
    Whether the budget has been exceeded.
    budget_limits list(object)
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    budget_type string
    Whether the budget tracks monetary cost or usage.
    calculated_spends list(object)
    Spend objects associated with the budget. See calculatedSpend Block for details.
    cost_filters list(object)
    Cost filters applied to the budget. See costFilter Block for details.
    cost_types list(object)
    Types of cost included in the budget. See costTypes Block for details.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Name of the cost filter.
    notifications list(object)
    Notifications associated with the budget. See notification Block for details.
    planned_limits list(object)
    Budget limits planned for future periods. See plannedLimit Block for details.
    tags map(string)
    Map of tags assigned to the resource.
    time_period_end string
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    time_period_start string
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    time_unit string
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    name_prefix string
    accountId String
    arn String
    ARN of the budget.
    autoAdjustDatas List<GetBudgetAutoAdjustData>
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    billingViewArn String
    ARN of the billing view.
    budgetExceeded Boolean
    Whether the budget has been exceeded.
    budgetLimits List<GetBudgetBudgetLimit>
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    budgetType String
    Whether the budget tracks monetary cost or usage.
    calculatedSpends List<GetBudgetCalculatedSpend>
    Spend objects associated with the budget. See calculatedSpend Block for details.
    costFilters List<GetBudgetCostFilter>
    Cost filters applied to the budget. See costFilter Block for details.
    costTypes List<GetBudgetCostType>
    Types of cost included in the budget. See costTypes Block for details.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Name of the cost filter.
    notifications List<GetBudgetNotification>
    Notifications associated with the budget. See notification Block for details.
    plannedLimits List<GetBudgetPlannedLimit>
    Budget limits planned for future periods. See plannedLimit Block for details.
    tags Map<String,String>
    Map of tags assigned to the resource.
    timePeriodEnd String
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    timePeriodStart String
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    timeUnit String
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    namePrefix String
    accountId string
    arn string
    ARN of the budget.
    autoAdjustDatas GetBudgetAutoAdjustData[]
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    billingViewArn string
    ARN of the billing view.
    budgetExceeded boolean
    Whether the budget has been exceeded.
    budgetLimits GetBudgetBudgetLimit[]
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    budgetType string
    Whether the budget tracks monetary cost or usage.
    calculatedSpends GetBudgetCalculatedSpend[]
    Spend objects associated with the budget. See calculatedSpend Block for details.
    costFilters GetBudgetCostFilter[]
    Cost filters applied to the budget. See costFilter Block for details.
    costTypes GetBudgetCostType[]
    Types of cost included in the budget. See costTypes Block for details.
    id string
    The provider-assigned unique ID for this managed resource.
    name string
    Name of the cost filter.
    notifications GetBudgetNotification[]
    Notifications associated with the budget. See notification Block for details.
    plannedLimits GetBudgetPlannedLimit[]
    Budget limits planned for future periods. See plannedLimit Block for details.
    tags {[key: string]: string}
    Map of tags assigned to the resource.
    timePeriodEnd string
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    timePeriodStart string
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    timeUnit string
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    namePrefix string
    account_id str
    arn str
    ARN of the budget.
    auto_adjust_datas Sequence[GetBudgetAutoAdjustData]
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    billing_view_arn str
    ARN of the billing view.
    budget_exceeded bool
    Whether the budget has been exceeded.
    budget_limits Sequence[GetBudgetBudgetLimit]
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    budget_type str
    Whether the budget tracks monetary cost or usage.
    calculated_spends Sequence[GetBudgetCalculatedSpend]
    Spend objects associated with the budget. See calculatedSpend Block for details.
    cost_filters Sequence[GetBudgetCostFilter]
    Cost filters applied to the budget. See costFilter Block for details.
    cost_types Sequence[GetBudgetCostType]
    Types of cost included in the budget. See costTypes Block for details.
    id str
    The provider-assigned unique ID for this managed resource.
    name str
    Name of the cost filter.
    notifications Sequence[GetBudgetNotification]
    Notifications associated with the budget. See notification Block for details.
    planned_limits Sequence[GetBudgetPlannedLimit]
    Budget limits planned for future periods. See plannedLimit Block for details.
    tags Mapping[str, str]
    Map of tags assigned to the resource.
    time_period_end str
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    time_period_start str
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    time_unit str
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    name_prefix str
    accountId String
    arn String
    ARN of the budget.
    autoAdjustDatas List<Property Map>
    Object that determines the budget amount for an auto-adjusting budget. See autoAdjustData Block for details.
    billingViewArn String
    ARN of the billing view.
    budgetExceeded Boolean
    Whether the budget has been exceeded.
    budgetLimits List<Property Map>
    Amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage tracked by the budget. See budgetLimit Block for details.
    budgetType String
    Whether the budget tracks monetary cost or usage.
    calculatedSpends List<Property Map>
    Spend objects associated with the budget. See calculatedSpend Block for details.
    costFilters List<Property Map>
    Cost filters applied to the budget. See costFilter Block for details.
    costTypes List<Property Map>
    Types of cost included in the budget. See costTypes Block for details.
    id String
    The provider-assigned unique ID for this managed resource.
    name String
    Name of the cost filter.
    notifications List<Property Map>
    Notifications associated with the budget. See notification Block for details.
    plannedLimits List<Property Map>
    Budget limits planned for future periods. See plannedLimit Block for details.
    tags Map<String>
    Map of tags assigned to the resource.
    timePeriodEnd String
    End of the time period covered by the budget. Format: 2017-01-01_12:00.
    timePeriodStart String
    Start of the time period covered by the budget. Format: 2017-01-01_12:00.
    timeUnit String
    Length of time until the budget resets the actual and forecasted spend. Valid values: MONTHLY, QUARTERLY, ANNUALLY, and DAILY.
    namePrefix String

    Supporting Types

    GetBudgetAutoAdjustData

    AutoAdjustType string
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    HistoricalOptions List<GetBudgetAutoAdjustDataHistoricalOption>
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    LastAutoAdjustTime string
    Last time that the budget was auto-adjusted.
    AutoAdjustType string
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    HistoricalOptions []GetBudgetAutoAdjustDataHistoricalOption
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    LastAutoAdjustTime string
    Last time that the budget was auto-adjusted.
    auto_adjust_type string
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    historical_options list(object)
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    last_auto_adjust_time string
    Last time that the budget was auto-adjusted.
    autoAdjustType String
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    historicalOptions List<GetBudgetAutoAdjustDataHistoricalOption>
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    lastAutoAdjustTime String
    Last time that the budget was auto-adjusted.
    autoAdjustType string
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    historicalOptions GetBudgetAutoAdjustDataHistoricalOption[]
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    lastAutoAdjustTime string
    Last time that the budget was auto-adjusted.
    auto_adjust_type str
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    historical_options Sequence[GetBudgetAutoAdjustDataHistoricalOption]
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    last_auto_adjust_time str
    Last time that the budget was auto-adjusted.
    autoAdjustType String
    String that defines whether the budget auto-adjusts based on historical or forecasted data. Valid values: FORECAST, HISTORICAL.
    historicalOptions List<Property Map>
    Historical data that the auto-adjusting budget is based on. See historicalOptions Block for details.
    lastAutoAdjustTime String
    Last time that the budget was auto-adjusted.

    GetBudgetAutoAdjustDataHistoricalOption

    BudgetAdjustmentPeriod int
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    LookbackAvailablePeriods int
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.
    BudgetAdjustmentPeriod int
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    LookbackAvailablePeriods int
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.
    budget_adjustment_period number
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    lookback_available_periods number
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.
    budgetAdjustmentPeriod Integer
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    lookbackAvailablePeriods Integer
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.
    budgetAdjustmentPeriod number
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    lookbackAvailablePeriods number
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.
    budget_adjustment_period int
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    lookback_available_periods int
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.
    budgetAdjustmentPeriod Number
    Number of budget periods included in the moving-average calculation that determines the auto-adjusted budget amount.
    lookbackAvailablePeriods Number
    Number of budget periods in the budgetAdjustmentPeriod included in the calculation of the current budget limit.

    GetBudgetBudgetLimit

    Amount string
    Amount of cost or usage measured for the budget.
    Unit string
    Unit of measurement used for the budget, such as dollars or GB.
    Amount string
    Amount of cost or usage measured for the budget.
    Unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount string
    Amount of cost or usage measured for the budget.
    unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount String
    Amount of cost or usage measured for the budget.
    unit String
    Unit of measurement used for the budget, such as dollars or GB.
    amount string
    Amount of cost or usage measured for the budget.
    unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount str
    Amount of cost or usage measured for the budget.
    unit str
    Unit of measurement used for the budget, such as dollars or GB.
    amount String
    Amount of cost or usage measured for the budget.
    unit String
    Unit of measurement used for the budget, such as dollars or GB.

    GetBudgetCalculatedSpend

    ActualSpends List<GetBudgetCalculatedSpendActualSpend>
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.
    ActualSpends []GetBudgetCalculatedSpendActualSpend
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.
    actual_spends list(object)
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.
    actualSpends List<GetBudgetCalculatedSpendActualSpend>
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.
    actualSpends GetBudgetCalculatedSpendActualSpend[]
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.
    actual_spends Sequence[GetBudgetCalculatedSpendActualSpend]
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.
    actualSpends List<Property Map>
    Amount of cost, usage, RI units, or Savings Plans units used. See actualSpend Block for details.

    GetBudgetCalculatedSpendActualSpend

    Amount string
    Amount of cost or usage measured for the budget.
    Unit string
    Unit of measurement used for the budget, such as dollars or GB.
    Amount string
    Amount of cost or usage measured for the budget.
    Unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount string
    Amount of cost or usage measured for the budget.
    unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount String
    Amount of cost or usage measured for the budget.
    unit String
    Unit of measurement used for the budget, such as dollars or GB.
    amount string
    Amount of cost or usage measured for the budget.
    unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount str
    Amount of cost or usage measured for the budget.
    unit str
    Unit of measurement used for the budget, such as dollars or GB.
    amount String
    Amount of cost or usage measured for the budget.
    unit String
    Unit of measurement used for the budget, such as dollars or GB.

    GetBudgetCostFilter

    Name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    Values List<string>
    Values of the cost filter.
    Name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    Values []string
    Values of the cost filter.
    name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    values list(string)
    Values of the cost filter.
    name String

    Name of the budget. Unique within an account.

    The following arguments are optional:

    values List<String>
    Values of the cost filter.
    name string

    Name of the budget. Unique within an account.

    The following arguments are optional:

    values string[]
    Values of the cost filter.
    name str

    Name of the budget. Unique within an account.

    The following arguments are optional:

    values Sequence[str]
    Values of the cost filter.
    name String

    Name of the budget. Unique within an account.

    The following arguments are optional:

    values List<String>
    Values of the cost filter.

    GetBudgetCostType

    IncludeCredit bool
    Whether to include credits in the cost budget.
    IncludeDiscount bool
    Whether to include discounts in the cost budget.
    IncludeOtherSubscription bool
    Whether to include other subscription costs in the cost budget.
    IncludeRecurring bool
    Whether to include recurring costs in the cost budget.
    IncludeRefund bool
    Whether to include refunds in the cost budget.
    IncludeSubscription bool
    Whether to include subscriptions in the cost budget.
    IncludeSupport bool
    Whether to include support costs in the cost budget.
    IncludeTax bool
    Whether to include tax in the cost budget.
    IncludeUpfront bool
    Whether to include upfront costs in the cost budget.
    UseAmortized bool
    Whether the budget uses the amortized rate.
    UseBlended bool
    Whether to use blended costs in the cost budget.
    IncludeCredit bool
    Whether to include credits in the cost budget.
    IncludeDiscount bool
    Whether to include discounts in the cost budget.
    IncludeOtherSubscription bool
    Whether to include other subscription costs in the cost budget.
    IncludeRecurring bool
    Whether to include recurring costs in the cost budget.
    IncludeRefund bool
    Whether to include refunds in the cost budget.
    IncludeSubscription bool
    Whether to include subscriptions in the cost budget.
    IncludeSupport bool
    Whether to include support costs in the cost budget.
    IncludeTax bool
    Whether to include tax in the cost budget.
    IncludeUpfront bool
    Whether to include upfront costs in the cost budget.
    UseAmortized bool
    Whether the budget uses the amortized rate.
    UseBlended bool
    Whether to use blended costs in the cost budget.
    include_credit bool
    Whether to include credits in the cost budget.
    include_discount bool
    Whether to include discounts in the cost budget.
    include_other_subscription bool
    Whether to include other subscription costs in the cost budget.
    include_recurring bool
    Whether to include recurring costs in the cost budget.
    include_refund bool
    Whether to include refunds in the cost budget.
    include_subscription bool
    Whether to include subscriptions in the cost budget.
    include_support bool
    Whether to include support costs in the cost budget.
    include_tax bool
    Whether to include tax in the cost budget.
    include_upfront bool
    Whether to include upfront costs in the cost budget.
    use_amortized bool
    Whether the budget uses the amortized rate.
    use_blended bool
    Whether to use blended costs in the cost budget.
    includeCredit Boolean
    Whether to include credits in the cost budget.
    includeDiscount Boolean
    Whether to include discounts in the cost budget.
    includeOtherSubscription Boolean
    Whether to include other subscription costs in the cost budget.
    includeRecurring Boolean
    Whether to include recurring costs in the cost budget.
    includeRefund Boolean
    Whether to include refunds in the cost budget.
    includeSubscription Boolean
    Whether to include subscriptions in the cost budget.
    includeSupport Boolean
    Whether to include support costs in the cost budget.
    includeTax Boolean
    Whether to include tax in the cost budget.
    includeUpfront Boolean
    Whether to include upfront costs in the cost budget.
    useAmortized Boolean
    Whether the budget uses the amortized rate.
    useBlended Boolean
    Whether to use blended costs in the cost budget.
    includeCredit boolean
    Whether to include credits in the cost budget.
    includeDiscount boolean
    Whether to include discounts in the cost budget.
    includeOtherSubscription boolean
    Whether to include other subscription costs in the cost budget.
    includeRecurring boolean
    Whether to include recurring costs in the cost budget.
    includeRefund boolean
    Whether to include refunds in the cost budget.
    includeSubscription boolean
    Whether to include subscriptions in the cost budget.
    includeSupport boolean
    Whether to include support costs in the cost budget.
    includeTax boolean
    Whether to include tax in the cost budget.
    includeUpfront boolean
    Whether to include upfront costs in the cost budget.
    useAmortized boolean
    Whether the budget uses the amortized rate.
    useBlended boolean
    Whether to use blended costs in the cost budget.
    include_credit bool
    Whether to include credits in the cost budget.
    include_discount bool
    Whether to include discounts in the cost budget.
    include_other_subscription bool
    Whether to include other subscription costs in the cost budget.
    include_recurring bool
    Whether to include recurring costs in the cost budget.
    include_refund bool
    Whether to include refunds in the cost budget.
    include_subscription bool
    Whether to include subscriptions in the cost budget.
    include_support bool
    Whether to include support costs in the cost budget.
    include_tax bool
    Whether to include tax in the cost budget.
    include_upfront bool
    Whether to include upfront costs in the cost budget.
    use_amortized bool
    Whether the budget uses the amortized rate.
    use_blended bool
    Whether to use blended costs in the cost budget.
    includeCredit Boolean
    Whether to include credits in the cost budget.
    includeDiscount Boolean
    Whether to include discounts in the cost budget.
    includeOtherSubscription Boolean
    Whether to include other subscription costs in the cost budget.
    includeRecurring Boolean
    Whether to include recurring costs in the cost budget.
    includeRefund Boolean
    Whether to include refunds in the cost budget.
    includeSubscription Boolean
    Whether to include subscriptions in the cost budget.
    includeSupport Boolean
    Whether to include support costs in the cost budget.
    includeTax Boolean
    Whether to include tax in the cost budget.
    includeUpfront Boolean
    Whether to include upfront costs in the cost budget.
    useAmortized Boolean
    Whether the budget uses the amortized rate.
    useBlended Boolean
    Whether to use blended costs in the cost budget.

    GetBudgetNotification

    ComparisonOperator string
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    NotificationType string
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    SubscriberEmailAddresses List<string>
    Email addresses to notify.
    SubscriberSnsTopicArns List<string>
    SNS topics to notify.
    Threshold double
    Threshold at which the notification is sent.
    ThresholdType string
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.
    ComparisonOperator string
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    NotificationType string
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    SubscriberEmailAddresses []string
    Email addresses to notify.
    SubscriberSnsTopicArns []string
    SNS topics to notify.
    Threshold float64
    Threshold at which the notification is sent.
    ThresholdType string
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.
    comparison_operator string
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    notification_type string
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    subscriber_email_addresses list(string)
    Email addresses to notify.
    subscriber_sns_topic_arns list(string)
    SNS topics to notify.
    threshold number
    Threshold at which the notification is sent.
    threshold_type string
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.
    comparisonOperator String
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    notificationType String
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    subscriberEmailAddresses List<String>
    Email addresses to notify.
    subscriberSnsTopicArns List<String>
    SNS topics to notify.
    threshold Double
    Threshold at which the notification is sent.
    thresholdType String
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.
    comparisonOperator string
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    notificationType string
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    subscriberEmailAddresses string[]
    Email addresses to notify.
    subscriberSnsTopicArns string[]
    SNS topics to notify.
    threshold number
    Threshold at which the notification is sent.
    thresholdType string
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.
    comparison_operator str
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    notification_type str
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    subscriber_email_addresses Sequence[str]
    Email addresses to notify.
    subscriber_sns_topic_arns Sequence[str]
    SNS topics to notify.
    threshold float
    Threshold at which the notification is sent.
    threshold_type str
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.
    comparisonOperator String
    Comparison operator used to evaluate the condition. Valid values: LESS_THAN, EQUAL_TO, GREATER_THAN.
    notificationType String
    Type of budget value to notify on. Valid values: ACTUAL, FORECASTED.
    subscriberEmailAddresses List<String>
    Email addresses to notify.
    subscriberSnsTopicArns List<String>
    SNS topics to notify.
    threshold Number
    Threshold at which the notification is sent.
    thresholdType String
    Type of threshold. Valid values: PERCENTAGE, ABSOLUTE_VALUE.

    GetBudgetPlannedLimit

    Amount string
    Amount of cost or usage measured for the budget.
    StartTime string
    Start time of the budget limit. Format: 2017-01-01_12:00.
    Unit string
    Unit of measurement used for the budget, such as dollars or GB.
    Amount string
    Amount of cost or usage measured for the budget.
    StartTime string
    Start time of the budget limit. Format: 2017-01-01_12:00.
    Unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount string
    Amount of cost or usage measured for the budget.
    start_time string
    Start time of the budget limit. Format: 2017-01-01_12:00.
    unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount String
    Amount of cost or usage measured for the budget.
    startTime String
    Start time of the budget limit. Format: 2017-01-01_12:00.
    unit String
    Unit of measurement used for the budget, such as dollars or GB.
    amount string
    Amount of cost or usage measured for the budget.
    startTime string
    Start time of the budget limit. Format: 2017-01-01_12:00.
    unit string
    Unit of measurement used for the budget, such as dollars or GB.
    amount str
    Amount of cost or usage measured for the budget.
    start_time str
    Start time of the budget limit. Format: 2017-01-01_12:00.
    unit str
    Unit of measurement used for the budget, such as dollars or GB.
    amount String
    Amount of cost or usage measured for the budget.
    startTime String
    Start time of the budget limit. Format: 2017-01-01_12:00.
    unit String
    Unit of measurement used for the budget, such as dollars or GB.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo aws logo
    Viewing docs for AWS v7.48.0
    published on Tuesday, Sep 22, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial