Compute - Get

Gets compute definition by its name. Any secrets (storage keys, service credentials, etc) are not returned - use 'keys' nested resource to get them.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}?api-version=2023-10-01

URI Parameters

Name In Required Type Description
computeName
path True

string

Name of the Azure Machine Learning compute.

resourceGroupName
path True

string

The name of the resource group. The name is case insensitive.

subscriptionId
path True

string

The ID of the target subscription.

workspaceName
path True

string

Name of Azure Machine Learning workspace.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$

api-version
query True

string

The API version to use for this operation.

Responses

Name Type Description
200 OK

ComputeResource

Success.

Other Status Codes

ErrorResponse

Error response describing why the request 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

Get a AKS Compute
Get a AML Compute
Get a Kubernetes Compute
Get an ComputeInstance

Get a AKS Compute

Sample Request

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123?api-version=2023-10-01

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "name": "compute123",
  "location": "eastus",
  "properties": {
    "createdOn": "2021-04-01T22:00:00.0000000+00:00",
    "modifiedOn": "2021-04-01T22:00:00.0000000+00:00",
    "description": "some compute",
    "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
    "computeType": "AKS",
    "provisioningState": "Succeeded"
  }
}

Get a AML Compute

Sample Request

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123?api-version=2023-10-01

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "name": "compute123",
  "location": "eastus2",
  "properties": {
    "description": "some compute",
    "createdOn": "2021-04-01T22:00:00.0000000+00:00",
    "modifiedOn": "2021-04-01T22:00:00.0000000+00:00",
    "computeType": "AmlCompute",
    "provisioningState": "Succeeded",
    "properties": {
      "vmSize": "STANDARD_NC6",
      "vmPriority": "Dedicated",
      "osType": "Windows",
      "virtualMachineImage": null,
      "isolatedNetwork": false,
      "subnet": {
        "id": "test-subnet-resource-id"
      },
      "scaleSettings": {
        "maxNodeCount": 1,
        "minNodeCount": 0,
        "nodeIdleTimeBeforeScaleDown": "PT5M"
      },
      "remoteLoginPortPublicAccess": "Enabled",
      "allocationState": "Resizing",
      "allocationStateTransitionTime": "2017-09-27T22:28:08.998Z",
      "errors": null,
      "currentNodeCount": 0,
      "targetNodeCount": 1,
      "nodeStateCounts": {
        "preparingNodeCount": 0,
        "runningNodeCount": 0,
        "idleNodeCount": 0,
        "unusableNodeCount": 0,
        "leavingNodeCount": 0,
        "preemptedNodeCount": 0
      },
      "enableNodePublicIp": true
    }
  }
}

Get a Kubernetes Compute

Sample Request

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123?api-version=2023-10-01

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "name": "compute123",
  "location": "eastus",
  "properties": {
    "createdOn": "2021-04-01T22:00:00.0000000+00:00",
    "modifiedOn": "2021-04-01T22:00:00.0000000+00:00",
    "description": "some compute",
    "resourceId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourcegroups/testrg123/providers/Microsoft.ContainerService/managedClusters/compute123-56826-c9b00420020b2",
    "computeType": "Kubernetes",
    "provisioningState": "Succeeded",
    "isAttachedCompute": true,
    "properties": {
      "relayConnectionString": null,
      "serviceBusConnectionString": null,
      "extensionPrincipalId": null,
      "extensionInstanceReleaseTrain": "stable",
      "vcName": null,
      "namespace": "default",
      "defaultInstanceType": "defaultInstanceType",
      "instanceTypes": {
        "defaultInstanceType": {
          "nodeSelector": null,
          "resources": {
            "requests": {
              "cpu": "1",
              "memory": "4Gi",
              "nvidia.com/gpu": null
            },
            "limits": {
              "cpu": "1",
              "memory": "4Gi",
              "nvidia.com/gpu": null
            }
          }
        }
      }
    }
  }
}

Get an ComputeInstance

Sample Request

