Espaces de travail/calculs Microsoft.MachineLearningServices 2020-09-01-preview

Définition de ressource Bicep

Le type de ressource workspaces/computes peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.MachineLearningServices/workspaces/computes, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/computes@2020-09-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    computeLocation: 'string'
    description: 'string'
    resourceId: 'string'
    computeType: 'string'
    // For remaining properties, see Compute objects
  }
}

Objets de calcul

Définissez la propriété computeType pour spécifier le type d’objet.

Pour AKS, utilisez :

  computeType: 'AKS'
  properties: {
    agentCount: int
    agentVmSize: 'string'
    aksNetworkingConfiguration: {
      dnsServiceIP: 'string'
      dockerBridgeCidr: 'string'
      serviceCidr: 'string'
      subnetId: 'string'
    }
    clusterFqdn: 'string'
    sslConfiguration: {
      cert: 'string'
      cname: 'string'
      key: 'string'
      status: 'string'
    }
  }

Pour AmlCompute, utilisez :

  computeType: 'AmlCompute'
  properties: {
    enableNodePublicIp: bool
    isolatedNetwork: bool
    osType: 'string'
    remoteLoginPortPublicAccess: 'string'
    scaleSettings: {
      maxNodeCount: int
      minNodeCount: int
      nodeIdleTimeBeforeScaleDown: 'string'
    }
    subnet: {
      id: 'string'
    }
    userAccountCredentials: {
      adminUserName: 'string'
      adminUserPassword: 'string'
      adminUserSshPublicKey: 'string'
    }
    virtualMachineImage: {
      id: 'string'
    }
    vmPriority: 'string'
    vmSize: 'string'
  }

Pour ComputeInstance, utilisez :

  computeType: 'ComputeInstance'
  properties: {
    applicationSharingPolicy: 'string'
    computeInstanceAuthorizationType: 'personal'
    personalComputeInstanceSettings: {
      assignedUser: {
        objectId: 'string'
        tenantId: 'string'
      }
    }
    setupScripts: {
      scripts: {
        creationScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
        startupScript: {
          scriptArguments: 'string'
          scriptData: 'string'
          scriptSource: 'string'
          timeout: 'string'
        }
      }
    }
    sshSettings: {
      adminPublicKey: 'string'
      sshPublicAccess: 'string'
    }
    subnet: {
      id: 'string'
    }
    vmSize: 'string'
  }

Pour Databricks, utilisez :

  computeType: 'Databricks'
  properties: {
    databricksAccessToken: 'string'
  }

Pour DataFactory, utilisez :

  computeType: 'DataFactory'

Pour DataLakeAnalytics, utilisez :

  computeType: 'DataLakeAnalytics'
  properties: {
    dataLakeStoreAccountName: 'string'
  }

Pour HDInsight, utilisez :

  computeType: 'HDInsight'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    sshPort: int
  }

Pour VirtualMachine, utilisez :

  computeType: 'VirtualMachine'
  properties: {
    address: 'string'
    administratorAccount: {
      password: 'string'
      privateKeyData: 'string'
      publicKeyData: 'string'
      username: 'string'
    }
    sshPort: int
    virtualMachineSize: 'string'
  }

Valeurs de propriétés

workspaces/computes

Nom Description Valeur
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep.
string (obligatoire)

Limite de caractères : de 3 à 24 pour les instance de calcul
3-32 pour le calcul AML
2-16 pour les autres types de calcul

Caractères valides :
Caractères alphanumériques et traits d’union.
location Spécifie l’emplacement de la ressource. string
tags Contient des étiquettes de ressources définies en tant que paires clé/valeur. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence sku de l’espace de travail. Sku
parent Dans Bicep, vous pouvez spécifier la ressource parente pour une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente.
Nom symbolique pour la ressource de type : espaces de travail
identité Identité de la ressource. Identité
properties Propriétés de calcul Calcul

Identité

Nom Description Valeur
type Type d’identité. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Identités affectées par l’utilisateur associées à la ressource. UserAssignedIdentities

UserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Calcul

Nom Description Valeur
computeLocation Emplacement du calcul sous-jacent string
description Description du calcul Machine Learning. string
resourceId ID de ressource ARM du calcul sous-jacent string
computeType Définir le type d’objet AKS
AmlCompute
ComputeInstance
Databricks
DataFactory
DataLakeAnalytics
HDInsight
VirtualMachine (obligatoire)

AKS

Nom Description Valeur
computeType Type de calcul 'AKS' (obligatoire)
properties Propriétés AKS AKSProperties

AKSProperties

Nom Description Valeur
agentCount Nombre d'agents int

Contraintes :
Valeur minimale = 1
agentVmSize Taille de la machine virtuelle de l’agent string
aksNetworkingConfiguration Configuration réseau AKS pour le réseau virtuel AksNetworkingConfiguration
clusterFqdn Nom de domaine complet du cluster string
sslConfiguration Configuration SSL SslConfiguration

AksNetworkingConfiguration

Nom Description Valeur
dnsServiceIP Adresse IP affectée au service DNS Kubernetes. Il doit se trouver dans la plage d’adresses du service Kubernetes spécifiée dans serviceCidr. string

Contraintes :
Modèle = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr Plage d’adresses IP de notation CIDR attribuée au réseau de pont Docker. Il ne doit pas chevaucher les plages d’adresses IP du sous-réseau ou la plage d’adresses du service Kubernetes. string

