Partilhar via


Áreas de trabalho/tarefas Microsoft.MachineLearningServices 2021-03-01-preview

Definição de recurso do Bicep

O tipo de recurso áreas de trabalho/tarefas pode ser implementado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces/jobs, adicione o seguinte Bicep ao seu modelo.

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

Objetos JobBase

Defina a propriedade jobType para especificar o tipo de objeto.

Para Comando, utilize:

  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'

Para Varrer, utilize:

  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'
  }

Objetos DistributionConfiguration

Defina a propriedade distributionType para especificar o tipo de objeto.

Para MPI, utilize:

  distributionType: 'Mpi'
  processCountPerInstance: int

Para o PyTorch, utilize:

  distributionType: 'PyTorch'
  processCount: int

Para o TensorFlow, utilize:

  distributionType: 'TensorFlow'
  parameterServerCount: int
  workerCount: int

Objetos IdentityConfiguration

Defina a propriedade identityType para especificar o tipo de objeto.

Para AMLToken, utilize:

  identityType: 'AMLToken'

Para Gerido, utilize:

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

Objetos EarlyTerminationPolicy

Defina a propriedade policyType para especificar o tipo de objeto.

Para Bandido, utilize:

  policyType: 'Bandit'
  slackAmount: int
  slackFactor: int

Para MedianStopping, utilize:

  policyType: 'MedianStopping'

Para TruncationSelection, utilize:

  policyType: 'TruncationSelection'
  truncationPercentage: int

Valores de propriedade

áreas de trabalho/tarefas

Nome Descrição Valor
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados no Bicep.
cadeia (obrigatório)
principal No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal.

Para obter mais informações, veja Recurso subordinado fora do recurso principal.
Nome simbólico para recurso do tipo: áreas de trabalho
propriedades [Obrigatório] Atributos adicionais da entidade. JobBase (obrigatório)

JobBase

Nome Descrição Valor
descrição O texto de descrição do recurso. string
propriedades O dicionário da propriedade do recurso. JobBaseProperties
etiquetas Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas. objeto
jobType Definir o tipo de objeto Comando
Varrer (obrigatório)

JobBaseProperties

Nome Descrição Valor
{customized property} string

CommandJob

Nome Descrição Valor
jobType [Obrigatório] Especifica o tipo de tarefa. "Comando" (obrigatório)
codeId ID do recurso arm do recurso de código. string
command [Obrigatório] O comando a executar no arranque da tarefa. Por exemplo, "python train.py" cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
computação [Obrigatório] Enlace de computação para a tarefa. ComputeConfiguration (necessário)
distribuição Configuração de distribuição da tarefa. Se estiver definido, este deve ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId O ID de recurso do ARM da especificação ambiente da tarefa. string
environmentVariables Variáveis de ambiente incluídas na tarefa. CommandJobEnvironmentVariables
experimentName O nome da experimentação a que pertence a tarefa. Se não estiver definido, a tarefa é colocada na experimentação "Predefinição". string
identidade Configuração de identidade. Se estiver definido, este deve ser um de AmlToken, ManagedIdentity ou nulo.
A predefinição é AmlToken se for nula.
IdentityConfiguration
inputDataBindings Mapeamento de enlaces de dados de entrada utilizados na tarefa. CommandJobInputDataBindings
outputDataBindings Mapeamento de enlaces de dados de saída utilizados na tarefa. CommandJobOutputDataBindings
prioridade Prioridade da tarefa para a política de agendamento. Aplica-se apenas a AMLCompute.
Funcionalidade de pré-visualização privada e apenas disponível para utilizadores na lista de permissões.
int
tempo limite A duração máxima da execução no formato ISO 8601, após a qual a tarefa será cancelada. Suporta apenas a duração com precisão tão baixa como Segundos. string

ComputeConfiguration

Nome Descrição Valor
instanceCount Número de instâncias ou nós. int
instanceType Tipo de SKU para executar. string
isLocal Definido como verdadeiro para tarefas em execução na computação local. bool
localização Localização para a execução do cluster virtual. string
propriedades Propriedades adicionais. ComputeConfigurationProperties
destino ID de recurso do ARM da Computação que está a direcionar. Se não for fornecido, o recurso será implementado como Gerido. string

ComputeConfigurationProperties

Nome Descrição Valor
{customized property} string

DistributionConfiguration

Nome Descrição Valor
distributionType Definir o tipo de objeto Mpi
PyTorch
TensorFlow (obrigatório)

Mpi

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de arquitetura de distribuição. "Mpi" (obrigatório)
processCountPerInstance Número de processos por nó MPI. int

PyTorch

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de arquitetura de distribuição. "PyTorch" (obrigatório)
processCount Contagem total de processos para a tarefa distribuída. int

TensorFlow

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de arquitetura de distribuição. "TensorFlow" (obrigatório)
parameterServerCount Número de tarefas de servidor de parâmetros. int
workerCount Número de trabalhadores. Substitui a contagem de nós no enlace de computação. int

CommandJobEnvironmentVariables

Nome Descrição Valor
{customized property} string

IdentityConfiguration

Nome Descrição Valor
identityType Definir o tipo de objeto AMLToken
Gerido (obrigatório)

AmlToken

Nome Descrição Valor
identityType [Obrigatório] Especifica o tipo de arquitetura de identidade. "AMLToken" (obrigatório)

ManagedIdentity

Nome Descrição Valor
identityType [Obrigatório] Especifica o tipo de arquitetura de identidade. "Gerido" (obrigatório)
clientId Especifica uma identidade atribuída pelo utilizador pelo ID de cliente. Para a atribuição do sistema, não defina este campo. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Especifica uma identidade atribuída pelo utilizador pelo ID do objeto. Para a atribuição do sistema, não defina este campo. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Especifica uma identidade atribuída pelo utilizador pelo ID de recurso do ARM. Para a atribuição do sistema, não defina este campo. string

CommandJobInputDataBindings

Nome Descrição Valor
{customized property} InputDataBinding

InputDataBinding

Nome Descrição Valor
dataId ID do recurso arm dos dados registadosVersion. string
mode Mecanismo para aceder ao artefacto de dados. 'Direto'
'Transferir'
"EvalDownload"
"EvalMount"
'Montar'
"ReadOnlyMount"
"ReadWriteMount"
'Carregar'
pathOnCompute Localização dos dados dentro do processo de contentor. string

CommandJobOutputDataBindings

Nome Descrição Valor
{customized property} OutputDataBinding

OutputDataBinding

Nome Descrição Valor
datastoreId ID do recurso arm do arquivo de dados onde a saída de dados será armazenada. string
mode Mecanismo de movimento de dados para o arquivo de dados. 'Direto'
'Transferir'
"EvalDownload"
"EvalMount"
'Montar'
"ReadOnlyMount"
"ReadWriteMount"
'Carregar'
pathOnCompute Localização dos dados dentro do processo de contentor. string
pathOnDatastore Caminho no arquivo de dados para os dados. string

SweepJob

Nome Descrição Valor
jobType [Obrigatório] Especifica o tipo de tarefa. "Varrer" (obrigatório)
algoritmo [Obrigatório] Tipo de algoritmos de amostragem de hiperparâmetros 'Bayesian'
"Grelha"
"Aleatório" (obrigatório)
computação [Obrigatório] Enlace de computação para a tarefa. ComputeConfiguration (necessário)
earlyTermination As políticas de cessação antecipada permitem cancelar execuções com mau desempenho antes de serem concluídas. EarlyTerminationPolicy
experimentName O nome da experimentação a que pertence a tarefa. Se não estiver definido, a tarefa é colocada na experimentação "Predefinição". string
identidade Configuração de identidade. Se estiver definido, este deve ser um de AmlToken, ManagedIdentity ou nulo.
A predefinição é AmlToken se for nula.
IdentityConfiguration
maxConcurrentTrials Um limite superior no número de tentativas executadas em paralelo. int
maxTotalTrials Um limite superior no número de avaliações a executar. int
objetivo [Obrigatório] Objetivo de otimização. Objetivo (obrigatório)
prioridade Prioridade da tarefa para a política de agendamento. Aplica-se apenas a AMLCompute.
Funcionalidade de pré-visualização privada e apenas disponível para utilizadores na lista de permissões.
int
searchSpace [Obrigatório] Um dicionário que contém cada parâmetro e a respetiva distribuição. A chave do dicionário é o nome do parâmetro SweepJobSearchSpace (obrigatório)
tempo limite O tempo limite total no formato ISO 8601. Suporta apenas a duração com precisão tão baixa como Minutos. string
trial Definição do componente de avaliação. TrialComponent

EarlyTerminationPolicy

Nome Descrição Valor
delayEvaluation Número de intervalos para atrasar a primeira avaliação. int
evaluationInterval Intervalo (número de execuções) entre avaliações de políticas. int
policyType Definir o tipo de objeto Bandido
MedianStopping
TruncationSelection (necessário)

BanditPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "Bandido" (obrigatório)
slackAmount Distância absoluta permitida a partir da execução com melhor desempenho. int
slackFactor Proporção da distância permitida da execução com melhor desempenho. int

MedianStoppingPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "MedianStopping" (obrigatório)

TruncationSelectionPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "TruncationSelection" (obrigatório)
truncationPercentage A percentagem de execuções a cancelar em cada intervalo de avaliação. int

Objetivo

Nome Descrição Valor
goal [Obrigatório] Define os objetivos de métricas suportados para otimização de hiperparâmetros "Maximizar"
"Minimizar" (obrigatório)
primaryMetric [Obrigatório] Nome da métrica a otimizar. cadeia (obrigatório)

Restrições:
Padrão = [a-zA-Z0-9_]

SweepJobSearchSpace

Nome Descrição Valor
{customized property} Para Bicep, pode utilizar a função any( ).

TrialComponent

Nome Descrição Valor
codeId ID do recurso arm do recurso de código. string
command [Obrigatório] O comando a executar no arranque da tarefa. Por exemplo, "python train.py" cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
distribuição Configuração de distribuição da tarefa. Se estiver definido, este deve ser um Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId O ID de recurso do ARM da especificação do Ambiente para a tarefa. string
environmentVariables Variáveis de ambiente incluídas na tarefa. TrialComponentEnvironmentVariables
inputDataBindings Mapeamento de enlaces de dados de entrada utilizados na tarefa. TrialComponentInputDataBindings
outputDataBindings Mapeamento de enlaces de dados de saída utilizados na tarefa. TrialComponentOutputDataBindings
tempo limite A duração máxima da execução no formato ISO 8601, após a qual o componente de avaliação será cancelado.
Só suporta a duração com precisão tão baixa como Segundos.
string

TrialComponentEnvironmentVariables

Nome Descrição Valor
{customized property} string

TrialComponentInputDataBindings

Nome Descrição Valor
{customized property} InputDataBinding

TrialComponentOutputDataBindings

Nome Descrição Valor
{customized property} OutputDataBinding

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criar uma tarefa de classificação de AutoML do Azure Machine Learning

Implementar no Azure
Este modelo cria uma tarefa de classificação de AutoML do Azure Machine Learning para descobrir o melhor modelo para prever se um cliente subscreverá um depósito a prazo fixo com uma instituição financeira.
Criar uma tarefa do Comando do Azure Machine Learning

Implementar no Azure
Este modelo cria uma tarefa do Comando do Azure Machine Learning com um script de hello_world básico
Criar uma tarefa de Varrimento do Azure Machine Learning

Implementar no Azure
Este modelo cria uma tarefa de Varrimento do Azure Machine Learning para otimização de hiperparâmetros.

Definição de recurso do modelo arm

O tipo de recurso áreas de trabalho/tarefas pode ser implementado com operações direcionadas:

Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces/jobs, adicione o seguinte JSON ao seu modelo.

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

Defina a propriedade jobType para especificar o tipo de objeto.

Para Comando, utilize:

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

Para Varrer, utilize:

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

Objetos DistributionConfiguration

Defina a propriedade distributionType para especificar o tipo de objeto.

Para MPI, utilize:

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

Para o PyTorch, utilize:

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

Para o TensorFlow, utilize:

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

Objetos IdentityConfiguration

Defina a propriedade identityType para especificar o tipo de objeto.

Para AMLToken, utilize:

  "identityType": "AMLToken"

Para Gerido, utilize:

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

Objetos EarlyTerminationPolicy

Defina a propriedade policyType para especificar o tipo de objeto.

Para Bandido, utilize:

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

Para MedianStopping, utilize:

  "policyType": "MedianStopping"

Para TruncationSelection, utilize:

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

Valores de propriedade