GET https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123?api-version=2023-10-01

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123",
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "name": "compute123",
  "location": "eastus2",
  "properties": {
    "description": "some compute",
    "createdOn": "2021-04-01T22:00:00.0000000+00:00",
    "modifiedOn": "2021-04-01T22:00:00.0000000+00:00",
    "computeType": "ComputeInstance",
    "provisioningState": "Succeeded",
    "properties": {
      "vmSize": "STANDARD_NC6",
      "subnet": {
        "id": "test-subnet-resource-id"
      },
      "applicationSharingPolicy": "Shared",
      "sshSettings": {
        "sshPublicAccess": "Enabled",
        "adminUserName": "azureuser",
        "sshPort": 22
      },
      "osImageMetadata": {
        "currentImageVersion": "22.06.14",
        "latestImageVersion": "22.07.22",
        "isLatestOsImageVersion": false
      },
      "customServices": [
        {
          "docker": {
            "privileged": true
          },
          "environmentVariables": {
            "test_var": {
              "type": "local",
              "value": "test_val"
            }
          },
          "volumes": [
            {
              "type": "bind",
              "readOnly": false,
              "source": "/home/azureuser/cloudfiles",
              "target": "/home/azureuser/cloudfiles"
            }
          ],
          "endpoints": [
            {
              "name": "connect",
              "target": 8787,
              "published": 8787,
              "protocol": "http"
            }
          ],
          "image": {
            "type": "docker",
            "reference": "ghcr.io/azure/rocker-rstudio-ml-verse:latest"
          },
          "name": "rstudio"
        }
      ],
      "computeInstanceAuthorizationType": "personal",
      "personalComputeInstanceSettings": {
        "assignedUser": {
          "objectId": "00000000-0000-0000-0000-000000000000",
          "tenantId": "00000000-0000-0000-0000-000000000000"
        }
      },
      "createdBy": {
        "userName": "foobar@microsoft.com",
        "userOrgId": "00000000-0000-0000-0000-000000000000",
        "userId": "00000000-0000-0000-0000-000000000000"
      },
      "connectivityEndpoints": {
        "publicIpAddress": "10.0.0.1",
        "privateIpAddress": "10.0.0.1"
      },
      "applications": [
        {
          "displayName": "Jupyter",
          "endpointUri": "https://compute123.eastus2.azureml.net/jupyter"
        }
      ],
      "errors": null,
      "state": "Running"
    }
  }
}

Definitions

Name Description
AKS

A Machine Learning compute based on AKS.

AksNetworkingConfiguration

Advance configuration for AKS networking

AllocationState

Allocation state.

AmlCompute

An Azure Machine Learning compute.

AmlComputeProperties

AML Compute properties

applicationSharingPolicy

Sharing policy for applications on this compute instance

AssignedUser

A user that can be assigned to a compute instance.

autosave

Auto save settings.

BindOptions

Describes the bind options for the container

caching

Caching type of Data Disk.

ClusterPurpose

Intended usage of the cluster

ComputeInstance

An Azure Machine Learning compute instance.

ComputeInstanceApplication

Defines an Aml Instance application and its connectivity endpoint URI.

ComputeInstanceAuthorizationType

Compute Instance Authorization type.

ComputeInstanceConnectivityEndpoints

Defines all connectivity endpoints and properties for an ComputeInstance.

ComputeInstanceContainer

Defines an Aml Instance container.

ComputeInstanceCreatedBy

Describes information on user who created this ComputeInstance.

ComputeInstanceDataDisk

Defines an Aml Instance DataDisk.

ComputeInstanceDataMount

Defines an Aml Instance DataMount.

ComputeInstanceEnvironmentInfo

Environment information

ComputeInstanceLastOperation

The last operation on ComputeInstance.

ComputeInstanceProperties

Compute Instance properties

ComputeInstanceSshSettings

Specifies policy and settings for SSH access.

ComputeInstanceState

Current state of an ComputeInstance.

ComputeInstanceVersion

Version of computeInstance.

ComputePowerAction

The compute power action.

ComputeRecurrenceFrequency

Enum to describe the frequency of a compute recurrence schedule

ComputeRecurrenceSchedule
ComputeResource

Machine Learning compute object wrapped into ARM resource envelope.

ComputeSchedules

The list of schedules to be applied on the computes

ComputeStartStopSchedule

Compute start stop schedule properties

ComputeTriggerType

Is the trigger type recurrence or cron.

ComputeType

The type of compute

ComputeWeekDay

Enum of weekday

createdByType

The type of identity that created the resource.

Cron

The workflow trigger cron for ComputeStartStop schedule type.

CustomService

Specifies the custom service configuration

Databricks

A DataFactory compute.

DatabricksProperties

Properties of Databricks

DataFactory

A DataFactory compute.

DataLakeAnalytics

A DataLakeAnalytics compute.

Docker

Docker container configuration

Endpoint

Describes the endpoint configuration for the container

EnvironmentVariable

Environment Variables for the container

EnvironmentVariableType

Type of Environment Variable

ErrorAdditionalInfo

The resource management error additional info.

ErrorDetail

The error detail.

ErrorResponse

Error response

HDInsight

A HDInsight compute.

HDInsightProperties

HDInsight compute properties

Image

Describes the Image Specifications

ImageMetadata

Returns metadata about the operating system image for this compute instance.

ImageType

Type of the image

InstanceTypeSchema

Instance type schema.

Kubernetes

A Machine Learning compute based on Kubernetes Compute.

KubernetesProperties

Kubernetes properties

LoadBalancerType

Load Balancer Type

ManagedServiceIdentity

Managed service identity (system assigned and/or user assigned identities)

ManagedServiceIdentityType

Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).

mountAction

Mount Action.

mountState

Mount state.

network

network of this container.

NodeStateCounts

Counts of various compute node states on the amlCompute.

OperationName

Name of the last operation.

OperationStatus

Operation status.

operationTrigger

Trigger of operation.

OsType

Compute OS Type

