import * as pulumi from "@pulumi/pulumi"; import * as inputs from "./types/input"; import * as outputs from "./types/output"; /** * Provides a Datadog Cost Budget resource. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as datadog from "@pulumi/datadog"; * * // Budget with multiple tag combinations * // Note: Each unique tag combination needs its own budget_line block * const withTags = new datadog.CostBudget("with_tags", { * name: "Multi-Environment Budget", * metricsQuery: "sum:aws.cost.amortized{*} by {environment}", * startMonth: 202601, * endMonth: 202603, * budgetLines: [ * { * amounts: { * "202601": 2000, * "202602": 2200, * "202603": 2000, * }, * tagFilters: [{ * tagKey: "environment", * tagValue: "production", * }], * }, * { * amounts: { * "202601": 1000, * "202602": 1100, * "202603": 1000, * }, * tagFilters: [{ * tagKey: "environment", * tagValue: "staging", * }], * }, * ], * }); * ``` * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as datadog from "@pulumi/datadog"; * * // Hierarchical budget with parent/child tag structure * // Note: Order in "by {tag1,tag2}" determines hierarchy (parent,child) * // Each unique parent+child combination needs its own budget_line block * const hierarchical = new datadog.CostBudget("hierarchical", { * name: "Team-Based AWS Budget", * metricsQuery: "sum:aws.cost.amortized{*} by {team,environment}", * startMonth: 202601, * endMonth: 202603, * budgetLines: [ * { * amounts: { * "202601": 1500, * "202602": 1600, * "202603": 1500, * }, * parentTagFilters: [{ * tagKey: "team", * tagValue: "backend", * }], * childTagFilters: [{ * tagKey: "environment", * tagValue: "production", * }], * }, * { * amounts: { * "202601": 500, * "202602": 550, * "202603": 500, * }, * parentTagFilters: [{ * tagKey: "team", * tagValue: "frontend", * }], * childTagFilters: [{ * tagKey: "environment", * tagValue: "staging", * }], * }, * ], * }); * ``` * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as datadog from "@pulumi/datadog"; * * // Legacy entries with tag filters (deprecated - use budget_line instead) * // Note: Each unique tag combination must have entries for all months * const legacyWithTags = new datadog.CostBudget("legacy_with_tags", { * name: "Production Budget (Legacy)", * metricsQuery: "sum:aws.cost.amortized{*} by {environment}", * startMonth: 202601, * endMonth: 202603, * entries: [ * { * month: 202601, * amount: 2000, * tagFilters: [{ * tagKey: "environment", * tagValue: "production", * }], * }, * { * month: 202602, * amount: 2200, * tagFilters: [{ * tagKey: "environment", * tagValue: "production", * }], * }, * { * month: 202603, * amount: 2000, * tagFilters: [{ * tagKey: "environment", * tagValue: "production", * }], * }, * ], * }); * ``` * * ## Import * * The `pulumi import` command can be used, for example: * * Cost budgets can be imported using their ID, e.g. * * ```sh * $ pulumi import datadog:index/costBudget:CostBudget example a1b2c3d4-e5f6-7890-abcd-ef1234567890 * ``` */ export declare class CostBudget extends pulumi.CustomResource { /** * Get an existing CostBudget resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: CostBudgetState, opts?: pulumi.CustomResourceOptions): CostBudget; /** * Returns true if the given object is an instance of CostBudget. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is CostBudget; /** * The ID of the budget. */ readonly budgetId: pulumi.Output; /** * Budget lines that group monthly amounts by tag combination. Use this instead of `entries` for a more convenient schema. **Note:** The order of budget*line blocks does not matter. */ readonly budgetLines: pulumi.Output; /** * The month when the budget ends (YYYYMM). */ readonly endMonth: pulumi.Output; /** * The entries of the budget. **Note:** You must provide entries for all months in the budget period. For hierarchical budgets, each unique tag combination must have entries for all months. * * @deprecated Use budgetLine instead. This field will be removed in a future version. */ readonly entries: pulumi.Output; /** * The cost query used to track against the budget. **Note:** For hierarchical budgets using `by {tag1,tag2}`, the order of tags determines the UI hierarchy (parent, child). */ readonly metricsQuery: pulumi.Output; /** * The name of the budget. */ readonly name: pulumi.Output; /** * The month when the budget starts (YYYYMM). */ readonly startMonth: pulumi.Output; /** * The sum of all budget entries' amounts. */ readonly totalAmount: pulumi.Output; /** * Create a CostBudget resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: CostBudgetArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering CostBudget resources. */ export interface CostBudgetState { /** * The ID of the budget. */ budgetId?: pulumi.Input; /** * Budget lines that group monthly amounts by tag combination. Use this instead of `entries` for a more convenient schema. **Note:** The order of budget*line blocks does not matter. */ budgetLines?: pulumi.Input[]>; /** * The month when the budget ends (YYYYMM). */ endMonth?: pulumi.Input; /** * The entries of the budget. **Note:** You must provide entries for all months in the budget period. For hierarchical budgets, each unique tag combination must have entries for all months. * * @deprecated Use budgetLine instead. This field will be removed in a future version. */ entries?: pulumi.Input[]>; /** * The cost query used to track against the budget. **Note:** For hierarchical budgets using `by {tag1,tag2}`, the order of tags determines the UI hierarchy (parent, child). */ metricsQuery?: pulumi.Input; /** * The name of the budget. */ name?: pulumi.Input; /** * The month when the budget starts (YYYYMM). */ startMonth?: pulumi.Input; /** * The sum of all budget entries' amounts. */ totalAmount?: pulumi.Input; } /** * The set of arguments for constructing a CostBudget resource. */ export interface CostBudgetArgs { /** * The ID of the budget. */ budgetId?: pulumi.Input; /** * Budget lines that group monthly amounts by tag combination. Use this instead of `entries` for a more convenient schema. **Note:** The order of budget*line blocks does not matter. */ budgetLines?: pulumi.Input[]>; /** * The month when the budget ends (YYYYMM). */ endMonth: pulumi.Input; /** * The entries of the budget. **Note:** You must provide entries for all months in the budget period. For hierarchical budgets, each unique tag combination must have entries for all months. * * @deprecated Use budgetLine instead. This field will be removed in a future version. */ entries?: pulumi.Input[]>; /** * The cost query used to track against the budget. **Note:** For hierarchical budgets using `by {tag1,tag2}`, the order of tags determines the UI hierarchy (parent, child). */ metricsQuery: pulumi.Input; /** * The name of the budget. */ name: pulumi.Input; /** * The month when the budget starts (YYYYMM). */ startMonth: pulumi.Input; }