áreas de trabalho/tarefas

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.MachineLearningServices/workspaces/jobs"
apiVersion A versão da API de recursos '2021-03-01-preview'
name O nome do recurso

Veja como definir nomes e tipos para recursos subordinados em modelos do ARM JSON.
cadeia (obrigatório)
propriedades [Obrigatório] Atributos adicionais da entidade. JobBase (obrigatório)

JobBase

Nome Descrição Valor
descrição O texto de descrição do recurso. string
propriedades O dicionário da propriedade do recurso. JobBaseProperties
etiquetas Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas. objeto
jobType Definir o tipo de objeto Comando
Varrer (obrigatório)

JobBaseProperties

Nome Descrição Valor
{customized property} string

CommandJob

Nome Descrição Valor
jobType [Obrigatório] Especifica o tipo de tarefa. "Comando" (obrigatório)
codeId ID do recurso arm do recurso de código. string
command [Obrigatório] O comando a executar no arranque da tarefa. Por exemplo, "python train.py" cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
computação [Obrigatório] Enlace de computação para a tarefa. ComputeConfiguration (necessário)
distribuição Configuração de distribuição da tarefa. Se estiver definido, este deve ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId O ID de recurso do ARM da especificação ambiente da tarefa. string
environmentVariables Variáveis de ambiente incluídas na tarefa. CommandJobEnvironmentVariables
experimentName O nome da experimentação a que pertence a tarefa. Se não estiver definido, a tarefa é colocada na experimentação "Predefinição". string
identidade Configuração de identidade. Se estiver definido, este deve ser um de AmlToken, ManagedIdentity ou nulo.
A predefinição é AmlToken se for nula.
IdentityConfiguration
inputDataBindings Mapeamento de enlaces de dados de entrada utilizados na tarefa. CommandJobInputDataBindings
outputDataBindings Mapeamento de enlaces de dados de saída utilizados na tarefa. CommandJobOutputDataBindings
prioridade Prioridade da tarefa para a política de agendamento. Aplica-se apenas a AMLCompute.
Funcionalidade de pré-visualização privada e disponível apenas para utilizadores na lista de permissões.
int
tempo limite A duração máxima da execução no formato ISO 8601, após a qual a tarefa será cancelada. Só suporta a duração com precisão tão baixa como Segundos. string

ComputeConfiguration

Nome Descrição Valor
instanceCount Número de instâncias ou nós. int
instanceType Tipo de SKU a executar. string
isLocal Definido como verdadeiro para tarefas em execução na computação local. bool
localização Localização da execução do cluster virtual. string
propriedades Propriedades adicionais. ComputeConfigurationProperties
destino ID de recurso arm da Computação que está a filtrar. Se não for fornecido, o recurso será implementado como Gerido. string

ComputeConfigurationProperties

Nome Descrição Valor
{customized property} string

DistributionConfiguration

Nome Descrição Valor
distributionType Definir o tipo de objeto Mpi
PyTorch
TensorFlow (obrigatório)

Mpi

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de estrutura de distribuição. "Mpi" (obrigatório)
processCountPerInstance Número de processos por nó MPI. int

PyTorch

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de estrutura de distribuição. "PyTorch" (obrigatório)
processCount Contagem total de processos para a tarefa distribuída. int

TensorFlow

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de estrutura de distribuição. "TensorFlow" (obrigatório)
parameterServerCount Número de tarefas de servidor de parâmetros. int
workerCount Número de trabalhadores. Substitui a contagem de nós no enlace de computação. int

CommandJobEnvironmentVariables

Nome Descrição Valor
{customized property} string

IdentityConfiguration

Nome Descrição Valor
identityType Definir o tipo de objeto AMLToken
Gerido (obrigatório)

AmlToken

Nome Descrição Valor
identityType [Obrigatório] Especifica o tipo de arquitetura de identidade. "AMLToken" (obrigatório)

ManagedIdentity

Nome Descrição Valor
identityType [Obrigatório] Especifica o tipo de arquitetura de identidade. "Gerido" (obrigatório)
clientId Especifica uma identidade atribuída pelo utilizador pelo ID de cliente. Para a atribuição do sistema, não defina este campo. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Especifica uma identidade atribuída pelo utilizador pelo ID do objeto. Para a atribuição do sistema, não defina este campo. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Especifica uma identidade atribuída pelo utilizador pelo ID de recurso do ARM. Para a atribuição do sistema, não defina este campo. string