Contraintes :
Modèle = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr Plage d’adresses IP de notation CIDR à partir de laquelle attribuer des adresses IP de cluster de service. Elle ne doit empiéter sur aucune plage d’adresses IP de sous-réseau. string

Contraintes :
Modèle = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul string

SslConfiguration

Nom Description Valeur
cert Données de certificat string
cname CNAME du certificat string
key Données clés string
status Activer ou désactiver ssl pour le scoring 'Auto'
'Désactivé'
'Enabled'

AmlCompute

Nom Description Valeur
computeType Type de calcul 'AmlCompute' (obligatoire)
properties Propriétés de calcul AML AmlComputeProperties

AmlComputeProperties

Nom Description Valeur
enableNodePublicIp Activez ou désactivez l’approvisionnement d’adresses IP publiques de nœud. Les valeurs possibles sont : les valeurs possibles sont : true : indique que les adresses IP publiques seront approvisionnées sur les nœuds de calcul. false : indique que les nœuds de calcul auront un point de terminaison privé et aucune adresse IP publique. bool
isolatedNetwork Le réseau est isolé ou non bool
osType Type de système d’exploitation de calcul 'Linux'
'Windows'
remoteLoginPortPublicAccess État du port SSH public. Les valeurs possibles sont : Désactivé : indique que le port ssh public est fermé sur tous les nœuds du cluster. Enabled : indique que le port SSH public est ouvert sur tous les nœuds du cluster. NotSpecified : indique que le port SSH public est fermé sur tous les nœuds du cluster si le réseau virtuel est défini, sinon il est ouvert sur tous les nœuds publics. La valeur par défaut est réservée à la création du cluster. Après la création, la valeur définie ne peut être que Disabled ou Enabled. 'Désactivé'
'Enabled'
'NotSpecified'
scaleSettings Paramètres de mise à l’échelle pour le calcul AML ScaleSettings
sous-réseau ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul. ResourceId
userAccountCredentials Informations d’identification d’un compte d’utilisateur administrateur qui sera créé sur chaque nœud de calcul. UserAccountCredentials
virtualMachineImage Image de machine virtuelle pour le calcul AML - windows uniquement VirtualMachineImage
vmPriority Priorité de machine virtuelle 'Dédié'
'LowPriority'
vmSize Taille de la machine virtuelle string

ScaleSettings

Nom Description Valeur
maxNodeCount Nombre maximal de nœuds à utiliser int (obligatoire)
minNodeCount Nombre minimal de nœuds à utiliser int
nodeIdleTimeBeforeScaleDown Temps d’inactivité du nœud avant la mise à l’échelle d’amlCompute. Cette chaîne doit être au format RFC. string

ResourceId

Nom Description Valeur
id ID de la ressource chaîne (obligatoire)

UserAccountCredentials

Nom Description Valeur
adminUsername Nom du compte d’utilisateur administrateur qui peut être utilisé pour ssh vers les nœuds. chaîne (obligatoire)
adminUserPassword Mot de passe du compte d’utilisateur administrateur. string
adminUserSshPublicKey Clé publique SSH du compte d’utilisateur administrateur. string

VirtualMachineImage

Nom Description Valeur
id Chemin d’accès à l’image de machine virtuelle string (obligatoire)

ComputeInstance

Nom Description Valeur
computeType Type de calcul 'ComputeInstance' (obligatoire)
properties Propriétés de l’instance de calcul ComputeInstanceProperties

ComputeInstanceProperties

Nom Description Valeur
applicationSharingPolicy Stratégie de partage d’applications sur ce instance de calcul entre les utilisateurs de l’espace de travail parent. Si la valeur est Personnelle, seul le créateur peut accéder aux applications sur cette instance de calcul. Lorsqu’il est partagé, tout utilisateur de l’espace de travail peut accéder aux applications sur ce instance en fonction de son rôle attribué. 'Personnel'
'Partagé'
computeInstanceAuthorizationType Type d’autorisation d’instance de calcul. Les valeurs disponibles sont personnelles (par défaut). 'personal'
personalComputeInstanceSettings Paramètres d’un instance de calcul personnel. PersonalComputeInstanceSettings
setupScripts Détails des scripts personnalisés à exécuter pour la configuration du cluster. SetupScripts
sshSettings Spécifie la stratégie et les paramètres pour l’accès SSH. ComputeInstanceSshSettings
sous-réseau ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul. ResourceId
vmSize Taille de la machine virtuelle string

PersonalComputeInstanceSettings

Nom Description Valeur
assignedUser Un utilisateur explicitement affecté à un instance de calcul personnel. AssignedUser

AssignedUser

Nom Description Valeur
objectId ID d’objet AAD de l’utilisateur. string (obligatoire)
tenantId ID de locataire AAD de l’utilisateur. string (obligatoire)

SetupScripts

Nom Description Valeur
Scripts Scripts d’installation personnalisés ScriptsToExecute

ScriptsToExecute

Nom Description Valeur
creationScript Script qui ne s’exécute qu’une seule fois lors de l’approvisionnement du calcul. ScriptReference
startupScript Script exécuté chaque fois que la machine démarre. ScriptReference

ScriptReference

Nom Description Valeur
scriptArguments Arguments de ligne de commande facultatifs passés au script à exécuter. string
scriptData Emplacement des scripts dans le volume monté. string
scriptSource Source de stockage du script : inline, workspace. string
timeout Période facultative passée à la commande timeout. string

ComputeInstanceSshSettings

