Compartilhar via


Workspaces/trabalhos do Microsoft.MachineLearningServices 2021-03-01-preview

Definição de recurso do Bicep

O tipo de recurso workspaces/trabalhos pode ser implantado com operações direcionadas:

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

Formato de recurso

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

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 EarlyTerminationPolicy

Defina a propriedade policyType para especificar o 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 IdentityConfiguration

Defina a propriedade identityType para especificar o tipo de objeto.

Para AMLToken, use:

{
  identityType: 'AMLToken'
}

Para managed, use:

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

Objetos JobBase

Defina a propriedade jobType para especificar o tipo de objeto.

Parade 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 de Varredura, 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(Azure.Bicep.Types.Concrete.AnyType)
  }
  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 de MPI, use:

{
  distributionType: 'Mpi'
  processCountPerInstance: int
}

Para PyTorch, use:

{
  distributionType: 'PyTorch'
  processCount: int
}

Para tensorFlow, use:

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

Valores de propriedade

AmlToken

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

BanditPolicy

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

CommandJob

Nome Descrição Valor
codeId ID do recurso ARM do ativo de código. corda
comando [Obrigatório] O comando a ser executado na inicialização do trabalho. Eg. "python train.py" corda

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_] (obrigatório)
calcular [Obrigatório] Associação de computação para o trabalho. ComputeConfiguration (obrigatório)
distribuição Configuração de distribuição do trabalho. Se definido, este deverá ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId A ID do recurso ARM da especificação de Ambiente para o trabalho. corda
environmentVariables Variáveis de ambiente incluídas no trabalho. commandJobEnvironmentVariables
experimentName O nome do experimento ao qual o trabalho pertence. Se não estiver definido, o trabalho será colocado no experimento "Padrão". corda
identidade Configuração de identidade. Se definido, este deverá ser um de AmlToken, ManagedIdentity ou nulo.
O padrão será AmlToken se nulo.
IdentityConfiguration
inputDataBindings Mapeamento de associações de dados de entrada usadas no trabalho. CommandJobInputDataBindings
jobType [Obrigatório] Especifica o tipo de trabalho. 'Command' (obrigatório)
outputDataBindings Mapeamento de associações de dados de saída usadas no trabalho. CommandJobOutputDataBindings
prioridade Prioridade de trabalho para a política de agendamento. Aplica-se apenas ao AMLCompute.
Recurso de visualização privada e disponível somente para usuários na lista de permissões.
int
timeout A duração máxima da execução no formato ISO 8601, após a qual o trabalho será cancelado. Só dá suporte à duração com precisão tão baixa quanto Segundos. corda

CommandJobEnvironmentVariables

Nome Descrição Valor

CommandJobInputDataBindings

Nome Descrição Valor

CommandJobOutputDataBindings

Nome Descrição Valor

ComputeConfiguration

Nome Descrição Valor
instanceCount Número de instâncias ou nós. int
instanceType Tipo de SKU em que executar. corda
isLocal Definido como true para trabalhos em execução na computação local. Bool
localização Local para execução do cluster virtual. corda
Propriedades Propriedades adicionais. computeConfigurationProperties
alvo ID de recurso arm da computação que você está direcionando. Se não for fornecido, o recurso será implantado como Gerenciado. corda

ComputeConfigurationProperties

Nome Descrição Valor

DistributionConfiguration

Nome Descrição Valor
distributionType Definir como 'Mpi' para o tipo Mpi. Defina como 'PyTorch' para o tipo PyTorch . Defina como 'TensorFlow' para o tipo tensorFlow. 'Mpi'
'PyTorch'
'TensorFlow' (obrigatório)

EarlyTerminationPolicy

Nome Descrição Valor
delayEvaluation Número de intervalos pelos quais atrasar a primeira avaliação. int
evaluationInterval Intervalo (número de execuções) entre avaliações de política. int
policyType Definido como 'Bandit' para o tipo BanditPolicy. Defina como 'MedianStopping' para o tipo MedianStoppingPolicy. Defina como 'TruncationSelection' para o tipo TruncationSelectionPolicy. 'Bandido'
'MedianStopping'
'TruncationSelection' (obrigatório)

