Create a cost budget for a tag

POST 
/cost-management/budgets

Creates an AWS Budgets-backed cost budget scoped to TagKey/TagValues, with 1–3 ActionConfigurations (email and/or stop_resources). Required body fields: BudgetName, BudgetAmount, BudgetPeriod, ActionConfigurations, TagKey, TagValues. Optional Description, CurrencyUnit (default USD), CreateSeparateBudgets (when true, creates one budget per TagValue and returns BudgetIds). BudgetPeriod is daily|monthly|quarterly|annually. ActionType is email|stop_resources; ThresholdType is percentage|absolute_value; stop_resources requires ResourceTypes from jobs|datalabs|data-pipelines|agents|ai-models (max one stop_resources). Not idempotent: duplicate tag+period returns CE-1003; duplicate AWS budget name returns CE-1004.

Request

Responses

200

Budget created. Returns BudgetId + Message normally, or BudgetIds + Message when CreateSeparateBudgets is true.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation failure. Body is {"Message": " - "}. Common codes: IPV-1008 (missing keys), IPV-1045 / IPV-1010 / IPV-1036 (field validation), CE-1003 (duplicate tag+period), CE-1004 (duplicate budget name), GE-1034.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers