Compartir a través de


Áreas de trabajo de Microsoft.MachineLearningServices/jobs 2021-03-01-preview

Definición de recursos de Bicep

El tipo de recurso workspaces/jobs se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/jobs, agregue el siguiente bicep a la plantilla.

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

Objetos DistributionConfiguration

Establezca la propiedad distributionType para especificar el tipo de objeto.

Para Mpi, use:

{
  distributionType: 'Mpi'
  processCountPerInstance: int
}

Para pyTorch, use:

{
  distributionType: 'PyTorch'
  processCount: int
}

Para tensorFlow, use:

{
  distributionType: 'TensorFlow'
  parameterServerCount: int
  workerCount: int
}

Objetos IdentityConfiguration

Establezca la propiedad identityType para especificar el tipo de objeto.

Para AMLToken, use:

{
  identityType: 'AMLToken'
}

Para managed, use:

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

Objetos EarlyTerminationPolicy

Establezca la propiedad policyType para especificar el tipo de objeto.

Para Bandit, use:

{
  policyType: 'Bandit'
  slackAmount: int
  slackFactor: int
}

Para medianStopping, use:

{
  policyType: 'MedianStopping'
}

Para TruncationSelection, use:

{
  policyType: 'TruncationSelection'
  truncationPercentage: int
}

Objetos JobBase

Establezca la propiedad jobType para especificar el tipo de objeto.

Para Comando, use:

{
  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'
    }
  }
  jobType: 'Command'
  outputDataBindings: {
    {customized property}: {
      datastoreId: 'string'
      mode: 'string'
      pathOnCompute: 'string'
      pathOnDatastore: 'string'
    }
  }
  priority: int
  timeout: 'string'
}

Para barrido, use:

{
  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
  }
  jobType: 'Sweep'
  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'
  }
}

Valores de propiedad

AmlToken

Nombre Descripción Valor
identityType [Obligatorio] Especifica el tipo de marco de identidad. 'AMLToken' (obligatorio)

BanditPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'Bandit' (obligatorio)
slackAmount Distancia absoluta permitida desde la mejor ejecución. Int
slackFactor Relación de la distancia permitida desde la ejecución con mejor rendimiento. Int

CommandJob

Nombre Descripción Valor
codeId Identificador de recurso de ARM del recurso de código. cuerda
mandar [Obligatorio] Comando que se va a ejecutar al iniciar el trabajo. Eg. "python train.py" cuerda

Restricciones:
Longitud mínima = 1
Patrón = [a-zA-Z0-9_] (obligatorio)
calcular [Obligatorio] Enlace de proceso para el trabajo. ComputeConfiguration (obligatorio)
distribución Configuración de distribución del trabajo. Si se establece, debe ser uno de Mpi, Tensorflow, PyTorch o NULL. DistributionConfiguration
environmentId El identificador de recurso de ARM de la especificación del entorno para el trabajo. cuerda
environmentVariables Variables de entorno incluidas en el trabajo. commandJobEnvironmentVariables
experimentName Nombre del experimento al que pertenece el trabajo. Si no se establece, el trabajo se coloca en el experimento "Predeterminado". cuerda
identidad Configuración de identidad. Si se establece, debe ser uno de AmlToken, ManagedIdentity o NULL.
El valor predeterminado es AmlToken si es null.
IdentityConfiguration
inputDataBindings Asignación de enlaces de datos de entrada usados en el trabajo. CommandJobInputDataBindings
jobType [Obligatorio] Especifica el tipo de trabajo. 'Command' (obligatorio)
outputDataBindings Asignación de enlaces de datos de salida usados en el trabajo. CommandJobOutputDataBindings
prioridad Prioridad del trabajo para la directiva de programación. Solo se aplica a AMLCompute.
Característica de vista previa privada y solo disponible para los usuarios en la lista de permitidos.
Int
interrupción Duración máxima de la ejecución en formato ISO 8601, después del cual se cancelará el trabajo. Solo admite la duración con una precisión tan baja como Segundos. cuerda

CommandJobEnvironmentVariables

Nombre Descripción Valor

CommandJobInputDataBindings

Nombre Descripción Valor

CommandJobOutputDataBindings

Nombre Descripción Valor

ComputeConfiguration

Nombre Descripción Valor
instanceCount Número de instancias o nodos. Int
instanceType Tipo de SKU en el que se ejecutará. cuerda
isLocal Establézcalo en true para los trabajos que se ejecutan en el proceso local. Bool
ubicación Ubicación de la ejecución del clúster virtual. cuerda
Propiedades Propiedades adicionales. ComputeConfigurationProperties
blanco Id. de recurso de ARM del proceso al que va dirigido. Si no se proporciona, el recurso se implementará como administrado. cuerda

ComputeConfigurationProperties

Nombre Descripción Valor

DistributionConfiguration

Nombre Descripción Valor
distributionType Establezca en "Mpi" para el tipo Mpi. Establezca en "PyTorch" para el tipo PyTorch. Establezca en "TensorFlow" para el tipo TensorFlow. 'Mpi'
'PyTorch'
'TensorFlow' (obligatorio)

EarlyTerminationPolicy

Nombre Descripción Valor
delayEvaluation Número de intervalos por los que se va a retrasar la primera evaluación. Int
evaluationInterval Intervalo (número de ejecuciones) entre evaluaciones de directivas. Int
policyType Establezca en "Bandit" para el tipo BanditPolicy. Establezca en "MedianStopping" para el tipo MedianStoppingPolicy. Establezca en "TruncationSelection" para el tipo TruncationSelectionPolicy. 'Bandido'
"MedianStopping"
'TruncationSelection' (obligatorio)

IdentityConfiguration

Nombre Descripción Valor
identityType Establezca en "AMLToken" para el tipo AmlToken. Establezca en "Administrado" para el tipo ManagedIdentity. 'AMLToken'
"Administrado" (obligatorio)

InputDataBinding

Nombre Descripción Valor
dataId Identificador de recurso de ARM de dataVersion registrado. cuerda
modo Mecanismo para acceder al artefacto de datos. 'Directo'
'Descargar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Cargar'
pathOnCompute Ubicación de los datos dentro del proceso de contenedor. cuerda

JobBase

Nombre Descripción Valor
descripción Texto de descripción del recurso. cuerda
jobType Establezca en "Command" para el tipo CommandJob. Establezca en "Barrido" para el tipo SweepJob. 'Command'
'Barrido' (obligatorio)
Propiedades Diccionario de propiedades de recurso. JobBaseProperties
Etiquetas Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar. JobBaseTags

JobBaseProperties

Nombre Descripción Valor

JobBaseTags

Nombre Descripción Valor

ManagedIdentity

Nombre Descripción Valor
clientId Especifica una identidad asignada por el usuario por identificador de cliente. En el caso de asignados por el sistema, no establezca este campo. cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType [Obligatorio] Especifica el tipo de marco de identidad. "Administrado" (obligatorio)
objectId Especifica una identidad asignada por el usuario por identificador de objeto. En el caso de asignados por el sistema, no establezca este campo. cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Especifica una identidad asignada por el usuario por el identificador de recurso de ARM. En el caso de asignados por el sistema, no establezca este campo. cuerda

MedianStoppingPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'MedianStopping' (obligatorio)

Microsoft.MachineLearningServices/workspaces/jobs

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.
Nombre simbólico del recurso de tipo: áreas de trabajo
Propiedades [Obligatorio] Atributos adicionales de la entidad. JobBase (obligatorio)

Mpi

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'Mpi' (obligatorio)
processCountPerInstance Número de procesos por nodo MPI. Int

Objetivo

Nombre Descripción Valor
Gol [Obligatorio] Define los objetivos de métrica admitidos para el ajuste de hiperparámetros 'Maximizar'
'Minimizar' (obligatorio)
primaryMetric [Obligatorio] Nombre de la métrica que se va a optimizar. cuerda

Restricciones:
Patrón = [a-zA-Z0-9_] (obligatorio)

OutputDataBinding

Nombre Descripción Valor
datastoreId Identificador de recurso de ARM del almacén de datos donde se almacenará la salida de datos. cuerda
modo Mecanismo para el movimiento de datos al almacén de datos. 'Directo'
'Descargar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Cargar'
pathOnCompute Ubicación de los datos dentro del proceso de contenedor. cuerda
pathOnDatastore Ruta de acceso dentro del almacén de datos a los datos. cuerda

PyTorch

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'PyTorch' (obligatorio)
processCount Recuento total de procesos para el trabajo distribuido. Int

SweepJob

Nombre Descripción Valor
algoritmo [Obligatorio] Tipo de los algoritmos de muestreo de hiperparámetros 'Bayesiano'
'Grid'
'Random' (obligatorio)
calcular [Obligatorio] Enlace de proceso para el trabajo. ComputeConfiguration (obligatorio)
earlyTermination Las directivas de terminación anticipada permiten cancelar ejecuciones de bajo rendimiento antes de completarse. EarlyTerminationPolicy
experimentName Nombre del experimento al que pertenece el trabajo. Si no se establece, el trabajo se coloca en el experimento "Predeterminado". cuerda
identidad Configuración de identidad. Si se establece, debe ser uno de AmlToken, ManagedIdentity o NULL.
El valor predeterminado es AmlToken si es null.
IdentityConfiguration
jobType [Obligatorio] Especifica el tipo de trabajo. 'Barrido' (obligatorio)
maxConcurrentTrials Límite superior del número de pruebas realizadas en paralelo. Int
maxTotalTrials Límite superior en el número de pruebas que se van a realizar. Int
objetivo [Obligatorio] Objetivo de optimización. objetivo (obligatorio)
prioridad Prioridad del trabajo para la directiva de programación. Solo se aplica a AMLCompute.
Característica de vista previa privada y solo disponible para los usuarios en la lista de permitidos.
Int
searchSpace [Obligatorio] Diccionario que contiene cada parámetro y su distribución. La clave de diccionario es el nombre del parámetro . SweepJobSearchSpace (obligatorio)
interrupción Tiempo de espera total en formato ISO 8601. Solo admite la duración con una precisión tan baja como Minutos. cuerda
juicio Definición del componente de prueba. TrialComponent de

SweepJobSearchSpace

Nombre Descripción Valor

TensorFlow

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'TensorFlow' (obligatorio)
parameterServerCount Número de tareas del servidor de parámetros. Int
workerCount Número de trabajadores. Sobrescribe el número de nodos en el enlace de proceso. Int

TrialComponent

Nombre Descripción Valor
codeId Identificador de recurso de ARM del recurso de código. cuerda
mandar [Obligatorio] Comando que se va a ejecutar al iniciar el trabajo. Eg. "python train.py" cuerda

Restricciones:
Longitud mínima = 1
Patrón = [a-zA-Z0-9_] (obligatorio)
distribución Configuración de distribución del trabajo. Si se establece, debe ser uno de Mpi, Tensorflow, PyTorch o NULL. DistributionConfiguration
environmentId El identificador de recurso de ARM de la especificación del entorno para el trabajo. cuerda
environmentVariables Variables de entorno incluidas en el trabajo. TrialComponentEnvironmentVariables
inputDataBindings Asignación de enlaces de datos de entrada usados en el trabajo. trialComponentInputDataBindings
outputDataBindings Asignación de enlaces de datos de salida usados en el trabajo. TrialComponentOutputDataBindings
interrupción Duración máxima de la ejecución en formato ISO 8601, después del cual se cancelará el componente de prueba.
Solo admite la duración con una precisión tan baja como Segundos.
cuerda

TrialComponentEnvironmentVariables

Nombre Descripción Valor

TrialComponentInputDataBindings

Nombre Descripción Valor

TrialComponentOutputDataBindings

Nombre Descripción Valor

TruncationSelectionPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'TruncationSelection' (obligatorio)
truncationPercentage Porcentaje de ejecuciones que se cancelarán en cada intervalo de evaluación. Int

Ejemplos de uso

Ejemplos de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
Creación de un trabajo de clasificación de AutoML de Azure Machine Learning Esta plantilla crea un trabajo de clasificación de AutoML de Azure Machine Learning para averiguar el mejor modelo para predecir si un cliente se suscribirá a un depósito a plazo fijo con una institución financiera.
Creación de un trabajo de comando de Azure Machine Learning Esta plantilla crea un trabajo de comando de Azure Machine Learning con un script de hello_world básico
Creación de un trabajo de barrido de Azure Machine Learning Esta plantilla crea un trabajo de barrido de Azure Machine Learning para el ajuste de hiperparámetros.

Definición de recursos de plantilla de ARM

El tipo de recurso workspaces/jobs se puede implementar con operaciones que tienen como destino:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/jobs, agregue el siguiente JSON a la plantilla.

{
  "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
  }
}

Objetos DistributionConfiguration

Establezca la propiedad distributionType para especificar el tipo de objeto.

Para Mpi, use:

{
  "distributionType": "Mpi",
  "processCountPerInstance": "int"
}

Para pyTorch, use:

{
  "distributionType": "PyTorch",
  "processCount": "int"
}

Para tensorFlow, use:

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

Objetos IdentityConfiguration

Establezca la propiedad identityType para especificar el tipo de objeto.

Para AMLToken, use:

{
  "identityType": "AMLToken"
}

Para managed, use:

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

Objetos EarlyTerminationPolicy

Establezca la propiedad policyType para especificar el tipo de objeto.

Para Bandit, use:

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

Para medianStopping, use:

{
  "policyType": "MedianStopping"
}

Para TruncationSelection, use:

{
  "policyType": "TruncationSelection",
  "truncationPercentage": "int"
}

Objetos JobBase

Establezca la propiedad jobType para especificar el tipo de objeto.

Para Comando, use:

{
  "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"
    }
  },
  "jobType": "Command",
  "outputDataBindings": {
    "{customized property}": {
      "datastoreId": "string",
      "mode": "string",
      "pathOnCompute": "string",
      "pathOnDatastore": "string"
    }
  },
  "priority": "int",
  "timeout": "string"
}

Para barrido, use:

{
  "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
  },
  "jobType": "Sweep",
  "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"
  }
}

Valores de propiedad

AmlToken

Nombre Descripción Valor
identityType [Obligatorio] Especifica el tipo de marco de identidad. 'AMLToken' (obligatorio)

BanditPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'Bandit' (obligatorio)
slackAmount Distancia absoluta permitida desde la mejor ejecución. Int
slackFactor Relación de la distancia permitida desde la ejecución con mejor rendimiento. Int

CommandJob

Nombre Descripción Valor
codeId Identificador de recurso de ARM del recurso de código. cuerda
mandar [Obligatorio] Comando que se va a ejecutar al iniciar el trabajo. Eg. "python train.py" cuerda

Restricciones:
Longitud mínima = 1
Patrón = [a-zA-Z0-9_] (obligatorio)
calcular [Obligatorio] Enlace de proceso para el trabajo. ComputeConfiguration (obligatorio)
distribución Configuración de distribución del trabajo. Si se establece, debe ser uno de Mpi, Tensorflow, PyTorch o NULL. DistributionConfiguration
environmentId El identificador de recurso de ARM de la especificación del entorno para el trabajo. cuerda
environmentVariables Variables de entorno incluidas en el trabajo. commandJobEnvironmentVariables
experimentName Nombre del experimento al que pertenece el trabajo. Si no se establece, el trabajo se coloca en el experimento "Predeterminado". cuerda
identidad Configuración de identidad. Si se establece, debe ser uno de AmlToken, ManagedIdentity o NULL.
El valor predeterminado es AmlToken si es null.
IdentityConfiguration
inputDataBindings Asignación de enlaces de datos de entrada usados en el trabajo. CommandJobInputDataBindings
jobType [Obligatorio] Especifica el tipo de trabajo. 'Command' (obligatorio)
outputDataBindings Asignación de enlaces de datos de salida usados en el trabajo. CommandJobOutputDataBindings
prioridad Prioridad del trabajo para la directiva de programación. Solo se aplica a AMLCompute.
Característica de vista previa privada y solo disponible para los usuarios en la lista de permitidos.
Int
interrupción Duración máxima de la ejecución en formato ISO 8601, después del cual se cancelará el trabajo. Solo admite la duración con una precisión tan baja como Segundos. cuerda

CommandJobEnvironmentVariables

Nombre Descripción Valor

CommandJobInputDataBindings

Nombre Descripción Valor

CommandJobOutputDataBindings

Nombre Descripción Valor

ComputeConfiguration

Nombre Descripción Valor
instanceCount Número de instancias o nodos. Int
instanceType Tipo de SKU en el que se ejecutará. cuerda
isLocal Establézcalo en true para los trabajos que se ejecutan en el proceso local. Bool
ubicación Ubicación de la ejecución del clúster virtual. cuerda
Propiedades Propiedades adicionales. ComputeConfigurationProperties
blanco Id. de recurso de ARM del proceso al que va dirigido. Si no se proporciona, el recurso se implementará como administrado. cuerda

ComputeConfigurationProperties

Nombre Descripción Valor

DistributionConfiguration

Nombre Descripción Valor
distributionType Establezca en "Mpi" para el tipo Mpi. Establezca en "PyTorch" para el tipo PyTorch. Establezca en "TensorFlow" para el tipo TensorFlow. 'Mpi'
'PyTorch'
'TensorFlow' (obligatorio)

EarlyTerminationPolicy

Nombre Descripción Valor
delayEvaluation Número de intervalos por los que se va a retrasar la primera evaluación. Int
evaluationInterval Intervalo (número de ejecuciones) entre evaluaciones de directivas. Int
policyType Establezca en "Bandit" para el tipo BanditPolicy. Establezca en "MedianStopping" para el tipo MedianStoppingPolicy. Establezca en "TruncationSelection" para el tipo TruncationSelectionPolicy. 'Bandido'
"MedianStopping"
'TruncationSelection' (obligatorio)

IdentityConfiguration

Nombre Descripción Valor
identityType Establezca en "AMLToken" para el tipo AmlToken. Establezca en "Administrado" para el tipo ManagedIdentity. 'AMLToken'
"Administrado" (obligatorio)

InputDataBinding

Nombre Descripción Valor
dataId Identificador de recurso de ARM de dataVersion registrado. cuerda
modo Mecanismo para acceder al artefacto de datos. 'Directo'
'Descargar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Cargar'
pathOnCompute Ubicación de los datos dentro del proceso de contenedor. cuerda

JobBase

Nombre Descripción Valor
descripción Texto de descripción del recurso. cuerda
jobType Establezca en "Command" para el tipo CommandJob. Establezca en "Barrido" para el tipo SweepJob. 'Command'
'Barrido' (obligatorio)
Propiedades Diccionario de propiedades de recurso. JobBaseProperties
Etiquetas Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar. JobBaseTags

JobBaseProperties

Nombre Descripción Valor

JobBaseTags

Nombre Descripción Valor

ManagedIdentity

Nombre Descripción Valor
clientId Especifica una identidad asignada por el usuario por identificador de cliente. En el caso de asignados por el sistema, no establezca este campo. cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType [Obligatorio] Especifica el tipo de marco de identidad. "Administrado" (obligatorio)
objectId Especifica una identidad asignada por el usuario por identificador de objeto. En el caso de asignados por el sistema, no establezca este campo. cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Especifica una identidad asignada por el usuario por el identificador de recurso de ARM. En el caso de asignados por el sistema, no establezca este campo. cuerda

MedianStoppingPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'MedianStopping' (obligatorio)

Microsoft.MachineLearningServices/workspaces/jobs

Nombre Descripción Valor
apiVersion La versión de api '2021-03-01-preview'
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (obligatorio)
Propiedades [Obligatorio] Atributos adicionales de la entidad. JobBase (obligatorio)
tipo El tipo de recurso "Microsoft.MachineLearningServices/workspaces/jobs"

Mpi

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'Mpi' (obligatorio)
processCountPerInstance Número de procesos por nodo MPI. Int

Objetivo

Nombre Descripción Valor
Gol [Obligatorio] Define los objetivos de métrica admitidos para el ajuste de hiperparámetros 'Maximizar'
'Minimizar' (obligatorio)
primaryMetric [Obligatorio] Nombre de la métrica que se va a optimizar. cuerda

Restricciones:
Patrón = [a-zA-Z0-9_] (obligatorio)

OutputDataBinding

Nombre Descripción Valor
datastoreId Identificador de recurso de ARM del almacén de datos donde se almacenará la salida de datos. cuerda
modo Mecanismo para el movimiento de datos al almacén de datos. 'Directo'
'Descargar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Cargar'
pathOnCompute Ubicación de los datos dentro del proceso de contenedor. cuerda
pathOnDatastore Ruta de acceso dentro del almacén de datos a los datos. cuerda

PyTorch

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'PyTorch' (obligatorio)
processCount Recuento total de procesos para el trabajo distribuido. Int

SweepJob

Nombre Descripción Valor
algoritmo [Obligatorio] Tipo de los algoritmos de muestreo de hiperparámetros 'Bayesiano'
'Grid'
'Random' (obligatorio)
calcular [Obligatorio] Enlace de proceso para el trabajo. ComputeConfiguration (obligatorio)
earlyTermination Las directivas de terminación anticipada permiten cancelar ejecuciones de bajo rendimiento antes de completarse. EarlyTerminationPolicy
experimentName Nombre del experimento al que pertenece el trabajo. Si no se establece, el trabajo se coloca en el experimento "Predeterminado". cuerda
identidad Configuración de identidad. Si se establece, debe ser uno de AmlToken, ManagedIdentity o NULL.
El valor predeterminado es AmlToken si es null.
IdentityConfiguration
jobType [Obligatorio] Especifica el tipo de trabajo. 'Barrido' (obligatorio)
maxConcurrentTrials Límite superior del número de pruebas realizadas en paralelo. Int
maxTotalTrials Límite superior en el número de pruebas que se van a realizar. Int
objetivo [Obligatorio] Objetivo de optimización. objetivo (obligatorio)
prioridad Prioridad del trabajo para la directiva de programación. Solo se aplica a AMLCompute.
Característica de vista previa privada y solo disponible para los usuarios en la lista de permitidos.
Int
searchSpace [Obligatorio] Diccionario que contiene cada parámetro y su distribución. La clave de diccionario es el nombre del parámetro . SweepJobSearchSpace (obligatorio)
interrupción Tiempo de espera total en formato ISO 8601. Solo admite la duración con una precisión tan baja como Minutos. cuerda
juicio Definición del componente de prueba. TrialComponent de

SweepJobSearchSpace

Nombre Descripción Valor

TensorFlow

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'TensorFlow' (obligatorio)
parameterServerCount Número de tareas del servidor de parámetros. Int
workerCount Número de trabajadores. Sobrescribe el número de nodos en el enlace de proceso. Int

TrialComponent

Nombre Descripción Valor
codeId Identificador de recurso de ARM del recurso de código. cuerda
mandar [Obligatorio] Comando que se va a ejecutar al iniciar el trabajo. Eg. "python train.py" cuerda

