Azure Machine Learning Subscriptions API

The Subscriptions API from Azure Machine Learning — 4 operation(s) for subscriptions.

GitHub OpenAPI

Operations 4

GET /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/quotas Quotas list #
POST /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/updateQuotas Quotas update #
GET /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/usages Usages list #
GET /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/vmSizes Virtual machine sizes list #

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-machine-learning:microsoft-azure-machine-learning-subscriptions-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-machine-learning-subscriptions-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Azure Machine Learning Services Subscriptions API
  version: '2026-09-01'
  description: These APIs allow end users to operate on Azure Machine Learning Workspace resources.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Subscriptions
paths:
  /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/quotas:
    get:
      operationId: Quotas_List
      description: Gets the currently assigned Workspace Quotas based on VMFamily.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/CustomLocationParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWorkspaceQuotas'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
      summary: Quotas list
      x-summary-source: derived
  /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/updateQuotas:
    post:
      operationId: Quotas_Update
      description: Update quota for each VM family in workspace.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/CustomLocationParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdateWorkspaceQuotasResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QuotaUpdateParameters'
        description: The request body
        required: true
      tags:
      - Subscriptions
      summary: Quotas update
      x-summary-source: derived
  /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/usages:
    get:
      operationId: Usages_List
      description: Gets the current usage information as well as limits for AML resources for given subscription and location.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/CustomLocationParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUsagesResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Subscriptions
      summary: Usages list
      x-summary-source: derived
  /subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/vmSizes:
    get:
      operationId: VirtualMachineSizes_List
      description: Returns supported VM Sizes in a location
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/CustomLocationParameter'
      responses:
        '200':
          description: The request has succeeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VirtualMachineSizeListResult'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      tags:
      - Subscriptions
      summary: Virtual machine sizes list
      x-summary-source: derived