CommandJobInputDataBindings

Nome Descrição Valor
{customized property} InputDataBinding

InputDataBinding

Nome Descrição Valor
dataId ID do recurso arm dos dados registadosVersion. string
mode Mecanismo para aceder ao artefacto de dados. 'Direto'
'Transferir'
"EvalDownload"
"EvalMount"
'Montar'
"ReadOnlyMount"
"ReadWriteMount"
'Carregar'
pathOnCompute Localização dos dados dentro do processo de contentor. string

CommandJobOutputDataBindings

Nome Descrição Valor
{customized property} OutputDataBinding

OutputDataBinding

Nome Descrição Valor
datastoreId ID do recurso arm do arquivo de dados onde a saída de dados será armazenada. string
mode Mecanismo de movimento de dados para o arquivo de dados. 'Direto'
'Transferir'
"EvalDownload"
"EvalMount"
'Montar'
"ReadOnlyMount"
"ReadWriteMount"
'Carregar'
pathOnCompute Localização dos dados dentro do processo de contentor. string
pathOnDatastore Caminho no arquivo de dados para os dados. string

SweepJob

Nome Descrição Valor
jobType [Obrigatório] Especifica o tipo de tarefa. "Varrer" (obrigatório)
algoritmo [Obrigatório] Tipo de algoritmos de amostragem de hiperparâmetros 'Bayesian'
"Grelha"
"Aleatório" (obrigatório)
computação [Obrigatório] Enlace de computação para a tarefa. ComputeConfiguration (obrigatório)
earlyTermination As políticas de cessação antecipada permitem cancelar execuções com mau desempenho antes de serem concluídas. EarlyTerminationPolicy
experimentName O nome da experimentação a que pertence a tarefa. Se não estiver definido, a tarefa é colocada na experimentação "Predefinição". string
identidade Configuração de identidade. Se estiver definido, este deve ser de AmlToken, ManagedIdentity ou nulo.
A predefinição é AmlToken se for nulo.
IdentityConfiguration
maxConcurrentTrials Um limite superior no número de tentativas executadas em paralelo. int
maxTotalTrials Um limite superior no número de tentativas a executar. int
objetivo [Obrigatório] Objetivo de otimização. Objetivo (obrigatório)
prioridade Prioridade da tarefa para a política de agendamento. Aplica-se apenas a AMLCompute.
Funcionalidade de pré-visualização privada e disponível apenas para utilizadores na lista de permissões.
int
searchSpace [Obrigatório] Um dicionário que contém cada parâmetro e a respetiva distribuição. A chave do dicionário é o nome do parâmetro SweepJobSearchSpace (obrigatório)
tempo limite O tempo limite total no formato ISO 8601. Só suporta a duração com precisão tão baixa como Minutos. string
trial Definição do componente de avaliação. TrialComponent

EarlyTerminationPolicy

Nome Descrição Valor
delayEvaluation Número de intervalos para atrasar a primeira avaliação. int
evaluationInterval Intervalo (número de execuções) entre avaliações de políticas. int
policyType Definir o tipo de objeto Bandit
MedianStopping
TruncationSelection (obrigatório)

BanditPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "Bandit" (obrigatório)
slackAmount Distância absoluta permitida da execução com melhor desempenho. int
slackFactor Proporção da distância permitida da execução com melhor desempenho. int

MedianStoppingPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "MedianStopping" (obrigatório)

TruncationSelectionPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "TruncationSelection" (obrigatório)
truncationPercentage A percentagem de execuções a cancelar em cada intervalo de avaliação. int

Objetivo

Nome Descrição Valor
goal [Obrigatório] Define os objetivos de métricas suportados para otimização de hiperparâmetros "Maximizar"
"Minimizar" (obrigatório)
primaryMetric [Obrigatório] Nome da métrica a otimizar. cadeia (obrigatório)

Restrições:
Padrão = [a-zA-Z0-9_]

SweepJobSearchSpace

Nome Descrição Valor
{customized property}

TrialComponent