Nom Description Valeur
adminPublicKey Spécifie le fichier de clé publique SSH rsa sous forme de chaîne. Utilisez « ssh-keygen -t rsa -b 2048 » pour générer vos paires de clés SSH. string
sshPublicAccess État du port SSH public. Les valeurs possibles sont : Désactivé : indique que le port ssh public est fermé sur cette instance. Activé : indique que le port ssh public est ouvert et accessible en fonction de la stratégie de réseau virtuel/sous-réseau, le cas échéant. 'Désactivé'
'Enabled'

Databricks

Nom Description Valeur
computeType Type de calcul 'Databricks' (obligatoire)
properties DatabricksProperties

DatabricksProperties

Nom Description Valeur
databricksAccessToken Jeton d’accès Databricks string

DataFactory

Nom Description Valeur
computeType Type de calcul 'DataFactory' (obligatoire)

DataLakeAnalytics

Nom Description Valeur
computeType Type de calcul 'DataLakeAnalytics' (obligatoire)
properties DataLakeAnalyticsProperties

DataLakeAnalyticsProperties

Nom Description Valeur
dataLakeStoreAccountName Nom du compte DataLake Store string

HDInsight

Nom Description Valeur
computeType Type de calcul 'HDInsight' (obligatoire)
properties HDInsightProperties

HDInsightProperties

Nom Description Valeur
address Adresse IP publique du nœud master du cluster. string
administratorAccount Administration informations d’identification pour master nœud du cluster VirtualMachineSshCredentials
sshPort Port ouvert pour les connexions ssh sur le nœud master du cluster. int

VirtualMachineSshCredentials

Nom Description Valeur
mot de passe Mot de passe du compte d’administrateur string
privateKeyData Données de clé privée string
publicKeyData Données de clé publique string
username Nom d’utilisateur du compte d’administrateur string

VirtualMachine

Nom Description Valeur
computeType Type de calcul 'VirtualMachine' (obligatoire)
properties VirtualMachineProperties

VirtualMachineProperties

Nom Description Valeur
address Adresse IP publique de la machine virtuelle. string
administratorAccount Administration informations d’identification pour la machine virtuelle VirtualMachineSshCredentials
sshPort Port ouvert pour les connexions ssh. int
virtualMachineSize Taille de la machine virtuelle string

Sku

Nom Description Valeur
name Nom de la référence sku string
Niveau Niveau de la référence sku comme De base ou Entreprise string

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Créer un calcul ADLA du service Machine Learning

Déployer sur Azure
Ce modèle crée un calcul ADLA du service Machine Learning.
Créer un service Machine Learning Service Aks Compute

Déployer sur Azure
Ce modèle crée un calcul Aks du service Machine Learning.
Créer un calcul DSVM Service Machine Learning

Déployer sur Azure
Ce modèle crée un calcul DSVM Du service Machine Learning.
Créer un cluster HDInsight Du service Machine Learning

Déployer sur Azure
Ce modèle crée un cluster HDInsight Du service Machine Learning
Créer un calcul aks Azure Machine Learning

Déployer sur Azure
Ce modèle crée un calcul aks Azure Machine Learning.
Créer un cluster de calcul Azure Machine Learning

Déployer sur Azure
Ce modèle crée un cluster de calcul Azure Machine Learning.
Créer une instance de calcul Azure Machine Learning

Déployer sur Azure
Ce modèle crée un instance de calcul Azure Machine Learning pour le compte d’un autre utilisateur avec un exemple de script d’installation en ligne
Créer un LinkedService dans l’espace de travail Azure Machine Learning

Déployer sur Azure
Ce modèle crée un LinkedService dans un espace de travail Azure Machine Learning existant.
Créer une cible de calcul AKS avec une adresse IP privée

Déployer sur Azure
Ce modèle crée une cible de calcul AKS dans un espace de travail de service Azure Machine Learning donné avec une adresse IP privée.

Définition de ressources de modèle ARM

Le type de ressource espaces de travail/calculs peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.MachineLearningServices/workspaces/computes, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.MachineLearningServices/workspaces/computes",
  "apiVersion": "2020-09-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "computeLocation": "string",
    "description": "string",
    "resourceId": "string",
    "computeType": "string"
    // For remaining properties, see Compute objects
  }
}

Objets de calcul

Définissez la propriété computeType pour spécifier le type d’objet.

Pour AKS, utilisez :

  "computeType": "AKS",
  "properties": {
    "agentCount": "int",
    "agentVmSize": "string",
    "aksNetworkingConfiguration": {
      "dnsServiceIP": "string",
      "dockerBridgeCidr": "string",
      "serviceCidr": "string",
      "subnetId": "string"
    },
    "clusterFqdn": "string",
    "sslConfiguration": {
      "cert": "string",
      "cname": "string",
      "key": "string",
      "status": "string"
    }
  }

Pour AmlCompute, utilisez :

  "computeType": "AmlCompute",
  "properties": {
    "enableNodePublicIp": "bool",
    "isolatedNetwork": "bool",
    "osType": "string",
    "remoteLoginPortPublicAccess": "string",
    "scaleSettings": {
      "maxNodeCount": "int",
      "minNodeCount": "int",
      "nodeIdleTimeBeforeScaleDown": "string"
    },
    "subnet": {
      "id": "string"
    },
    "userAccountCredentials": {
      "adminUserName": "string",
      "adminUserPassword": "string",
      "adminUserSshPublicKey": "string"
    },
    "virtualMachineImage": {
      "id": "string"
    },
    "vmPriority": "string",
    "vmSize": "string"
  }