components:
  schemas:
    UsageUnit:
      type: string
      description: An enum describing the unit of usage measurement.
      enum:
      - Count
      x-ms-enum:
        name: UsageUnit
        modelAsString: true
        values:
        - name: Count
          value: Count
    VMPriceOSType:
      type: string
      description: Operating system type used by the VM.
      enum:
      - Linux
      - Windows
      x-ms-enum:
        name: VMPriceOSType
        modelAsString: true
        values:
        - name: Linux
          value: Linux
        - name: Windows
          value: Windows
    UpdateWorkspaceQuotas:
      type: object
      description: The properties for update Quota response.
      properties:
        id:
          type: string
          description: Specifies the resource ID.
          readOnly: true
        type:
          type: string
          description: Specifies the resource type.
          readOnly: true
        limit:
          type: integer
          format: int64
          title: Limit.
          description: The maximum permitted quota of the resource.
        unit:
          $ref: '#/components/schemas/QuotaUnit'
          description: An enum describing the unit of quota measurement.
          readOnly: true
        status:
          $ref: '#/components/schemas/Status'
          title: Update Workspace Quota Status.
          description: Status of update workspace quota.
          readOnly: true
    ListUsagesResult:
      type: object
      description: The List Usages operation response.
      properties:
        value:
          type: array
          description: The Usage items on this page
          items:
            $ref: '#/components/schemas/Usage'
          readOnly: true
        nextLink:
          type: string
          format: uri
          description: The link to the next page of items
      required:
      - value
    VMTier:
      type: string
      description: The type of the VM.
      enum:
      - Standard
      - LowPriority
      - Spot
      x-ms-enum:
        name: VMTier
        modelAsString: true
        values:
        - name: Standard
          value: Standard
        - name: LowPriority
          value: LowPriority
        - name: Spot
          value: Spot
    VirtualMachineSize:
      type: object
      description: Describes the properties of a VM size.
      properties:
        name:
          type: string
          title: Virtual Machine size name
          description: The name of the virtual machine size.
          readOnly: true
        family:
          type: string
          title: Virtual Machine family name
          description: The family name of the virtual machine size.
          readOnly: true
        vCPUs:
          type: integer
          format: int32
          title: Number of vPUs
          description: The number of vCPUs supported by the virtual machine size.
          readOnly: true
        gpus:
          type: integer
          format: int32
          title: Number of gPUs
          description: The number of gPUs supported by the virtual machine size.
          readOnly: true
        osVhdSizeMB:
          type: integer
          format: int32
          title: OS VHD Disk size
          description: The OS VHD disk size, in MB, allowed by the virtual machine size.
          readOnly: true
        maxResourceVolumeMB:
          type: integer
          format: int32
          title: Resource volume size
          description: The resource volume size, in MB, allowed by the virtual machine size.
          readOnly: true
        memoryGB:
          type: number
          format: double
          title: Memory size
          description: The amount of memory, in GB, supported by the virtual machine size.
          readOnly: true
        lowPriorityCapable:
          type: boolean
          title: Low priority capable
          description: Specifies if the virtual machine size supports low priority VMs.
          readOnly: true
        premiumIO:
          type: boolean
          title: Premium IO supported
          description: Specifies if the virtual machine size supports premium IO.
          readOnly: true
        estimatedVMPrices:
          $ref: '#/components/schemas/EstimatedVMPrices'
          title: Estimated VM prices
          description: The estimated price information for using a VM.
        supportedComputeTypes:
          type: array
          title: Supported Compute Types
          description: Specifies the compute types supported by the virtual machine size.
          items:
            type: string
    BillingCurrency:
      type: string
      description: 'Three lettered code specifying the currency of the VM price. Example: USD'
      enum:
      - USD
      x-ms-enum:
        name: BillingCurrency
        modelAsString: true
        values:
        - name: USD
          value: USD
    UpdateWorkspaceQuotasResult:
      type: object
      description: The result of update workspace quota.
      properties:
        value:
          type: array
          description: The list of workspace quota update result.
          items:
            $ref: '#/components/schemas/UpdateWorkspaceQuotas'
          readOnly: true
        nextLink:
          type: string
          description: The URI to fetch the next page of workspace quota update result. Call ListNext() with this to fetch the next page of Workspace Quota update result.
          readOnly: true
    Usage:
      type: object
      description: Describes AML Resource Usage.
      properties:
        id:
          type: string
          description: Specifies the resource ID.
          readOnly: true
        amlWorkspaceLocation:
          type: string
          description: Region of the AML workspace in the id.
          readOnly: true
        type:
          type: string
          description: Specifies the resource type.
          readOnly: true
        unit:
          $ref: '#/components/schemas/UsageUnit'
          description: An enum describing the unit of usage measurement.
          readOnly: true
        currentValue:
          type: integer
          format: int64
          description: The current usage of the resource.
          readOnly: true
        limit:
          type: integer
          format: int64
          description: The maximum permitted usage of the resource.
          readOnly: true
        name:
          $ref: '#/components/schemas/UsageName'
          description: The name of the type of usage.
          readOnly: true
    ResourceQuota:
      type: object
      description: The quota assigned to a resource.
      properties:
        id:
          type: string
          description: Specifies the resource ID.
          readOnly: true
        amlWorkspaceLocation:
          type: string
          description: Region of the AML workspace in the id.
          readOnly: true
        type:
          type: string
          description: Specifies the resource type.
          readOnly: true
        name:
          $ref: '#/components/schemas/ResourceName'
          description: Name of the resource.
          readOnly: true
        limit:
          type: integer
          format: int64
          title: Limit.
          description: The maximum permitted quota of the resource.
          readOnly: true
        unit:
          $ref: '#/components/schemas/QuotaUnit'
          description: An enum describing the unit of quota measurement.
          readOnly: true
    QuotaUnit:
      type: string
      description: An enum describing the unit of quota measurement.
      enum:
      - Count
      x-ms-enum:
        name: QuotaUnit
        modelAsString: true
        values:
        - name: Count
          value: Count
    Status:
      type: string
      description: Status of update workspace quota.
      enum:
      - Undefined
      - Success
      - Failure
      - InvalidQuotaBelowClusterMinimum
      - InvalidQuotaExceedsSubscriptionLimit
      - InvalidVMFamilyName
      - OperationNotSupportedForSku
      - OperationNotEnabledForRegion
      x-ms-enum:
        name: Status
        modelAsString: true
        values:
        - name: Undefined
          value: Undefined
        - name: Success
          value: Success
        - name: Failure
          value: Failure
        - name: InvalidQuotaBelowClusterMinimum
          value: InvalidQuotaBelowClusterMinimum
        - name: InvalidQuotaExceedsSubscriptionLimit
          value: InvalidQuotaExceedsSubscriptionLimit
        - name: InvalidVMFamilyName
          value: InvalidVMFamilyName
        - name: OperationNotSupportedForSku
          value: OperationNotSupportedForSku
        - name: OperationNotEnabledForRegion
          value: OperationNotEnabledForRegion
    QuotaUpdateParameters:
      type: object
      description: Quota update parameters.
      properties:
        value:
          type: array
          description: The list for update quota.
          items:
            $ref: '#/components/schemas/QuotaBaseProperties'
        location:
          type: string
          description: Region of workspace quota to be updated.
    UsageName:
      type: object
      description: The Usage Names.
      properties:
        value:
          type: string
          description: The name of the resource.
          readOnly: true
        localizedValue:
          type: string
          description: The localized name of the resource.
          readOnly: true
    ListWorkspaceQuotas:
      type: object
      description: The List WorkspaceQuotasByVMFamily operation response.
      properties:
        value:
          type: array
          description: The ResourceQuota items on this page
          items:
            $ref: '#/components/schemas/ResourceQuota'
          readOnly: true
        nextLink:
          type: string
          format: uri
          description: The link to the next page of items
      required:
      - value
    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.
    EstimatedVMPrice:
      type: object
      description: The estimated price info for using a VM of a particular OS type, tier, etc.
      properties:
        retailPrice:
          type: number
          format: double
          title: Retail price
          description: The price charged for using the VM.
        osType:
          $ref: '#/components/schemas/VMPriceOSType'
          title: OS type
          description: Operating system type used by the VM.
        vmTier:
          $ref: '#/components/schemas/VMTier'
          title: VM tier
          description: The type of the VM.
      required:
      - retailPrice
      - osType
      - vmTier
    EstimatedVMPrices:
      type: object
      description: The estimated price info for using a VM.
      properties:
        billingCurrency:
          $ref: '#/components/schemas/BillingCurrency'
          title: Billing currency
          description: 'Three lettered code specifying the currency of the VM price. Example: USD'
        unitOfMeasure:
          $ref: '#/components/schemas/UnitOfMeasure'
          title: Unit of time measure
          description: 'The unit of time measurement for the specified VM price. Example: OneHour'
        values:
          type: array
          title: List of estimated VM prices.
          description: The list of estimated prices for using a VM of a particular OS type, tier, etc.
          items:
            $ref: '#/components/schemas/EstimatedVMPrice'
          x-ms-identifiers: []
      required:
      - billingCurrency
      - unitOfMeasure
      - values
    QuotaBaseProperties:
      type: object
      description: The properties for Quota update or retrieval.
      properties:
        id:
          type: string
          description: Specifies the resource ID.
        type:
          type: string
          description: Specifies the resource type.
        limit:
          type: integer
          format: int64
          title: Limit.
          description: The maximum permitted quota of the resource.
        unit:
          $ref: '#/components/schemas/QuotaUnit'
          description: An enum describing the unit of quota measurement.
    VirtualMachineSizeListResult:
      type: object
      description: The List Virtual Machine size operation response.
      properties:
        value:
          type: array
          description: The list of virtual machine sizes supported by AmlCompute.
          items:
            $ref: '#/components/schemas/VirtualMachineSize'
          x-ms-identifiers:
          - name
    ResourceName:
      type: object
      description: The Resource Name.
      properties:
        value:
          type: string
          description: The name of the resource.
          readOnly: true
        localizedValue:
          type: string
          description: The localized name of the resource.
          readOnly: true
    UnitOfMeasure:
      type: string
      description: 'The unit of time measurement for the specified VM price. Example: OneHour'
      enum:
      - OneHour
      x-ms-enum:
        name: UnitOfMeasure
        modelAsString: true
        values:
        - name: OneHour
          value: OneHour
  parameters:
    CustomLocationParameter:
      name: location
      in: path
      description: The location name.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
        pattern: ^[-\w\._]+$
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: The ID of the target subscription.
      required: true
      schema:
        type: string
        minLength: 1
    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.