Azure Cost Management Budgets API

The Budgets API from Azure Cost Management — 4 operation(s) for budgets.

GitHub OpenAPI
Business capability
IT Financial Management BC-600.80

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /{scope}/providers/Microsoft.Consumption/budgets Budgets list #
GET /{scope}/providers/Microsoft.Consumption/budgets/{budgetName} Budgets get #
PUT /{scope}/providers/Microsoft.Consumption/budgets/{budgetName} Budgets create or update #
DELETE /{scope}/providers/Microsoft.Consumption/budgets/{budgetName} Budgets delete #
GET /{scope}/providers/Microsoft.CostManagement/budgets List budgets for a scope · Budgets list #
Ask an LLM
“What budgets are set up on my Azure subscription?”
“Can I filter the budgets at a scope, for example by category?”
Tell an agent
List all budgets at scope {scope}.
List the budgets at {scope} matching filter {filter}.
GET /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName} Get a budget by name · Budgets get #
Ask an LLM
“How much is left in a particular budget and what are its thresholds?”
“Can I read one budget's amount, time period and notifications by name?”
Tell an agent
Get budget {budgetName} at scope {scope}.
Show me the current spend and notification settings of budget {budgetName} in {scope}.
PUT /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName} Create or update a budget · Budgets create or update #
Ask an LLM
“How do I set a monthly spending budget with alert thresholds on a subscription?”
“Can I change an existing budget's amount, and do I need its eTag to do it safely?”
Tell an agent
Create budget {budgetName} at scope {scope} with these settings: {properties}.
Update budget {budgetName} in {scope} to {properties} using eTag {eTag}.
DELETE /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName} Delete a budget · Budgets delete #
Ask an LLM
“How do I remove a budget I no longer need?”
“Can I delete a budget from a resource group without affecting the others?”
Tell an agent destructive · confirm first
Delete budget {budgetName} at scope {scope}.
Remove the {budgetName} budget from {scope}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-azure-cost-management:microsoft-azure-cost-management-budgets-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-azure-cost-management-budgets-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ConsumptionManagementClient Budgets API
  version: '2026-06-01'
  description: Consumption management client provides access to consumption resources for Azure Enterprise Subscriptions.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Budgets
paths:
  /{scope}/providers/Microsoft.Consumption/budgets:
    get:
      operationId: Budgets_List
      tags:
      - Budgets
      description: Lists all budgets for the defined scope.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/consumption/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BudgetsListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Budgets list
      x-summary-source: derived
  /{scope}/providers/Microsoft.Consumption/budgets/{budgetName}:
    get:
      operationId: Budgets_Get
      tags:
      - Budgets
      description: Gets the budget for the scope by budget name.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/consumption/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: budgetName
        in: path
        description: Budget Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Budget'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Budgets get
      x-summary-source: derived
    put:
      operationId: Budgets_CreateOrUpdate
      tags:
      - Budgets
      description: The operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/consumption/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: budgetName
        in: path
        description: Budget Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource 'Budget' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Budget'
        '201':
          description: Resource 'Budget' create operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Budget'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Budget'
        description: Parameters supplied to the Create Budget operation.
        required: true
      summary: Budgets create or update
      x-summary-source: derived
    delete:
      operationId: Budgets_Delete
      tags:
      - Budgets
      description: The operation to delete a budget.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/consumption/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: budgetName
        in: path
        description: Budget Name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Resource deleted successfully.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Budgets delete
      x-summary-source: derived
  /{scope}/providers/Microsoft.CostManagement/budgets:
    get:
      operationId: Budgets_List
      tags:
      - Budgets
      description: Lists all budgets for the defined scope.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/CostManagement/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: $filter
        in: query
        description: OData filter option. May be used to filter budgets by properties/category. The filter supports 'eq' only.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BudgetsListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Budgets list
      x-summary-source: derived
  /{scope}/providers/Microsoft.CostManagement/budgets/{budgetName}:
    get:
      operationId: Budgets_Get
      tags:
      - Budgets
      description: Gets the budget for the scope by budget name.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/CostManagement/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: budgetName
        in: path
        description: Budget Name.
        required: true
        schema:
          type: string
          maxLength: 63
          minLength: 1
          pattern: ^[a-zA-Z0-9_-]+$
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Budget'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Budgets get
      x-summary-source: derived
    put:
      operationId: Budgets_CreateOrUpdate
      tags:
      - Budgets
      description: The operation to create or update a budget. You can optionally provide an eTag if desired as a form of concurrency control. To obtain the latest eTag for a given budget, perform a get operation prior to your put operation.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/CostManagement/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: budgetName
        in: path
        description: Budget Name.
        required: true
        schema:
          type: string
          maxLength: 63
          minLength: 1
          pattern: ^[a-zA-Z0-9_-]+$
      responses:
        '200':
          description: Resource 'Budget' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Budget'
        '201':
          description: Resource 'Budget' create operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Budget'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Budget'
        description: Parameters supplied to the Create Budget operation.
        required: true
      summary: Budgets create or update
      x-summary-source: derived
    delete:
      operationId: Budgets_Delete
      tags:
      - Budgets
      description: The operation to delete a budget.
      externalDocs:
        url: https://docs.microsoft.com/en-us/rest/api/CostManagement/
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: scope
        in: path
        description: The fully qualified Azure Resource manager identifier of the resource.
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      - name: budgetName
        in: path
        description: Budget Name.
        required: true
        schema:
          type: string
          maxLength: 63
          minLength: 1
          pattern: ^[a-zA-Z0-9_-]+$
      responses:
        '200':
          description: Resource deleted successfully.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Budgets delete
      x-summary-source: derived