Pour ComputeInstance, utilisez :

  "computeType": "ComputeInstance",
  "properties": {
    "applicationSharingPolicy": "string",
    "computeInstanceAuthorizationType": "personal",
    "personalComputeInstanceSettings": {
      "assignedUser": {
        "objectId": "string",
        "tenantId": "string"
      }
    },
    "setupScripts": {
      "scripts": {
        "creationScript": {
          "scriptArguments": "string",
          "scriptData": "string",
          "scriptSource": "string",
          "timeout": "string"
        },
        "startupScript": {
          "scriptArguments": "string",
          "scriptData": "string",
          "scriptSource": "string",
          "timeout": "string"
        }
      }
    },
    "sshSettings": {
      "adminPublicKey": "string",
      "sshPublicAccess": "string"
    },
    "subnet": {
      "id": "string"
    },
    "vmSize": "string"
  }

Pour Databricks, utilisez :

  "computeType": "Databricks",
  "properties": {
    "databricksAccessToken": "string"
  }

Pour DataFactory, utilisez :

  "computeType": "DataFactory"

Pour DataLakeAnalytics, utilisez :

  "computeType": "DataLakeAnalytics",
  "properties": {
    "dataLakeStoreAccountName": "string"
  }

Pour HDInsight, utilisez :

  "computeType": "HDInsight",
  "properties": {
    "address": "string",
    "administratorAccount": {
      "password": "string",
      "privateKeyData": "string",
      "publicKeyData": "string",
      "username": "string"
    },
    "sshPort": "int"
  }

Pour VirtualMachine, utilisez :

  "computeType": "VirtualMachine",
  "properties": {
    "address": "string",
    "administratorAccount": {
      "password": "string",
      "privateKeyData": "string",
      "publicKeyData": "string",
      "username": "string"
    },
    "sshPort": "int",
    "virtualMachineSize": "string"
  }

Valeurs de propriétés

workspaces/computes

Nom Description Valeur
type Type de ressource « Microsoft.MachineLearningServices/workspaces/computes »
apiVersion Version de l’API de ressource « 2020-09-01-preview »
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON.
chaîne (obligatoire)

Limite de caractères : de 3 à 24 pour les instance de calcul
3-32 pour le calcul AML
2-16 pour les autres types de calcul

Caractères valides :
Caractères alphanumériques et traits d’union.
location Spécifie l’emplacement de la ressource. string
tags Contient des balises de ressources définies en tant que paires clé/valeur. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence sku de l’espace de travail. Sku
identité Identité de la ressource. Identité
properties Propriétés de calcul Calcul

Identité

Nom Description Valeur
type Type d’identité. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'
userAssignedIdentities Identités affectées par l’utilisateur associées à la ressource. UserAssignedIdentities

UserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Calcul

Nom Description Valeur
computeLocation Emplacement du calcul sous-jacent string
description Description du calcul Machine Learning. string
resourceId ID de ressource ARM du calcul sous-jacent string
computeType Définir le type d’objet AKS
AmlCompute
ComputeInstance
Databricks
DataFactory
DataLakeAnalytics
HDInsight
VirtualMachine (obligatoire)

AKS

Nom Description Valeur
computeType Type de calcul 'AKS' (obligatoire)
properties Propriétés AKS AKSProperties

AKSProperties

Nom Description Valeur
agentCount Nombre d'agents int

Contraintes :
Valeur minimale = 1
agentVmSize Taille de la machine virtuelle de l’agent string
aksNetworkingConfiguration Configuration réseau AKS pour le réseau virtuel AksNetworkingConfiguration
clusterFqdn Nom de domaine complet du cluster string
sslConfiguration Configuration SSL SslConfiguration

AksNetworkingConfiguration

Nom Description Valeur
dnsServiceIP Adresse IP affectée au service DNS Kubernetes. Il doit se trouver dans la plage d’adresses du service Kubernetes spécifiée dans serviceCidr. string

Contraintes :
Modèle = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr Plage d’adresses IP de notation CIDR attribuée au réseau de pont Docker. Il ne doit pas chevaucher les plages d’adresses IP du sous-réseau ou la plage d’adresses du service Kubernetes. string

Contraintes :
Modèle = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr Plage d’adresses IP de notation CIDR à partir de laquelle attribuer des adresses IP de cluster de service. Elle ne doit empiéter sur aucune plage d’adresses IP de sous-réseau. string

Contraintes :
Modèle = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul string

SslConfiguration

Nom Description Valeur
cert Données de certificat string
cname CNAME du certificat string
key Données clés string
status Activer ou désactiver ssl pour le scoring 'Auto'
'Désactivé'
'Enabled'

AmlCompute

Nom Description Valeur
computeType Type de calcul 'AmlCompute' (obligatoire)
properties Propriétés de calcul AML AmlComputeProperties

AmlComputeProperties

Nom Description Valeur
enableNodePublicIp Activer ou désactiver l’approvisionnement d’adresses IP publiques de nœud. Les valeurs possibles sont les suivantes : les valeurs possibles sont : true : indique que les nœuds de calcul auront des adresses IP publiques approvisionnées. false : indique que les nœuds de calcul auront un point de terminaison privé et aucune adresse IP publique. bool
isolatedNetwork Le réseau est isolé ou non bool
osType Type de système d’exploitation de calcul 'Linux'
'Windows'
remoteLoginPortPublicAccess État du port SSH public. Les valeurs possibles sont : Désactivé : indique que le port ssh public est fermé sur tous les nœuds du cluster. Enabled : indique que le port SSH public est ouvert sur tous les nœuds du cluster. NotSpecified : indique que le port SSH public est fermé sur tous les nœuds du cluster si le réseau virtuel est défini, sinon il est ouvert sur tous les nœuds publics. La valeur par défaut est réservée à la création du cluster. Après la création, la valeur définie ne peut être que Disabled ou Enabled. 'Désactivé'
'Enabled'
'NotSpecified'
scaleSettings Paramètres de mise à l’échelle pour le calcul AML ScaleSettings
sous-réseau ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul. ResourceId
userAccountCredentials Informations d’identification d’un compte d’utilisateur administrateur qui sera créé sur chaque nœud de calcul. UserAccountCredentials
virtualMachineImage Image de machine virtuelle pour le calcul AML - Windows uniquement VirtualMachineImage
vmPriority Priorité de la machine virtuelle 'Dedicated'
'LowPriority'
vmSize Taille de la machine virtuelle string

ScaleSettings

Nom Description Valeur
maxNodeCount Nombre maximal de nœuds à utiliser int (obligatoire)
minNodeCount Nombre minimal de nœuds à utiliser int
nodeIdleTimeBeforeScaleDown Temps d’inactivité du nœud avant le scale-down amlCompute. Cette chaîne doit être au format RFC. string

ResourceId

Nom Description Valeur
id ID de la ressource string (obligatoire)

UserAccountCredentials

Nom Description Valeur
adminUsername Nom du compte d’utilisateur administrateur qui peut être utilisé pour établir une connexion SSH aux nœuds. string (obligatoire)
adminUserPassword Mot de passe du compte d’utilisateur administrateur. string
adminUserSshPublicKey Clé publique SSH du compte d’utilisateur administrateur. string

VirtualMachineImage

Nom Description Valeur
id Chemin d’accès à l’image de machine virtuelle string (obligatoire)

ComputeInstance

Nom Description Valeur
computeType Type de calcul 'ComputeInstance' (obligatoire)
properties Propriétés de l’instance de calcul ComputeInstanceProperties

ComputeInstanceProperties

Nom Description Valeur
applicationSharingPolicy Stratégie de partage d’applications sur ce instance de calcul entre les utilisateurs de l’espace de travail parent. Si la valeur est Personnelle, seul le créateur peut accéder aux applications sur cette instance de calcul. Lorsqu’il est partagé, tout utilisateur de l’espace de travail peut accéder aux applications sur ce instance en fonction de son rôle attribué. 'Personnel'
'Partagé'
computeInstanceAuthorizationType Type d’autorisation d’instance de calcul. Les valeurs disponibles sont personnelles (par défaut). 'personal'
personalComputeInstanceSettings Paramètres d’un instance de calcul personnel. PersonalComputeInstanceSettings
setupScripts Détails des scripts personnalisés à exécuter pour la configuration du cluster. SetupScripts
sshSettings Spécifie la stratégie et les paramètres pour l’accès SSH. ComputeInstanceSshSettings
sous-réseau ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul. ResourceId
vmSize Taille de la machine virtuelle string

PersonalComputeInstanceSettings

Nom Description Valeur
assignedUser Un utilisateur explicitement affecté à un instance de calcul personnel. AssignedUser

AssignedUser

Nom Description Valeur
objectId ID d’objet AAD de l’utilisateur. string (obligatoire)
tenantId ID de locataire AAD de l’utilisateur. string (obligatoire)

SetupScripts

Nom Description Valeur
Scripts Scripts d’installation personnalisés ScriptsToExecute

ScriptsToExecute

Nom Description Valeur
creationScript Script qui ne s’exécute qu’une seule fois lors de l’approvisionnement du calcul. ScriptReference
startupScript Script exécuté chaque fois que la machine démarre. ScriptReference

ScriptReference

Nom Description Valeur
scriptArguments Arguments de ligne de commande facultatifs passés au script à exécuter. string
scriptData Emplacement des scripts dans le volume monté. string
scriptSource Source de stockage du script : inline, workspace. string
timeout Période facultative passée à la commande timeout. string

ComputeInstanceSshSettings

Nom Description Valeur
adminPublicKey Spécifie le fichier de clé publique SSH rsa sous forme de chaîne. Utilisez « ssh-keygen -t rsa -b 2048 » pour générer vos paires de clés SSH. string
sshPublicAccess État du port SSH public. Les valeurs possibles sont : Désactivé : indique que le port ssh public est fermé sur ce instance. Activé : indique que le port ssh public est ouvert et accessible conformément à la stratégie de réseau virtuel/sous-réseau, le cas échéant. 'Désactivé'
'Enabled'

Databricks

Nom Description Valeur
computeType Type de calcul 'Databricks' (obligatoire)
properties DatabricksProperties

DatabricksProperties

Nom Description Valeur
databricksAccessToken Jeton d’accès Databricks string

DataFactory

Nom Description Valeur
computeType Type de calcul 'DataFactory' (obligatoire)

DataLakeAnalytics

Nom Description Valeur
computeType Type de calcul 'DataLakeAnalytics' (obligatoire)
properties DataLakeAnalyticsProperties

DataLakeAnalyticsProperties

Nom Description Valeur
dataLakeStoreAccountName Nom du compte DataLake Store string

HDInsight

Nom Description Valeur
computeType Type de calcul 'HDInsight' (obligatoire)
properties HDInsightProperties

HDInsightProperties

Nom Description Valeur
address Adresse IP publique du nœud master du cluster. string
administratorAccount Administration informations d’identification pour master nœud du cluster VirtualMachineSshCredentials
sshPort Port ouvert pour les connexions ssh sur le nœud master du cluster. int

