@@ -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,195 @@ 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: object
4707+ BudgetDataAttributes:
4708+ description: The definition of `BudgetDataAttributes` object.
4709+ properties:
4710+ created_at:
4711+ description: The `attributes` `created_at`.
4712+ format: int64
4713+ type: integer
4714+ created_by:
4715+ description: The `attributes` `created_by`.
4716+ type: string
4717+ end_month:
4718+ description: The `attributes` `end_month`.
4719+ format: int64
4720+ type: integer
4721+ metrics_query:
4722+ description: The `attributes` `metrics_query`.
4723+ type: string
4724+ name:
4725+ description: The `attributes` `name`.
4726+ type: string
4727+ org_id:
4728+ description: The `attributes` `org_id`.
4729+ format: int64
4730+ type: integer
4731+ start_month:
4732+ description: The `attributes` `start_month`.
4733+ format: int64
4734+ type: integer
4735+ tags:
4736+ description: The `attributes` `tags`.
4737+ items:
4738+ type: string
4739+ type: array
4740+ total_amount:
4741+ description: The `attributes` `total_amount`.
4742+ format: double
4743+ type: number
4744+ updated_at:
4745+ description: The `attributes` `updated_at`.
4746+ format: int64
4747+ type: integer
4748+ updated_by:
4749+ description: The `attributes` `updated_by`.
4750+ type: string
4751+ type: object
4752+ BudgetEntry:
4753+ description: The entry of a budget.
4754+ properties:
4755+ amount:
4756+ description: The `amount` of the budget entry.
4757+ format: double
4758+ type: number
4759+ month:
4760+ description: The `month` of the budget entry.
4761+ format: int64
4762+ type: integer
4763+ tag_filters:
4764+ description: The `tag_filters` of the budget entry.
4765+ items:
4766+ type: string
4767+ type: array
4768+ type: object
4769+ BudgetWithEntries:
4770+ description: The definition of `BudgetWithEntries` object.
4771+ example:
4772+ data:
4773+ attributes:
4774+ created_at: 1738258683590
4775+ created_by: 00000000-0a0a-0a0a-aaa0-00000000000a
4776+ end_month: 202502
4777+ entries:
4778+ - amount: 500
4779+ month: 202501
4780+ tag_filters:
4781+ - tag_key: service
4782+ tag_value: ec2
4783+ - amount: 500
4784+ month: 202502
4785+ tag_filters:
4786+ - tag_key: service
4787+ tag_value: ec2
4788+ metrics_query: aws.cost.amortized{service:ec2} by {service}
4789+ name: my budget
4790+ org_id: 123
4791+ start_month: 202501
4792+ tags:
4793+ - service
4794+ total_amount: 1000
4795+ updated_at: 1738258683590
4796+ updated_by: 00000000-0a0a-0a0a-aaa0-00000000000a
4797+ id: '1'
4798+ type: budget
4799+ properties:
4800+ data:
4801+ $ref: '#/components/schemas/BudgetWithEntriesData'
4802+ type: object
4803+ BudgetWithEntriesData:
4804+ description: The definition of `BudgetWithEntriesData` object.
4805+ properties:
4806+ attributes:
4807+ $ref: '#/components/schemas/BudgetWithEntriesDataAttributes'
4808+ id:
4809+ description: The `BudgetWithEntriesData` `id`.
4810+ type: string
4811+ type: object
4812+ BudgetWithEntriesDataAttributes:
4813+ description: The definition of `BudgetWithEntriesDataAttributes` object.
4814+ properties:
4815+ created_at:
4816+ description: The `attributes` `created_at`.
4817+ format: int64
4818+ type: integer
4819+ created_by:
4820+ description: The `attributes` `created_by`.
4821+ type: string
4822+ end_month:
4823+ description: The `attributes` `end_month`.
4824+ format: int64
4825+ type: integer
4826+ entries:
4827+ description: The `attributes` `entries`.
4828+ items:
4829+ $ref: '#/components/schemas/BudgetEntry'
4830+ type: array
4831+ metrics_query:
4832+ description: The `attributes` `metrics_query`.
4833+ type: string
4834+ name:
4835+ description: The `attributes` `name`.
4836+ type: string
4837+ org_id:
4838+ description: The `attributes` `org_id`.
4839+ format: int64
4840+ type: integer
4841+ start_month:
4842+ description: The `attributes` `start_month`.
4843+ format: int64
4844+ type: integer
4845+ tags:
4846+ description: The `attributes` `tags`.
4847+ items:
4848+ type: string
4849+ type: array
4850+ total_amount:
4851+ description: The `attributes` `total_amount`.
4852+ format: double
4853+ type: number
4854+ updated_at:
4855+ description: The `attributes` `updated_at`.
4856+ format: int64
4857+ type: integer
4858+ updated_by:
4859+ description: The `attributes` `updated_by`.
4860+ type: string
4861+ type: object
46664862 BulkMuteFindingsRequest:
46674863 description: The new bulk mute finding request.
46684864 properties:
@@ -39431,6 +39627,105 @@ paths:
3943139627 operator: OR
3943239628 permissions:
3943339629 - cloud_cost_management_write
39630+ /api/v2/cost/budget:
39631+ put:
39632+ description: Create a new budget or update an existing one.
39633+ operationId: UpsertBudget
39634+ requestBody:
39635+ content:
39636+ application/json:
39637+ schema:
39638+ $ref: '#/components/schemas/BudgetWithEntries'
39639+ required: true
39640+ responses:
39641+ '200':
39642+ content:
39643+ application/json:
39644+ schema:
39645+ $ref: '#/components/schemas/BudgetWithEntries'
39646+ description: OK
39647+ '400':
39648+ description: Bad Request
39649+ '404':
39650+ description: Not Found
39651+ '429':
39652+ $ref: '#/components/responses/TooManyRequestsResponse'
39653+ security:
39654+ - apiKeyAuth: []
39655+ appKeyAuth: []
39656+ - AuthZ:
39657+ - cloud_cost_management_write
39658+ summary: Update if exists, or create a new budget
39659+ tags:
39660+ - Cloud Cost Management
39661+ /api/v2/cost/budget/{budget_id}:
39662+ delete:
39663+ description: Delete a budget.
39664+ operationId: DeleteBudget
39665+ parameters:
39666+ - $ref: '#/components/parameters/BudgetID'
39667+ responses:
39668+ '204':
39669+ description: No Content
39670+ '400':
39671+ description: Bad Request
39672+ '429':
39673+ $ref: '#/components/responses/TooManyRequestsResponse'
39674+ security:
39675+ - apiKeyAuth: []
39676+ appKeyAuth: []
39677+ - AuthZ:
39678+ - cloud_cost_management_write
39679+ summary: Delete a budget
39680+ tags:
39681+ - Cloud Cost Management
39682+ get:
39683+ description: Get a budget.
39684+ operationId: GetBudget
39685+ parameters:
39686+ - $ref: '#/components/parameters/BudgetID'
39687+ responses:
39688+ '200':
39689+ content:
39690+ application/json:
39691+ schema:
39692+ $ref: '#/components/schemas/BudgetWithEntries'
39693+ description: OK
39694+ '400':
39695+ description: Bad Request
39696+ '404':
39697+ description: Not Found
39698+ '429':
39699+ $ref: '#/components/responses/TooManyRequestsResponse'
39700+ security:
39701+ - apiKeyAuth: []
39702+ appKeyAuth: []
39703+ - AuthZ:
39704+ - cloud_cost_management_read
39705+ summary: Get a budget
39706+ tags:
39707+ - Cloud Cost Management
39708+ /api/v2/cost/budgets:
39709+ get:
39710+ description: List budgets.
39711+ operationId: ListBudgets
39712+ responses:
39713+ '200':
39714+ content:
39715+ application/json:
39716+ schema:
39717+ $ref: '#/components/schemas/BudgetArray'
39718+ description: OK
39719+ '429':
39720+ $ref: '#/components/responses/TooManyRequestsResponse'
39721+ security:
39722+ - apiKeyAuth: []
39723+ appKeyAuth: []
39724+ - AuthZ:
39725+ - cloud_cost_management_read
39726+ summary: List budgets
39727+ tags:
39728+ - Cloud Cost Management
3943439729 /api/v2/cost/custom_costs:
3943539730 get:
3943639731 description: List the Custom Costs files.
0 commit comments