PersonalComputeInstanceSettings

Settings for a personal compute instance.

Properties

AKS properties

protocol

Endpoint Communication Protocol

ProvisioningState

The current deployment state of workspace resource. The provisioningState is to indicate states for resource provisioning.

provisioningStatus

The current deployment state of schedule.

Recurrence

The workflow trigger recurrence for ComputeStartStop schedule type.

remoteLoginPortPublicAccess

Close remote Login Access Port

ResourceId

Represents a resource ID. For example, for a subnet, it is the resource URL for the subnet.

Resources

Resource requests/limits for this instance type

ScaleSettings

scale settings for AML Compute

ScheduleBase
ScheduleProvisioningState

The current deployment state of schedule.

ScheduleStatus

Is the schedule enabled or disabled?

ScriptReference

Script reference

ScriptsToExecute

Customized setup scripts

SetupScripts

Details of customized scripts to execute for setting up the cluster.

Sku

The resource model definition representing SKU

SkuTier

This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.

sourceType

Data source type.

sshPublicAccess

Access policy for SSH

SslConfigStatus

Enable or disable ssl for scoring

SslConfiguration

The ssl configuration for scoring

storageAccountType

type of this storage account.

SynapseSpark

A SynapseSpark compute.

systemData

Metadata pertaining to creation and last modification of the resource.

SystemService

A system service running on a compute.

TmpfsOptions

Describes the tmpfs options for the container

UserAccountCredentials

Settings for user account that gets created on each on the nodes of a compute.

UserAssignedIdentity

User assigned identity properties

VirtualMachine

A Machine Learning compute based on Azure Virtual Machines.

VirtualMachineImage

Virtual Machine image for Windows AML Compute

VirtualMachineSshCredentials

Admin credentials for virtual machine

VmPriority

Virtual Machine priority

VolumeDefinition

Describes the volume configuration for the container

VolumeDefinitionType

Type of Volume Definition

VolumeOptions

Describes the volume options for the container

AKS

A Machine Learning compute based on AKS.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

AKS

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

Properties

AKS properties

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

AksNetworkingConfiguration

Advance configuration for AKS networking

Name Type Description
dnsServiceIP

string

An IP address assigned to the Kubernetes DNS service. It must be within the Kubernetes service address range specified in serviceCidr.

dockerBridgeCidr

string

A CIDR notation IP range assigned to the Docker bridge network. It must not overlap with any Subnet IP ranges or the Kubernetes service address range.

serviceCidr

string

A CIDR notation IP range from which to assign service cluster IPs. It must not overlap with any Subnet IP ranges.

subnetId

string

Virtual network subnet resource ID the compute nodes belong to

AllocationState

Allocation state.

Name Type Description
Resizing

string

Steady

string

AmlCompute

An Azure Machine Learning compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

AmlCompute

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

AmlComputeProperties

Properties of AmlCompute

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

AmlComputeProperties

AML Compute properties

Name Type Default Value Description
allocationState

AllocationState

Allocation state.
Allocation state of the compute. Possible values are: steady - Indicates that the compute is not resizing. There are no changes to the number of compute nodes in the compute in progress. A compute enters this state when it is created and when no operations are being performed on the compute to change the number of compute nodes. resizing - Indicates that the compute is resizing; that is, compute nodes are being added to or removed from the compute.

allocationStateTransitionTime

string

Allocation state transition time.
The time at which the compute entered its current allocation state.

currentNodeCount

integer

Current node count.
The number of compute nodes currently assigned to the compute.

enableNodePublicIp

boolean

True

Enable node public IP.
Enable or disable node public IP address provisioning. Possible values are: Possible values are: true - Indicates that the compute nodes will have public IPs provisioned. false - Indicates that the compute nodes will have a private endpoint and no public IPs.

errors

ErrorResponse[]

Errors.
Collection of errors encountered by various compute nodes during node setup.

isolatedNetwork

boolean

Network is isolated or not

nodeStateCounts

NodeStateCounts

Node state counts.
Counts of various node states on the compute.

osType

OsType

Linux

Compute OS Type

propertyBag

object

A property bag containing additional properties.

remoteLoginPortPublicAccess

remoteLoginPortPublicAccess

NotSpecified

Close remote Login Access Port
State of the public SSH port. Possible values are: Disabled - Indicates that the public ssh port is closed on all nodes of the cluster. Enabled - Indicates that the public ssh port is open on all nodes of the cluster. NotSpecified - Indicates that the public ssh port is closed on all nodes of the cluster if VNet is defined, else is open all public nodes. It can be default only during cluster creation time, after creation it will be either enabled or disabled.

scaleSettings

ScaleSettings

Scale settings for AML Compute

subnet

ResourceId

Subnet.
Virtual network subnet resource ID the compute nodes belong to.

targetNodeCount

integer

Target node count.
The target number of compute nodes for the compute. If the allocationState is resizing, this property denotes the target node count for the ongoing resize operation. If the allocationState is steady, this property denotes the target node count for the previous resize operation.