Nome Descrição Valor
codeId ID do recurso arm do recurso de código. string
command [Obrigatório] O comando a executar no arranque da tarefa. Por exemplo, "python train.py" cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
distribuição Configuração de distribuição da tarefa. Se estiver definido, este deve ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId O ID de recurso do ARM da especificação ambiente da tarefa. string
environmentVariables Variáveis de ambiente incluídas na tarefa. TrialComponentEnvironmentVariables
inputDataBindings Mapeamento de enlaces de dados de entrada utilizados na tarefa. TrialComponentInputDataBindings
outputDataBindings Mapeamento de enlaces de dados de saída utilizados na tarefa. TrialComponentOutputDataBindings
tempo limite A duração máxima da execução no formato ISO 8601, após o qual o componente de avaliação será cancelado.
Suporta apenas a duração com precisão tão baixa como Segundos.
string

TrialComponentEnvironmentVariables

Nome Descrição Valor
{customized property} string

TrialComponentInputDataBindings

Nome Descrição Valor
{customized property} InputDataBinding

TrialComponentOutputDataBindings

Nome Descrição Valor
{customized property} OutputDataBinding

Modelos de início rápido

Os seguintes modelos de início rápido implementam este tipo de recurso.

Modelo Description
Criar uma tarefa de classificação autoML do Azure Machine Learning

Implementar no Azure
Este modelo cria uma tarefa de classificação autoML do Azure Machine Learning para descobrir o melhor modelo para prever se um cliente subscreverá um depósito a prazo fixo com uma instituição financeira.
Criar uma tarefa do Comando do Azure Machine Learning

Implementar no Azure
Este modelo cria uma tarefa do Comando do Azure Machine Learning com um script de hello_world básico
Criar uma tarefa do Azure Machine Learning Sweep

Implementar no Azure
Este modelo cria uma tarefa do Azure Machine Learning Sweep para otimização de hiperparâmetros.

Definição de recurso do Terraform (fornecedor AzAPI)

O tipo de recurso áreas de trabalho/tarefas pode ser implementado com operações que visam:

  • Grupos de recursos

Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.

Formato do recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces/jobs, adicione o seguinte Terraform ao seu modelo.

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

Objetos JobBase

Defina a propriedade jobType para especificar o tipo de objeto.

Para Comando, utilize:

  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"

Para Varrer, utilize:

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

Objetos DistributionConfiguration

Defina a propriedade distributionType para especificar o tipo de objeto.

Para MPI, utilize:

  distributionType = "Mpi"
  processCountPerInstance = int

Para o PyTorch, utilize:

  distributionType = "PyTorch"
  processCount = int

Para o TensorFlow, utilize:

  distributionType = "TensorFlow"
  parameterServerCount = int
  workerCount = int

Objetos IdentityConfiguration

Defina a propriedade identityType para especificar o tipo de objeto.

Para AMLToken, utilize:

  identityType = "AMLToken"

Para Gerido, utilize:

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

Objetos EarlyTerminationPolicy

Defina a propriedade policyType para especificar o tipo de objeto.

Para Bandido, utilize:

  policyType = "Bandit"
  slackAmount = int
  slackFactor = int

Para MedianStopping, utilize:

  policyType = "MedianStopping"

Para TruncationSelection, utilize:

  policyType = "TruncationSelection"
  truncationPercentage = int

Valores de propriedade

áreas de trabalho/tarefas

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview"
name O nome do recurso cadeia (obrigatório)
parent_id O ID do recurso que é o principal para este recurso. ID do recurso do tipo: áreas de trabalho
propriedades [Obrigatório] Atributos adicionais da entidade. JobBase (obrigatório)

JobBase

Nome Descrição Valor
descrição O texto de descrição do recurso. string
propriedades O dicionário da propriedade do recurso. JobBaseProperties
etiquetas Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas. objeto
jobType Definir o tipo de objeto Comando
Varrer (obrigatório)

JobBaseProperties

Nome Descrição Valor
{customized property} string

CommandJob