IdentityConfiguration

Nome Descrição Valor
identityType Defina como 'AMLToken' para o tipo AmlToken. Definido como 'Gerenciado' para o tipo ManagedIdentity. 'AMLToken'
'Gerenciado' (obrigatório)

InputDataBinding

Nome Descrição Valor
dataId ID do recurso ARM do dataVersion registrado. corda
modo Mecanismo para acessar o artefato de dados. 'Direct'
'Baixar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Carregar'
pathOnCompute Local dos dados dentro do processo de contêiner. corda

JobBase

Nome Descrição Valor
descrição O texto de descrição do ativo. corda
jobType Defina como 'Command' para o tipo CommandJob. Defina como 'Sweep' para o tipo SweepJob . 'Command'
'Sweep' (obrigatório)
Propriedades O dicionário de propriedades do ativo. JobBaseProperties
Tags Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas. JobBaseTags

JobBaseProperties

Nome Descrição Valor

JobBaseTags

Nome Descrição Valor

ManagedIdentity

Nome Descrição Valor
clientId Especifica uma identidade atribuída pelo usuário pela ID do cliente. Para atribuído pelo sistema, não defina esse campo. corda

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}$
identityType [Obrigatório] Especifica o tipo de estrutura de identidade. 'Gerenciado' (obrigatório)
objectId Especifica uma identidade atribuída pelo usuário por ID de objeto. Para atribuído pelo sistema, não defina esse campo. corda

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 usuário pela ID de recurso do ARM. Para atribuído pelo sistema, não defina esse campo. corda

MedianStoppingPolicy

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

Microsoft.MachineLearningServices/workspaces/jobs

Nome Descrição Valor
nome O nome do recurso corda

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (obrigatório)
pai No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai.

Para obter mais informações, consulte recurso filho fora do recurso pai.
Nome simbólico para o recurso do tipo: workspaces
Propriedades [Obrigatório] Atributos adicionais da entidade. do JobBase (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ó de MPI. int

Objetivo

Nome Descrição Valor
objetivo [Obrigatório] Define as metas de métrica com suporte para ajuste de hiperparâmetro 'Maximize'
'Minimizar' (obrigatório)
primaryMetric [Obrigatório] Nome da métrica a ser otimizada. corda

Restrições:
Padrão = [a-zA-Z0-9_] (obrigatório)

OutputDataBinding

Nome Descrição Valor
datastoreId ID do recurso ARM do armazenamento de dados em que a saída de dados será armazenada. corda
modo Mecanismo de movimentação de dados para armazenamento de dados. 'Direct'
'Baixar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Carregar'
pathOnCompute Local dos dados dentro do processo de contêiner. corda
pathOnDatastore Caminho dentro do armazenamento de dados para os dados. corda

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 o trabalho distribuído. int

SweepJob

Nome Descrição Valor
algoritmo [Obrigatório] Tipo de algoritmos de amostragem de hiperparâmetro 'Bayesian'
'Grade'
'Aleatório' (obrigatório)
calcular [Obrigatório] Associação de computação para o trabalho. ComputeConfiguration (obrigatório)
earlyTermination As políticas de término antecipado permitem o cancelamento de execuções de baixo desempenho antes de serem concluídas. EarlyTerminationPolicy
experimentName O nome do experimento ao qual o trabalho pertence. Se não estiver definido, o trabalho será colocado no experimento "Padrão". corda
identidade Configuração de identidade. Se definido, este deverá ser um de AmlToken, ManagedIdentity ou nulo.
O padrão será AmlToken se nulo.
IdentityConfiguration
jobType [Obrigatório] Especifica o tipo de trabalho. 'Sweep' (obrigatório)
maxConcurrentTrials Um limite superior no número de avaliações executadas em paralelo. int
maxTotalTrials Um limite superior no número de avaliações a serem executadas. int
objetivo [Obrigatório] Objetivo de otimização. objective (obrigatório)
prioridade Prioridade de trabalho para a política de agendamento. Aplica-se apenas ao AMLCompute.
Recurso de visualização privada e disponível somente para usuários na lista de permissões.
int
searchSpace [Obrigatório] Um dicionário que contém cada parâmetro e sua distribuição. A chave do dicionário é o nome do parâmetro SweepJobSearchSpace (obrigatório)
timeout O tempo limite total no formato ISO 8601. Só dá suporte à duração com precisão tão baixa quanto Minutos. corda
julgamento Definição do componente de avaliação. TrialComponent

SweepJobSearchSpace

Nome Descrição Valor

TensorFlow

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

TrialComponent

Nome Descrição Valor
codeId ID do recurso ARM do ativo de código. corda
comando [Obrigatório] O comando a ser executado na inicialização do trabalho. Eg. "python train.py" corda

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_] (obrigatório)
distribuição Configuração de distribuição do trabalho. Se definido, este deverá ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId A ID do recurso ARM da especificação de Ambiente para o trabalho. corda
environmentVariables Variáveis de ambiente incluídas no trabalho. TrialComponentEnvironmentVariables
inputDataBindings Mapeamento de associações de dados de entrada usadas no trabalho. TrialComponentInputDataBindings
outputDataBindings Mapeamento de associações de dados de saída usadas no trabalho. TrialComponentOutputDataBindings
timeout A duração máxima da execução no formato ISO 8601, após a qual o componente de avaliação será cancelado.
Só dá suporte à duração com precisão tão baixa quanto Segundos.
corda