userAccountCredentials

UserAccountCredentials

User account credentials.
Credentials for an administrator user account that will be created on each compute node.

virtualMachineImage

VirtualMachineImage

Virtual Machine image for AML Compute - windows only

vmPriority

VmPriority

Virtual Machine priority

vmSize

string

Virtual Machine Size

applicationSharingPolicy

Sharing policy for applications on this compute instance

Name Type Description
Personal

string

Shared

string

AssignedUser

A user that can be assigned to a compute instance.

Name Type Description
objectId

string

User’s AAD Object Id.

tenantId

string

User’s AAD Tenant Id.

autosave

Auto save settings.

Name Type Description
Local

string

None

string

Remote

string

BindOptions

Describes the bind options for the container

Name Type Description
createHostPath

boolean

Indicate whether to create host path.

propagation

string

Type of Bind Option

selinux

string

Mention the selinux options.

caching

Caching type of Data Disk.

Name Type Description
None

string

ReadOnly

string

ReadWrite

string

ClusterPurpose

Intended usage of the cluster

Name Type Description
DenseProd

string

DevTest

string

FastProd

string

ComputeInstance

An Azure Machine Learning compute instance.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

ComputeInstance

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

ComputeInstanceProperties

Properties of ComputeInstance

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

ComputeInstanceApplication

Defines an Aml Instance application and its connectivity endpoint URI.

Name Type Description
displayName

string

Name of the ComputeInstance application.

endpointUri

string

Application' endpoint URI.

ComputeInstanceAuthorizationType

Compute Instance Authorization type.

Name Type Description
personal

string

ComputeInstanceConnectivityEndpoints

Defines all connectivity endpoints and properties for an ComputeInstance.

Name Type Description
privateIpAddress

string

Private IP Address of this ComputeInstance (local to the VNET in which the compute instance is deployed).

publicIpAddress

string

Public IP Address of this ComputeInstance.

ComputeInstanceContainer

Defines an Aml Instance container.

Name Type Description
autosave

autosave

Auto save settings.

environment

ComputeInstanceEnvironmentInfo

Environment information of this container.

gpu

string

Information of GPU.

name

string

Name of the ComputeInstance container.

network

network

network of this container.

services

object[]

services of this containers.

ComputeInstanceCreatedBy

Describes information on user who created this ComputeInstance.

Name Type Description
userId

string

Uniquely identifies the user within his/her organization.

userName

string

Name of the user.

userOrgId

string

Uniquely identifies user' Azure Active Directory organization.

ComputeInstanceDataDisk

Defines an Aml Instance DataDisk.

Name Type Default Value Description
caching

caching

Caching type of Data Disk.

diskSizeGB

integer

The initial disk size in gigabytes.
The initial disk size in gigabytes.

lun

integer

The logical unit number.
The lun is used to uniquely identify each data disk. If attaching multiple disks, each should have a distinct lun.

storageAccountType

storageAccountType

Standard_LRS

type of this storage account.

ComputeInstanceDataMount

Defines an Aml Instance DataMount.

Name Type Description
createdBy

string

who this data mount created by.

error

string

Error of this data mount.

mountAction

mountAction

Mount Action.

mountName

string

name of the ComputeInstance data mount.

mountPath

string

Path of this data mount.

mountState

mountState

Mount state.

mountedOn

string

Mounted time.
The time when the disk mounted.

source

string

Source of the ComputeInstance data mount.

sourceType

sourceType

Data source type.

ComputeInstanceEnvironmentInfo

Environment information

Name Type Description
name

string

name of environment.

version

string

version of environment.

ComputeInstanceLastOperation

The last operation on ComputeInstance.

Name Type Description
operationName

OperationName

Name of the last operation.

operationStatus

OperationStatus

Operation status.

operationTime

string

Time of the last operation.

operationTrigger

operationTrigger

Trigger of operation.

ComputeInstanceProperties

Compute Instance properties

Name Type Default Value Description
applicationSharingPolicy

applicationSharingPolicy

Shared

Sharing policy for applications on this compute instance
Policy for sharing applications on this compute instance among users of parent workspace. If Personal, only the creator can access applications on this compute instance. When Shared, any workspace user can access applications on this instance depending on his/her assigned role.

applications

ComputeInstanceApplication[]

Describes available applications and their endpoints on this ComputeInstance.

computeInstanceAuthorizationType

ComputeInstanceAuthorizationType

personal

Compute Instance Authorization type.
The Compute Instance Authorization type. Available values are personal (default).

connectivityEndpoints

ComputeInstanceConnectivityEndpoints

Describes all connectivity endpoints available for this ComputeInstance.

containers

ComputeInstanceContainer[]

Describes informations of containers on this ComputeInstance.

createdBy

ComputeInstanceCreatedBy

Describes information on user who created this ComputeInstance.

customServices

CustomService[]

List of Custom Services added to the compute.

dataDisks

ComputeInstanceDataDisk[]

