Azure Cost Management Cost Allocation Rule Definitions API

Manage rules that redistribute shared cost between scopes within a billing account.

Documentation GitHub OpenAPI

Business capability

Operations 4

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 /providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules List cost allocation rules for a billing account · Cost allocation rules list #

Ask an LLM

“What cost allocation rules exist on my billing account or enterprise enrollment?”

“How can I see every rule that splits shared costs across subscriptions?”

Tell an agent

List all cost allocation rules for billing account {billingAccountId}.

Show me the cost allocation rules defined on enrollment {billingAccountId}.

GET /providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName} Get a cost allocation rule by name · Cost allocation rules get #

Ask an LLM

“Which sources and targets does a specific cost allocation rule use?”

“Can I read one allocation rule's details by its name?”

Tell an agent

Get cost allocation rule {ruleName} on billing account {billingAccountId}.

Show me how allocation rule {ruleName} splits costs in {billingAccountId}.

PUT /providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName} Create or update a cost allocation rule · Cost allocation rules create or update #

Ask an LLM

“How do I reallocate shared platform costs from one subscription to several others?”

“Can I edit an existing cost allocation rule to change its targets?”

Tell an agent

Create cost allocation rule {ruleName} on billing account {billingAccountId} with {properties}.

Update allocation rule {ruleName} in {billingAccountId} so it uses {properties}.

DELETE /providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName} Delete a cost allocation rule · Cost allocation rules delete #

Ask an LLM

“How do I stop a cost allocation rule from redistributing costs?”

“Can I delete an allocation rule from my enterprise enrollment?”

Tell an agent destructive · confirm first

Delete cost allocation rule {ruleName} from billing account {billingAccountId}.

Remove allocation rule {ruleName} on {billingAccountId}.

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-costallocationruledefinitions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: CostManagementClient Cost Allocation Rule Definitions API
  version: '2026-06-01'
  description: CostManagement management client provides access to CostManagement 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: CostAllocationRuleDefinitions
paths:
  /providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules:
    get:
      operationId: CostAllocationRules_List
      tags:
      - CostAllocationRuleDefinitions
      description: Get the list of all cost allocation rules for a billing account or enterprise enrollment.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: billingAccountId
        in: path
        description: BillingAccount ID
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostAllocationRuleList'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        CostAllocationRulesList:
          $ref: ./examples/CostAllocationRulesList.json
      x-ms-pageable:
        nextLinkName: nextLink
      summary: Cost allocation rules list
      x-summary-source: derived
  ? /providers/microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/costAllocationRules/{ruleName}
  : get:
      operationId: CostAllocationRules_Get
      tags:
      - CostAllocationRuleDefinitions
      description: Get a cost allocation rule by rule name and billing account or enterprise enrollment.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: billingAccountId
        in: path
        description: BillingAccount ID
        required: true
        schema:
          type: string
      - name: ruleName
        in: path
        description: Cost allocation rule name. The name cannot include spaces or any non alphanumeric characters other than '_' and '-'. The max length is 260 characters.
        required: true
        schema:
          type: string
          pattern: '[A-Za-z0-9\-_]+'
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostAllocationRuleDefinition'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        CostAllocationRules:
          $ref: ./examples/CostAllocationRuleGet.json
      summary: Cost allocation rules get
      x-summary-source: derived
    put:
      operationId: CostAllocationRules_CreateOrUpdate
      tags:
      - CostAllocationRuleDefinitions
      description: Create/Update a rule to allocate cost between different resources within a billing account or enterprise enrollment.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: billingAccountId
        in: path
        description: BillingAccount ID
        required: true
        schema:
          type: string
      - name: ruleName
        in: path
        description: Cost allocation rule name. The name cannot include spaces or any non alphanumeric characters other than '_' and '-'. The max length is 260 characters.
        required: true
        schema:
          type: string
          pattern: '[A-Za-z0-9\-_]+'
      responses:
        '200':
          description: Resource 'CostAllocationRuleDefinition' update operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostAllocationRuleDefinition'
        '201':
          description: Resource 'CostAllocationRuleDefinition' create operation succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostAllocationRuleDefinition'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        CostAllocationRulesCreateResourceGroup:
          $ref: ./examples/CostAllocationRuleCreate.json
        CostAllocationRulesCreateTag:
          $ref: ./examples/CostAllocationRuleCreateTag.json
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CostAllocationRuleDefinition'
        description: Cost allocation rule to be created or updated
        required: true
      summary: Cost allocation rules create or update
      x-summary-source: derived
    delete:
      operationId: CostAllocationRules_Delete
      tags:
      - CostAllocationRuleDefinitions
      description: Delete cost allocation rule for billing account or enterprise enrollment.
      parameters:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/parameters/ApiVersionParameter
      - name: billingAccountId
        in: path
        description: BillingAccount ID
        required: true
        schema:
          type: string
      - name: ruleName
        in: path
        description: Cost allocation rule name. The name cannot include spaces or any non alphanumeric characters other than '_' and '-'. The max length is 260 characters.
        required: true
        schema:
          type: string
          pattern: '[A-Za-z0-9\-_]+'
      responses:
        '200':
          description: Resource deleted successfully.
        '204':
          description: Resource does not exist.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        DeleteCostAllocationRule:
          $ref: ./examples/CostAllocationRuleDelete.json
      summary: Cost allocation rules delete
      x-summary-source: derived