TrialComponentEnvironmentVariables

Nome Descrição Valor

TrialComponentInputDataBindings

Nome Descrição Valor

TrialComponentOutputDataBindings

Nome Descrição Valor

TruncationSelectionPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração de política 'TruncationSelection' (obrigatório)
truncationPercentage O percentual de execuções a serem canceladas em cada intervalo de avaliação. int

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Criar um trabalho de classificação do AutoML do Azure Machine Learning Este modelo cria um trabalho de classificação de AutoML do Azure Machine Learning para descobrir o melhor modelo para prever se um cliente assinará um depósito de termo fixo com uma instituição financeira.
criar um trabalho do Comando do Azure Machine Learning Este modelo cria um trabalho de Comando do Azure Machine Learning com um script de hello_world básico
Criar um trabalho do Azure Machine Learning Sweep Este modelo cria um trabalho de Varredura do Azure Machine Learning para ajuste de hiperparâmetro.

Definição de recurso de modelo do ARM

O tipo de recurso workspaces/trabalhos pode ser implantado com operações direcionadas:

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

Formato de recurso

Para criar um recurso Microsoft.MachineLearningServices/workspaces/jobs, adicione o JSON a seguir ao 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 EarlyTerminationPolicy

Defina a propriedade policyType para especificar o 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 IdentityConfiguration

Defina a propriedade identityType para especificar o tipo de objeto.

Para AMLToken, use:

{
  "identityType": "AMLToken"
}

Para managed, use:

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

Objetos JobBase

Defina a propriedade jobType para especificar o tipo de objeto.

Parade 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 de Varredura, 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"
  }
}

Objetos DistributionConfiguration

Defina a propriedade distributionType para especificar o tipo de objeto.

Para de MPI, use:

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

Para PyTorch, use:

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

Para tensorFlow, use:

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

Valores de propriedade

AmlToken

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

BanditPolicy

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

CommandJob

