import type { MetadataBearer as __MetadataBearer } from "@smithy/types"; import type { DescribeBudgetsRequest, DescribeBudgetsResponse } from "../models/models_0"; /** * @public */ export type { __MetadataBearer }; /** * @public * * The input for {@link DescribeBudgetsCommand}. */ export interface DescribeBudgetsCommandInput extends DescribeBudgetsRequest { } /** * @public * * The output of {@link DescribeBudgetsCommand}. */ export interface DescribeBudgetsCommandOutput extends DescribeBudgetsResponse, __MetadataBearer { } declare const DescribeBudgetsCommand_base: { new (input: DescribeBudgetsCommandInput): import("@smithy/core/client").CommandImpl; new (input: DescribeBudgetsCommandInput): import("@smithy/core/client").CommandImpl; getEndpointParameterInstructions(): import("@smithy/types").EndpointParameterInstructions; }; /** *

Lists the budgets that are associated with an account.

* *

The Request Syntax section shows the BudgetLimit syntax. For * PlannedBudgetLimits, see the Examples section.

*
* @example * Use a bare-bones client and the command you need to make an API call. * ```javascript * import { BudgetsClient, DescribeBudgetsCommand } from "@aws-sdk/client-budgets"; // ES Modules import * // const { BudgetsClient, DescribeBudgetsCommand } = require("@aws-sdk/client-budgets"); // CommonJS import * // import type { BudgetsClientConfig } from "@aws-sdk/client-budgets"; * const config = {}; // type is BudgetsClientConfig * const client = new BudgetsClient(config); * const input = { // DescribeBudgetsRequest * AccountId: "STRING_VALUE", // required * MaxResults: Number("int"), * NextToken: "STRING_VALUE", * ShowFilterExpression: true || false, * }; * const command = new DescribeBudgetsCommand(input); * const response = await client.send(command); * // { // DescribeBudgetsResponse * // Budgets: [ // Budgets * // { // Budget * // BudgetName: "STRING_VALUE", // required * // BudgetLimit: { // Spend * // Amount: "STRING_VALUE", // required * // Unit: "STRING_VALUE", // required * // }, * // PlannedBudgetLimits: { // PlannedBudgetLimits * // "": { * // Amount: "STRING_VALUE", // required * // Unit: "STRING_VALUE", // required * // }, * // }, * // CostFilters: { // CostFilters * // "": [ // DimensionValues * // "STRING_VALUE", * // ], * // }, * // CostTypes: { // CostTypes * // IncludeTax: true || false, * // IncludeSubscription: true || false, * // UseBlended: true || false, * // IncludeRefund: true || false, * // IncludeCredit: true || false, * // IncludeUpfront: true || false, * // IncludeRecurring: true || false, * // IncludeOtherSubscription: true || false, * // IncludeSupport: true || false, * // IncludeDiscount: true || false, * // UseAmortized: true || false, * // }, * // TimeUnit: "DAILY" || "MONTHLY" || "QUARTERLY" || "ANNUALLY" || "CUSTOM", // required * // TimePeriod: { // TimePeriod * // Start: new Date("TIMESTAMP"), * // End: new Date("TIMESTAMP"), * // }, * // CalculatedSpend: { // CalculatedSpend * // ActualSpend: { * // Amount: "STRING_VALUE", // required * // Unit: "STRING_VALUE", // required * // }, * // ForecastedSpend: { * // Amount: "STRING_VALUE", // required * // Unit: "STRING_VALUE", // required * // }, * // }, * // BudgetType: "USAGE" || "COST" || "RI_UTILIZATION" || "RI_COVERAGE" || "SAVINGS_PLANS_UTILIZATION" || "SAVINGS_PLANS_COVERAGE", // required * // LastUpdatedTime: new Date("TIMESTAMP"), * // AutoAdjustData: { // AutoAdjustData * // AutoAdjustType: "HISTORICAL" || "FORECAST", // required * // HistoricalOptions: { // HistoricalOptions * // BudgetAdjustmentPeriod: Number("int"), // required * // LookBackAvailablePeriods: Number("int"), * // }, * // LastAutoAdjustTime: new Date("TIMESTAMP"), * // }, * // FilterExpression: { // Expression * // Or: [ // Expressions * // { * // Or: [ * // "", * // ], * // And: [ * // "", * // ], * // Not: "", * // Dimensions: { // ExpressionDimensionValues * // Key: "AZ" || "INSTANCE_TYPE" || "LINKED_ACCOUNT" || "LINKED_ACCOUNT_NAME" || "OPERATION" || "PURCHASE_TYPE" || "REGION" || "SERVICE" || "SERVICE_CODE" || "USAGE_TYPE" || "USAGE_TYPE_GROUP" || "RECORD_TYPE" || "OPERATING_SYSTEM" || "TENANCY" || "SCOPE" || "PLATFORM" || "SUBSCRIPTION_ID" || "LEGAL_ENTITY_NAME" || "INVOICING_ENTITY" || "DEPLOYMENT_OPTION" || "DATABASE_ENGINE" || "CACHE_ENGINE" || "INSTANCE_TYPE_FAMILY" || "BILLING_ENTITY" || "RESERVATION_ID" || "RESOURCE_ID" || "RIGHTSIZING_TYPE" || "SAVINGS_PLANS_TYPE" || "SAVINGS_PLAN_ARN" || "PAYMENT_OPTION" || "RESERVATION_MODIFIED" || "TAG_KEY" || "COST_CATEGORY_NAME", // required * // Values: [ // Values // required * // "STRING_VALUE", * // ], * // MatchOptions: [ // MatchOptions * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "GREATER_THAN_OR_EQUAL" || "CASE_SENSITIVE" || "CASE_INSENSITIVE", * // ], * // }, * // Tags: { // TagValues * // Key: "STRING_VALUE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "GREATER_THAN_OR_EQUAL" || "CASE_SENSITIVE" || "CASE_INSENSITIVE", * // ], * // }, * // CostCategories: { // CostCategoryValues * // Key: "STRING_VALUE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "GREATER_THAN_OR_EQUAL" || "CASE_SENSITIVE" || "CASE_INSENSITIVE", * // ], * // }, * // }, * // ], * // And: [ * // "", * // ], * // Not: "", * // Dimensions: { * // Key: "AZ" || "INSTANCE_TYPE" || "LINKED_ACCOUNT" || "LINKED_ACCOUNT_NAME" || "OPERATION" || "PURCHASE_TYPE" || "REGION" || "SERVICE" || "SERVICE_CODE" || "USAGE_TYPE" || "USAGE_TYPE_GROUP" || "RECORD_TYPE" || "OPERATING_SYSTEM" || "TENANCY" || "SCOPE" || "PLATFORM" || "SUBSCRIPTION_ID" || "LEGAL_ENTITY_NAME" || "INVOICING_ENTITY" || "DEPLOYMENT_OPTION" || "DATABASE_ENGINE" || "CACHE_ENGINE" || "INSTANCE_TYPE_FAMILY" || "BILLING_ENTITY" || "RESERVATION_ID" || "RESOURCE_ID" || "RIGHTSIZING_TYPE" || "SAVINGS_PLANS_TYPE" || "SAVINGS_PLAN_ARN" || "PAYMENT_OPTION" || "RESERVATION_MODIFIED" || "TAG_KEY" || "COST_CATEGORY_NAME", // required * // Values: [ // required * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "GREATER_THAN_OR_EQUAL" || "CASE_SENSITIVE" || "CASE_INSENSITIVE", * // ], * // }, * // Tags: { * // Key: "STRING_VALUE", * // Values: [ * // "STRING_VALUE", * // ], * // MatchOptions: [ * // "EQUALS" || "ABSENT" || "STARTS_WITH" || "ENDS_WITH" || "CONTAINS" || "GREATER_THAN_OR_EQUAL" || "CASE_SENSITIVE" || "CASE_INSENSITIVE", * // ], * // }, * // CostCategories: { * // Key: "STRING_VALUE", * // Values: "", * // MatchOptions: "", * // }, * // }, * // Metrics: [ // Metrics * // "BlendedCost" || "UnblendedCost" || "AmortizedCost" || "NetUnblendedCost" || "NetAmortizedCost" || "UsageQuantity" || "NormalizedUsageAmount" || "Hours", * // ], * // BillingViewArn: "STRING_VALUE", * // HealthStatus: { // HealthStatus * // Status: "HEALTHY" || "UNHEALTHY", * // StatusReason: "BILLING_VIEW_NO_ACCESS" || "BILLING_VIEW_UNHEALTHY" || "FILTER_INVALID" || "MULTI_YEAR_HISTORICAL_DATA_DISABLED", * // LastUpdatedTime: new Date("TIMESTAMP"), * // }, * // }, * // ], * // NextToken: "STRING_VALUE", * // }; * * ``` * * @param DescribeBudgetsCommandInput - {@link DescribeBudgetsCommandInput} * @returns {@link DescribeBudgetsCommandOutput} * @see {@link DescribeBudgetsCommandInput} for command's `input` shape. * @see {@link DescribeBudgetsCommandOutput} for command's `response` shape. * @see {@link BudgetsClientResolvedConfig | config} for BudgetsClient's `config` shape. * * @throws {@link AccessDeniedException} (client fault) *

You are not authorized to use this operation with the given parameters.

* * @throws {@link ExpiredNextTokenException} (client fault) *

The pagination token expired.

* * @throws {@link InternalErrorException} (server fault) *

An error on the server occurred during the processing of your request. Try again later.

* * @throws {@link InvalidNextTokenException} (client fault) *

The pagination token is invalid.

* * @throws {@link InvalidParameterException} (client fault) *

An error on the client occurred. Typically, the cause is an invalid input value.

* * @throws {@link NotFoundException} (client fault) *

We can’t locate the resource that you specified.

* * @throws {@link ThrottlingException} (client fault) *

The number of API requests has exceeded the maximum allowed API request throttling limit * for the account.

* * @throws {@link BudgetsServiceException} *

Base exception class for all service exceptions from Budgets service.

* * * @public */ export declare class DescribeBudgetsCommand extends DescribeBudgetsCommand_base { /** @internal type navigation helper, not in runtime. */ protected static __types: { api: { input: DescribeBudgetsRequest; output: DescribeBudgetsResponse; }; sdk: { input: DescribeBudgetsCommandInput; output: DescribeBudgetsCommandOutput; }; }; }