Partager via

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

  • Article

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 de ressource

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: {}
    jobType: 'string'
    // For remaining properties, see JobBase objects
  }
}

Objets JobBase

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

Pour commande, 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 de 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 managé, 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 médiane, utilisez :

  policyType: 'MedianStopping'

Pour truncationSelection, utilisez :

  policyType: 'TruncationSelection'
  truncationPercentage: int

Valeurs de propriété

espaces de travail/travaux

Nom Description Valeur
nom Nom de la ressource

Découvrez comment définir des noms et des types pour les ressources enfants dans Bicep.		 chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’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
Propriétés [Obligatoire] Attributs supplémentaires de l’entité. JobBase (obligatoire)

JobBase

Nom Description Valeur
description Texte de description de la ressource. corde
Propriétés Dictionnaire de propriétés de ressource. jobBaseProperties
étiquettes Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour. objet
jobType Définir le type d’objet commande
de balayage (obligatoire)

JobBaseProperties

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

CommandJob

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

Contraintes:
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
calculer [Obligatoire] Liaison de calcul pour le travail. computeConfiguration (obligatoire)
distribution Configuration de distribution du travail. Si elle est définie, il doit s’agir de l’un des valeurs Mpi, Tensorflow, PyTorch ou Null. distributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. corde
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 ». corde
identité Configuration de l’identité. Si cette valeur est définie, il doit s’agir de l’un des valeurs 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
priorité Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité d’aperçu privé et disponible uniquement pour les utilisateurs de 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. corde

ComputeConfiguration

Nom Description Valeur
instanceCount Nombre d’instances ou de nœuds. Int
instanceType Type de référence SKU à exécuter. corde
isLocal Défini sur true pour les travaux exécutés sur le calcul local. Bool
emplacement Emplacement de l’exécution du cluster virtuel. corde
Propriétés Propriétés supplémentaires. ComputeConfigurationProperties
cible ID de ressource ARM du calcul que vous ciblez. Si la ressource n’est pas fournie, elle est déployée en tant que gérée. corde

ComputeConfigurationProperties

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

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 travailleurs. Remplace le nombre de nœuds dans la liaison de calcul. Int

CommandJobEnvironmentVariables

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

IdentityConfiguration

Nom Description Valeur
identityType Définir le type d’objet AMLToken
managed (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 données attribuées par le système, ne définissez pas ce champ. corde

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 les données attribuées par le système, ne définissez pas ce champ. corde

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 ID de ressource ARM. Pour les données attribuées par le système, ne définissez pas ce champ. corde

CommandJobInputDataBindings

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

InputDataBinding

Nom Description Valeur
dataId ID de ressource ARM du dataVersion inscrit. corde
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. corde

CommandJobOutputDataBindings

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

OutputDataBinding

Nom Description Valeur
datastoreId ID de ressource ARM du magasin de données où la sortie des données sera stockée. corde
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. corde
pathOnDatastore Chemin d’accès dans le magasin de données aux données. corde

SweepJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. 'Balayage' (obligatoire)
algorithme [Obligatoire] Type des algorithmes d’échantillonnage d’hyperparamètres 'Bayésien'
'Grid'
'Random' (obligatoire)
calculer [Obligatoire] Liaison de calcul pour le travail. computeConfiguration (obligatoire)
earlyTermination Les stratégies d’arrêt anticipé permettent d’annuler les exécutions médiocres avant qu’elles ne soient terminées. 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 ». corde
identité Configuration de l’identité. Si cette valeur est définie, il doit s’agir de l’un des éléments 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 au nombre d’essais à effectuer. Int
objectif [Obligatoire] Objectif d’optimisation. objective (obligatoire)
priorité Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité d’aperçu privé et disponible uniquement pour les utilisateurs de 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 total d’expiration au format ISO 8601. Prend uniquement en charge la durée avec une précision aussi faible que minutes. corde
procès Définition du composant d’évaluation. 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 à partir de la meilleure exécution. Int
slackFactor Ratio de la distance autorisée par rapport à la meilleure exécution. 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)
troncationPercentage Pourcentage d’exécutions à annuler à chaque intervalle d’évaluation. Int

Objectif

Nom Description Valeur
but [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. chaîne (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. corde
commander [Obligatoire] Commande à exécuter au démarrage du travail. Eg. « python train.py » chaîne (obligatoire)

Contraintes:
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
distribution Configuration de distribution du travail. Si elle est définie, il doit s’agir de l’un des valeurs Mpi, Tensorflow, PyTorch ou Null. distributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. corde
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 laquelle le composant d’évaluation sera annulé.
Prend uniquement en charge la durée avec une précision aussi faible que secondes.
 corde

TrialComponentEnvironmentVariables

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

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 de base hello_world
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 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 de l’API, consultez journal des modifications.

Format de ressource

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": {},
    "jobType": "string"
    // For remaining properties, see JobBase objects
  }
}