Nome Descrição Valor
codeId ID do recurso ARM do ativo de código. corda
comando [Obrigatório] O comando a ser executado na inicialização do trabalho. Eg. "python train.py" corda

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_] (obrigatório)
calcular [Obrigatório] Associação de computação para o trabalho. ComputeConfiguration (obrigatório)
distribuição Configuração de distribuição do trabalho. Se definido, este deverá ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId A ID do recurso ARM da especificação de Ambiente para o trabalho. corda
environmentVariables Variáveis de ambiente incluídas no trabalho. commandJobEnvironmentVariables
experimentName O nome do experimento ao qual o trabalho pertence. Se não estiver definido, o trabalho será colocado no experimento "Padrão". corda
identidade Configuração de identidade. Se definido, este deverá ser um de AmlToken, ManagedIdentity ou nulo.
O padrão será AmlToken se nulo.
IdentityConfiguration
inputDataBindings Mapeamento de associações de dados de entrada usadas no trabalho. CommandJobInputDataBindings
jobType [Obrigatório] Especifica o tipo de trabalho. 'Command' (obrigatório)
outputDataBindings Mapeamento de associações de dados de saída usadas no trabalho. CommandJobOutputDataBindings
prioridade Prioridade de trabalho para a política de agendamento. Aplica-se apenas ao AMLCompute.
Recurso de visualização privada e disponível somente para usuários na lista de permissões.
int
timeout A duração máxima da execução no formato ISO 8601, após a qual o trabalho será cancelado. Só dá suporte à duração com precisão tão baixa quanto Segundos. corda

CommandJobEnvironmentVariables

Nome Descrição Valor

CommandJobInputDataBindings

Nome Descrição Valor

CommandJobOutputDataBindings

Nome Descrição Valor

ComputeConfiguration

Nome Descrição Valor
instanceCount Número de instâncias ou nós. int
instanceType Tipo de SKU em que executar. corda
isLocal Definido como true para trabalhos em execução na computação local. Bool
localização Local para execução do cluster virtual. corda
Propriedades Propriedades adicionais. computeConfigurationProperties
alvo ID de recurso arm da computação que você está direcionando. Se não for fornecido, o recurso será implantado como Gerenciado. corda

ComputeConfigurationProperties

Nome Descrição Valor

DistributionConfiguration

Nome Descrição Valor
distributionType Definir como 'Mpi' para o tipo Mpi. Defina como 'PyTorch' para o tipo PyTorch . Defina como 'TensorFlow' para o tipo tensorFlow. 'Mpi'
'PyTorch'
'TensorFlow' (obrigatório)

EarlyTerminationPolicy

Nome Descrição Valor
delayEvaluation Número de intervalos pelos quais atrasar a primeira avaliação. int
evaluationInterval Intervalo (número de execuções) entre avaliações de política. int
policyType Definido como 'Bandit' para o tipo BanditPolicy. Defina como 'MedianStopping' para o tipo MedianStoppingPolicy. Defina como 'TruncationSelection' para o tipo TruncationSelectionPolicy. 'Bandido'
'MedianStopping'
'TruncationSelection' (obrigatório)

IdentityConfiguration

Nome Descrição Valor
identityType Defina como 'AMLToken' para o tipo AmlToken. Definido como 'Gerenciado' para o tipo ManagedIdentity. 'AMLToken'
'Gerenciado' (obrigatório)

InputDataBinding

Nome Descrição Valor
dataId ID do recurso ARM do dataVersion registrado. corda
modo Mecanismo para acessar o artefato de dados. 'Direct'
'Baixar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Carregar'
pathOnCompute Local dos dados dentro do processo de contêiner. corda

JobBase

Nome Descrição Valor
descrição O texto de descrição do ativo. corda
jobType Defina como 'Command' para o tipo CommandJob. Defina como 'Sweep' para o tipo SweepJob . 'Command'
'Sweep' (obrigatório)
Propriedades O dicionário de propriedades do ativo. JobBaseProperties
Tags Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas. JobBaseTags

JobBaseProperties

Nome Descrição Valor

JobBaseTags

Nome Descrição Valor

ManagedIdentity