VirtualMachineSshCredentials

Nom Description Valeur
mot de passe Mot de passe du compte administrateur string
privateKeyData Données de clé privée string
publicKeyData Données de clé publique string
username Nom d’utilisateur du compte administrateur string

VirtualMachine

Nom Description Valeur
computeType Type de calcul 'VirtualMachine' (obligatoire)
properties VirtualMachineProperties

VirtualMachineProperties

Nom Description Valeur
address Adresse IP publique de la machine virtuelle. string
administratorAccount Administration informations d’identification pour la machine virtuelle VirtualMachineSshCredentials
sshPort Port ouvert pour les connexions ssh. int
virtualMachineSize Taille de la machine virtuelle string

Sku

Nom Description Valeur
name Nom de la référence SKU string
Niveau Niveau de la référence (SKU) comme De base ou Enterprise string

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Créer un calcul ADLA du service Machine Learning

Déployer sur Azure
Ce modèle crée un calcul ADLA du service Machine Learning.
Créer un service Machine Learning Service Aks Compute

Déployer sur Azure
Ce modèle crée un service Machine Learning Service Aks Compute.
Créer un calcul DSVM Machine Learning Service

Déployer sur Azure
Ce modèle crée un calcul DSVM Du service Machine Learning.
Créer un cluster HDInsight De Machine Learning Service

Déployer sur Azure
Ce modèle crée un cluster HDInsight de Service Machine Learning
Créer un calcul aks Azure Machine Learning

Déployer sur Azure
Ce modèle crée un calcul aks Azure Machine Learning.
Créer un cluster de calcul Azure Machine Learning

Déployer sur Azure
Ce modèle crée un cluster de calcul Azure Machine Learning.
Créer une instance de calcul Azure Machine Learning

Déployer sur Azure
Ce modèle crée un instance de calcul Azure Machine Learning pour le compte d’un autre utilisateur avec un exemple de script d’installation en ligne
Créer un LinkedService dans l’espace de travail Azure Machine Learning

Déployer sur Azure
Ce modèle crée un LinkedService dans un espace de travail Azure Machine Learning existant.
Créer une cible de calcul AKS avec une adresse IP privée

Déployer sur Azure
Ce modèle crée une cible de calcul AKS dans un espace de travail de service Azure Machine Learning donné avec une adresse IP privée.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource workspaces/computes peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.MachineLearningServices/workspaces/computes, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/computes@2020-09-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      computeLocation = "string"
      description = "string"
      resourceId = "string"
      computeType = "string"
      // For remaining properties, see Compute objects
    }
    sku = {
      name = "string"
      tier = "string"
    }
  })
}

Objets de calcul

Définissez la propriété computeType pour spécifier le type d’objet.

Pour AKS, utilisez :

  computeType = "AKS"
  properties = {
    agentCount = int
    agentVmSize = "string"
    aksNetworkingConfiguration = {
      dnsServiceIP = "string"
      dockerBridgeCidr = "string"
      serviceCidr = "string"
      subnetId = "string"
    }
    clusterFqdn = "string"
    sslConfiguration = {
      cert = "string"
      cname = "string"
      key = "string"
      status = "string"
    }
  }

Pour AmlCompute, utilisez :

  computeType = "AmlCompute"
  properties = {
    enableNodePublicIp = bool
    isolatedNetwork = bool
    osType = "string"
    remoteLoginPortPublicAccess = "string"
    scaleSettings = {
      maxNodeCount = int
      minNodeCount = int
      nodeIdleTimeBeforeScaleDown = "string"
    }
    subnet = {
      id = "string"
    }
    userAccountCredentials = {
      adminUserName = "string"
      adminUserPassword = "string"
      adminUserSshPublicKey = "string"
    }
    virtualMachineImage = {
      id = "string"
    }
    vmPriority = "string"
    vmSize = "string"
  }

Pour ComputeInstance, utilisez :

  computeType = "ComputeInstance"
  properties = {
    applicationSharingPolicy = "string"
    computeInstanceAuthorizationType = "personal"
    personalComputeInstanceSettings = {
      assignedUser = {
        objectId = "string"
        tenantId = "string"
      }
    }
    setupScripts = {
      scripts = {
        creationScript = {
          scriptArguments = "string"
          scriptData = "string"
          scriptSource = "string"
          timeout = "string"
        }
        startupScript = {
          scriptArguments = "string"
          scriptData = "string"
          scriptSource = "string"
          timeout = "string"
        }
      }
    }
    sshSettings = {
      adminPublicKey = "string"
      sshPublicAccess = "string"
    }
    subnet = {
      id = "string"
    }
    vmSize = "string"
  }

Pour Databricks, utilisez :

  computeType = "Databricks"
  properties = {
    databricksAccessToken = "string"
  }

Pour DataFactory, utilisez :

  computeType = "DataFactory"

Pour DataLakeAnalytics, utilisez :

  computeType = "DataLakeAnalytics"
  properties = {
    dataLakeStoreAccountName = "string"
  }

Pour HDInsight, utilisez :

  computeType = "HDInsight"
  properties = {
    address = "string"
    administratorAccount = {
      password = "string"
      privateKeyData = "string"
      publicKeyData = "string"
      username = "string"
    }
    sshPort = int
  }

Pour VirtualMachine, utilisez :

  computeType = "VirtualMachine"
  properties = {
    address = "string"
    administratorAccount = {
      password = "string"
      privateKeyData = "string"
      publicKeyData = "string"
      username = "string"
    }
    sshPort = int
    virtualMachineSize = "string"
  }