Restricciones:
Longitud mínima = 1
Patrón = [a-zA-Z0-9_] (obligatorio)
distribución Configuración de distribución del trabajo. Si se establece, debe ser uno de Mpi, Tensorflow, PyTorch o NULL. DistributionConfiguration
environmentId El identificador de recurso de ARM de la especificación del entorno para el trabajo. cuerda
environmentVariables Variables de entorno incluidas en el trabajo. TrialComponentEnvironmentVariables
inputDataBindings Asignación de enlaces de datos de entrada usados en el trabajo. trialComponentInputDataBindings
outputDataBindings Asignación de enlaces de datos de salida usados en el trabajo. TrialComponentOutputDataBindings
interrupción Duración máxima de la ejecución en formato ISO 8601, después del cual se cancelará el componente de prueba.
Solo admite la duración con una precisión tan baja como Segundos.
cuerda

TrialComponentEnvironmentVariables

Nombre Descripción Valor

TrialComponentInputDataBindings

Nombre Descripción Valor

TrialComponentOutputDataBindings

Nombre Descripción Valor

TruncationSelectionPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'TruncationSelection' (obligatorio)
truncationPercentage Porcentaje de ejecuciones que se cancelarán en cada intervalo de evaluación. Int

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla Descripción
Creación de un trabajo de clasificación de AutoML de Azure Machine Learning

Implementación en Azure
Esta plantilla crea un trabajo de clasificación de AutoML de Azure Machine Learning para averiguar el mejor modelo para predecir si un cliente se suscribirá a un depósito a plazo fijo con una institución financiera.
Creación de un trabajo de comando de Azure Machine Learning

Implementación en Azure
Esta plantilla crea un trabajo de comando de Azure Machine Learning con un script de hello_world básico
Creación de un trabajo de barrido de Azure Machine Learning

Implementación en Azure
Esta plantilla crea un trabajo de barrido de Azure Machine Learning para el ajuste de hiperparámetros.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso workspaces/jobs se puede implementar con operaciones que tienen como destino:

  • grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.MachineLearningServices/workspaces/jobs, agregue el siguiente terraform a la plantilla.

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

Objetos DistributionConfiguration

Establezca la propiedad distributionType para especificar el tipo de objeto.

Para Mpi, use:

{
  distributionType = "Mpi"
  processCountPerInstance = int
}

Para pyTorch, use:

{
  distributionType = "PyTorch"
  processCount = int
}

Para tensorFlow, use:

{
  distributionType = "TensorFlow"
  parameterServerCount = int
  workerCount = int
}

Objetos IdentityConfiguration

Establezca la propiedad identityType para especificar el tipo de objeto.

Para AMLToken, use:

{
  identityType = "AMLToken"
}

Para managed, use:

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

Objetos EarlyTerminationPolicy

Establezca la propiedad policyType para especificar el tipo de objeto.

Para Bandit, use:

{
  policyType = "Bandit"
  slackAmount = int
  slackFactor = int
}

Para medianStopping, use:

{
  policyType = "MedianStopping"
}

Para TruncationSelection, use:

{
  policyType = "TruncationSelection"
  truncationPercentage = int
}

Objetos JobBase

Establezca la propiedad jobType para especificar el tipo de objeto.

Para Comando, use:

{
  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"
    }
  }
  jobType = "Command"
  outputDataBindings = {
    {customized property} = {
      datastoreId = "string"
      mode = "string"
      pathOnCompute = "string"
      pathOnDatastore = "string"
    }
  }
  priority = int
  timeout = "string"
}

Para barrido, use:

{
  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
  }
  jobType = "Sweep"
  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"
  }
}

Valores de propiedad

AmlToken

Nombre Descripción Valor
identityType [Obligatorio] Especifica el tipo de marco de identidad. 'AMLToken' (obligatorio)

BanditPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'Bandit' (obligatorio)
slackAmount Distancia absoluta permitida desde la mejor ejecución. Int
slackFactor Relación de la distancia permitida desde la ejecución con mejor rendimiento. Int

CommandJob

Nombre Descripción Valor
codeId Identificador de recurso de ARM del recurso de código. cuerda
mandar [Obligatorio] Comando que se va a ejecutar al iniciar el trabajo. Eg. "python train.py" cuerda

