Áreas de trabalho/tarefas Microsoft.MachineLearningServices 2022-05-01
Definição de recurso do Bicep
O tipo de recurso áreas de trabalho/tarefas pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de 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 Bicep ao seu modelo.
resource symbolicname 'Microsoft.MachineLearningServices/workspaces/jobs@2022-05-01' = {
name: 'string'
parent: resourceSymbolicName
properties: {
computeId: 'string'
description: 'string'
displayName: 'string'
experimentName: 'string'
identity: {
identityType: 'string'
// For remaining properties, see IdentityConfiguration objects
}
isArchived: bool
properties: {}
services: {}
tags: {}
jobType: 'string'
// For remaining properties, see JobBaseProperties objects
}
}
Objetos JobBaseProperties
Defina a propriedade jobType para especificar o tipo de objeto.
Para Comando, utilize:
jobType: 'Command'
codeId: 'string'
command: 'string'
distribution: {
distributionType: 'string'
// For remaining properties, see DistributionConfiguration objects
}
environmentId: 'string'
environmentVariables: {}
inputs: {}
limits: {
jobLimitsType: 'string'
timeout: 'string'
}
outputs: {}
resources: {
instanceCount: int
instanceType: 'string'
properties: {}
}
Para Pipeline, utilize:
jobType: 'Pipeline'
inputs: {}
jobs: {}
outputs: {}
settings: any()
Para Varrer, utilize:
jobType: 'Sweep'
earlyTermination: {
delayEvaluation: int
evaluationInterval: int
policyType: 'string'
// For remaining properties, see EarlyTerminationPolicy objects
}
inputs: {}
limits: {
jobLimitsType: 'string'
maxConcurrentTrials: int
maxTotalTrials: int
timeout: 'string'
trialTimeout: 'string'
}
objective: {
goal: 'string'
primaryMetric: 'string'
}
outputs: {}
samplingAlgorithm: {
samplingAlgorithmType: 'string'
// For remaining properties, see SamplingAlgorithm objects
}
searchSpace: any()
trial: {
codeId: 'string'
command: 'string'
distribution: {
distributionType: 'string'
// For remaining properties, see DistributionConfiguration objects
}
environmentId: 'string'
environmentVariables: {}
resources: {
instanceCount: int
instanceType: 'string'
properties: {}
}
}
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'
Para UserIdentity, utilize:
identityType: 'UserIdentity'
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'
processCountPerInstance: int
Para o TensorFlow, utilize:
distributionType: 'TensorFlow'
parameterServerCount: int
workerCount: int
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
SamplingAlgorithm objects (Objetos SamplingAlgorithm)
Defina a propriedade samplingAlgorithmType para especificar o tipo de objeto.
Para Bayesian, utilize:
samplingAlgorithmType: 'Bayesian'
Para Grelha, utilize:
samplingAlgorithmType: 'Grid'
Para Aleatório, utilize:
samplingAlgorithmType: 'Random'
rule: 'string'
seed: 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. | JobBaseProperties (obrigatório) |
JobBaseProperties
Nome | Descrição | Valor |
---|---|---|
computeId | ID do recurso arm do recurso de computação. | string |
descrição | O texto de descrição do recurso. | string |
displayName | Nome a apresentar da tarefa. | string |
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, UserIdentity ou null. A predefinição é AmlToken se for nula. |
IdentityConfiguration |
isArchived | O recurso está arquivado? | bool |
propriedades | O dicionário da propriedade do recurso. | objeto |
services | Lista de JobEndpoints. Para tarefas locais, um ponto final de tarefa terá um valor de ponto final de FileStreamObject. |
objeto |
etiquetas | Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas. | objeto |
jobType | Definir o tipo de objeto | Comando Pipeline Varrer (obrigatório) |
IdentityConfiguration
Nome | Descrição | Valor |
---|---|---|
identityType | Definir o tipo de objeto | AMLToken Gerido UserIdentity (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 |
UserIdentity
Nome | Descrição | Valor |
---|---|---|
identityType | [Obrigatório] Especifica o tipo de arquitetura de identidade. | "UserIdentity" (obrigatório) |
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_] |
distribuição | Configuração de distribuição da tarefa. Se estiver definido, este deve ser um de Mpi, Tensorflow, PyTorch ou nulo. | DistributionConfiguration |
environmentId | [Obrigatório] O ID de recurso do ARM da especificação ambiente da tarefa. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
environmentVariables | Variáveis de ambiente incluídas na tarefa. | objeto |
entradas | Mapeamento de enlaces de dados de entrada utilizados na tarefa. | objeto |
limites | Limite da Tarefa de Comando. | CommandJobLimits |
saídas | Mapeamento de enlaces de dados de saída utilizados na tarefa. | objeto |
resources | Configuração do Recurso de Computação para a tarefa. | ResourceConfiguration |
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) |
processCountPerInstance | Número de processos por nó. | 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. Se não for especificado, a predefinição será a contagem de instâncias. | int |
CommandJobLimits
Nome | Descrição | Valor |
---|---|---|
jobLimitsType | [Obrigatório] Tipo jobLimit. | "Comando" "Varrer" (obrigatório) |
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 |
ResourceConfiguration
Nome | Descrição | Valor |
---|---|---|
instanceCount | Número opcional de instâncias ou nós utilizados pelo destino de computação. | int |
instanceType | Tipo opcional de VM utilizado como suportado pelo destino de computação. | string |
propriedades | Saco de propriedades adicionais. | objeto |
PipelineJob
Nome | Descrição | Valor |
---|---|---|
jobType | [Obrigatório] Especifica o tipo de tarefa. | "Pipeline" (obrigatório) |
entradas | Entradas para a tarefa de pipeline. | objeto |
tarefas | As tarefas constroem a Tarefa de Pipeline. | objeto |
saídas | Saídas para a tarefa de pipeline | objeto |
definições | Definições do pipeline, para aspetos como ContinueRunOnStepFailure, etc. | Para o Bicep, pode utilizar a função any( ). |
SweepJob
Nome | Descrição | Valor |
---|---|---|
jobType | [Obrigatório] Especifica o tipo de tarefa. | "Varrer" (obrigatório) |
earlyTermination | As políticas de cessação antecipada permitem cancelar execuções de mau desempenho antes de serem concluídas | EarlyTerminationPolicy |
entradas | Mapeamento de enlaces de dados de entrada utilizados na tarefa. | objeto |
limites | Limite de tarefas de varrimento. | SweepJobLimits |
objetivo | [Obrigatório] Objetivo de otimização. | Objetivo (obrigatório) |
saídas | Mapeamento de enlaces de dados de saída utilizados na tarefa. | objeto |
samplingAlgorithm | [Obrigatório] O algoritmo de amostragem de hiperparâmetros | SamplingAlgorithm (obrigatório) |
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 | Para Bicep, pode utilizar a função any( ). (obrigatório) |
trial | [Obrigatório] Definição do componente de avaliação. | TrialComponent (obrigatório) |
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 |
SweepJobLimits
Nome | Descrição | Valor |
---|---|---|
jobLimitsType | [Obrigatório] Tipo jobLimit. | 'Comando' "Varrer" (obrigatório) |
maxConcurrentTrials | Varra o número máximo de tentativas simultâneas da Tarefa. | int |
maxTotalTrials | Varra o número máximo de tentativas de Tarefas. | 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 |
trialTimeout | Valor de tempo limite da Avaliação de Tarefas de Varrimento. | string |
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_] |
SamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | Definir o tipo de objeto | Bayesian Grelha Aleatório (obrigatório) |
BayesianSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | 'Bayesian' (obrigatório) |
GridSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Grelha" (obrigatório) |
RandomSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Aleatório" (obrigatório) |
regra | O tipo específico de algoritmo aleatório | "Aleatório" 'Sobol' |
seed | Um número inteiro opcional para utilizar como seed para geração de números aleatórios | int |
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 | [Obrigatório] O ID de recurso do ARM da especificação do Ambiente para a tarefa. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
environmentVariables | Variáveis de ambiente incluídas na tarefa. | objeto |
resources | Configuração do Recurso de Computação para a tarefa. | ResourceConfiguration |
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 |
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 |
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 |
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:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
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": "2022-05-01",
"name": "string",
"properties": {
"computeId": "string",
"description": "string",
"displayName": "string",
"experimentName": "string",
"identity": {
"identityType": "string"
// For remaining properties, see IdentityConfiguration objects
},
"isArchived": "bool",
"properties": {},
"services": {},
"tags": {},
"jobType": "string"
// For remaining properties, see JobBaseProperties objects
}
}
Objetos JobBaseProperties
Defina a propriedade jobType para especificar o tipo de objeto.
Para Comando, utilize:
"jobType": "Command",
"codeId": "string",
"command": "string",
"distribution": {
"distributionType": "string"
// For remaining properties, see DistributionConfiguration objects
},
"environmentId": "string",
"environmentVariables": {},
"inputs": {},
"limits": {
"jobLimitsType": "string",
"timeout": "string"
},
"outputs": {},
"resources": {
"instanceCount": "int",
"instanceType": "string",
"properties": {}
}
Para Pipeline, utilize:
"jobType": "Pipeline",
"inputs": {},
"jobs": {},
"outputs": {},
"settings": {}
Para Varrer, utilize:
"jobType": "Sweep",
"earlyTermination": {
"delayEvaluation": "int",
"evaluationInterval": "int",
"policyType": "string"
// For remaining properties, see EarlyTerminationPolicy objects
},
"inputs": {},
"limits": {
"jobLimitsType": "string",
"maxConcurrentTrials": "int",
"maxTotalTrials": "int",
"timeout": "string",
"trialTimeout": "string"
},
"objective": {
"goal": "string",
"primaryMetric": "string"
},
"outputs": {},
"samplingAlgorithm": {
"samplingAlgorithmType": "string"
// For remaining properties, see SamplingAlgorithm objects
},
"searchSpace": {},
"trial": {
"codeId": "string",
"command": "string",
"distribution": {
"distributionType": "string"
// For remaining properties, see DistributionConfiguration objects
},
"environmentId": "string",
"environmentVariables": {},
"resources": {
"instanceCount": "int",
"instanceType": "string",
"properties": {}
}
}
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"
Para UserIdentity, utilize:
"identityType": "UserIdentity"
Objetos DistributionConfiguration
Defina a propriedade distributionType para especificar o tipo de objeto.
Para MPI, utilize:
"distributionType": "Mpi",
"processCountPerInstance": "int"
Para PyTorch, utilize:
"distributionType": "PyTorch",
"processCountPerInstance": "int"
Para TensorFlow, utilize:
"distributionType": "TensorFlow",
"parameterServerCount": "int",
"workerCount": "int"
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"
Objetos SamplingAlgorithm
Defina a propriedade samplingAlgorithmType para especificar o tipo de objeto.
Para Bayesian, utilize:
"samplingAlgorithmType": "Bayesian"
Para Grid, utilize:
"samplingAlgorithmType": "Grid"
Para Aleatório, utilize:
"samplingAlgorithmType": "Random",
"rule": "string",
"seed": "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 | '2022-05-01' |
name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos arm JSON. |
cadeia (obrigatório) |
propriedades | [Obrigatório] Atributos adicionais da entidade. | JobBaseProperties (obrigatório) |
JobBaseProperties
Nome | Descrição | Valor |
---|---|---|
computeId | ID do recurso arm do recurso de computação. | string |
descrição | O texto de descrição do recurso. | string |
displayName | Nome a apresentar da tarefa. | string |
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, UserIdentity ou nulo. A predefinição é AmlToken se for nulo. |
IdentityConfiguration |
isArchived | O elemento está arquivado? | bool |
propriedades | O dicionário da propriedade do recurso. | objeto |
services | Lista de JobEndpoints. Para tarefas locais, um ponto final de tarefa terá um valor de ponto final de FileStreamObject. |
objeto |
etiquetas | Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas. | objeto |
jobType | Definir o tipo de objeto | Comando Pipeline Varrer (obrigatório) |
IdentityConfiguration
Nome | Descrição | Valor |
---|---|---|
identityType | Definir o tipo de objeto | AMLToken Gerido UserIdentity (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 |
UserIdentity
Nome | Descrição | Valor |
---|---|---|
identityType | [Obrigatório] Especifica o tipo de arquitetura de identidade. | "UserIdentity" (obrigatório) |
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_] |
distribuição | Configuração de distribuição da tarefa. Se estiver definido, este deve ser um de Mpi, Tensorflow, PyTorch ou nulo. | DistributionConfiguration |
environmentId | [Obrigatório] O ID de recurso do ARM da especificação ambiente da tarefa. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
environmentVariables | Variáveis de ambiente incluídas na tarefa. | objeto |
entradas | Mapeamento de enlaces de dados de entrada utilizados na tarefa. | objeto |
limites | Limite da Tarefa de Comando. | CommandJobLimits |
saídas | Mapeamento de enlaces de dados de saída utilizados na tarefa. | objeto |
resources | Configuração do Recurso de Computação para a tarefa. | ResourceConfiguration |
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) |
processCountPerInstance | Número de processos por nó. | 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. Se não for especificado, a predefinição será a contagem de instâncias. | int |
CommandJobLimits
Nome | Descrição | Valor |
---|---|---|
jobLimitsType | [Obrigatório] Tipo jobLimit. | 'Comando' "Varrer" (obrigatório) |
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 |
ResourceConfiguration
Nome | Descrição | Valor |
---|---|---|
instanceCount | Número opcional de instâncias ou nós utilizados pelo destino de computação. | int |
instanceType | Tipo opcional de VM utilizado como suportado pelo destino de computação. | string |
propriedades | Saco de propriedades adicionais. | objeto |
PipelineJob
Nome | Descrição | Valor |
---|---|---|
jobType | [Obrigatório] Especifica o tipo de tarefa. | "Pipeline" (obrigatório) |
entradas | Entradas para a tarefa de pipeline. | objeto |
tarefas | As tarefas constroem a Tarefa de Pipeline. | objeto |
saídas | Saídas para a tarefa de pipeline | objeto |
definições | Definições do pipeline, para aspetos como ContinueRunOnStepFailure, etc. |
SweepJob
Nome | Descrição | Valor |
---|---|---|
jobType | [Obrigatório] Especifica o tipo de tarefa. | "Varrer" (obrigatório) |
earlyTermination | As políticas de cessação antecipada permitem cancelar execuções com mau desempenho antes de serem concluídas | EarlyTerminationPolicy |
entradas | Mapeamento de enlaces de dados de entrada utilizados na tarefa. | objeto |
limites | Limite de Tarefas de Varrimento. | SweepJobLimits |
objetivo | [Obrigatório] Objetivo de otimização. | Objetivo (obrigatório) |
saídas | Mapeamento de enlaces de dados de saída utilizados na tarefa. | objeto |
samplingAlgorithm | [Obrigatório] O algoritmo de amostragem de hiperparâmetros | SamplingAlgorithm (obrigatório) |
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 | |
trial | [Obrigatório] Definição do componente de avaliação. | TrialComponent (obrigatório) |
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 |
SweepJobLimits
Nome | Descrição | Valor |
---|---|---|
jobLimitsType | [Obrigatório] Tipo jobLimit. | "Comando" "Varrer" (obrigatório) |
maxConcurrentTrials | Varra Tarefa máxima de avaliações simultâneas. | int |
maxTotalTrials | Varra o número máximo de avaliações de tarefas. | 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 |
trialTimeout | Valor de tempo limite da Avaliação de Tarefas de Varrimento. | string |
Objetivo
Nome | Descrição | Valor |
---|---|---|
goal | [Obrigatório] Define os objetivos de métricas suportados para otimização de hiperparâmetros | "Maximizar" "Minimizar" (necessário) |
primaryMetric | [Obrigatório] Nome da métrica a otimizar. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
SamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | Definir o tipo de objeto | Bayesian Grelha Aleatório (obrigatório) |
BayesianSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Bayesian" (obrigatório) |
GridSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Grelha" (obrigatório) |
RandomSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Aleatório" (obrigatório) |
regra | O tipo específico de algoritmo aleatório | "Aleatório" 'Sobol' |
seed | Um número inteiro opcional a utilizar como seed para geração de números aleatórios | int |
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 | [Obrigatório] O ID de recurso do ARM da especificação ambiente da tarefa. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
environmentVariables | Variáveis de ambiente incluídas na tarefa. | objeto |
resources | Configuração do Recurso de Computação para a tarefa. | ResourceConfiguration |
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 |
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 |
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 |
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@2022-05-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
computeId = "string"
description = "string"
displayName = "string"
experimentName = "string"
identity = {
identityType = "string"
// For remaining properties, see IdentityConfiguration objects
}
isArchived = bool
properties = {}
services = {}
tags = {}
jobType = "string"
// For remaining properties, see JobBaseProperties objects
}
})
}
Objetos JobBaseProperties
Defina a propriedade jobType para especificar o tipo de objeto.
Para Comando, utilize:
jobType = "Command"
codeId = "string"
command = "string"
distribution = {
distributionType = "string"
// For remaining properties, see DistributionConfiguration objects
}
environmentId = "string"
environmentVariables = {}
inputs = {}
limits = {
jobLimitsType = "string"
timeout = "string"
}
outputs = {}
resources = {
instanceCount = int
instanceType = "string"
properties = {}
}
Para Pipeline, utilize:
jobType = "Pipeline"
inputs = {}
jobs = {}
outputs = {}
Para Varrer, utilize:
jobType = "Sweep"
earlyTermination = {
delayEvaluation = int
evaluationInterval = int
policyType = "string"
// For remaining properties, see EarlyTerminationPolicy objects
}
inputs = {}
limits = {
jobLimitsType = "string"
maxConcurrentTrials = int
maxTotalTrials = int
timeout = "string"
trialTimeout = "string"
}
objective = {
goal = "string"
primaryMetric = "string"
}
outputs = {}
samplingAlgorithm = {
samplingAlgorithmType = "string"
// For remaining properties, see SamplingAlgorithm objects
}
trial = {
codeId = "string"
command = "string"
distribution = {
distributionType = "string"
// For remaining properties, see DistributionConfiguration objects
}
environmentId = "string"
environmentVariables = {}
resources = {
instanceCount = int
instanceType = "string"
properties = {}
}
}
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"
Para UserIdentity, utilize:
identityType = "UserIdentity"
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"
processCountPerInstance = int
Para o TensorFlow, utilize:
distributionType = "TensorFlow"
parameterServerCount = int
workerCount = int
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
SamplingAlgorithm objects (Objetos SamplingAlgorithm)
Defina a propriedade samplingAlgorithmType para especificar o tipo de objeto.
Para Bayesian, utilize:
samplingAlgorithmType = "Bayesian"
Para Grelha, utilize:
samplingAlgorithmType = "Grid"
Para Aleatório, utilize:
samplingAlgorithmType = "Random"
rule = "string"
seed = int
Valores de propriedade
áreas de trabalho/tarefas
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | "Microsoft.MachineLearningServices/workspaces/jobs@2022-05-01" |
name | O nome do recurso | cadeia (obrigatório) |
parent_id | O ID do recurso que é o principal para este recurso. | ID para recurso do tipo: áreas de trabalho |
propriedades | [Obrigatório] Atributos adicionais da entidade. | JobBaseProperties (obrigatório) |
JobBaseProperties
Nome | Descrição | Valor |
---|---|---|
computeId | ID do recurso arm do recurso de computação. | string |
descrição | O texto de descrição do recurso. | string |
displayName | Nome a apresentar da tarefa. | string |
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, UserIdentity ou nulo. A predefinição é AmlToken se for nulo. |
IdentityConfiguration |
isArchived | O elemento está arquivado? | bool |
propriedades | O dicionário da propriedade do recurso. | objeto |
services | Lista de JobEndpoints. Para tarefas locais, um ponto final de tarefa terá um valor de ponto final de FileStreamObject. |
objeto |
etiquetas | Dicionário de etiquetas. As etiquetas podem ser adicionadas, removidas e atualizadas. | objeto |
jobType | Definir o tipo de objeto | Comando Pipeline Varrer (obrigatório) |
IdentityConfiguration
Nome | Descrição | Valor |
---|---|---|
identityType | Definir o tipo de objeto | AMLToken Gerido UserIdentity (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 |
UserIdentity
Nome | Descrição | Valor |
---|---|---|
identityType | [Obrigatório] Especifica o tipo de arquitetura de identidade. | "UserIdentity" (obrigatório) |
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_] |
distribuição | Configuração de distribuição da tarefa. Se estiver definido, este deve ser um Mpi, Tensorflow, PyTorch ou nulo. | DistributionConfiguration |
environmentId | [Obrigatório] O ID de recurso do ARM da especificação do Ambiente para a tarefa. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
environmentVariables | Variáveis de ambiente incluídas na tarefa. | objeto |
entradas | Mapeamento de enlaces de dados de entrada utilizados na tarefa. | objeto |
limites | Limite de Tarefas de Comando. | CommandJobLimits |
saídas | Mapeamento de enlaces de dados de saída utilizados na tarefa. | objeto |
resources | Configuração do Recurso de Computação para a tarefa. | ResourceConfiguration |
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) |
processCountPerInstance | Número de processos por nó. | 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. Se não for especificado, a predefinição será a contagem de instâncias. | int |
CommandJobLimits
Nome | Descrição | Valor |
---|---|---|
jobLimitsType | [Obrigatório] Tipo jobLimit. | "Comando" "Varrer" (obrigatório) |
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 |
ResourceConfiguration
Nome | Descrição | Valor |
---|---|---|
instanceCount | Número opcional de instâncias ou nós utilizados pelo destino de computação. | int |
instanceType | Tipo opcional de VM utilizado como suportado pelo destino de computação. | string |
propriedades | Saco de propriedades adicionais. | objeto |
PipelineJob
Nome | Descrição | Valor |
---|---|---|
jobType | [Obrigatório] Especifica o tipo de tarefa. | "Pipeline" (obrigatório) |
entradas | Entradas para a tarefa de pipeline. | objeto |
tarefas | As tarefas constroem a Tarefa de Pipeline. | objeto |
saídas | Saídas para a tarefa de pipeline | objeto |
definições | Definições do pipeline, para aspetos como ContinueRunOnStepFailure, etc. |
SweepJob
Nome | Descrição | Valor |
---|---|---|
jobType | [Obrigatório] Especifica o tipo de tarefa. | "Varrer" (obrigatório) |
earlyTermination | As políticas de cessação antecipada permitem cancelar execuções de mau desempenho antes de serem concluídas | EarlyTerminationPolicy |
entradas | Mapeamento de enlaces de dados de entrada utilizados na tarefa. | objeto |
limites | Limite de tarefas de varrimento. | SweepJobLimits |
objetivo | [Obrigatório] Objetivo de otimização. | Objetivo (obrigatório) |
saídas | Mapeamento de enlaces de dados de saída utilizados na tarefa. | objeto |
samplingAlgorithm | [Obrigatório] O algoritmo de amostragem de hiperparâmetros | SamplingAlgorithm (obrigatório) |
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 | |
trial | [Obrigatório] Definição do componente de avaliação. | TrialComponent (obrigatório) |
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 |
SweepJobLimits
Nome | Descrição | Valor |
---|---|---|
jobLimitsType | [Obrigatório] Tipo jobLimit. | "Comando" "Varrer" (obrigatório) |
maxConcurrentTrials | Varra Tarefa máxima de avaliações simultâneas. | int |
maxTotalTrials | Varra o número máximo de avaliações de tarefas. | 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 |
trialTimeout | Valor de tempo limite da Avaliação de Tarefas de Varrimento. | string |
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_] |
SamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | Definir o tipo de objeto | Bayesian Grelha Aleatório (obrigatório) |
BayesianSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Bayesian" (obrigatório) |
GridSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Grelha" (obrigatório) |
RandomSamplingAlgorithm
Nome | Descrição | Valor |
---|---|---|
samplingAlgorithmType | [Obrigatório] O algoritmo utilizado para gerar valores de hiperparâmetros, juntamente com as propriedades de configuração | "Aleatório" (obrigatório) |
regra | O tipo específico de algoritmo aleatório | "Aleatório" "Sobol" |
seed | Um número inteiro opcional a utilizar como seed para geração de números aleatórios | int |
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 | [Obrigatório] O ID de recurso do ARM da especificação ambiente da tarefa. | cadeia (obrigatório) Restrições: Padrão = [a-zA-Z0-9_] |
environmentVariables | Variáveis de ambiente incluídas na tarefa. | objeto |
resources | Configuração do Recurso de Computação para a tarefa. | ResourceConfiguration |