Describes informations of dataDisks on this ComputeInstance.

dataMounts

ComputeInstanceDataMount[]

Describes informations of dataMounts on this ComputeInstance.

enableNodePublicIp

boolean

Enable node public IP.
Enable or disable node public IP address provisioning. Possible values are: Possible values are: true - Indicates that the compute nodes will have public IPs provisioned. false - Indicates that the compute nodes will have a private endpoint and no public IPs.

errors

ErrorResponse[]

Errors.
Collection of errors encountered on this ComputeInstance.

lastOperation

ComputeInstanceLastOperation

The last operation on ComputeInstance.

osImageMetadata

ImageMetadata

Returns metadata about the operating system image for this compute instance.

personalComputeInstanceSettings

PersonalComputeInstanceSettings

Personal Compute Instance settings.
Settings for a personal compute instance.

schedules

ComputeSchedules

The list of schedules to be applied on the computes.

setupScripts

SetupScripts

Details of customized scripts to execute for setting up the cluster.

sshSettings

ComputeInstanceSshSettings

Specifies policy and settings for SSH access.

state

ComputeInstanceState

The current state of this ComputeInstance.

subnet

ResourceId

Subnet.
Virtual network subnet resource ID the compute nodes belong to.

versions

ComputeInstanceVersion

ComputeInstance version.

vmSize

string

Virtual Machine Size

ComputeInstanceSshSettings

Specifies policy and settings for SSH access.

Name Type Default Value Description
adminPublicKey

string

Specifies the SSH rsa public key file as a string. Use "ssh-keygen -t rsa -b 2048" to generate your SSH key pairs.

adminUserName

string

Describes the admin user name.

sshPort

integer

Describes the port for connecting through SSH.

sshPublicAccess

sshPublicAccess

Disabled

Access policy for SSH
State of the public SSH port. Possible values are: Disabled - Indicates that the public ssh port is closed on this instance. Enabled - Indicates that the public ssh port is open and accessible according to the VNet/subnet policy if applicable.

ComputeInstanceState

Current state of an ComputeInstance.

Name Type Description
CreateFailed

string

Creating

string

Deleting

string

JobRunning

string

Restarting

string

Running

string

SettingUp

string

SetupFailed

string

Starting

string

Stopped

string

Stopping

string

Unknown

string

Unusable

string

UserSettingUp

string

UserSetupFailed

string

ComputeInstanceVersion

Version of computeInstance.

Name Type Description
runtime

string

Runtime of compute instance.

ComputePowerAction

The compute power action.

Name Type Description
Start

string

Stop

string

ComputeRecurrenceFrequency

Enum to describe the frequency of a compute recurrence schedule

Name Type Description
Day

string

Day frequency

Hour

string

Hour frequency

Minute

string

Minute frequency

Month

string

Month frequency

Week

string

Week frequency

ComputeRecurrenceSchedule

Name Type Description
hours

integer[]

[Required] List of hours for the schedule.

minutes

integer[]

[Required] List of minutes for the schedule.

monthDays

integer[]

List of month days for the schedule

weekDays

ComputeWeekDay[]

List of days for the schedule.

ComputeResource

Machine Learning compute object wrapped into ARM resource envelope.

Name Type Description
id

string

Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

The identity of the resource.

location

string

Specifies the location of the resource.

name

string

The name of the resource

properties Compute:

Compute properties

sku

Sku

The sku of the workspace.

systemData

systemData

Azure Resource Manager metadata containing createdBy and modifiedBy information.

tags

object

Contains resource tags defined as key/value pairs.

type

string

The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts"

ComputeSchedules

The list of schedules to be applied on the computes

Name Type Description
computeStartStop

ComputeStartStopSchedule[]

The list of compute start stop schedules to be applied.

ComputeStartStopSchedule

Compute start stop schedule properties

Name Type Description
action

ComputePowerAction

[Required] The compute power action.

cron

Cron

Required if triggerType is Cron.

id

string

A system assigned id for the schedule.

provisioningStatus

provisioningStatus

The current deployment state of schedule.

recurrence

Recurrence

Required if triggerType is Recurrence.

schedule

ScheduleBase

[Deprecated] Not used any more.

status

ScheduleStatus

Is the schedule enabled or disabled?

triggerType

ComputeTriggerType

[Required] The schedule trigger type.

ComputeTriggerType

Is the trigger type recurrence or cron.

Name Type Description
Cron

string

Recurrence

string

ComputeType

The type of compute

Name Type Description
AKS

string

AmlCompute

string

ComputeInstance

string

DataFactory

string

DataLakeAnalytics

string

Databricks

string

HDInsight

string

Kubernetes

string

SynapseSpark

string

VirtualMachine

string

ComputeWeekDay

Enum of weekday

Name Type Description
Friday

string

Friday weekday

Monday

string

Monday weekday

Saturday

string

Saturday weekday

Sunday

string

Sunday weekday

Thursday

string

Thursday weekday

Tuesday

string

Tuesday weekday