Restricciones:
Longitud mínima = 1
Patrón = [a-zA-Z0-9_] (obligatorio)
calcular [Obligatorio] Enlace de proceso para el trabajo. ComputeConfiguration (obligatorio)
distribución Configuración de distribución del trabajo. Si se establece, debe ser uno de Mpi, Tensorflow, PyTorch o NULL. DistributionConfiguration
environmentId El identificador de recurso de ARM de la especificación del entorno para el trabajo. cuerda
environmentVariables Variables de entorno incluidas en el trabajo. commandJobEnvironmentVariables
experimentName Nombre del experimento al que pertenece el trabajo. Si no se establece, el trabajo se coloca en el experimento "Predeterminado". cuerda
identidad Configuración de identidad. Si se establece, debe ser uno de AmlToken, ManagedIdentity o NULL.
El valor predeterminado es AmlToken si es null.
IdentityConfiguration
inputDataBindings Asignación de enlaces de datos de entrada usados en el trabajo. CommandJobInputDataBindings
jobType [Obligatorio] Especifica el tipo de trabajo. 'Command' (obligatorio)
outputDataBindings Asignación de enlaces de datos de salida usados en el trabajo. CommandJobOutputDataBindings
prioridad Prioridad del trabajo para la directiva de programación. Solo se aplica a AMLCompute.
Característica de vista previa privada y solo disponible para los usuarios en la lista de permitidos.
Int
interrupción Duración máxima de la ejecución en formato ISO 8601, después del cual se cancelará el trabajo. Solo admite la duración con una precisión tan baja como Segundos. cuerda

CommandJobEnvironmentVariables

Nombre Descripción Valor

CommandJobInputDataBindings

Nombre Descripción Valor

CommandJobOutputDataBindings

Nombre Descripción Valor

ComputeConfiguration

Nombre Descripción Valor
instanceCount Número de instancias o nodos. Int
instanceType Tipo de SKU en el que se ejecutará. cuerda
isLocal Establézcalo en true para los trabajos que se ejecutan en el proceso local. Bool
ubicación Ubicación de la ejecución del clúster virtual. cuerda
Propiedades Propiedades adicionales. ComputeConfigurationProperties
blanco Id. de recurso de ARM del proceso al que va dirigido. Si no se proporciona, el recurso se implementará como administrado. cuerda

ComputeConfigurationProperties

Nombre Descripción Valor

DistributionConfiguration

Nombre Descripción Valor
distributionType Establezca en "Mpi" para el tipo Mpi. Establezca en "PyTorch" para el tipo PyTorch. Establezca en "TensorFlow" para el tipo TensorFlow. 'Mpi'
'PyTorch'
'TensorFlow' (obligatorio)

EarlyTerminationPolicy

Nombre Descripción Valor
delayEvaluation Número de intervalos por los que se va a retrasar la primera evaluación. Int
evaluationInterval Intervalo (número de ejecuciones) entre evaluaciones de directivas. Int
policyType Establezca en "Bandit" para el tipo BanditPolicy. Establezca en "MedianStopping" para el tipo MedianStoppingPolicy. Establezca en "TruncationSelection" para el tipo TruncationSelectionPolicy. 'Bandido'
"MedianStopping"
'TruncationSelection' (obligatorio)

IdentityConfiguration

Nombre Descripción Valor
identityType Establezca en "AMLToken" para el tipo AmlToken. Establezca en "Administrado" para el tipo ManagedIdentity. 'AMLToken'
"Administrado" (obligatorio)

InputDataBinding

Nombre Descripción Valor
dataId Identificador de recurso de ARM de dataVersion registrado. cuerda
modo Mecanismo para acceder al artefacto de datos. 'Directo'
'Descargar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Cargar'
pathOnCompute Ubicación de los datos dentro del proceso de contenedor. cuerda

JobBase

Nombre Descripción Valor
descripción Texto de descripción del recurso. cuerda
jobType Establezca en "Command" para el tipo CommandJob. Establezca en "Barrido" para el tipo SweepJob. 'Command'
'Barrido' (obligatorio)
Propiedades Diccionario de propiedades de recurso. JobBaseProperties
Etiquetas Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar. JobBaseTags

JobBaseProperties

Nombre Descripción Valor

JobBaseTags

Nombre Descripción Valor

ManagedIdentity

Nombre Descripción Valor
clientId Especifica una identidad asignada por el usuario por identificador de cliente. En el caso de asignados por el sistema, no establezca este campo. cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
identityType [Obligatorio] Especifica el tipo de marco de identidad. "Administrado" (obligatorio)
objectId Especifica una identidad asignada por el usuario por identificador de objeto. En el caso de asignados por el sistema, no establezca este campo. cuerda

Restricciones:
Longitud mínima = 36
Longitud máxima = 36
Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Especifica una identidad asignada por el usuario por el identificador de recurso de ARM. En el caso de asignados por el sistema, no establezca este campo. cuerda

MedianStoppingPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'MedianStopping' (obligatorio)

Microsoft.MachineLearningServices/workspaces/jobs

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Patrón = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: áreas de trabajo
Propiedades [Obligatorio] Atributos adicionales de la entidad. JobBase (obligatorio)
tipo El tipo de recurso "Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview"