Nome Descrição Valor
clientId Especifica uma identidade atribuída pelo usuário pela ID do cliente. Para atribuído pelo sistema, não defina esse campo. corda

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}$
identityType [Obrigatório] Especifica o tipo de estrutura de identidade. 'Gerenciado' (obrigatório)
objectId Especifica uma identidade atribuída pelo usuário por ID de objeto. Para atribuído pelo sistema, não defina esse campo. corda

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 usuário pela ID de recurso do ARM. Para atribuído pelo sistema, não defina esse campo. corda

MedianStoppingPolicy

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

Microsoft.MachineLearningServices/workspaces/jobs

Nome Descrição Valor
apiVersion A versão da API '2021-03-01-preview'
nome O nome do recurso corda

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (obrigatório)
Propriedades [Obrigatório] Atributos adicionais da entidade. do JobBase (obrigatório)
tipo O tipo de recurso 'Microsoft.MachineLearningServices/workspaces/jobs'

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ó de MPI. int

Objetivo

Nome Descrição Valor
objetivo [Obrigatório] Define as metas de métrica com suporte para ajuste de hiperparâmetro 'Maximize'
'Minimizar' (obrigatório)
primaryMetric [Obrigatório] Nome da métrica a ser otimizada. corda

Restrições:
Padrão = [a-zA-Z0-9_] (obrigatório)

OutputDataBinding

Nome Descrição Valor
datastoreId ID do recurso ARM do armazenamento de dados em que a saída de dados será armazenada. corda
modo Mecanismo de movimentação de dados para armazenamento de dados. 'Direct'
'Baixar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Carregar'
pathOnCompute Local dos dados dentro do processo de contêiner. corda
pathOnDatastore Caminho dentro do armazenamento de dados para os dados. corda

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 o trabalho distribuído. int

SweepJob

Nome Descrição Valor
algoritmo [Obrigatório] Tipo de algoritmos de amostragem de hiperparâmetro 'Bayesian'
'Grade'
'Aleatório' (obrigatório)
calcular [Obrigatório] Associação de computação para o trabalho. ComputeConfiguration (obrigatório)
earlyTermination As políticas de término antecipado permitem o cancelamento de execuções de baixo desempenho antes de serem concluídas. EarlyTerminationPolicy
experimentName O nome do experimento ao qual o trabalho pertence. Se não estiver definido, o trabalho será colocado no experimento "Padrão". corda
identidade Configuração de identidade. Se definido, este deverá ser um de AmlToken, ManagedIdentity ou nulo.
O padrão será AmlToken se nulo.
IdentityConfiguration
jobType [Obrigatório] Especifica o tipo de trabalho. 'Sweep' (obrigatório)
maxConcurrentTrials Um limite superior no número de avaliações executadas em paralelo. int
maxTotalTrials Um limite superior no número de avaliações a serem executadas. int
objetivo [Obrigatório] Objetivo de otimização. objective (obrigatório)
prioridade Prioridade de trabalho para a política de agendamento. Aplica-se apenas ao AMLCompute.
Recurso de visualização privada e disponível somente para usuários na lista de permissões.
int
searchSpace [Obrigatório] Um dicionário que contém cada parâmetro e sua distribuição. A chave do dicionário é o nome do parâmetro SweepJobSearchSpace (obrigatório)
timeout O tempo limite total no formato ISO 8601. Só dá suporte à duração com precisão tão baixa quanto Minutos. corda
julgamento Definição do componente de avaliação. TrialComponent

SweepJobSearchSpace

Nome Descrição Valor

TensorFlow

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

TrialComponent

Nome Descrição Valor
codeId ID do recurso ARM do ativo de código. corda
comando [Obrigatório] O comando a ser executado na inicialização do trabalho. Eg. "python train.py" corda

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_] (obrigatório)
distribuição Configuração de distribuição do trabalho. Se definido, este deverá ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId A ID do recurso ARM da especificação de Ambiente para o trabalho. corda
environmentVariables Variáveis de ambiente incluídas no trabalho. TrialComponentEnvironmentVariables
inputDataBindings Mapeamento de associações de dados de entrada usadas no trabalho. TrialComponentInputDataBindings
outputDataBindings Mapeamento de associações de dados de saída usadas no trabalho. TrialComponentOutputDataBindings
timeout A duração máxima da execução no formato ISO 8601, após a qual o componente de avaliação será cancelado.
Só dá suporte à duração com precisão tão baixa quanto Segundos.
corda

