Usages - List

Service:
Machine Learning
API Version:
2025-09-01

Gets the current usage information as well as limits for AML resources for given subscription and location.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.MachineLearningServices/locations/{location}/usages?api-version=2025-09-01

URI Parameters

Name In Required Type Description
location
 path True

string

pattern: ^[-\w\._]+$

The location for which resource usage is queried.
subscriptionId
 path True

string

minLength: 1

The ID of the target subscription.
api-version
 query True

string

minLength: 1

The API version to use for this operation.

Responses

Name Type Description
200 OK

ListUsagesResult

OK
Other Status Codes

ErrorResponse

Error response describing why the operation failed

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

List Usages

Sample request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.MachineLearningServices/locations/eastus/usages?api-version=2025-09-01

Sample response

Status code:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages",
      "type": "Microsoft.MachineLearningServices/totalCores/usages",
      "currentValue": 7,
      "limit": 100,
      "name": {
        "localizedValue": "Clusters",
        "value": "Clusters"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages",
      "type": "Microsoft.MachineLearningServices/dedicatedCores/usages",
      "currentValue": 14,
      "limit": 24,
      "name": {
        "localizedValue": "Total Cluster Dedicated Regional vCPUs",
        "value": "Total Cluster Dedicated Regional vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_D_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 48,
      "name": {
        "localizedValue": "Standard D Family Cluster Dedicated vCPUs",
        "value": "Standard D Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 2,
      "limit": 24,
      "name": {
        "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspaces/usages",
      "currentValue": 2,
      "limit": 24,
      "name": {
        "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster1_dsv2/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspaces/computes/usages",
      "currentValue": 2,
      "limit": 24,
      "name": {
        "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster2_dsv2/usages/Standard_DSv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspaces/computes/usages",
      "currentValue": 0,
      "limit": 24,
      "name": {
        "value": "Standard DSv2 Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard DSv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_Dv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 24,
      "name": {
        "localizedValue": "Standard Dv2 Family Cluster Dedicated vCPUs",
        "value": "Standard Dv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_FSv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 24,
      "name": {
        "value": "Standard FSv2 Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard FSv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 12,
      "limit": 24,
      "name": {
        "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
        "value": "Standard NC Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/usages",
      "currentValue": 6,
      "limit": 24,
      "name": {
        "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
        "value": "Standard NC Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster1_nc/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
      "currentValue": 6,
      "limit": 24,
      "name": {
        "localizedValue": "Standard NC Family Cluster Dedicated vCPUs",
        "value": "Standard NC Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspaces/usages",
      "currentValue": 6,
      "limit": 24,
      "name": {
        "value": "Standard NC Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/computes/demo_cluser1_nc/usages/Standard_NC_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspaces/computes/usages",
      "currentValue": 6,
      "limit": 24,
      "name": {
        "value": "Standard NC Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard NC Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 0,
      "name": {
        "localizedValue": "Standard NCv2 Family Cluster Dedicated vCPUs",
        "value": "Standard NCv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv3_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 0,
      "name": {
        "localizedValue": "Standard NCv3 Family Cluster Dedicated vCPUs",
        "value": "Standard NCv3 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_ND_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 0,
      "name": {
        "localizedValue": "Standard ND Family Cluster Dedicated vCPUs",
        "value": "Standard ND Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NDv2_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 0,
      "name": {
        "value": "Standard NDv2 Family Cluster Dedicated vCPUs",
        "localizedValue": "Standard NDv2 Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NV_Family_Cluster_Dedicated_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": 24,
      "name": {
        "localizedValue": "Standard NV Family Cluster Dedicated vCPUs",
        "value": "Standard NV Family Cluster Dedicated vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages",
      "type": "Microsoft.MachineLearningServices/lowPriorityCores/usages",
      "currentValue": 18,
      "limit": 50,
      "name": {
        "localizedValue": "Total Cluster LowPriority Regional vCPUs",
        "value": "Total Cluster LowPriority Regional vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_D_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "value": "Standard D Family Cluster LowPriority vCPUs",
        "localizedValue": "Standard D Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_DSv2_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard DSv2 Family Cluster LowPriority vCPUs",
        "value": "Standard DSv2 Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_Dv2_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard Dv2 Family Cluster LowPriority vCPUs",
        "value": "Standard Dv2 Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_FSv2_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard FSv2 Family Cluster LowPriority vCPUs",
        "value": "Standard FSv2 Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 18,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
        "value": "Standard NC Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/usages",
      "currentValue": 6,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
        "value": "Standard NC Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace1/computes/demo_cluster1_lowPriority_nc/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
      "currentValue": 6,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
        "value": "Standard NC Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/usages",
      "currentValue": 12,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
        "value": "Standard NC Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/computes/demo_cluster2_lowPriority_nc/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
      "currentValue": 6,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
        "value": "Standard NC Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.MachineLearningServices/workspaces/demo_workspace2/computes/demo_cluster3_lowPriority_nc/usages/Standard_NC_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/workspace/computes/usages",
      "currentValue": 6,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NC Family Cluster LowPriority vCPUs",
        "value": "Standard NC Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv2_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NCv2 Family Cluster LowPriority vCPUs",
        "value": "Standard NCv2 Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NCv3_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NCv3 Family Cluster LowPriority vCPUs",
        "value": "Standard NCv3 Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_ND_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard ND Family Cluster LowPriority vCPUs",
        "value": "Standard ND Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NDv2_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NDv2 Family Cluster LowPriority vCPUs",
        "value": "Standard NDv2 Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    },
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/usages/Standard_NV_Family_Cluster_LowPriority_vCPUs",
      "type": "Microsoft.MachineLearningServices/vmFamily/usages",
      "currentValue": 0,
      "limit": -1,
      "name": {
        "localizedValue": "Standard NV Family Cluster LowPriority vCPUs",
        "value": "Standard NV Family Cluster LowPriority vCPUs"
      },
      "unit": "Count"
    }
  ]
}

Definitions

Name Description
ErrorAdditionalInfo

The resource management error additional info.
ErrorDetail

The error detail.
ErrorResponse

Error response
ListUsagesResult

The List Usages operation response.
Usage

Describes AML Resource Usage.
UsageName

The Usage Names.
UsageUnit

An enum describing the unit of usage measurement.

ErrorAdditionalInfo

Object

The resource management error additional info.

Name Type Description
info

object

The additional info.
type

string

The additional info type.

ErrorDetail

Object

The error detail.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

The error additional info.
code

string

The error code.
details

ErrorDetail[]

The error details.
message

string

The error message.
target

string

The error target.

ErrorResponse

Object

Error response

Name Type Description
error

ErrorDetail

The error object.

ListUsagesResult

Object

The List Usages operation response.

Name Type Description
nextLink

string

The URI to fetch the next page of AML resource usage information. Call ListNext() with this to fetch the next page of AML resource usage information.
value

Usage[]

The list of AML resource usages.

Usage

Object

Describes AML Resource Usage.

Name Type Description
amlWorkspaceLocation

string

Region of the AML workspace in the id.
currentValue

integer (int64)

The current usage of the resource.
id

string

Specifies the resource ID.
limit

integer (int64)

The maximum permitted usage of the resource.
name

UsageName

The name of the type of usage.
type

string

Specifies the resource type.
unit

UsageUnit

An enum describing the unit of usage measurement.

UsageName

Object

The Usage Names.

Name Type Description
localizedValue

string

The localized name of the resource.
value

string

The name of the resource.

UsageUnit

Enumeration

An enum describing the unit of usage measurement.

Value Description
Count