Valeurs de propriétés

workspaces/computes

Nom Description Valeur
type Type de ressource « Microsoft.MachineLearningServices/workspaces/computes@2020-09-01-preview »
name Nom de la ressource string (obligatoire)

Limite de caractères : de 3 à 24 pour les instance de calcul
3-32 pour le calcul AML
2-16 pour les autres types de calcul

Caractères valides :
Caractères alphanumériques et traits d’union.
location Spécifie l’emplacement de la ressource. string
parent_id ID de la ressource qui est le parent de cette ressource. ID pour la ressource de type : espaces de travail
tags Contient des étiquettes de ressources définies en tant que paires clé/valeur. Dictionnaire de noms et de valeurs d’étiquettes.
sku Référence sku de l’espace de travail. Sku
identité Identité de la ressource. Identité
properties Propriétés de calcul Calcul

Identité

Nom Description Valeur
type Type d’identité. « SystemAssigned »
« SystemAssigned,UserAssigned »
« UserAssigned »
identity_ids Identités affectées par l’utilisateur associées à la ressource. Tableau d’ID d’identité utilisateur.

UserAssignedIdentities

Nom Description Valeur
{propriété personnalisée} userAssignedIdentity

userAssignedIdentity

Cet objet ne contient aucune propriété à définir pendant le déploiement. Toutes les propriétés sont ReadOnly.

Calcul

Nom Description Valeur
computeLocation Emplacement du calcul sous-jacent string
description Description du calcul Machine Learning. string
resourceId ID de ressource ARM du calcul sous-jacent string
computeType Définir le type d’objet AKS
AmlCompute
ComputeInstance
Databricks
DataFactory
DataLakeAnalytics
HDInsight
VirtualMachine (obligatoire)

AKS

Nom Description Valeur
computeType Type de calcul « AKS » (obligatoire)
properties Propriétés AKS AKSProperties

AKSProperties

Nom Description Valeur
agentCount Nombre d'agents int

Contraintes :
Valeur minimale = 1
agentVmSize Taille de la machine virtuelle de l’agent string
aksNetworkingConfiguration Configuration de la mise en réseau AKS pour le réseau virtuel AksNetworkingConfiguration
clusterFqdn Nom de domaine complet du cluster string
sslConfiguration Configuration SSL SslConfiguration

AksNetworkingConfiguration

Nom Description Valeur
dnsServiceIP Adresse IP affectée au service DNS Kubernetes. Il doit se trouver dans la plage d’adresses du service Kubernetes spécifiée dans serviceCidr. string

Contraintes :
Modèle = ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
dockerBridgeCidr Plage d’adresses IP de notation CIDR affectée au réseau de pont Docker. Il ne doit pas chevaucher les plages d’adresses IP de sous-réseau ou la plage d’adresses du service Kubernetes. string

Contraintes :
Modèle = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
serviceCidr Plage d’adresses IP de notation CIDR à partir de laquelle attribuer des adresses IP de cluster de service. Elle ne doit empiéter sur aucune plage d’adresses IP de sous-réseau. string

Contraintes :
Modèle = ^([0-9]{1,3}\.){3}[0-9]{1,3}(\/([0-9]|[1-2][0-9]|3[0-2]))?$
subnetId ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul string

SslConfiguration

Nom Description Valeur
cert Données de certificat string
cname CNAME du certificat string
key Données clés string
status Activer ou désactiver ssl pour le scoring « Auto »
« Désactivé »
« Activé »

AmlCompute

Nom Description Valeur
computeType Type de calcul « AmlCompute » (obligatoire)
properties Propriétés de calcul AML AmlComputeProperties

AmlComputeProperties

Nom Description Valeur
enableNodePublicIp Activez ou désactivez l’approvisionnement d’adresses IP publiques de nœud. Les valeurs possibles sont : les valeurs possibles sont : true : indique que les adresses IP publiques seront approvisionnées sur les nœuds de calcul. false : indique que les nœuds de calcul auront un point de terminaison privé et aucune adresse IP publique. bool
isolatedNetwork Le réseau est isolé ou non bool
osType Type de système d’exploitation de calcul « Linux »
« Windows »
remoteLoginPortPublicAccess État du port SSH public. Les valeurs possibles sont : Désactivé : indique que le port ssh public est fermé sur tous les nœuds du cluster. Enabled : indique que le port SSH public est ouvert sur tous les nœuds du cluster. NotSpecified : indique que le port SSH public est fermé sur tous les nœuds du cluster si le réseau virtuel est défini, sinon il est ouvert sur tous les nœuds publics. La valeur par défaut est réservée à la création du cluster. Après la création, la valeur définie ne peut être que Disabled ou Enabled. « Désactivé »
« Activé »
« NotSpecified »
scaleSettings Paramètres de mise à l’échelle pour le calcul AML ScaleSettings
sous-réseau ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul. ResourceId
userAccountCredentials Informations d’identification d’un compte d’utilisateur administrateur qui sera créé sur chaque nœud de calcul. UserAccountCredentials
virtualMachineImage Image de machine virtuelle pour le calcul AML - windows uniquement VirtualMachineImage
vmPriority Priorité de machine virtuelle « Dédié »
« LowPriority »
vmSize Taille de la machine virtuelle string

ScaleSettings

Nom Description Valeur
maxNodeCount Nombre maximal de nœuds à utiliser int (obligatoire)
minNodeCount Nombre minimal de nœuds à utiliser int
nodeIdleTimeBeforeScaleDown Temps d’inactivité du nœud avant la mise à l’échelle d’amlCompute. Cette chaîne doit être au format RFC. string

ResourceId

Nom Description Valeur
id ID de la ressource chaîne (obligatoire)

UserAccountCredentials

Nom Description Valeur
adminUsername Nom du compte d’utilisateur administrateur qui peut être utilisé pour ssh vers les nœuds. chaîne (obligatoire)
adminUserPassword Mot de passe du compte d’utilisateur administrateur. string
adminUserSshPublicKey Clé publique SSH du compte d’utilisateur administrateur. string

VirtualMachineImage

Nom Description Valeur
id Chemin d’accès à l’image de machine virtuelle chaîne (obligatoire)

ComputeInstance

Nom Description Valeur
computeType Type de calcul « ComputeInstance » (obligatoire)
properties Propriétés de l’instance de calcul ComputeInstanceProperties

ComputeInstanceProperties

Nom Description Valeur
applicationSharingPolicy Stratégie de partage d’applications sur cette instance de calcul entre les utilisateurs de l’espace de travail parent. S’il est personnel, seul le créateur peut accéder aux applications sur cette instance de calcul. Lorsqu’il est partagé, tout utilisateur de l’espace de travail peut accéder aux applications sur ce instance en fonction du rôle qu’il lui a attribué. « Personnel »
« Partagé »
computeInstanceAuthorizationType Type d’autorisation d’instance de calcul. Les valeurs disponibles sont personnelles (valeur par défaut). « personnel »
personalComputeInstanceSettings Paramètres d’un instance de calcul personnel. PersonalComputeInstanceSettings
setupScripts Détails des scripts personnalisés à exécuter pour la configuration du cluster. SetupScripts
sshSettings Spécifie la stratégie et les paramètres pour l’accès SSH. ComputeInstanceSshSettings
sous-réseau ID de ressource de sous-réseau de réseau virtuel auquel appartiennent les nœuds de calcul. ResourceId
vmSize Taille de la machine virtuelle string

PersonalComputeInstanceSettings

Nom Description Valeur
assignedUser Un utilisateur explicitement affecté à un instance de calcul personnel. AssignedUser

AssignedUser

Nom Description Valeur
objectId ID d’objet AAD de l’utilisateur. chaîne (obligatoire)
tenantId ID de locataire AAD de l’utilisateur. chaîne (obligatoire)

SetupScripts

Nom Description Valeur
Scripts Scripts d’installation personnalisés ScriptsToExecute

ScriptsToExecute

Nom Description Valeur
creationScript Script qui n’est exécuté qu’une seule fois lors de l’approvisionnement du calcul. ScriptReference
startupScript Script exécuté chaque fois que la machine démarre. ScriptReference

ScriptReference

Nom Description Valeur
scriptArguments Arguments de ligne de commande facultatifs passés au script à exécuter. string
scriptData Emplacement des scripts dans le volume monté. string
scriptSource Source de stockage du script : inline, espace de travail. string
timeout Période de temps facultative passée à la commande timeout. string

ComputeInstanceSshSettings

Nom Description Valeur
adminPublicKey Spécifie le fichier de clé publique SSH rsa en tant que chaîne. Utilisez « ssh-keygen -t rsa -b 2048 » pour générer vos paires de clés SSH. string
sshPublicAccess État du port SSH public. Les valeurs possibles sont : Désactivé : indique que le port ssh public est fermé sur cette instance. Activé : indique que le port ssh public est ouvert et accessible en fonction de la stratégie de réseau virtuel/sous-réseau, le cas échéant. « Désactivé »
« Activé »

Databricks

Nom Description Valeur
computeType Type de calcul « Databricks » (obligatoire)
properties DatabricksProperties

DatabricksProperties

Nom Description Valeur
databricksAccessToken Jeton d’accès Databricks string

DataFactory

Nom Description Valeur
computeType Type de calcul « DataFactory » (obligatoire)

DataLakeAnalytics

Nom Description Valeur
computeType Type de calcul « DataLakeAnalytics » (obligatoire)
properties DataLakeAnalyticsProperties

DataLakeAnalyticsProperties

Nom Description Valeur
dataLakeStoreAccountName Nom du compte DataLake Store string

HDInsight

Nom Description Valeur
computeType Type de calcul « HDInsight » (obligatoire)
properties HDInsightProperties

HDInsightProperties

Nom Description Valeur
address Adresse IP publique du nœud master du cluster. string
administratorAccount Administration informations d’identification pour master nœud du cluster VirtualMachineSshCredentials
sshPort Port ouvert pour les connexions ssh sur le nœud master du cluster. int

VirtualMachineSshCredentials

Nom Description Valeur
mot de passe Mot de passe du compte d’administrateur string
privateKeyData Données de clé privée string
publicKeyData Données de clé publique string
username Nom d’utilisateur du compte d’administrateur string

VirtualMachine

Nom Description Valeur
computeType Type de calcul « VirtualMachine » (obligatoire)
properties VirtualMachineProperties

VirtualMachineProperties

Nom Description Valeur
address Adresse IP publique de la machine virtuelle. string
administratorAccount Administration informations d’identification pour la machine virtuelle VirtualMachineSshCredentials
sshPort Port ouvert pour les connexions ssh. int
virtualMachineSize Taille de la machine virtuelle string

Sku

Nom Description Valeur
name Nom de la référence sku string
Niveau Niveau de la référence sku comme De base ou Entreprise string