TrialComponentEnvironmentVariables

Nome Descrição Valor

TrialComponentInputDataBindings

Nome Descrição Valor

TrialComponentOutputDataBindings

Nome Descrição Valor

TruncationSelectionPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração de política 'TruncationSelection' (obrigatório)
truncationPercentage O percentual de execuções a serem canceladas em cada intervalo de avaliação. int

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar um trabalho de classificação do AutoML do Azure Machine Learning

Implantar no Azure
Este modelo cria um trabalho de classificação de AutoML do Azure Machine Learning para descobrir o melhor modelo para prever se um cliente assinará um depósito de termo fixo com uma instituição financeira.
criar um trabalho do Comando do Azure Machine Learning

Implantar no Azure
Este modelo cria um trabalho de Comando do Azure Machine Learning com um script de hello_world básico
Criar um trabalho do Azure Machine Learning Sweep

Implantar no Azure
Este modelo cria um trabalho de Varredura do Azure Machine Learning para ajuste de hiperparâmetro.

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

O tipo de recurso workspaces/trabalhos pode ser implantado com operações direcionadas:

  • grupos de recursos

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

Formato de recurso

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

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

Objetos EarlyTerminationPolicy

Defina a propriedade policyType para especificar o 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 IdentityConfiguration

Defina a propriedade identityType para especificar o tipo de objeto.

Para AMLToken, use:

{
  identityType = "AMLToken"
}

Para managed, use:

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

Objetos JobBase

Defina a propriedade jobType para especificar o tipo de objeto.

Parade 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 de Varredura, 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"
  }
}

Objetos DistributionConfiguration

Defina a propriedade distributionType para especificar o tipo de objeto.

Para de MPI, use:

{
  distributionType = "Mpi"
  processCountPerInstance = int
}

Para PyTorch, use:

{
  distributionType = "PyTorch"
  processCount = int
}

Para tensorFlow, use:

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

Valores de propriedade

AmlToken

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

BanditPolicy

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

CommandJob

Nome Descrição Valor
codeId ID do recurso ARM do ativo de código. corda
comando [Obrigatório] O comando a ser executado na inicialização do trabalho. Eg. "python train.py" corda

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_] (obrigatório)
calcular [Obrigatório] Associação de computação para o trabalho. ComputeConfiguration (obrigatório)
distribuição Configuração de distribuição do trabalho. Se definido, este deverá ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId A ID do recurso ARM da especificação de Ambiente para o trabalho. corda
environmentVariables Variáveis de ambiente incluídas no trabalho. commandJobEnvironmentVariables
experimentName O nome do experimento ao qual o trabalho pertence. Se não estiver definido, o trabalho será colocado no experimento "Padrão". corda
identidade Configuração de identidade. Se definido, este deverá ser um de AmlToken, ManagedIdentity ou nulo.
O padrão será AmlToken se nulo.
IdentityConfiguration
inputDataBindings Mapeamento de associações de dados de entrada usadas no trabalho. CommandJobInputDataBindings
jobType [Obrigatório] Especifica o tipo de trabalho. 'Command' (obrigatório)
outputDataBindings Mapeamento de associações de dados de saída usadas no trabalho. CommandJobOutputDataBindings
prioridade Prioridade de trabalho para a política de agendamento. Aplica-se apenas ao AMLCompute.
Recurso de visualização privada e disponível somente para usuários na lista de permissões.
int
timeout A duração máxima da execução no formato ISO 8601, após a qual o trabalho será cancelado. Só dá suporte à duração com precisão tão baixa quanto Segundos. corda