Wednesday

string

Wednesday weekday

createdByType

The type of identity that created the resource.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

Cron

The workflow trigger cron for ComputeStartStop schedule type.

Name Type Default Value Description
expression

string

[Required] Specifies cron expression of schedule. The expression should follow NCronTab format.

startTime

string

The start time in yyyy-MM-ddTHH:mm:ss format.

timeZone

string

UTC

Specifies time zone in which the schedule runs. TimeZone should follow Windows time zone format. Refer: https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11

CustomService

Specifies the custom service configuration

Name Type Description
docker

Docker

Describes the docker settings for the image

endpoints

Endpoint[]

Configuring the endpoints for the container

environmentVariables

<string,  EnvironmentVariable>

Environment Variable for the container

image

Image

Describes the Image Specifications

name

string

Name of the Custom Service

volumes

VolumeDefinition[]

Configuring the volumes for the container

Databricks

A DataFactory compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

Databricks

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

DatabricksProperties

Properties of Databricks

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

DatabricksProperties

Properties of Databricks

Name Type Description
databricksAccessToken

string

Databricks access token

workspaceUrl

string

Workspace Url

DataFactory

A DataFactory compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

DataFactory

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

DataLakeAnalytics

A DataLakeAnalytics compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

DataLakeAnalytics

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

Properties

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

Docker

Docker container configuration

Name Type Description
privileged

boolean

Indicate whether container shall run in privileged or non-privileged mode.

Endpoint

Describes the endpoint configuration for the container

Name Type Default Value Description
hostIp

string

Host IP over which the application is exposed from the container

name

string

Name of the Endpoint

protocol

protocol

tcp

Endpoint Communication Protocol
Protocol over which communication will happen over this endpoint

published

integer

Port over which the application is exposed from container.

target

integer

Application port inside the container.

EnvironmentVariable

Environment Variables for the container

Name Type Default Value Description
type

EnvironmentVariableType

local

Type of Environment Variable
Type of the Environment Variable. Possible values are: local - For local variable

value

string

Value of the Environment variable

EnvironmentVariableType

Type of Environment Variable

Name Type Description
local

string

ErrorAdditionalInfo

The resource management error additional info.

Name Type Description
info

object

The additional info.

type

string

The additional info type.

ErrorDetail

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

Error response

Name Type Description
error

ErrorDetail

The error object.

HDInsight

A HDInsight compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

HDInsight

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

HDInsightProperties

HDInsight compute properties

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

HDInsightProperties

HDInsight compute properties

Name Type Description
address

string

Public IP address of the master node of the cluster.

administratorAccount

VirtualMachineSshCredentials

Admin credentials for master node of the cluster

sshPort

integer

Port open for ssh connections on the master node of the cluster.

Image

Describes the Image Specifications

Name Type Default Value Description
reference

string

Image reference

type

ImageType

docker

Type of the image
Type of the image. Possible values are: docker - For docker images. azureml - For AzureML images

ImageMetadata

Returns metadata about the operating system image for this compute instance.

Name Type Description
currentImageVersion

string

Specifies the current operating system image version this compute instance is running on.

isLatestOsImageVersion

boolean

Specifies whether this compute instance is running on the latest operating system image.

latestImageVersion

string

Specifies the latest available operating system image version.

ImageType

Type of the image

Name Type Description
azureml

string

docker

string

InstanceTypeSchema

Instance type schema.

Name Type Description
nodeSelector

object

Node Selector

resources

Resources

Resource requests/limits for this instance type

Kubernetes

A Machine Learning compute based on Kubernetes Compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

Kubernetes

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

KubernetesProperties

Properties of Kubernetes

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

KubernetesProperties

Kubernetes properties

Name Type Default Value Description
defaultInstanceType

string

Default instance type

extensionInstanceReleaseTrain

string

Extension instance release train.

extensionPrincipalId

string

Extension principal-id.

instanceTypes

<string,  InstanceTypeSchema>

Instance Type Schema

namespace

string

default

Compute namespace

relayConnectionString

string

Relay connection string.

serviceBusConnectionString

string

ServiceBus connection string.

vcName

string

VC name.

LoadBalancerType

Load Balancer Type

Name Type Description
InternalLoadBalancer

string

PublicIp

string

ManagedServiceIdentity

Managed service identity (system assigned and/or user assigned identities)

Name Type Description
principalId

string

The service principal ID of the system assigned identity. This property will only be provided for a system assigned identity.

tenantId

string

The tenant ID of the system assigned identity. This property will only be provided for a system assigned identity.

type

ManagedServiceIdentityType

Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned Identities
The set of user assigned identities associated with the resource. The userAssignedIdentities dictionary keys will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. The dictionary values can be empty objects ({}) in requests.

ManagedServiceIdentityType

Type of managed service identity (where both SystemAssigned and UserAssigned types are allowed).

Name Type Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

mountAction

Mount Action.

Name Type Description
Mount

string

Unmount

string

mountState

Mount state.

Name Type Description
MountFailed

string

MountRequested

string

Mounted

string

UnmountFailed

string

UnmountRequested

string

Unmounted

string

network

network of this container.

Name Type Description
Bridge

string

Host

string

NodeStateCounts

Counts of various compute node states on the amlCompute.

Name Type Description
idleNodeCount

integer

Idle node count.
Number of compute nodes in idle state.

leavingNodeCount

integer

Leaving node count.
Number of compute nodes which are leaving the amlCompute.

preemptedNodeCount

integer

Preempted node count.
Number of compute nodes which are in preempted state.

preparingNodeCount

integer

Preparing node count.
Number of compute nodes which are being prepared.

runningNodeCount

integer

Running node count.
Number of compute nodes which are running jobs.

unusableNodeCount

integer

Unusable node count.
Number of compute nodes which are in unusable state.

OperationName

Name of the last operation.

Name Type Description
Create

string

Delete

string

Reimage

string

Restart

string

Start

string

Stop

string

OperationStatus

Operation status.

Name Type Description
CreateFailed

string

DeleteFailed

string

InProgress

string

ReimageFailed

string

RestartFailed

string

StartFailed

string

StopFailed

string

Succeeded

string

operationTrigger

Trigger of operation.

Name Type Description
IdleShutdown

string

Schedule

string

User

string

OsType

Compute OS Type

Name Type Description
Linux

string

Windows

string

PersonalComputeInstanceSettings

Settings for a personal compute instance.

Name Type Description
assignedUser

AssignedUser

Assigned User.
A user explicitly assigned to a personal compute instance.

Properties

AKS properties

Name Type Default Value Description
agentCount

integer

Number of agents

agentVmSize

string

Agent virtual machine size

aksNetworkingConfiguration

AksNetworkingConfiguration

AKS networking configuration for vnet

clusterFqdn

string

Cluster full qualified domain name

clusterPurpose

ClusterPurpose

FastProd

Intended usage of the cluster

loadBalancerSubnet

string

Load Balancer Subnet

loadBalancerType

LoadBalancerType

PublicIp

Load Balancer Type

sslConfiguration

SslConfiguration

SSL configuration

systemServices

SystemService[]

System services

protocol

Endpoint Communication Protocol

Name Type Description
http

string

tcp

string

udp

string

ProvisioningState

The current deployment state of workspace resource. The provisioningState is to indicate states for resource provisioning.

Name Type Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

Updating

string

provisioningStatus

The current deployment state of schedule.

Name Type Description
Completed

string

Failed

string

Provisioning

string

Recurrence

The workflow trigger recurrence for ComputeStartStop schedule type.

Name Type Default Value Description
frequency

ComputeRecurrenceFrequency

[Required] The frequency to trigger schedule.

interval

integer

[Required] Specifies schedule interval in conjunction with frequency

schedule

ComputeRecurrenceSchedule

[Required] The recurrence schedule.

startTime

string

The start time in yyyy-MM-ddTHH:mm:ss format.

timeZone

string

UTC

Specifies time zone in which the schedule runs. TimeZone should follow Windows time zone format. Refer: https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/default-time-zones?view=windows-11

remoteLoginPortPublicAccess

Close remote Login Access Port

Name Type Description
Disabled

string

Enabled

string

NotSpecified

string

ResourceId

Represents a resource ID. For example, for a subnet, it is the resource URL for the subnet.

Name Type Description
id

string

The ID of the resource

Resources

Resource requests/limits for this instance type

Name Type Description
limits

object

Resource limits for this instance type

requests

object

Resource requests for this instance type

ScaleSettings

scale settings for AML Compute

Name Type Default Value Description
maxNodeCount

integer

Max number of nodes to use

minNodeCount

integer

0

Min number of nodes to use

nodeIdleTimeBeforeScaleDown

string

Node Idle Time before scaling down amlCompute. This string needs to be in the RFC Format.

ScheduleBase

Name Type Description
id

string

A system assigned id for the schedule.

provisioningStatus

ScheduleProvisioningState

The current deployment state of schedule.

status

ScheduleStatus

Is the schedule enabled or disabled?

ScheduleProvisioningState

The current deployment state of schedule.

Name Type Description
Completed

string

Failed

string

Provisioning

string

ScheduleStatus

Is the schedule enabled or disabled?

Name Type Description
Disabled

string

Enabled

string

ScriptReference

Script reference

Name Type Description
scriptArguments

string

Optional command line arguments passed to the script to run.

scriptData

string

The location of scripts in the mounted volume.

scriptSource

string

The storage source of the script: workspace.

timeout

string

Optional time period passed to timeout command.

ScriptsToExecute

Customized setup scripts

Name Type Description
creationScript

ScriptReference

Script that's run only once during provision of the compute.

startupScript

ScriptReference

Script that's run every time the machine starts.

SetupScripts

Details of customized scripts to execute for setting up the cluster.

Name Type Description
scripts

ScriptsToExecute

Customized setup scripts

Sku

The resource model definition representing SKU

Name Type Description
capacity

integer

If the SKU supports scale out/in then the capacity integer should be included. If scale out/in is not possible for the resource this may be omitted.

family

string

If the service has different generations of hardware, for the same SKU, then that can be captured here.

name

string

The name of the SKU. Ex - P3. It is typically a letter+number code

size

string

The SKU size. When the name field is the combination of tier and some other value, this would be the standalone code.

tier

SkuTier

This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.

SkuTier

This field is required to be implemented by the Resource Provider if the service has more than one tier, but is not required on a PUT.

Name Type Description
Basic

string

Free

string

Premium

string

Standard

string

sourceType

Data source type.

Name Type Description
Dataset

string

Datastore

string

URI

string

sshPublicAccess

Access policy for SSH

Name Type Description
Disabled

string

Enabled

string

SslConfigStatus

Enable or disable ssl for scoring

Name Type Description
Auto

string

Disabled

string

Enabled

string

SslConfiguration

The ssl configuration for scoring

Name Type Description
cert

string

Cert data

cname

string

CNAME of the cert

key

string

Key data

leafDomainLabel

string

Leaf domain label of public endpoint

overwriteExistingDomain

boolean

Indicates whether to overwrite existing domain label.

status

SslConfigStatus

Enable or disable ssl for scoring

storageAccountType

type of this storage account.

Name Type Description
Premium_LRS

string

Standard_LRS

string

SynapseSpark

A SynapseSpark compute.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

SynapseSpark

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

Properties

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

systemData

Metadata pertaining to creation and last modification of the resource.

Name Type Description
createdAt

string

The timestamp of resource creation (UTC).

createdBy

string

The identity that created the resource.

createdByType

createdByType

The type of identity that created the resource.

lastModifiedAt

string

The timestamp of resource last modification (UTC)

lastModifiedBy

string

The identity that last modified the resource.

lastModifiedByType

createdByType

The type of identity that last modified the resource.

SystemService

A system service running on a compute.

Name Type Description
publicIpAddress

string

Public IP address

systemServiceType

string

The type of this system service.

version

string

The version for this type.

TmpfsOptions

Describes the tmpfs options for the container

Name Type Description
size

integer

Mention the Tmpfs size

UserAccountCredentials

Settings for user account that gets created on each on the nodes of a compute.

Name Type Description
adminUserName

string

User name.
Name of the administrator user account which can be used to SSH to nodes.

adminUserPassword

string

Password.
Password of the administrator user account.

adminUserSshPublicKey

string

SSH public key.
SSH public key of the administrator user account.

UserAssignedIdentity

User assigned identity properties

Name Type Description
clientId

string

The client ID of the assigned identity.

principalId

string

The principal ID of the assigned identity.

VirtualMachine

A Machine Learning compute based on Azure Virtual Machines.

Name Type Description
computeLocation

string

Location for the underlying compute

computeType string:

VirtualMachine

The type of compute

createdOn

string

The time at which the compute was created.

description

string

The description of the Machine Learning compute.

disableLocalAuth

boolean

Opt-out of local authentication and ensure customers can use only MSI and AAD exclusively for authentication.

isAttachedCompute

boolean

Indicating whether the compute was provisioned by user and brought from outside if true, or machine learning service provisioned it if false.

modifiedOn

string

The time at which the compute was last modified.

properties

Properties

provisioningErrors

ErrorResponse[]

Errors during provisioning

provisioningState

ProvisioningState

The provision state of the cluster. Valid values are Unknown, Updating, Provisioning, Succeeded, and Failed.

resourceId

string

ARM resource id of the underlying compute

VirtualMachineImage

Virtual Machine image for Windows AML Compute

Name Type Description
id

string

Virtual Machine image path

VirtualMachineSshCredentials

Admin credentials for virtual machine

Name Type Description
password

string

Password of admin account

privateKeyData

string

Private key data

publicKeyData

string

Public key data

username

string

Username of admin account

VmPriority

Virtual Machine priority

Name Type Description
Dedicated

string

LowPriority

string

VolumeDefinition

Describes the volume configuration for the container

Name Type Default Value Description
bind

BindOptions

Bind Options of the mount

consistency

string

Consistency of the volume

readOnly

boolean

Indicate whether to mount volume as readOnly. Default value for this is false.

source

string

Source of the mount. For bind mounts this is the host path.

target

string

Target of the mount. For bind mounts this is the path in the container.

tmpfs

TmpfsOptions

tmpfs option of the mount

type

VolumeDefinitionType

bind

Type of Volume Definition
Type of Volume Definition. Possible Values: bind,volume,tmpfs,npipe

volume

VolumeOptions

Volume Options of the mount

VolumeDefinitionType

Type of Volume Definition

Name Type Description
bind

string

npipe

string

tmpfs

string

volume

string

VolumeOptions

Describes the volume options for the container

Name Type Description
nocopy

boolean

Indicate whether volume is nocopy