components:
  schemas:
    CostAllocationResourceType:
      type: string
      description: Category of resource to use for allocation.
      enum:
      - Dimension
      - Tag
      x-ms-enum:
        name: CostAllocationResourceType
        modelAsString: true
        values:
        - name: Dimension
          value: Dimension
          description: Indicates an Azure dimension such as a subscription id or resource group name is being used for allocation.
        - name: Tag
          value: Tag
          description: Allocates cost based on Azure Tag key value pairs.
    CostAllocationRuleProperties:
      type: object
      description: The properties of a cost allocation rule
      properties:
        description:
          type: string
          description: Description of a cost allocation rule.
        details:
          $ref: '#/components/schemas/CostAllocationRuleDetails'
          description: Resource information for the cost allocation rule
        status:
          $ref: '#/components/schemas/RuleStatus'
          description: Status of the rule
        createdDate:
          type: string
          format: date-time
          description: Time at which the rule was created. Rules that change cost for the same resource are applied in order of creation.
          readOnly: true
        updatedDate:
          type: string
          format: date-time
          description: Time at which the rule was last updated.
          readOnly: true
      required:
      - details
      - status
    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
    CostAllocationRuleList:
      type: object
      description: Result of listing cost allocation rules. It contains a list of available rules in the billing account or enterprise enrollment provided.
      properties:
        value:
          type: array
          description: The list of cost allocation rules.
          items:
            $ref: '#/components/schemas/CostAllocationRuleDefinition'
          x-ms-identifiers:
          - id
        nextLink:
          type: string
          description: URL to get the next set of rule list results if there are any.
    TargetCostAllocationResource:
      type: object
      description: Target resources for cost allocation.
      properties:
        values:
          type: array
          description: Target resources for cost allocation. This list cannot contain more than 25 values.
          items:
            $ref: '#/components/schemas/CostAllocationProportion'
          x-ms-identifiers:
          - name
        policyType:
          $ref: '#/components/schemas/CostAllocationPolicyType'
          description: Method of cost allocation for the rule
      required:
      - values
      - policyType
      allOf:
      - $ref: '#/components/schemas/CostAllocationResource'
    CostAllocationPolicyType:
      type: string
      description: Method to use for allocating cost. FixedProportion indicates that cost will be split based on specified percentage values.
      enum:
      - FixedProportion
      x-ms-enum:
        name: CostAllocationPolicyType
        modelAsString: true
        values:
        - name: FixedProportion
          value: FixedProportion
    ErrorResponse:
      type: object
      description: 'Error response indicates that the service is not able to process the incoming request. The reason is provided in the error message. \n\nSome Error responses: \n\n * 429 TooManyRequests - Request is throttled. Retry after waiting for the time specified in the \"x-ms-ratelimit-microsoft.consumption-retry-after\" header. \n\n * 503 ServiceUnavailable - Service is temporarily unavailable. Retry after waiting for the time specified in the \"Retry-After\" header.'
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetails'
          description: The details of the error.
    CostAllocationProportion:
      type: object
      description: Target resources and allocation
      properties:
        name:
          type: string
          description: Target resource for cost allocation
        percentage:
          type: number
          format: float
          description: Percentage of source cost to allocate to this resource. This value can be specified to two decimal places and the total percentage of all resources in this rule must sum to 100.00.
      required:
      - name
      - percentage
    CostAllocationRuleDetails:
      type: object
      description: Resource details of the cost allocation rule
      properties:
        sourceResources:
          type: array
          description: Source resources for cost allocation. At this time, this list can contain no more than one element.
          items:
            $ref: '#/components/schemas/SourceCostAllocationResource'
          x-ms-identifiers:
          - name
        targetResources:
          type: array
          description: Target resources for cost allocation. At this time, this list can contain no more than one element.
          items:
            $ref: '#/components/schemas/TargetCostAllocationResource'
          x-ms-identifiers:
          - name
    RuleStatus:
      type: string
      description: Current status of the rule.
      enum:
      - NotActive
      - Active
      - Processing
      x-ms-enum:
        name: RuleStatus
        modelAsString: true
        values:
        - name: NotActive
          value: NotActive
          description: Rule is saved but not used to allocate costs.
        - name: Active
          value: Active
          description: Rule is saved and impacting cost allocation.
        - name: Processing
          value: Processing
          description: Rule is saved and cost allocation is being updated. Readonly value that cannot be submitted in a put request.
    CostAllocationRuleDefinition:
      type: object
      description: The cost allocation rule model definition
      properties:
        properties:
          $ref: '#/components/schemas/CostAllocationRuleProperties'
          description: Cost allocation rule properties
      allOf:
      - $ref: ../../../../../../common-types/resource-management/v5/types.json#/definitions/ProxyResource
    CostAllocationResource:
      type: object
      description: Common values for resources for cost allocation
      properties:
        resourceType:
          $ref: '#/components/schemas/CostAllocationResourceType'
          description: Type of resources contained in this cost allocation rule
        name:
          type: string
          description: If resource type is dimension, this must be either ResourceGroupName or SubscriptionId. If resource type is tag, this must be a valid Azure tag
      required:
      - resourceType
      - name
    SourceCostAllocationResource:
      type: object
      description: Source resources for cost allocation
      properties:
        values:
          type: array
          description: Source Resources for cost allocation. This list cannot contain more than 25 values.
          items:
            type: string
      required:
      - values
      allOf:
      - $ref: '#/components/schemas/CostAllocationResource'
  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.

Azure Cost Management Cost Allocation Rule Definitions API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification