Espaces de travail/travaux Microsoft.MachineLearningServices 2021-03-01-preview

Définition de ressource Bicep

Le type de ressource espaces de travail/travaux 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/jobs, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    description: 'string'
    properties: {
      {customized property}: 'string'
    }
    tags: {
      {customized property}: 'string'
    }
    jobType: 'string'
    // For remaining properties, see JobBase objects
  }
}

Objets JobBase

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

Pour Command, utilisez :

  jobType: 'Command'
  codeId: 'string'
  command: 'string'
  compute: {
    instanceCount: int
    instanceType: 'string'
    isLocal: bool
    location: 'string'
    properties: {
      {customized property}: 'string'
    }
    target: 'string'
  }
  distribution: {
    distributionType: 'string'
    // For remaining properties, see DistributionConfiguration objects
  }
  environmentId: 'string'
  environmentVariables: {
    {customized property}: 'string'
  }
  experimentName: 'string'
  identity: {
    identityType: 'string'
    // For remaining properties, see IdentityConfiguration objects
  }
  inputDataBindings: {
    {customized property}: {
      dataId: 'string'
      mode: 'string'
      pathOnCompute: 'string'
    }
  }
  outputDataBindings: {
    {customized property}: {
      datastoreId: 'string'
      mode: 'string'
      pathOnCompute: 'string'
      pathOnDatastore: 'string'
    }
  }
  priority: int
  timeout: 'string'