CommandJobEnvironmentVariables

Nome Descrição Valor

CommandJobInputDataBindings

Nome Descrição Valor

CommandJobOutputDataBindings

Nome Descrição Valor

ComputeConfiguration

Nome Descrição Valor
instanceCount Número de instâncias ou nós. int
instanceType Tipo de SKU em que executar. corda
isLocal Definido como true para trabalhos em execução na computação local. Bool
localização Local para execução do cluster virtual. corda
Propriedades Propriedades adicionais. computeConfigurationProperties
alvo ID de recurso arm da computação que você está direcionando. Se não for fornecido, o recurso será implantado como Gerenciado. corda

ComputeConfigurationProperties

Nome Descrição Valor

DistributionConfiguration

Nome Descrição Valor
distributionType Definir como 'Mpi' para o tipo Mpi. Defina como 'PyTorch' para o tipo PyTorch . Defina como 'TensorFlow' para o tipo tensorFlow. 'Mpi'
'PyTorch'
'TensorFlow' (obrigatório)

EarlyTerminationPolicy

Nome Descrição Valor
delayEvaluation Número de intervalos pelos quais atrasar a primeira avaliação. int
evaluationInterval Intervalo (número de execuções) entre avaliações de política. int
policyType Definido como 'Bandit' para o tipo BanditPolicy. Defina como 'MedianStopping' para o tipo MedianStoppingPolicy. Defina como 'TruncationSelection' para o tipo TruncationSelectionPolicy. 'Bandido'
'MedianStopping'
'TruncationSelection' (obrigatório)

IdentityConfiguration

Nome Descrição Valor
identityType Defina como 'AMLToken' para o tipo AmlToken. Definido como 'Gerenciado' para o tipo ManagedIdentity. 'AMLToken'
'Gerenciado' (obrigatório)

InputDataBinding

Nome Descrição Valor
dataId ID do recurso ARM do dataVersion registrado. corda
modo Mecanismo para acessar o artefato de dados. 'Direct'
'Baixar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Carregar'
pathOnCompute Local dos dados dentro do processo de contêiner. corda

JobBase

Nome Descrição Valor
descrição O texto de descrição do ativo. corda
jobType Defina como 'Command' para o tipo CommandJob. Defina como 'Sweep' para o tipo SweepJob . 'Command'
'Sweep' (obrigatório)
Propriedades O dicionário de propriedades do ativo. JobBaseProperties
Tags Dicionário de marcas. As marcas podem ser adicionadas, removidas e atualizadas. JobBaseTags

JobBaseProperties

Nome Descrição Valor

JobBaseTags

Nome Descrição Valor

ManagedIdentity

Nome Descrição Valor
clientId Especifica uma identidade atribuída pelo usuário pela ID do cliente. Para atribuído pelo sistema, não defina esse campo. corda

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}$
identityType [Obrigatório] Especifica o tipo de estrutura de identidade. 'Gerenciado' (obrigatório)
objectId Especifica uma identidade atribuída pelo usuário por ID de objeto. Para atribuído pelo sistema, não defina esse campo. corda

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 usuário pela ID de recurso do ARM. Para atribuído pelo sistema, não defina esse campo. corda

MedianStoppingPolicy

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

Microsoft.MachineLearningServices/workspaces/jobs

Nome Descrição Valor
nome O nome do recurso corda

Restrições:
Padrão = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (obrigatório)
parent_id A ID do recurso que é o pai desse recurso. ID do recurso do tipo: workspaces
Propriedades [Obrigatório] Atributos adicionais da entidade. do JobBase (obrigatório)
tipo O tipo de recurso "Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview"

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ó de MPI. int

Objetivo

Nome Descrição Valor
objetivo [Obrigatório] Define as metas de métrica com suporte para ajuste de hiperparâmetro 'Maximize'
'Minimizar' (obrigatório)
primaryMetric [Obrigatório] Nome da métrica a ser otimizada. corda