Nome Descrição Valor
jobType [Obrigatório] Especifica o tipo de tarefa. "Comando" (obrigatório)
codeId ID do recurso arm do recurso de código. string
command [Obrigatório] O comando a executar no arranque da tarefa. Por exemplo, "python train.py" cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
computação [Obrigatório] Enlace de computação para a tarefa. ComputeConfiguration (obrigatório)
distribuição Configuração de distribuição da tarefa. Se estiver definido, este deve ser um Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId O ID de recurso do ARM da especificação do Ambiente para a tarefa. string
environmentVariables Variáveis de ambiente incluídas na tarefa. CommandJobEnvironmentVariables
experimentName O nome da experimentação a que pertence a tarefa. Se não estiver definido, a tarefa é colocada na experimentação "Predefinição". string
identidade Configuração de identidade. Se estiver definido, este deve ser de AmlToken, ManagedIdentity ou nulo.
A predefinição é AmlToken se for nulo.
IdentityConfiguration
inputDataBindings Mapeamento de enlaces de dados de entrada utilizados na tarefa. CommandJobInputDataBindings
outputDataBindings Mapeamento de enlaces de dados de saída utilizados na tarefa. CommandJobOutputDataBindings
prioridade Prioridade da tarefa para a política de agendamento. Aplica-se apenas a AMLCompute.
Funcionalidade de pré-visualização privada e disponível apenas para utilizadores na lista de permissões.
int
tempo limite A duração máxima da execução no formato ISO 8601, após a qual a tarefa será cancelada. Só suporta a duração com precisão tão baixa como Segundos. string

ComputeConfiguration

Nome Descrição Valor
instanceCount Número de instâncias ou nós. int
instanceType Tipo de SKU a executar. string
isLocal Definido como verdadeiro para tarefas em execução na computação local. bool
localização Localização da execução do cluster virtual. string
propriedades Propriedades adicionais. ComputeConfigurationProperties
destino ID de recurso arm da Computação que está a filtrar. Se não for fornecido, o recurso será implementado como Gerido. string

ComputeConfigurationProperties

Nome Descrição Valor
{customized property} string

DistributionConfiguration

Nome Descrição Valor
distributionType Definir o tipo de objeto Mpi
PyTorch
TensorFlow (obrigatório)

Mpi

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de estrutura de distribuição. "Mpi" (obrigatório)
processCountPerInstance Número de processos por nó MPI. int

PyTorch

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de estrutura de distribuição. "PyTorch" (obrigatório)
processCount Contagem total de processos para a tarefa distribuída. int

TensorFlow

Nome Descrição Valor
distributionType [Obrigatório] Especifica o tipo de estrutura de distribuição. "TensorFlow" (obrigatório)
parameterServerCount Número de tarefas de servidor de parâmetros. int
workerCount Número de trabalhadores. Substitui a contagem de nós no enlace de computação. int

CommandJobEnvironmentVariables

Nome Descrição Valor
{customized property} string

IdentityConfiguration

Nome Descrição Valor
identityType Definir o tipo de objeto AMLToken
Gerido (obrigatório)

AmlToken

Nome Descrição Valor
identityType [Obrigatório] Especifica o tipo de arquitetura de identidade. "AMLToken" (obrigatório)

ManagedIdentity

Nome Descrição Valor
identityType [Obrigatório] Especifica o tipo de arquitetura de identidade. "Gerido" (obrigatório)
clientId Especifica uma identidade atribuída pelo utilizador pelo ID de cliente. Para a atribuição do sistema, não defina este campo. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Especifica uma identidade atribuída pelo utilizador por ID de objeto. Para a atribuição do sistema, não defina este campo. string

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Especifica uma identidade atribuída pelo utilizador pelo ID de recurso do ARM. Para a atribuição do sistema, não defina este campo. string

CommandJobInputDataBindings

Nome Descrição Valor
{customized property} InputDataBinding

InputDataBinding

Nome Descrição Valor
dataId ID do recurso arm dos dados registadosVersion. string
mode Mecanismo para aceder ao artefacto de dados. "Direto"
"Transferir"
"EvalDownload"
"EvalMount"
"Montar"
"ReadOnlyMount"
"ReadWriteMount"
"Carregar"
pathOnCompute Localização dos dados dentro do processo de contentor. string

CommandJobOutputDataBindings

Nome Descrição Valor
{customized property} OutputDataBinding

OutputDataBinding

Nome Descrição Valor
datastoreId ID do recurso arm do arquivo de dados onde a saída de dados será armazenada. string
mode Mecanismo de movimento de dados para o arquivo de dados. "Direto"
"Transferir"
"EvalDownload"
"EvalMount"
"Montar"
"ReadOnlyMount"
"ReadWriteMount"
"Carregar"
pathOnCompute Localização dos dados dentro do processo de contentor. string
pathOnDatastore Caminho dentro do arquivo de dados para os dados. string

