API Evangelist enhancements — Azure Cost Management budgets

overlay: 1.0.0
info:
  title: API Evangelist enhancements — Azure Cost Management budgets
  version: 1.0.0
  x-generated: '2026-09-17'
  x-method: generated
  x-source: openapi/microsoft-azure-cost-management-budgets-api-openapi.yml (derived from openapi/_original/microsoft-azure-cost-management-openapi.json)
  x-note: Annotations authored by API Evangelist, not by Microsoft. Applying this overlay never changes
    the provider contract; it adds the retry, reversibility and read-only facts an agent needs and the
    Swagger 2.0 source cannot carry.
extends: openapi/microsoft-azure-cost-management-budgets-api-openapi.yml
actions:
- target: $.info
  description: Record that this document was refined by API Evangelist from the provider-published contract,
    and point at the artifacts that carry the runtime semantics the contract leaves out.
  update:
    x-api-evangelist-source: openapi/_original/microsoft-azure-cost-management-openapi.json
    x-api-evangelist-source-upstream: https://github.com/Azure/azure-rest-api-specs/tree/main/specification/cost-management/resource-manager/Microsoft.CostManagement/CostManagement/stable/2026-06-01/openapi.json
    x-api-evangelist-conventions: conventions/microsoft-azure-cost-management-conventions.yml
    x-api-evangelist-errors: errors/microsoft-azure-cost-management-problem-types.yml
    x-api-evangelist-rate-limits: rate-limits/microsoft-azure-cost-management-rate-limits.yml
- target: $
  description: Attach the documentation surface the provider publishes for this resource group.
  update:
    externalDocs:
      description: Azure Cost Management REST API reference
      url: https://learn.microsoft.com/en-us/rest/api/cost-management/
- target: $.paths['/{scope}/providers/Microsoft.CostManagement/budgets'].get
  description: Runtime semantics for Budgets_List that the provider contract does not express.
  update:
    x-api-evangelist-read-only: true
- target: $.paths['/{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}'].get
  description: Runtime semantics for Budgets_Get that the provider contract does not express.
  update:
    x-api-evangelist-read-only: true
- target: $.paths['/{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}'].put
  description: Runtime semantics for Budgets_CreateOrUpdate that the provider contract does not express.
  update:
    x-api-evangelist-idempotency:
      safe_to_retry: true
      mechanism: http-put-to-client-chosen-name
      key_header: null
    x-api-evangelist-reversibility:
      reversal_operation: Budgets_Delete
      window: null
      window_documented: false
- target: $.paths['/{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}'].delete
  description: Runtime semantics for Budgets_Delete that the provider contract does not express.
  update:
    x-api-evangelist-reversibility:
      reversal_operation: null
      window: null
      note: No restore, undelete or retention window is documented.