Objets JobBase

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

Pour commande, 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 de 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 managé, 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 médiane, utilisez :

  "policyType": "MedianStopping"

Pour truncationSelection, utilisez :

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

Valeurs de propriété

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'
nom Nom de la ressource

Découvrez comment définir des noms et des types pour les ressources enfants dans modèles ARM JSON.		 chaîne (obligatoire)
Propriétés [Obligatoire] Attributs supplémentaires de l’entité. JobBase (obligatoire)

JobBase

Nom Description Valeur
description Texte de description de la ressource. corde
Propriétés Dictionnaire de propriétés de ressource. jobBaseProperties
étiquettes Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour. objet
jobType Définir le type d’objet commande
de balayage (obligatoire)

JobBaseProperties

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

CommandJob

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

Contraintes:
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
calculer [Obligatoire] Liaison de calcul pour le travail. computeConfiguration (obligatoire)
distribution Configuration de distribution du travail. Si elle est définie, il doit s’agir de l’un des valeurs Mpi, Tensorflow, PyTorch ou Null. distributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. corde
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 ». corde
identité Configuration de l’identité. Si cette valeur est définie, il doit s’agir de l’un des valeurs 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
priorité Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité d’aperçu privé et disponible uniquement pour les utilisateurs de 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. corde

ComputeConfiguration

Nom Description Valeur
instanceCount Nombre d’instances ou de nœuds. Int
instanceType Type de référence SKU à exécuter. corde
isLocal Défini sur true pour les travaux exécutés sur le calcul local. Bool
emplacement Emplacement de l’exécution du cluster virtuel. corde
Propriétés Propriétés supplémentaires. ComputeConfigurationProperties
cible ID de ressource ARM du calcul que vous ciblez. Si la ressource n’est pas fournie, elle est déployée en tant que gérée. corde

ComputeConfigurationProperties

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

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 travailleurs. Remplace le nombre de nœuds dans la liaison de calcul. Int

CommandJobEnvironmentVariables

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

IdentityConfiguration

Nom Description Valeur
identityType Définir le type d’objet AMLToken
managed (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 données attribuées par le système, ne définissez pas ce champ. corde

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 les données attribuées par le système, ne définissez pas ce champ. corde

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 ID de ressource ARM. Pour les données attribuées par le système, ne définissez pas ce champ. corde

CommandJobInputDataBindings

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

InputDataBinding

Nom Description Valeur
dataId ID de ressource ARM du dataVersion inscrit. corde
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. corde

CommandJobOutputDataBindings

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

OutputDataBinding

Nom Description Valeur
datastoreId ID de ressource ARM du magasin de données où la sortie des données sera stockée. corde
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. corde
pathOnDatastore Chemin d’accès dans le magasin de données aux données. corde

SweepJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. 'Balayage' (obligatoire)
algorithme [Obligatoire] Type des algorithmes d’échantillonnage d’hyperparamètres 'Bayésien'
'Grid'
'Random' (obligatoire)
calculer [Obligatoire] Liaison de calcul pour le travail. computeConfiguration (obligatoire)
earlyTermination Les stratégies d’arrêt anticipé permettent d’annuler les exécutions médiocres avant qu’elles ne soient terminées. 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 ». corde
identité Configuration de l’identité. Si cette valeur est définie, il doit s’agir de l’un des éléments 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 au nombre d’essais à effectuer. Int
objectif [Obligatoire] Objectif d’optimisation. objective (obligatoire)
priorité Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité d’aperçu privé et disponible uniquement pour les utilisateurs de 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 total d’expiration au format ISO 8601. Prend uniquement en charge la durée avec une précision aussi faible que minutes. corde
procès Définition du composant d’évaluation. 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 à partir de la meilleure exécution. Int
slackFactor Ratio de la distance autorisée par rapport à la meilleure exécution. 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)
troncationPercentage Pourcentage d’exécutions à annuler à chaque intervalle d’évaluation. Int

Objectif

Nom Description Valeur
but [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. chaîne (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. corde
commander [Obligatoire] Commande à exécuter au démarrage du travail. Eg. « python train.py » chaîne (obligatoire)

Contraintes:
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
distribution Configuration de distribution du travail. Si elle est définie, il doit s’agir de l’un des valeurs Mpi, Tensorflow, PyTorch ou Null. distributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. corde
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 laquelle le composant d’évaluation sera annulé.
Prend uniquement en charge la durée avec une précision aussi faible que secondes.
 corde

TrialComponentEnvironmentVariables

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

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 de base hello_world
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 de l’API, consultez journal des modifications.

Format de ressource

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 = {}
      jobType = "string"
      // For remaining properties, see JobBase objects
    }
  })
}

Objets JobBase

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