Restrições:
Padrão = [a-zA-Z0-9_] (obrigatório)

OutputDataBinding

Nome Descrição Valor
datastoreId ID do recurso ARM do armazenamento de dados em que a saída de dados será armazenada. corda
modo Mecanismo de movimentação de dados para armazenamento de dados. 'Direct'
'Baixar'
'EvalDownload'
'EvalMount'
'Montar'
'ReadOnlyMount'
'ReadWriteMount'
'Carregar'
pathOnCompute Local dos dados dentro do processo de contêiner. corda
pathOnDatastore Caminho dentro do armazenamento de dados para os dados. corda

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 o trabalho distribuído. int

SweepJob

Nome Descrição Valor
algoritmo [Obrigatório] Tipo de algoritmos de amostragem de hiperparâmetro 'Bayesian'
'Grade'
'Aleatório' (obrigatório)
calcular [Obrigatório] Associação de computação para o trabalho. ComputeConfiguration (obrigatório)
earlyTermination As políticas de término antecipado permitem o cancelamento de execuções de baixo desempenho antes de serem concluídas. EarlyTerminationPolicy
experimentName O nome do experimento ao qual o trabalho pertence. Se não estiver definido, o trabalho será colocado no experimento "Padrão". corda
identidade Configuração de identidade. Se definido, este deverá ser um de AmlToken, ManagedIdentity ou nulo.
O padrão será AmlToken se nulo.
IdentityConfiguration
jobType [Obrigatório] Especifica o tipo de trabalho. 'Sweep' (obrigatório)
maxConcurrentTrials Um limite superior no número de avaliações executadas em paralelo. int
maxTotalTrials Um limite superior no número de avaliações a serem executadas. int
objetivo [Obrigatório] Objetivo de otimização. objective (obrigatório)
prioridade Prioridade de trabalho para a política de agendamento. Aplica-se apenas ao AMLCompute.
Recurso de visualização privada e disponível somente para usuários na lista de permissões.
int
searchSpace [Obrigatório] Um dicionário que contém cada parâmetro e sua distribuição. A chave do dicionário é o nome do parâmetro SweepJobSearchSpace (obrigatório)
timeout O tempo limite total no formato ISO 8601. Só dá suporte à duração com precisão tão baixa quanto Minutos. corda
julgamento Definição do componente de avaliação. TrialComponent

SweepJobSearchSpace

Nome Descrição Valor

TensorFlow

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

TrialComponent

Nome Descrição Valor
codeId ID do recurso ARM do ativo de código. corda
comando [Obrigatório] O comando a ser executado na inicialização do trabalho. Eg. "python train.py" corda

Restrições:
Comprimento mínimo = 1
Padrão = [a-zA-Z0-9_] (obrigatório)
distribuição Configuração de distribuição do trabalho. Se definido, este deverá ser um de Mpi, Tensorflow, PyTorch ou nulo. DistributionConfiguration
environmentId A ID do recurso ARM da especificação de Ambiente para o trabalho. corda
environmentVariables Variáveis de ambiente incluídas no trabalho. TrialComponentEnvironmentVariables
inputDataBindings Mapeamento de associações de dados de entrada usadas no trabalho. TrialComponentInputDataBindings
outputDataBindings Mapeamento de associações de dados de saída usadas no trabalho. TrialComponentOutputDataBindings
timeout A duração máxima da execução no formato ISO 8601, após a qual o componente de avaliação será cancelado.
Só dá suporte à duração com precisão tão baixa quanto Segundos.
corda

TrialComponentEnvironmentVariables

Nome Descrição Valor

TrialComponentInputDataBindings

Nome Descrição Valor

TrialComponentOutputDataBindings

Nome Descrição Valor

TruncationSelectionPolicy

Nome Descrição Valor
policyType [Obrigatório] Nome da configuração de política 'TruncationSelection' (obrigatório)
truncationPercentage O percentual de execuções a serem canceladas em cada intervalo de avaliação. int