Pour Balayage, utilisez :

  jobType: 'Sweep'
  algorithm: 'string'
  compute: {
    instanceCount: int
    instanceType: 'string'
    isLocal: bool
    location: 'string'
    properties: {
      {customized property}: 'string'
    }
    target: 'string'
  }
  earlyTermination: {
    delayEvaluation: int
    evaluationInterval: int
    policyType: 'string'
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  experimentName: 'string'
  identity: {
    identityType: 'string'
    // For remaining properties, see IdentityConfiguration objects
  }
  maxConcurrentTrials: int
  maxTotalTrials: int
  objective: {
    goal: 'string'
    primaryMetric: 'string'
  }
  priority: int
  searchSpace: {
    {customized property}: any()
  }
  timeout: 'string'
  trial: {
    codeId: 'string'
    command: 'string'
    distribution: {
      distributionType: 'string'
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId: 'string'
    environmentVariables: {
      {customized property}: 'string'
    }
    inputDataBindings: {
      {customized property}: {
        dataId: 'string'
        mode: 'string'
        pathOnCompute: 'string'
      }
    }
    outputDataBindings: {
      {customized property}: {
        datastoreId: 'string'
        mode: 'string'
        pathOnCompute: 'string'
        pathOnDatastore: 'string'
      }
    }
    timeout: 'string'
  }

Objets DistributionConfiguration

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

Pour Mpi, utilisez :

  distributionType: 'Mpi'
  processCountPerInstance: int

Pour PyTorch, utilisez :

  distributionType: 'PyTorch'
  processCount: int

Pour TensorFlow, utilisez :

  distributionType: 'TensorFlow'
  parameterServerCount: int
  workerCount: int

Objets IdentityConfiguration

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

Pour AMLToken, utilisez :

  identityType: 'AMLToken'

Pour Géré, utilisez :

  identityType: 'Managed'
  clientId: 'string'
  objectId: 'string'
  resourceId: 'string'

Objets EarlyTerminationPolicy

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

Pour Bandit, utilisez :

  policyType: 'Bandit'
  slackAmount: int
  slackFactor: int

Pour MedianStopping, utilisez :

  policyType: 'MedianStopping'

Pour TroncationSelection, utilisez :

  policyType: 'TruncationSelection'
  truncationPercentage: int

Valeurs de propriétés

espaces de travail/travaux

Nom Description Valeur
name Nom de la ressource

Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep.
chaîne (obligatoire)
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 de la ressource de type : espaces de travail
properties [Obligatoire] Attributs supplémentaires de l’entité. JobBase (obligatoire)

JobBase

Nom Description Valeur
description Texte de description de la ressource. string
properties Dictionnaire de propriétés de ressource. JobBaseProperties
tags Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour. object
jobType Définir le type d’objet Commande
Balayage (obligatoire)

JobBaseProperties

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

CommandJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. 'Command' (obligatoire)
codeId ID de ressource ARM de la ressource de code. string
command [Obligatoire] Commande à exécuter au démarrage du travail. par exemple « python train.py » chaîne (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
compute [Obligatoire] Liaison de calcul pour le travail. ComputeConfiguration (obligatoire)
distribution Configuration de distribution du travail. S’il est défini, il doit s’agir de Mpi, Tensorflow, PyTorch ou null. DistributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. string
environmentVariables Variables d’environnement incluses dans le travail. CommandJobEnvironmentVariables
experimentName Nom de l’expérience à laquelle appartient le travail. S’il n’est pas défini, le travail est placé dans l’expérience « Par défaut ». string
identité Configuration de l’identité. S’il est défini, il doit s’agir d’AmlToken, ManagedIdentity ou null.
La valeur par défaut est AmlToken si null.
IdentityConfiguration
inputDataBindings Mappage des liaisons de données d’entrée utilisées dans le travail. CommandJobInputDataBindings
outputDataBindings Mappage des liaisons de données de sortie utilisées dans le travail. CommandJobOutputDataBindings
priority Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité de préversion privée et disponible uniquement pour les utilisateurs figurant dans la liste verte.
int
timeout Durée d’exécution maximale au format ISO 8601, après laquelle le travail sera annulé. Prend uniquement en charge la durée avec une précision aussi faible que secondes. string

ComputeConfiguration

Nom Description Valeur
instanceCount Nombre d’instances ou de nœuds. int
instanceType Type de référence SKU sur lequel s’exécuter. string
isLocal Définissez sur true pour les travaux en cours d’exécution sur le calcul local. bool
location Emplacement de l’exécution du cluster virtuel. string
properties Propriétés supplémentaires. ComputeConfigurationProperties
target ID de ressource ARM du calcul que vous ciblez. Si elle n’est pas fournie, la ressource est déployée comme gérée. string

ComputeConfigurationProperties

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

DistributionConfiguration

Nom Description Valeur
distributionType Définir le type d’objet Mpi
PyTorch
TensorFlow (obligatoire)

Mpi

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. 'Mpi' (obligatoire)
processCountPerInstance Nombre de processus par nœud MPI. int

PyTorch

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. 'PyTorch' (obligatoire)
processCount Nombre total de processus pour le travail distribué. int

TensorFlow

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. 'TensorFlow' (obligatoire)
parameterServerCount Nombre de tâches de serveur de paramètres. int
workerCount Nombre de workers. Remplace le nombre de nœuds dans la liaison de calcul. int

CommandJobEnvironmentVariables

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

IdentityConfiguration

Nom Description Valeur
identityType Définir le type d’objet AMLToken
Géré (obligatoire)

AmlToken

Nom Description Valeur
identityType [Obligatoire] Spécifie le type d’infrastructure d’identité. 'AMLToken' (obligatoire)

ManagedIdentity

Nom Description Valeur
identityType [Obligatoire] Spécifie le type d’infrastructure d’identité. 'Managed' (obligatoire)
clientId Spécifie une identité affectée par l’utilisateur par ID client. Pour les personnes affectées par le système, ne définissez pas ce champ. string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Spécifie une identité affectée par l’utilisateur par l’ID d’objet. Pour les personnes affectées par le système, ne définissez pas ce champ. string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Spécifie une identité affectée par l’utilisateur par l’ID de ressource ARM. Pour les personnes affectées par le système, ne définissez pas ce champ. string

CommandJobInputDataBindings

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

InputDataBinding

Nom Description Valeur
dataId ID de ressource ARM de la dataVersion inscrite. string
mode Mécanisme d’accès à l’artefact de données. 'Direct'
'Télécharger'
'EvalDownload'
'EvalMount'
'Mount'
'ReadOnlyMount'
'ReadWriteMount'
'Upload'
pathOnCompute Emplacement des données à l’intérieur du processus de conteneur. string

CommandJobOutputDataBindings

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

OutputDataBinding

Nom Description Valeur
datastoreId ID de ressource ARM du magasin de données dans lequel la sortie des données sera stockée. string
mode Mécanisme de déplacement des données vers le magasin de données. 'Direct'
'Télécharger'
'EvalDownload'
'EvalMount'
'Mount'
'ReadOnlyMount'
'ReadWriteMount'
'Upload'
pathOnCompute Emplacement des données à l’intérieur du processus de conteneur. string
pathOnDatastore Chemin d’accès aux données dans le magasin de données. string

SweepJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. 'Sweep' (obligatoire)
algorithme [Obligatoire] Type des algorithmes d’échantillonnage des hyperparamètres « Bayésien »
'Grid'
'Random' (obligatoire)
compute [Obligatoire] Liaison de calcul pour le travail. ComputeConfiguration (obligatoire)
earlyTermination Les stratégies d’arrêt anticipé permettent d’annuler les exécutions peu performantes avant qu’elles ne se terminent. EarlyTerminationPolicy
experimentName Nom de l’expérience à laquelle appartient le travail. S’il n’est pas défini, le travail est placé dans l’expérience « Par défaut ». string
identité Configuration de l’identité. S’il est défini, il doit s’agir d’AmlToken, ManagedIdentity ou null.
La valeur par défaut est AmlToken si null.
IdentityConfiguration
maxConcurrentTrials Limite supérieure du nombre d’essais effectués en parallèle. int
maxTotalTrials Limite supérieure du nombre d’essais à effectuer. int
objective [Obligatoire] Objectif d’optimisation. Objectif (obligatoire)
priority Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité de préversion privée et disponible uniquement pour les utilisateurs figurant dans la liste verte.
int
searchSpace [Obligatoire] Dictionnaire contenant chaque paramètre et sa distribution. La clé de dictionnaire est le nom du paramètre SweepJobSearchSpace (obligatoire)
timeout Délai d’expiration total au format ISO 8601. Prend uniquement en charge la durée avec une précision aussi faible que minutes. string
trial Définition du composant d’essai. TrialComponent

EarlyTerminationPolicy

Nom Description Valeur
delayEvaluation Nombre d’intervalles par lesquels retarder la première évaluation. int
evaluationInterval Intervalle (nombre d’exécutions) entre les évaluations de stratégie. int
policyType Définir le type d’objet Bandit
MedianStopping
TruncationSelection (obligatoire)

BanditPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie 'Bandit' (obligatoire)
slackAmount Distance absolue autorisée par rapport à l’exécution la plus performante. int
slackFactor Ratio de la distance autorisée par rapport à l’exécution la plus performante. int

MedianStoppingPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie 'MedianStopping' (obligatoire)

TruncationSelectionPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie 'TruncationSelection' (obligatoire)
truncationPercentage Pourcentage d’exécutions à annuler à chaque intervalle d’évaluation. int

Objectif

Nom Description Valeur
goal [Obligatoire] Définit les objectifs de métriques pris en charge pour le réglage des hyperparamètres 'Agrandir'
'Réduire' (obligatoire)
primaryMetric [Obligatoire] Nom de la métrique à optimiser. string (obligatoire)

Contraintes :
Modèle = [a-zA-Z0-9_]

SweepJobSearchSpace

Nom Description Valeur
{propriété personnalisée} Pour Bicep, vous pouvez utiliser la fonction any().

TrialComponent

Nom Description Valeur
codeId ID de ressource ARM de la ressource de code. string
command [Obligatoire] Commande à exécuter au démarrage du travail. par exemple « python train.py » string (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
distribution Configuration de distribution du travail. S’il est défini, il doit s’agir de Mpi, Tensorflow, PyTorch ou null. DistributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. string
environmentVariables Variables d’environnement incluses dans le travail. TrialComponentEnvironmentVariables
inputDataBindings Mappage des liaisons de données d’entrée utilisées dans le travail. TrialComponentInputDataBindings
outputDataBindings Mappage des liaisons de données de sortie utilisées dans le travail. TrialComponentOutputDataBindings
timeout Durée maximale d’exécution au format ISO 8601, après quoi le composant d’évaluation sera annulé.
Prend uniquement en charge la durée avec une précision aussi faible que secondes.
string

TrialComponentEnvironmentVariables

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

TrialComponentInputDataBindings

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

TrialComponentOutputDataBindings

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

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 travail de classification AutoML Azure Machine Learning

Déployer sur Azure
Ce modèle crée un travail de classification AutoML Azure Machine Learning pour déterminer le meilleur modèle pour prédire si un client s’abonnera à un dépôt à terme fixe auprès d’une institution financière.
Créer un travail de commande Azure Machine Learning

Déployer sur Azure
Ce modèle crée un travail de commande Azure Machine Learning avec un script hello_world de base
Créer un travail de balayage Azure Machine Learning

Déployer sur Azure
Ce modèle crée un travail de balayage Azure Machine Learning pour le réglage des hyperparamètres.

Définition de ressources de modèle ARM

Le type de ressource espaces de travail/travaux 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/jobs, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.MachineLearningServices/workspaces/jobs",
  "apiVersion": "2021-03-01-preview",
  "name": "string",
  "properties": {
    "description": "string",
    "properties": {
      "{customized property}": "string"
    },
    "tags": {
      "{customized property}": "string"
    },
    "jobType": "string"
    // For remaining properties, see JobBase objects
  }
}

Objets JobBase

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

Pour Command, utilisez :

  "jobType": "Command",
  "codeId": "string",
  "command": "string",
  "compute": {
    "instanceCount": "int",
    "instanceType": "string",
    "isLocal": "bool",
    "location": "string",
    "properties": {
      "{customized property}": "string"
    },
    "target": "string"
  },
  "distribution": {
    "distributionType": "string"
    // For remaining properties, see DistributionConfiguration objects
  },
  "environmentId": "string",
  "environmentVariables": {
    "{customized property}": "string"
  },
  "experimentName": "string",
  "identity": {
    "identityType": "string"
    // For remaining properties, see IdentityConfiguration objects
  },
  "inputDataBindings": {
    "{customized property}": {
      "dataId": "string",
      "mode": "string",
      "pathOnCompute": "string"
    }
  },
  "outputDataBindings": {
    "{customized property}": {
      "datastoreId": "string",
      "mode": "string",
      "pathOnCompute": "string",
      "pathOnDatastore": "string"
    }
  },
  "priority": "int",
  "timeout": "string"

Pour Balayage, utilisez :

  "jobType": "Sweep",
  "algorithm": "string",
  "compute": {
    "instanceCount": "int",
    "instanceType": "string",
    "isLocal": "bool",
    "location": "string",
    "properties": {
      "{customized property}": "string"
    },
    "target": "string"
  },
  "earlyTermination": {
    "delayEvaluation": "int",
    "evaluationInterval": "int",
    "policyType": "string"
    // For remaining properties, see EarlyTerminationPolicy objects
  },
  "experimentName": "string",
  "identity": {
    "identityType": "string"
    // For remaining properties, see IdentityConfiguration objects
  },
  "maxConcurrentTrials": "int",
  "maxTotalTrials": "int",
  "objective": {
    "goal": "string",
    "primaryMetric": "string"
  },
  "priority": "int",
  "searchSpace": {
    "{customized property}": {}
  },
  "timeout": "string",
  "trial": {
    "codeId": "string",
    "command": "string",
    "distribution": {
      "distributionType": "string"
      // For remaining properties, see DistributionConfiguration objects
    },
    "environmentId": "string",
    "environmentVariables": {
      "{customized property}": "string"
    },
    "inputDataBindings": {
      "{customized property}": {
        "dataId": "string",
        "mode": "string",
        "pathOnCompute": "string"
      }
    },
    "outputDataBindings": {
      "{customized property}": {
        "datastoreId": "string",
        "mode": "string",
        "pathOnCompute": "string",
        "pathOnDatastore": "string"
      }
    },
    "timeout": "string"
  }

Objets DistributionConfiguration

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

Pour Mpi, utilisez :

  "distributionType": "Mpi",
  "processCountPerInstance": "int"

Pour PyTorch, utilisez :

  "distributionType": "PyTorch",
  "processCount": "int"

Pour TensorFlow, utilisez :

  "distributionType": "TensorFlow",
  "parameterServerCount": "int",
  "workerCount": "int"

Objets IdentityConfiguration

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

Pour AMLToken, utilisez :

  "identityType": "AMLToken"

Pour Géré, utilisez :

  "identityType": "Managed",
  "clientId": "string",
  "objectId": "string",
  "resourceId": "string"

Objets EarlyTerminationPolicy

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

Pour Bandit, utilisez :

  "policyType": "Bandit",
  "slackAmount": "int",
  "slackFactor": "int"

Pour MedianStopping, utilisez :

  "policyType": "MedianStopping"

Pour TroncationSelection, utilisez :

  "policyType": "TruncationSelection",
  "truncationPercentage": "int"

Valeurs de propriétés

espaces de travail/travaux

Nom Description Valeur
type Type de ressource « Microsoft.MachineLearningServices/workspaces/jobs »
apiVersion Version de l’API de ressource « 2021-03-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)
properties [Obligatoire] Attributs supplémentaires de l’entité. JobBase (obligatoire)

JobBase

Nom Description Valeur
description Texte de description de la ressource. string
properties Dictionnaire de propriétés de ressource. JobBaseProperties
tags Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour. object
jobType Définir le type d’objet Commande
Balayage (obligatoire)

JobBaseProperties

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

CommandJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. 'Command' (obligatoire)
codeId ID de ressource ARM de la ressource de code. string
command [Obligatoire] Commande à exécuter au démarrage du travail. par exemple « python train.py » chaîne (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
compute [Obligatoire] Liaison de calcul pour le travail. ComputeConfiguration (obligatoire)
distribution Configuration de distribution du travail. S’il est défini, il doit s’agir de Mpi, Tensorflow, PyTorch ou null. DistributionConfiguration
environmentId ID de ressource ARM de la spécification Environment pour le travail. string
environmentVariables Variables d’environnement incluses dans le travail. CommandJobEnvironmentVariables
experimentName Nom de l’expérience à laquelle appartient le travail. S’il n’est pas défini, le travail est placé dans l’expérience « Par défaut ». string
identité Configuration de l’identité. S’il est défini, il doit s’agir d’AmlToken, ManagedIdentity ou null.
La valeur par défaut est AmlToken si null.
IdentityConfiguration
inputDataBindings Mappage des liaisons de données d’entrée utilisées dans le travail. CommandJobInputDataBindings
outputDataBindings Mappage des liaisons de données de sortie utilisées dans le travail. CommandJobOutputDataBindings
priority Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité de préversion privée et disponible uniquement pour les utilisateurs de la liste verte.
int
timeout Durée maximale d’exécution au format ISO 8601, après quoi le travail sera annulé. Prend uniquement en charge la durée avec une précision aussi faible que secondes. string

ComputeConfiguration

Nom Description Valeur
instanceCount Nombre d’instances ou de nœuds. int
instanceType Type de référence SKU sur lequel exécuter. string
isLocal Définissez sur true pour les travaux s’exécutant sur le calcul local. bool
location Emplacement de l’exécution du cluster virtuel. string
properties Propriétés supplémentaires. ComputeConfigurationProperties
target ID de ressource ARM du calcul que vous ciblez. Si elle n’est pas fournie, la ressource sera déployée en tant que gérée. string

ComputeConfigurationProperties

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

DistributionConfiguration

Nom Description Valeur
distributionType Définir le type d’objet Mpi
PyTorch
TensorFlow (obligatoire)

Mpi

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. 'Mpi' (obligatoire)
processCountPerInstance Nombre de processus par nœud MPI. int

PyTorch

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. 'PyTorch' (obligatoire)
processCount Nombre total de processus pour le travail distribué. int

TensorFlow

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. 'TensorFlow' (obligatoire)
parameterServerCount Nombre de tâches de serveur de paramètres. int
workerCount Nombre de workers. Remplace le nombre de nœuds dans la liaison de calcul. int

CommandJobEnvironmentVariables

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

IdentityConfiguration

Nom Description Valeur
identityType Définir le type d’objet AMLToken
Managé (obligatoire)

AmlToken

Nom Description Valeur
identityType [Obligatoire] Spécifie le type d’infrastructure d’identité. 'AMLToken' (obligatoire)

ManagedIdentity

Nom Description Valeur
identityType [Obligatoire] Spécifie le type d’infrastructure d’identité. 'Managed' (obligatoire)
clientId Spécifie une identité affectée par l’utilisateur par ID client. Pour l’affectation par le système, ne définissez pas ce champ. string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Spécifie une identité affectée par l’utilisateur par ID d’objet. Pour l’affectation par le système, ne définissez pas ce champ. string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Spécifie une identité affectée par l’utilisateur par l’ID de ressource ARM. Pour l’affectation par le système, ne définissez pas ce champ. string

CommandJobInputDataBindings

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

InputDataBinding

Nom Description Valeur
dataId ID de ressource ARM de la dataVersion inscrite. string
mode Mécanisme d’accès à l’artefact de données. 'Direct'
'Télécharger'
'EvalDownload'
'EvalMount'
'Mount'
'ReadOnlyMount'
'ReadWriteMount'
'Charger'
pathOnCompute Emplacement des données à l’intérieur du processus de conteneur. string

CommandJobOutputDataBindings

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

OutputDataBinding

Nom Description Valeur
datastoreId ID de ressource ARM du magasin de données dans lequel la sortie des données sera stockée. string
mode Mécanisme de déplacement des données vers le magasin de données. 'Direct'
'Télécharger'
'EvalDownload'
'EvalMount'
'Mount'
'ReadOnlyMount'
'ReadWriteMount'
'Charger'
pathOnCompute Emplacement des données à l’intérieur du processus de conteneur. string
pathOnDatastore Chemin d’accès dans le magasin de données aux données. string

SweepJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. 'Balayage' (obligatoire)
algorithme [Obligatoire] Type des algorithmes d’échantillonnage des hyperparamètres « Bayésien »
'Grid'
'Random' (obligatoire)
compute [Obligatoire] Liaison de calcul pour le travail. ComputeConfiguration (obligatoire)
earlyTermination Les stratégies d’arrêt anticipé permettent d’annuler les exécutions peu performantes avant qu’elles ne se terminent. EarlyTerminationPolicy
experimentName Nom de l’expérience à laquelle appartient le travail. S’il n’est pas défini, le travail est placé dans l’expérience « Par défaut ». string
identité Configuration de l’identité. S’il est défini, il doit s’agir d’AmlToken, ManagedIdentity ou null.
La valeur par défaut est AmlToken si null.
IdentityConfiguration
maxConcurrentTrials Limite supérieure du nombre d’essais effectués en parallèle. int
maxTotalTrials Limite supérieure du nombre d’essais à effectuer. int
objective [Obligatoire] Objectif d’optimisation. Objectif (obligatoire)
priority Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité de préversion privée et disponible uniquement pour les utilisateurs figurant dans la liste verte.
int
searchSpace [Obligatoire] Dictionnaire contenant chaque paramètre et sa distribution. La clé de dictionnaire est le nom du paramètre SweepJobSearchSpace (obligatoire)
timeout Délai d’expiration total au format ISO 8601. Prend uniquement en charge la durée avec une précision aussi faible que minutes. string
trial Définition du composant d’essai. TrialComponent

EarlyTerminationPolicy

Nom Description Valeur
delayEvaluation Nombre d’intervalles par lesquels retarder la première évaluation. int
evaluationInterval Intervalle (nombre d’exécutions) entre les évaluations de stratégie. int
policyType Définir le type d’objet Bandit
MedianStopping
TruncationSelection (obligatoire)

BanditPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie 'Bandit' (obligatoire)
slackAmount Distance absolue autorisée par rapport à l’exécution la plus performante. int
slackFactor Ratio de la distance autorisée par rapport à l’exécution la plus performante. int

MedianStoppingPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie 'MedianStopping' (obligatoire)

TruncationSelectionPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie 'TruncationSelection' (obligatoire)
truncationPercentage Pourcentage d’exécutions à annuler à chaque intervalle d’évaluation. int

Objectif

Nom Description Valeur
goal [Obligatoire] Définit les objectifs de métriques pris en charge pour le réglage des hyperparamètres 'Agrandir'
'Réduire' (obligatoire)
primaryMetric [Obligatoire] Nom de la métrique à optimiser. string (obligatoire)

Contraintes :
Modèle = [a-zA-Z0-9_]

SweepJobSearchSpace

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

TrialComponent

Nom Description Valeur
codeId ID de ressource ARM de la ressource de code. string
command [Obligatoire] Commande à exécuter au démarrage du travail. par exemple « python train.py » string (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
distribution Configuration de distribution du travail. S’il est défini, il doit s’agir de Mpi, Tensorflow, PyTorch ou null. DistributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. string
environmentVariables Variables d’environnement incluses dans le travail. TrialComponentEnvironmentVariables
inputDataBindings Mappage des liaisons de données d’entrée utilisées dans le travail. TrialComponentInputDataBindings
outputDataBindings Mappage des liaisons de données de sortie utilisées dans le travail. TrialComponentOutputDataBindings
timeout Durée maximale d’exécution au format ISO 8601, après quoi le composant d’évaluation sera annulé.
Prend uniquement en charge la durée avec une précision aussi faible que secondes.
string

TrialComponentEnvironmentVariables

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

TrialComponentInputDataBindings

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

TrialComponentOutputDataBindings

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

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 travail de classification AutoML Azure Machine Learning

Déployer sur Azure
Ce modèle crée un travail de classification AutoML Azure Machine Learning pour déterminer le meilleur modèle pour prédire si un client s’abonnera à un dépôt à terme fixe auprès d’une institution financière.
Créer un travail de commande Azure Machine Learning

Déployer sur Azure
Ce modèle crée un travail de commande Azure Machine Learning avec un script hello_world de base
Créer un travail de balayage Azure Machine Learning

Déployer sur Azure
Ce modèle crée un travail de balayage Azure Machine Learning pour le réglage des hyperparamètres.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource espaces de travail/travaux 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/jobs, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      description = "string"
      properties = {
        {customized property} = "string"
      }
      tags = {
        {customized property} = "string"
      }
      jobType = "string"
      // For remaining properties, see JobBase objects
    }
  })
}