Pour commande, 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 de 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 managé, 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 médiane, utilisez :

  policyType = "MedianStopping"

Pour truncationSelection, utilisez :

  policyType = "TruncationSelection"
  truncationPercentage = int

Valeurs de propriété

espaces de travail/travaux

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

JobBase

Nom Description Valeur
description Texte de description de la ressource. corde
Propriétés Dictionnaire de propriétés de ressource. jobBaseProperties
étiquettes Dictionnaire de balises. Les balises peuvent être ajoutées, supprimées et mises à jour. objet
jobType Définir le type d’objet commande
de balayage (obligatoire)

JobBaseProperties

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

CommandJob

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

Contraintes:
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
calculer [Obligatoire] Liaison de calcul pour le travail. computeConfiguration (obligatoire)
distribution Configuration de distribution du travail. Si elle est définie, il doit s’agir de l’un des valeurs Mpi, Tensorflow, PyTorch ou Null. distributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. corde
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 ». corde
identité Configuration de l’identité. Si cette valeur est définie, il doit s’agir de l’un des valeurs 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
priorité Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité d’aperçu privé et disponible uniquement pour les utilisateurs de 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. corde

ComputeConfiguration

Nom Description Valeur
instanceCount Nombre d’instances ou de nœuds. Int
instanceType Type de référence SKU à exécuter. corde
isLocal Défini sur true pour les travaux exécutés sur le calcul local. Bool
emplacement Emplacement de l’exécution du cluster virtuel. corde
Propriétés Propriétés supplémentaires. ComputeConfigurationProperties
cible ID de ressource ARM du calcul que vous ciblez. Si la ressource n’est pas fournie, elle est déployée en tant que gérée. corde

ComputeConfigurationProperties

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

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 travailleurs. Remplace le nombre de nœuds dans la liaison de calcul. Int

CommandJobEnvironmentVariables

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

IdentityConfiguration

Nom Description Valeur
identityType Définir le type d’objet AMLToken
managed (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 données attribuées par le système, ne définissez pas ce champ. corde

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 les données attribuées par le système, ne définissez pas ce champ. corde

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 ID de ressource ARM. Pour les données attribuées par le système, ne définissez pas ce champ. corde

CommandJobInputDataBindings

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

InputDataBinding

Nom Description Valeur
dataId ID de ressource ARM du dataVersion inscrit. corde
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. corde

CommandJobOutputDataBindings

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

OutputDataBinding

Nom Description Valeur
datastoreId ID de ressource ARM du magasin de données où la sortie des données sera stockée. corde
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. corde
pathOnDatastore Chemin d’accès dans le magasin de données aux données. corde

SweepJob

Nom Description Valeur
jobType [Obligatoire] Spécifie le type de travail. « Balayage » (obligatoire)
algorithme [Obligatoire] Type des algorithmes d’échantillonnage d’hyperparamètres « Bayésien »
« Grid »
« Random » (obligatoire)
calculer [Obligatoire] Liaison de calcul pour le travail. computeConfiguration (obligatoire)
earlyTermination Les stratégies d’arrêt anticipé permettent d’annuler les exécutions médiocres avant qu’elles ne soient terminées. 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 ». corde
identité Configuration de l’identité. Si cette valeur est définie, il doit s’agir de l’un des éléments 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 au nombre d’essais à effectuer. Int
objectif [Obligatoire] Objectif d’optimisation. objective (obligatoire)
priorité Priorité du travail pour la stratégie de planification. S’applique uniquement à AMLCompute.
Fonctionnalité d’aperçu privé et disponible uniquement pour les utilisateurs de 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 total d’expiration au format ISO 8601. Prend uniquement en charge la durée avec une précision aussi faible que minutes. corde
procès Définition du composant d’évaluation. 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 à partir de la meilleure exécution. Int
slackFactor Ratio de la distance autorisée par rapport à la meilleure exécution. 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)
troncationPercentage Pourcentage d’exécutions à annuler à chaque intervalle d’évaluation. Int

Objectif

Nom Description Valeur
but [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. chaîne (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. corde
commander [Obligatoire] Commande à exécuter au démarrage du travail. Eg. « python train.py » chaîne (obligatoire)

Contraintes:
Longueur minimale = 1
Modèle = [a-zA-Z0-9_]
distribution Configuration de distribution du travail. Si elle est définie, il doit s’agir de l’un des valeurs Mpi, Tensorflow, PyTorch ou Null. distributionConfiguration
environmentId ID de ressource ARM de la spécification d’environnement pour le travail. corde
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 laquelle le composant d’évaluation sera annulé.
Prend uniquement en charge la durée avec une précision aussi faible que secondes.
 corde

TrialComponentEnvironmentVariables

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

TrialComponentInputDataBindings

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

TrialComponentOutputDataBindings

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