Mpi

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'Mpi' (obligatorio)
processCountPerInstance Número de procesos por nodo MPI. Int

Objetivo

Nombre Descripción Valor
Gol [Obligatorio] Define los objetivos de métrica admitidos para el ajuste de hiperparámetros 'Maximizar'
'Minimizar' (obligatorio)
primaryMetric [Obligatorio] Nombre de la métrica que se va a optimizar. cuerda

Restricciones:
Patrón = [a-zA-Z0-9_] (obligatorio)

OutputDataBinding

Nombre Descripción Valor
datastoreId Identificador de recurso de ARM del almacén de datos donde se almacenará la salida de datos. cuerda
modo Mecanismo para el movimiento de datos al almacén de datos. 'Directo'
'Descargar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Cargar'
pathOnCompute Ubicación de los datos dentro del proceso de contenedor. cuerda
pathOnDatastore Ruta de acceso dentro del almacén de datos a los datos. cuerda

PyTorch

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'PyTorch' (obligatorio)
processCount Recuento total de procesos para el trabajo distribuido. Int

SweepJob

Nombre Descripción Valor
algoritmo [Obligatorio] Tipo de los algoritmos de muestreo de hiperparámetros 'Bayesiano'
'Grid'
'Random' (obligatorio)
calcular [Obligatorio] Enlace de proceso para el trabajo. ComputeConfiguration (obligatorio)
earlyTermination Las directivas de terminación anticipada permiten cancelar ejecuciones de bajo rendimiento antes de completarse. EarlyTerminationPolicy
experimentName Nombre del experimento al que pertenece el trabajo. Si no se establece, el trabajo se coloca en el experimento "Predeterminado". cuerda
identidad Configuración de identidad. Si se establece, debe ser uno de AmlToken, ManagedIdentity o NULL.
El valor predeterminado es AmlToken si es null.
IdentityConfiguration
jobType [Obligatorio] Especifica el tipo de trabajo. 'Barrido' (obligatorio)
maxConcurrentTrials Límite superior del número de pruebas realizadas en paralelo. Int
maxTotalTrials Límite superior en el número de pruebas que se van a realizar. Int
objetivo [Obligatorio] Objetivo de optimización. objetivo (obligatorio)
prioridad Prioridad del trabajo para la directiva de programación. Solo se aplica a AMLCompute.
Característica de vista previa privada y solo disponible para los usuarios en la lista de permitidos.
Int
searchSpace [Obligatorio] Diccionario que contiene cada parámetro y su distribución. La clave de diccionario es el nombre del parámetro . SweepJobSearchSpace (obligatorio)
interrupción Tiempo de espera total en formato ISO 8601. Solo admite la duración con una precisión tan baja como Minutos. cuerda
juicio Definición del componente de prueba. TrialComponent de

SweepJobSearchSpace

Nombre Descripción Valor

TensorFlow

Nombre Descripción Valor
distributionType [Obligatorio] Especifica el tipo de marco de distribución. 'TensorFlow' (obligatorio)
parameterServerCount Número de tareas del servidor de parámetros. Int
workerCount Número de trabajadores. Sobrescribe el número de nodos en el enlace de proceso. Int

TrialComponent

Nombre Descripción Valor
codeId Identificador de recurso de ARM del recurso de código. cuerda
mandar [Obligatorio] Comando que se va a ejecutar al iniciar el trabajo. Eg. "python train.py" cuerda

Restricciones:
Longitud mínima = 1
Patrón = [a-zA-Z0-9_] (obligatorio)
distribución Configuración de distribución del trabajo. Si se establece, debe ser uno de Mpi, Tensorflow, PyTorch o NULL. DistributionConfiguration
environmentId El identificador de recurso de ARM de la especificación del entorno para el trabajo. cuerda
environmentVariables Variables de entorno incluidas en el trabajo. TrialComponentEnvironmentVariables
inputDataBindings Asignación de enlaces de datos de entrada usados en el trabajo. trialComponentInputDataBindings
outputDataBindings Asignación de enlaces de datos de salida usados en el trabajo. TrialComponentOutputDataBindings
interrupción Duración máxima de la ejecución en formato ISO 8601, después del cual se cancelará el componente de prueba.
Solo admite la duración con una precisión tan baja como Segundos.
cuerda

TrialComponentEnvironmentVariables

Nombre Descripción Valor

TrialComponentInputDataBindings

Nombre Descripción Valor

TrialComponentOutputDataBindings

Nombre Descripción Valor

TruncationSelectionPolicy

Nombre Descripción Valor
policyType [Obligatorio] Nombre de la configuración de directiva 'TruncationSelection' (obligatorio)
truncationPercentage Porcentaje de ejecuciones que se cancelarán en cada intervalo de evaluación. Int