SweepJob

Nome Descrição Valor
jobType [Obrigatório] Especifica o tipo de tarefa. "Varrer" (obrigatório)
algoritmo [Obrigatório] Tipo de algoritmos de amostragem de hiperparâmetros "Bayesian"
"Grelha"
"Aleatório" (obrigatório)
computação [Obrigatório] Enlace de computação para a tarefa. ComputeConfiguration (obrigatório)
earlyTermination As políticas de cessação antecipada permitem cancelar execuções com mau desempenho antes de serem concluídas. EarlyTerminationPolicy
experimentName O nome da experimentação a que pertence a tarefa. Se não estiver definido, a tarefa é colocada na experimentação "Predefinição". string
identidade Configuração de identidade. Se estiver definido, este deve ser de AmlToken, ManagedIdentity ou nulo.
A predefinição é AmlToken se for nulo.
IdentityConfiguration
maxConcurrentTrials Um limite superior no número de tentativas executadas em paralelo. int
maxTotalTrials Um limite superior no número de tentativas a executar. int
objetivo [Obrigatório] Objetivo de otimização. Objetivo (obrigatório)
prioridade Prioridade da tarefa para a política de agendamento. Aplica-se apenas a AMLCompute.
Funcionalidade de pré-visualização privada e disponível apenas para utilizadores na lista de permissões.
int
searchSpace [Obrigatório] Um dicionário que contém cada parâmetro e a respetiva distribuição. A chave do dicionário é o nome do parâmetro SweepJobSearchSpace (obrigatório)
tempo limite O tempo limite total no formato ISO 8601. Só suporta a duração com precisão tão baixa como Minutos. string
trial Definição do componente de avaliação. TrialComponent

EarlyTerminationPolicy

Nome Descrição Valor
delayEvaluation Número de intervalos para atrasar a primeira avaliação. int
evaluationInterval Intervalo (número de execuções) entre avaliações de políticas. int
policyType Definir o tipo de objeto Bandit
MedianStopping
TruncationSelection (obrigatório)

BanditPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "Bandit" (obrigatório)
slackAmount Distância absoluta permitida da execução com melhor desempenho. int
slackFactor Proporção da distância permitida da execução com melhor desempenho. int

MedianStoppingPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "MedianStopping" (obrigatório)

TruncationSelectionPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração da política "TruncationSelection" (obrigatório)
truncationPercentage A percentagem de execuções a cancelar em cada intervalo de avaliação. int

Objetivo

Nome Descrição Valor
goal [Obrigatório] Define os objetivos de métricas suportados para otimização de hiperparâmetros "Maximizar"
"Minimizar" (obrigatório)
primaryMetric [Obrigatório] Nome da métrica a otimizar. cadeia (obrigatório)

Restrições:
Padrão = [a-zA-Z0-9_]

SweepJobSearchSpace

Nome Descrição Valor
{customized property}

TrialComponent

Nome Descrição Valor
codeId ID do recurso arm do recurso de código. string
command [Obrigatório] O comando a executar no arranque da tarefa. Por exemplo, "python train.py" cadeia (obrigatório)

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_]
distribuição Configuração de distribuição da tarefa. Se estiver definido, este deve ser um Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId O ID de recurso do ARM da especificação ambiente da tarefa. string
environmentVariables Variáveis de ambiente incluídas na tarefa. TrialComponentEnvironmentVariables
inputDataBindings Mapeamento de enlaces de dados de entrada utilizados na tarefa. TrialComponentInputDataBindings
outputDataBindings Mapeamento de enlaces de dados de saída utilizados na tarefa. TrialComponentOutputDataBindings
tempo limite A duração máxima da execução no formato ISO 8601, após o qual o componente de avaliação será cancelado.
Suporta apenas a duração com precisão tão baixa como Segundos.
string

TrialComponentEnvironmentVariables

Nome Descrição Valor
{customized property} string

TrialComponentInputDataBindings

Nome Descrição Valor
{customized property} InputDataBinding

TrialComponentOutputDataBindings

Nome Descrição Valor
{customized property} OutputDataBinding