Objets JobBase

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

Pour Command, utilisez :

  jobType = "Command"
  codeId = "string"
  command = "string"
  compute = {
    instanceCount = int
    instanceType = "string"
    isLocal = bool
    location = "string"
    properties = {
      {customized property} = "string"
    }
    target = "string"
  }
  distribution = {
    distributionType = "string"
    // For remaining properties, see DistributionConfiguration objects
  }
  environmentId = "string"
  environmentVariables = {
    {customized property} = "string"
  }
  experimentName = "string"
  identity {
    identityType = "string"
    // For remaining properties, see IdentityConfiguration objects
  }
  inputDataBindings = {
    {customized property} = {
      dataId = "string"
      mode = "string"
      pathOnCompute = "string"
    }
  }
  outputDataBindings = {
    {customized property} = {
      datastoreId = "string"
      mode = "string"
      pathOnCompute = "string"
      pathOnDatastore = "string"
    }
  }
  priority = int
  timeout = "string"

Pour Balayage, utilisez :

  jobType = "Sweep"
  algorithm = "string"
  compute = {
    instanceCount = int
    instanceType = "string"
    isLocal = bool
    location = "string"
    properties = {
      {customized property} = "string"
    }
    target = "string"
  }
  earlyTermination = {
    delayEvaluation = int
    evaluationInterval = int
    policyType = "string"
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  experimentName = "string"
  identity {
    identityType = "string"
    // For remaining properties, see IdentityConfiguration objects
  }
  maxConcurrentTrials = int
  maxTotalTrials = int
  objective = {
    goal = "string"
    primaryMetric = "string"
  }
  priority = int
  searchSpace = {}
  timeout = "string"
  trial = {
    codeId = "string"
    command = "string"
    distribution = {
      distributionType = "string"
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId = "string"
    environmentVariables = {
      {customized property} = "string"
    }
    inputDataBindings = {
      {customized property} = {
        dataId = "string"
        mode = "string"
        pathOnCompute = "string"
      }
    }
    outputDataBindings = {
      {customized property} = {
        datastoreId = "string"
        mode = "string"
        pathOnCompute = "string"
        pathOnDatastore = "string"
      }
    }
    timeout = "string"
  }

Objets DistributionConfiguration

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

Pour Mpi, utilisez :

  distributionType = "Mpi"
  processCountPerInstance = int

Pour PyTorch, utilisez :

  distributionType = "PyTorch"
  processCount = int

Pour TensorFlow, utilisez :

  distributionType = "TensorFlow"
  parameterServerCount = int
  workerCount = int

Objets IdentityConfiguration

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

Pour AMLToken, utilisez :

  identityType = "AMLToken"

Pour Géré, utilisez :

  identityType = "Managed"
  clientId = "string"
  objectId = "string"
  resourceId = "string"

Objets EarlyTerminationPolicy

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

Pour Bandit, utilisez :

  policyType = "Bandit"
  slackAmount = int
  slackFactor = int

Pour MedianStopping, utilisez :

  policyType = "MedianStopping"

Pour TruncationSelection, utilisez :

  policyType = "TruncationSelection"
  truncationPercentage = int

Valeurs de propriétés

espaces de travail/travaux

Nom Description Valeur
type Type de ressource « Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview »
name Nom de la ressource string (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID pour la ressource de type : espaces de travail
properties [Obligatoire] Attributs supplémentaires de l’entité. JobBase (obligatoire)

JobBase

Nom Description Valeur
description Texte de description de la ressource. string
properties Dictionnaire de propriétés de ressource. JobBaseProperties
tags Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour. object
jobType Définir le type d’objet Commande
Balayage (obligatoire)

JobBaseProperties

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

CommandJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. « Command » (obligatoire)
codeId ID de ressource ARM de la ressource de code. string
command [Obligatoire] Commande à exécuter au démarrage du travail. par exemple « python train.py » string (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
compute [Obligatoire] Liaison de calcul pour le travail. ComputeConfiguration (obligatoire)
distribution Configuration de distribution du travail. S’il est défini, il doit s’agir de Mpi, Tensorflow, PyTorch ou null. DistributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. string
environmentVariables Variables d’environnement incluses dans le travail. CommandJobEnvironmentVariables
experimentName Nom de l’expérience à laquelle appartient le travail. S’il n’est pas défini, le travail est placé dans l’expérience « Par défaut ». string
identité Configuration de l’identité. S’il est défini, il doit s’agir d’AmlToken, ManagedIdentity ou null.
La valeur par défaut est AmlToken si null.
IdentityConfiguration
inputDataBindings Mappage des liaisons de données d’entrée utilisées dans le travail. CommandJobInputDataBindings
outputDataBindings Mappage des liaisons de données de sortie utilisées dans le travail. CommandJobOutputDataBindings
priority Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité de préversion privée et disponible uniquement pour les utilisateurs figurant dans la liste verte.
int
timeout Durée d’exécution maximale au format ISO 8601, après laquelle le travail sera annulé. Prend uniquement en charge la durée avec une précision aussi faible que secondes. string

ComputeConfiguration

Nom Description Valeur
instanceCount Nombre d’instances ou de nœuds. int
instanceType Type de référence SKU sur lequel s’exécuter. string
isLocal Définissez sur true pour les travaux en cours d’exécution sur le calcul local. bool
location Emplacement de l’exécution du cluster virtuel. string
properties Propriétés supplémentaires. ComputeConfigurationProperties
target ID de ressource ARM du calcul que vous ciblez. Si elle n’est pas fournie, la ressource est déployée comme gérée. string

ComputeConfigurationProperties

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

DistributionConfiguration

Nom Description Valeur
distributionType Définir le type d’objet Mpi
PyTorch
TensorFlow (obligatoire)

Mpi

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. « Mpi » (obligatoire)
processCountPerInstance Nombre de processus par nœud MPI. int

PyTorch

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. « PyTorch » (obligatoire)
processCount Nombre total de processus pour le travail distribué. int

TensorFlow

Nom Description Valeur
distributionType [Obligatoire] Spécifie le type d’infrastructure de distribution. « TensorFlow » (obligatoire)
parameterServerCount Nombre de tâches de serveur de paramètres. int
workerCount Nombre de workers. Remplace le nombre de nœuds dans la liaison de calcul. int

CommandJobEnvironmentVariables

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

IdentityConfiguration

Nom Description Valeur
identityType Définir le type d’objet AMLToken
Géré (obligatoire)

AmlToken

Nom Description Valeur
identityType [Obligatoire] Spécifie le type d’infrastructure d’identité. « AMLToken » (obligatoire)

ManagedIdentity

Nom Description Valeur
identityType [Obligatoire] Spécifie le type d’infrastructure d’identité. « Géré » (obligatoire)
clientId Spécifie une identité affectée par l’utilisateur par ID client. Pour les personnes affectées par le système, ne définissez pas ce champ. string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Spécifie une identité affectée par l’utilisateur par ID d’objet. Pour l’affectation par le système, ne définissez pas ce champ. string

Contraintes :
Longueur minimale = 36
Longueur maximale = 36
Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Spécifie une identité affectée par l’utilisateur par l’ID de ressource ARM. Pour l’affectation par le système, ne définissez pas ce champ. string

CommandJobInputDataBindings

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

InputDataBinding

Nom Description Valeur
dataId ID de ressource ARM de la dataVersion inscrite. string
mode Mécanisme d’accès à l’artefact de données. « Direct »
« Télécharger »
« EvalDownload »
« EvalMount »
« Montage »
« ReadOnlyMount »
« ReadWriteMount »
« Charger »
pathOnCompute Emplacement des données à l’intérieur du processus de conteneur. string

CommandJobOutputDataBindings

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

OutputDataBinding

Nom Description Valeur
datastoreId ID de ressource ARM du magasin de données dans lequel la sortie des données sera stockée. string
mode Mécanisme de déplacement des données vers le magasin de données. « Direct »
« Télécharger »
« EvalDownload »
« EvalMount »
« Montage »
« ReadOnlyMount »
« ReadWriteMount »
« Charger »
pathOnCompute Emplacement des données à l’intérieur du processus de conteneur. string
pathOnDatastore Chemin d’accès dans le magasin de données aux données. string

SweepJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. « Balayage » (obligatoire)
algorithme [Obligatoire] Type des algorithmes d’échantillonnage des hyperparamètres « Bayésien »
« Grille »
« Aléatoire » (obligatoire)
compute [Obligatoire] Liaison de calcul pour le travail. ComputeConfiguration (obligatoire)
earlyTermination Les stratégies d’arrêt anticipé permettent d’annuler les exécutions peu performantes avant qu’elles ne se terminent. EarlyTerminationPolicy
experimentName Nom de l’expérience à laquelle appartient le travail. S’il n’est pas défini, le travail est placé dans l’expérience « Par défaut ». string
identité Configuration de l’identité. S’il est défini, il doit s’agir d’AmlToken, ManagedIdentity ou null.
La valeur par défaut est AmlToken si null.
IdentityConfiguration
maxConcurrentTrials Limite supérieure du nombre d’essais effectués en parallèle. int
maxTotalTrials Limite supérieure du nombre d’essais à effectuer. int
objective [Obligatoire] Objectif d’optimisation. Objectif (obligatoire)
priority Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité de préversion privée et disponible uniquement pour les utilisateurs figurant dans la liste verte.
int
searchSpace [Obligatoire] Dictionnaire contenant chaque paramètre et sa distribution. La clé de dictionnaire est le nom du paramètre SweepJobSearchSpace (obligatoire)
timeout Délai d’expiration total au format ISO 8601. Prend uniquement en charge la durée avec une précision aussi faible que minutes. string
trial Définition du composant d’essai. TrialComponent

EarlyTerminationPolicy

Nom Description Valeur
delayEvaluation Nombre d’intervalles par lesquels retarder la première évaluation. int
evaluationInterval Intervalle (nombre d’exécutions) entre les évaluations de stratégie. int
policyType Définir le type d’objet Bandit
MedianStopping
TruncationSelection (obligatoire)

BanditPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie « Bandit » (obligatoire)
slackAmount Distance absolue autorisée par rapport à l’exécution la plus performante. int
slackFactor Ratio de la distance autorisée par rapport à l’exécution la plus performante. int

MedianStoppingPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie « MedianStopping » (obligatoire)

TruncationSelectionPolicy

Nom Description Valeur
policyType [Obligatoire] Nom de la configuration de la stratégie « TruncationSelection » (obligatoire)
truncationPercentage Pourcentage d’exécutions à annuler à chaque intervalle d’évaluation. int

Objectif

Nom Description Valeur
goal [Obligatoire] Définit les objectifs de métriques pris en charge pour le réglage des hyperparamètres « Agrandir »
« Réduire » (obligatoire)
primaryMetric [Obligatoire] Nom de la métrique à optimiser. string (obligatoire)

Contraintes :
Modèle = [a-zA-Z0-9_]

SweepJobSearchSpace

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

TrialComponent

Nom Description Valeur
codeId ID de ressource ARM de la ressource de code. string
command [Obligatoire] Commande à exécuter au démarrage du travail. par exemple « python train.py » string (obligatoire)

Contraintes :
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
distribution Configuration de distribution du travail. S’il est défini, il doit s’agir de Mpi, Tensorflow, PyTorch ou null. DistributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. string
environmentVariables Variables d’environnement incluses dans le travail. TrialComponentEnvironmentVariables
inputDataBindings Mappage des liaisons de données d’entrée utilisées dans le travail. TrialComponentInputDataBindings
outputDataBindings Mappage des liaisons de données de sortie utilisées dans le travail. TrialComponentOutputDataBindings
timeout Durée maximale d’exécution au format ISO 8601, après quoi le composant d’évaluation sera annulé.
Prend uniquement en charge la durée avec une précision aussi faible que secondes.
string

TrialComponentEnvironmentVariables

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

TrialComponentInputDataBindings

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

TrialComponentOutputDataBindings

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