components:
  schemas:
    OperatorType:
      type: string
      description: The comparison operator.
      enum:
      - EqualTo
      - GreaterThan
      - GreaterThanOrEqualTo
      x-ms-enum:
        name: OperatorType
        modelAsString: true
        values:
        - name: EqualTo
          value: EqualTo
          description: 'Alert will be triggered if the evaluated cost is the same as threshold value. Note: It’s not recommended to use this OperatorType as there’s low chance of cost being exactly the same as threshold value, leading to missing of your alert. This OperatorType will be deprecated in future.'
        - name: GreaterThan
          value: GreaterThan
          description: 'Alert will be triggered if the evaluated cost is greater than the threshold value. Note: This is the recommended OperatorType while configuring Budget Alert.'
        - name: GreaterThanOrEqualTo
          value: GreaterThanOrEqualTo
          description: Alert will be triggered if the evaluated cost is greater than or equal to the threshold value.
    BudgetFilter:
      type: object
      description: May be used to filter budgets by resource group, resource, or meter.
      properties:
        and:
          type: array
          description: The logical "AND" expression. Must have at least 2 items.
          minItems: 0
          items:
            $ref: '#/components/schemas/BudgetFilterProperties'
          x-ms-identifiers: []
        dimensions:
          $ref: '#/components/schemas/BudgetComparisonExpression'
          description: Has comparison expression for a dimension
        tags:
          $ref: '#/components/schemas/BudgetComparisonExpression'
          description: Has comparison expression for a tag
    ForecastSpend:
      type: object
      description: The forecasted cost which is being tracked for a budget.
      properties:
        amount:
          type: number
          format: decimal
          description: The forecasted cost for the total time period which is being tracked by the budget. This value is only provided if the budget contains a forecast alert type.
          readOnly: true
        unit:
          type: string
          description: The unit of measure for the budget amount.
          readOnly: true
    TimeGrainType:
      type: string
      description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. BillingMonth, BillingQuarter, and BillingAnnual are only supported by WD customers
      enum:
      - Monthly
      - Quarterly
      - Annually
      - BillingMonth
      - BillingQuarter
      - BillingAnnual
      x-ms-enum:
        name: TimeGrainType
        modelAsString: true
        values:
        - name: Monthly
          value: Monthly
        - name: Quarterly
          value: Quarterly
        - name: Annually
          value: Annually
        - name: BillingMonth
          value: BillingMonth
        - name: BillingQuarter
          value: BillingQuarter
        - name: BillingAnnual
          value: BillingAnnual
    CultureCode:
      type: string
      description: Language in which the recipient will receive the notification
      enum:
      - en-us
      - ja-jp
      - zh-cn
      - de-de
      - es-es
      - fr-fr
      - it-it
      - ko-kr
      - pt-br
      - ru-ru
      - zh-tw
      - cs-cz
      - pl-pl
      - tr-tr
      - da-dk
      - en-gb
      - hu-hu
      - nb-no
      - nl-nl
      - pt-pt
      - sv-se
      x-ms-enum:
        name: CultureCode
        modelAsString: true
        values:
        - name: en-us
          value: en-us
        - name: ja-jp
          value: ja-jp
        - name: zh-cn
          value: zh-cn
        - name: de-de
          value: de-de
        - name: es-es
          value: es-es
        - name: fr-fr
          value: fr-fr
        - name: it-it
          value: it-it
        - name: ko-kr
          value: ko-kr
        - name: pt-br
          value: pt-br
        - name: ru-ru
          value: ru-ru
        - name: zh-tw
          value: zh-tw
        - name: cs-cz
          value: cs-cz
        - name: pl-pl
          value: pl-pl
        - name: tr-tr
          value: tr-tr
        - name: da-dk
          value: da-dk
        - name: en-gb
          value: en-gb
        - name: hu-hu
          value: hu-hu
        - name: nb-no
          value: nb-no
        - name: nl-nl
          value: nl-nl
        - name: pt-pt
          value: pt-pt
        - name: sv-se
          value: sv-se
    BudgetComparisonExpression:
      type: object
      description: The comparison expression to be used in the budgets.
      properties:
        name:
          type: string
          description: The name of the column to use in comparison.
        operator:
          $ref: '#/components/schemas/BudgetOperatorType'
          description: The operator to use for comparison.
        values:
          type: array
          description: Array of values to use for comparison
          minItems: 0
          items:
            type: string
      required:
      - name
      - operator
      - values
    CurrentSpend:
      type: object
      description: The current amount of cost which is being tracked for a budget.
      properties:
        amount:
          type: number
          format: decimal
          description: The total amount of cost which is being tracked by the budget.
          readOnly: true
        unit:
          type: string
          description: The unit of measure for the budget amount.
          readOnly: true
    BudgetsListResult:
      type: object
      description: Result of listing budgets. It contains a list of available budgets in the scope provided.
      properties:
        value:
          type: array
          description: The list of budgets.
          items:
            $ref: '#/components/schemas/Budget'
          readOnly: true
        nextLink:
          type: string
          description: The link (url) to the next page of results.
          readOnly: true
    systemData:
      type: object
      description: Metadata pertaining to creation and last modification of the resource.
      properties:
        createdBy:
          type: string
          description: The identity that created the resource.
        createdByType:
          type: string
          description: The type of identity that created the resource.
          enum:
          - User
          - Application
          - ManagedIdentity
          - Key
          x-ms-enum:
            name: createdByType
            modelAsString: true
        createdAt:
          type: string
          format: date-time
          description: The timestamp of resource creation (UTC).
        lastModifiedBy:
          type: string
          description: The identity that last modified the resource.
        lastModifiedByType:
          type: string
          description: The type of identity that last modified the resource.
          enum:
          - User
          - Application
          - ManagedIdentity
          - Key
          x-ms-enum:
            name: createdByType
            modelAsString: true
        lastModifiedAt:
          type: string
          format: date-time
          description: The timestamp of resource last modification (UTC)
      readOnly: true
    ProxyResource:
      type: object
      title: Proxy Resource
      description: The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
      allOf:
      - $ref: '#/components/schemas/Resource'
    ErrorResponse:
      type: object
      title: Error response
      description: Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: The error object.
    BudgetTimePeriod:
      type: object
      description: The start and end date for a budget.
      properties:
        startDate:
          type: string
          format: date-time
          description: The start date for the budget.
        endDate:
          type: string
          format: date-time
          description: The end date for the budget. If not provided, we default this to 10 years from the start date.
      required:
      - startDate
    CategoryType:
      type: string
      description: The category of the budget, whether the budget tracks cost or usage.
      enum:
      - Cost
      x-ms-enum:
        name: CategoryType
        modelAsString: true
        values:
        - name: Cost
          value: Cost
    BudgetFilterProperties:
      type: object
      description: The Dimensions or Tags to filter a budget by.
      properties:
        dimensions:
          $ref: '#/components/schemas/BudgetComparisonExpression'
          description: Has comparison expression for a dimension
        tags:
          $ref: '#/components/schemas/BudgetComparisonExpression'
          description: Has comparison expression for a tag
    Notification:
      type: object
      description: The notification associated with a budget.
      properties:
        enabled:
          type: boolean
          description: The notification is enabled or not.
        operator:
          $ref: '#/components/schemas/OperatorType'
          description: The comparison operator.
        threshold:
          type: number
          format: decimal
          description: Threshold value associated with a notification. Notification is sent when the cost exceeded the threshold. It is always percent and has to be between 0 and 1000.
        contactEmails:
          type: array
          description: Email addresses to send the budget notification to when the threshold is exceeded. Must have at least one contact email or contact group specified at the Subscription or Resource Group scopes. All other scopes must have at least one contact email specified.
          minItems: 0
          maxItems: 50
          items:
            type: string
        contactRoles:
          type: array
          description: Contact roles to send the budget notification to when the threshold is exceeded.
          items:
            type: string
        contactGroups:
          type: array
          description: Action groups to send the budget notification to when the threshold is exceeded. Must be provided as a fully qualified Azure resource id. Only supported at Subscription or Resource Group scopes.
          minItems: 0
          maxItems: 50
          items:
            type: string
        thresholdType:
          type: string
          description: The type of threshold
          default: Actual
          enum:
          - Actual
          - Forecasted
          x-ms-enum:
            name: ThresholdType
            modelAsString: true
            values:
            - name: Actual
              value: Actual
              description: Actual costs budget alerts notify when the actual accrued cost exceeds the allocated budget .
            - name: Forecasted
              value: Forecasted
              description: Forecasted costs budget alerts provide advanced notification that your spending trends are likely to exceed your allocated budget, as it relies on forecasted cost predictions.
        locale:
          $ref: '#/components/schemas/CultureCode'
          description: Language in which the recipient will receive the notification
      required:
      - enabled
      - operator
      - threshold
      - contactEmails
    BudgetProperties:
      type: object
      description: The properties of the budget.
      properties:
        category:
          $ref: '#/components/schemas/CategoryType'
          description: The category of the budget, whether the budget tracks cost or usage.
        amount:
          type: number
          format: decimal
          description: The total amount of cost to track with the budget
        timeGrain:
          $ref: '#/components/schemas/TimeGrainType'
          description: The time covered by a budget. Tracking of the amount will be reset based on the time grain. BillingMonth, BillingQuarter, and BillingAnnual are only supported by WD customers
        timePeriod:
          $ref: '#/components/schemas/BudgetTimePeriod'
          description: Has start and end date of the budget. The start date must be first of the month and should be less than the end date. Budget start date must be on or after June 1, 2017. Future start date should not be more than twelve months. Past start date should  be selected within the timegrain period. There are no restrictions on the end date.
        filter:
          $ref: '#/components/schemas/BudgetFilter'
          description: May be used to filter budgets by user-specified dimensions and/or tags.
        currentSpend:
          $ref: '#/components/schemas/CurrentSpend'
          description: The current amount of cost which is being tracked for a budget.
          readOnly: true
        notifications:
          type: object
          description: Dictionary of notifications associated with the budget. Budget can have up to five notifications.
          additionalProperties:
            $ref: '#/components/schemas/Notification'
        forecastSpend:
          $ref: '#/components/schemas/ForecastSpend'
          description: The forecasted cost which is being tracked for a budget.
          readOnly: true
      required:
      - category
      - amount
      - timeGrain
      - timePeriod
    BudgetOperatorType:
      type: string
      description: The operator to use for comparison.
      enum:
      - In
      x-ms-enum:
        name: BudgetOperatorType
        modelAsString: true
        values:
        - name: In
          value: In
    Resource:
      type: object
      title: Resource
      description: Common fields that are returned in the response for all Azure Resource Manager resources
      properties:
        id:
          type: string
          description: Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
          readOnly: true
        name:
          type: string
          description: The name of the resource
          readOnly: true
        type:
          type: string
          description: The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"
          readOnly: true
        systemData:
          $ref: '#/components/schemas/systemData'
          type: object
          description: Azure Resource Manager metadata containing createdBy and modifiedBy information.
          readOnly: true
      x-ms-azure-resource: true
    Budget:
      type: object
      description: A budget resource.
      properties:
        properties:
          $ref: '#/components/schemas/BudgetProperties'
          description: The properties of the budget.
          x-ms-client-flatten: true
        eTag:
          type: string
          description: eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.
      allOf:
      - $ref: '#/components/schemas/ProxyResource'
    Azure.Core.eTag:
      type: string
      description: 'The ETag (or entity tag) HTTP response header is an identifier for a specific version of a resource.

        It lets caches be more efficient and save bandwidth, as a web server does not need to resend a full response if the content was not changed.


        It is a string of ASCII characters placed between double quotes, like "675af34563dc-tr34".'
    Frequency:
      type: string
      description: 'Frequency of a notification. Represents how long the notification will be silent after triggering an alert for a threshold breach. If not specified, the frequency will be set by default based on the timeGrain (Weekly when timeGrain: Last7Days, Monthly when timeGrain: Last30Days).


        Supported for CategoryType(s): ReservationUtilization.'
      enum:
      - Daily
      - Weekly
      - Monthly
      x-ms-enum:
        name: Frequency
        modelAsString: true
        values:
        - name: Daily
          value: Daily
          description: After the threshold breaches and an Alert is fired, no further alerts will be sent until the next calendar day.
        - name: Weekly
          value: Weekly
          description: After the threshold breaches and an Alert is fired, no further alerts will be sent for 7 calendar days.
        - name: Monthly
          value: Monthly
          description: After the threshold breaches and an Alert is fired, no further alerts will be sent for 30 calendar days.
    ErrorDetails:
      type: object
      description: The details of the error.
      properties:
        code:
          type: string
          description: Error code.
          readOnly: true
        message:
          type: string
          description: Error message indicating why the operation failed.
          readOnly: true
    BudgetNotificationOperatorType:
      type: string
      description: 'The comparison operator.


        Supported for CategoryType(s): Cost, ReservationUtilization.


        Supported operators for **CategoryType: Cost**

        - GreaterThan

        - GreaterThanOrEqualTo


        Supported operators for **CategoryType: ReservationUtilization**

        - LessThan'
      enum:
      - EqualTo
      - GreaterThan
      - GreaterThanOrEqualTo
      - LessThan
      x-ms-enum:
        name: BudgetNotificationOperatorType
        modelAsString: true
        values:
        - name: EqualTo
          value: EqualTo
          description: 'Notification will be triggered if the evaluated cost is the same as threshold value. Note: It’s not recommended to use this OperatorType as there’s low chance of cost being exactly the same as threshold value, leading to missing of your alert. This OperatorType will be deprecated in future.


            Supported for CategoryType(s): Cost.'
        - name: GreaterThan
          value: GreaterThan
          description: 'Notification will be triggered if the evaluated cost is greater than the threshold value. Note: This is the recommended OperatorType while configuring Budget Alert.


            Supported for CategoryType(s): Cost.'
        - name: GreaterThanOrEqualTo
          value: GreaterThanOrEqualTo
          description: 'Notification will be triggered if the evaluated cost is greater than or equal to the threshold value.


            Supported for CategoryType(s): Cost.'
        - name: LessThan
          value: LessThan
          description: 'Notification will be triggered if any Reservations in the scope of the Reservation Utilization Alert Rule have a utilization less than the threshold percentage.


            Supported for CategoryType(s): ReservationUtilization.'
  parameters:
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.