@@ -186,6 +186,13 @@ components:
186186 required: true
187187 schema:
188188 type: string
189+ BudgetID:
190+ description: Budget id.
191+ in: path
192+ name: budget_id
193+ required: true
194+ schema:
195+ type: string
189196 CaseIDPathParameter:
190197 description: Case's UUID or key
191198 example: f98a5a5b-e0ff-45d4-b2f5-afe6e74de504
@@ -4663,6 +4670,241 @@ components:
46634670 data:
46644671 $ref: '#/components/schemas/BillingDimensionsMappingBody'
46654672 type: object
4673+ BudgetArray:
4674+ description: The definition of `BudgetArray` object.
4675+ example:
4676+ data:
4677+ - attributes:
4678+ created_at: 1741011342772
4679+ created_by: user1
4680+ end_month: 202502
4681+ metrics_query: aws.cost.amortized{service:ec2} by {service}
4682+ name: my budget
4683+ org_id: 123
4684+ start_month: 202501
4685+ tags: null
4686+ total_amount: 1000
4687+ updated_at: 1741011342772
4688+ updated_by: user2
4689+ id: '1'
4690+ type: budget
4691+ properties:
4692+ data:
4693+ description: The `BudgetArray` `data`.
4694+ items:
4695+ $ref: '#/components/schemas/BudgetData'
4696+ type: array
4697+ type: object
4698+ BudgetData:
4699+ description: The definition of `BudgetData` object.
4700+ properties:
4701+ attributes:
4702+ $ref: '#/components/schemas/BudgetDataAttributes'
4703+ id:
4704+ description: The `BudgetData` `id`.
4705+ type: string
4706+ type:
4707+ $ref: '#/components/schemas/BudgetDataType'
4708+ type: object
4709+ BudgetDataAttributes:
4710+ description: The definition of `BudgetDataAttributes` object.
4711+ properties:
4712+ created_at:
4713+ description: The `attributes` `created_at`.
4714+ format: int64
4715+ type: integer
4716+ created_by:
4717+ description: The `attributes` `created_by`.
4718+ type: string
4719+ end_month:
4720+ description: The `attributes` `end_month`.
4721+ format: int64
4722+ type: integer
4723+ metrics_query:
4724+ description: The `attributes` `metrics_query`.
4725+ type: string
4726+ name:
4727+ description: The `attributes` `name`.
4728+ type: string
4729+ org_id:
4730+ description: The `attributes` `org_id`.
4731+ format: int64
4732+ type: integer
4733+ start_month:
4734+ description: The `attributes` `start_month`.
4735+ format: int64
4736+ type: integer
4737+ tags:
4738+ description: The `attributes` `tags`.
4739+ items:
4740+ type: string
4741+ type: array
4742+ total_amount:
4743+ description: The `attributes` `total_amount`.
4744+ format: double
4745+ type: number
4746+ updated_at:
4747+ description: The `attributes` `updated_at`.
4748+ format: int64
4749+ type: integer
4750+ updated_by:
4751+ description: The `attributes` `updated_by`.
4752+ type: string
4753+ type: object
4754+ BudgetDataBudgetWithEntriesDataAttributes:
4755+ description: The definition of `BudgetDataBudgetWithEntriesDataAttributes` object.
4756+ properties:
4757+ created_at:
4758+ description: The `attributes` `created_at`.
4759+ format: int64
4760+ type: integer
4761+ created_by:
4762+ description: The `attributes` `created_by`.
4763+ type: string
4764+ end_month:
4765+ description: The `attributes` `end_month`.
4766+ format: int64
4767+ type: integer
4768+ entries:
4769+ description: The `attributes` `entries`.
4770+ items:
4771+ $ref: '#/components/schemas/BudgetDataBudgetWithEntriesDataAttributesEntriesItems'
4772+ type: array
4773+ metrics_query:
4774+ description: The `attributes` `metrics_query`.
4775+ type: string
4776+ name:
4777+ description: The `attributes` `name`.
4778+ type: string
4779+ org_id:
4780+ description: The `attributes` `org_id`.
4781+ format: int64
4782+ type: integer
4783+ start_month:
4784+ description: The `attributes` `start_month`.
4785+ format: int64
4786+ type: integer
4787+ tags:
4788+ description: The `attributes` `tags`.
4789+ items:
4790+ type: string
4791+ type: array
4792+ total_amount:
4793+ description: The `attributes` `total_amount`.
4794+ format: double
4795+ type: number
4796+ updated_at:
4797+ description: The `attributes` `updated_at`.
4798+ format: int64
4799+ type: integer
4800+ updated_by:
4801+ description: The `attributes` `updated_by`.
4802+ type: string
4803+ type: object
4804+ BudgetDataBudgetWithEntriesDataAttributesEntriesItems:
4805+ description: The definition of `BudgetDataBudgetWithEntriesDataAttributesEntriesItems`
4806+ object.
4807+ properties:
4808+ data:
4809+ $ref: '#/components/schemas/BudgetDataBudgetWithEntriesDataAttributesEntriesItemsData'
4810+ type: object
4811+ BudgetDataBudgetWithEntriesDataAttributesEntriesItemsData:
4812+ description: The definition of `BudgetDataBudgetWithEntriesDataAttributesEntriesItemsData`
4813+ object.
4814+ properties:
4815+ attributes:
4816+ $ref: '#/components/schemas/BudgetDataBudgetWithEntriesDataAttributesEntriesItemsDataAttributes'
4817+ type: object
4818+ BudgetDataBudgetWithEntriesDataAttributesEntriesItemsDataAttributes:
4819+ description: The definition of `BudgetDataBudgetWithEntriesDataAttributesEntriesItemsDataAttributes`
4820+ object.
4821+ properties:
4822+ amount:
4823+ description: The `attributes` `amount`.
4824+ format: double
4825+ type: number
4826+ month:
4827+ description: The `attributes` `month`.
4828+ format: int64
4829+ type: integer
4830+ tag_filters:
4831+ description: The `attributes` `tag_filters`.
4832+ items:
4833+ $ref: '#/components/schemas/BudgetDataBudgetWithEntriesDataAttributesEntriesItemsDataAttributesTagFiltersItems'
4834+ type: array
4835+ type: object
4836+ BudgetDataBudgetWithEntriesDataAttributesEntriesItemsDataAttributesTagFiltersItems:
4837+ description: The definition of `BudgetDataBudgetWithEntriesDataAttributesEntriesItemsDataAttributesTagFiltersItems`
4838+ object.
4839+ properties:
4840+ tag_key:
4841+ description: The `items` `tag_key`.
4842+ type: string
4843+ tag_value:
4844+ description: The `items` `tag_value`.
4845+ type: string
4846+ type: object
4847+ BudgetDataBudgetWithEntriesDataType:
4848+ default: budget
4849+ description: The definition of `BudgetDataBudgetWithEntriesDataType` object.
4850+ enum:
4851+ - budget
4852+ type: string
4853+ x-enum-varnames:
4854+ - BUDGET
4855+ BudgetDataType:
4856+ default: budget
4857+ description: The definition of `BudgetDataType` object.
4858+ enum:
4859+ - budget
4860+ type: string
4861+ x-enum-varnames:
4862+ - BUDGET
4863+ BudgetWithEntries:
4864+ description: The definition of `BudgetWithEntries` object.
4865+ example:
4866+ data:
4867+ attributes:
4868+ created_at: 1738258683590
4869+ created_by: 00000000-0a0a-0a0a-aaa0-00000000000a
4870+ end_month: 202502
4871+ entries:
4872+ - amount: 500
4873+ month: 202501
4874+ tag_filters:
4875+ - tag_key: service
4876+ tag_value: ec2
4877+ - amount: 500
4878+ month: 202502
4879+ tag_filters:
4880+ - tag_key: service
4881+ tag_value: ec2
4882+ metrics_query: aws.cost.amortized{service:ec2} by {service}
4883+ name: my budget
4884+ org_id: 123
4885+ start_month: 202501
4886+ tags:
4887+ - service
4888+ total_amount: 1000
4889+ updated_at: 1738258683590
4890+ updated_by: 00000000-0a0a-0a0a-aaa0-00000000000a
4891+ id: '1'
4892+ type: budget
4893+ properties:
4894+ data:
4895+ $ref: '#/components/schemas/BudgetWithEntriesData'
4896+ type: object
4897+ BudgetWithEntriesData:
4898+ description: The definition of `BudgetWithEntriesData` object.
4899+ properties:
4900+ attributes:
4901+ $ref: '#/components/schemas/BudgetDataBudgetWithEntriesDataAttributes'
4902+ id:
4903+ description: The `BudgetWithEntriesData` `id`.
4904+ type: string
4905+ type:
4906+ $ref: '#/components/schemas/BudgetDataBudgetWithEntriesDataType'
4907+ type: object
46664908 BulkMuteFindingsRequest:
46674909 description: The new bulk mute finding request.
46684910 properties:
@@ -39431,6 +39673,105 @@ paths:
3943139673 operator: OR
3943239674 permissions:
3943339675 - cloud_cost_management_write
39676+ /api/v2/cost/budget:
39677+ put:
39678+ description: Create a new budget or update an existing one.
39679+ operationId: UpsertBudget
39680+ requestBody:
39681+ content:
39682+ application/json:
39683+ schema:
39684+ $ref: '#/components/schemas/BudgetWithEntries'
39685+ required: true
39686+ responses:
39687+ '200':
39688+ content:
39689+ application/json:
39690+ schema:
39691+ $ref: '#/components/schemas/BudgetWithEntries'
39692+ description: OK
39693+ '400':
39694+ description: Bad Request
39695+ '404':
39696+ description: Not Found
39697+ '429':
39698+ $ref: '#/components/responses/TooManyRequestsResponse'
39699+ security:
39700+ - apiKeyAuth: []
39701+ appKeyAuth: []
39702+ - AuthZ:
39703+ - cloud_cost_management_write
39704+ summary: Update if exists, or create a new budget
39705+ tags:
39706+ - Cloud Cost Management
39707+ /api/v2/cost/budget/{budget_id}:
39708+ delete:
39709+ description: Delete a budget.
39710+ operationId: DeleteBudget
39711+ parameters:
39712+ - $ref: '#/components/parameters/BudgetID'
39713+ responses:
39714+ '204':
39715+ description: No Content
39716+ '400':
39717+ description: Bad Request
39718+ '429':
39719+ $ref: '#/components/responses/TooManyRequestsResponse'
39720+ security:
39721+ - apiKeyAuth: []
39722+ appKeyAuth: []
39723+ - AuthZ:
39724+ - cloud_cost_management_write
39725+ summary: Delete a budget
39726+ tags:
39727+ - Cloud Cost Management
39728+ get:
39729+ description: Get a budget.
39730+ operationId: GetBudget
39731+ parameters:
39732+ - $ref: '#/components/parameters/BudgetID'
39733+ responses:
39734+ '200':
39735+ content:
39736+ application/json:
39737+ schema:
39738+ $ref: '#/components/schemas/BudgetWithEntries'
39739+ description: OK
39740+ '400':
39741+ description: Bad Request
39742+ '404':
39743+ description: Not Found
39744+ '429':
39745+ $ref: '#/components/responses/TooManyRequestsResponse'
39746+ security:
39747+ - apiKeyAuth: []
39748+ appKeyAuth: []
39749+ - AuthZ:
39750+ - cloud_cost_management_read
39751+ summary: Get a budget
39752+ tags:
39753+ - Cloud Cost Management
39754+ /api/v2/cost/budgets:
39755+ get:
39756+ description: List budgets.
39757+ operationId: ListBudgets
39758+ responses:
39759+ '200':
39760+ content:
39761+ application/json:
39762+ schema:
39763+ $ref: '#/components/schemas/BudgetArray'
39764+ description: OK
39765+ '429':
39766+ $ref: '#/components/responses/TooManyRequestsResponse'
39767+ security:
39768+ - apiKeyAuth: []
39769+ appKeyAuth: []
39770+ - AuthZ:
39771+ - cloud_cost_management_read
39772+ summary: List budgets
39773+ tags:
39774+ - Cloud Cost Management
3943439775 /api/v2/cost/custom_costs:
3943539776 get:
3943639777 description: List the Custom Costs files.
0 commit comments