Поделиться через


Рабочие области и задания Microsoft.MachineLearningServices 2021-03-01-preview

Определение ресурсов Bicep

Тип ресурса рабочих областей и заданий можно развернуть с помощью операций, предназначенных для следующих задач:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.MachineLearningServices/workspaces/jobs, добавьте следующий Bicep в шаблон.

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

Объекты JobBase

Задайте свойство jobType, чтобы указать тип объекта.

Для команды используйте следующую команду:

  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'

Для используйте:

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

Объекты DistributionConfiguration

Задайте свойство distributionType, чтобы указать тип объекта.

Для Mpiиспользуйте:

  distributionType: 'Mpi'
  processCountPerInstance: int

Для PyTorchиспользуйте:

  distributionType: 'PyTorch'
  processCount: int

Для TensorFlowиспользуйте:

  distributionType: 'TensorFlow'
  parameterServerCount: int
  workerCount: int

Объекты IdentityConfiguration

Задайте свойство identityType, чтобы указать тип объекта.

Для AMLTokenиспользуйте:

  identityType: 'AMLToken'

Для управляемыхиспользуйте:

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

Объекты EarlyTerminationPolicy

Задайте свойство policyType, чтобы указать тип объекта.

Для Banditиспользуйте:

  policyType: 'Bandit'
  slackAmount: int
  slackFactor: int

Для MedianStoppingиспользуйте:

  policyType: 'MedianStopping'

Для TruncationSelectionиспользуйте:

  policyType: 'TruncationSelection'
  truncationPercentage: int

Значения свойств

рабочие области и задания

Имя Описание Ценность
имя Имя ресурса

Узнайте, как задать имена и типы дочерних ресурсов в Bicep.
строка (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса.
Символьное имя ресурса типа: рабочих областей
свойства [Обязательный] Дополнительные атрибуты сущности. JobBase (обязательно)

JobBase

Имя Описание Ценность
описание Текст описания ресурса. струна
свойства Словарь свойств ресурса. JobBaseProperties
Теги Словарь тегов. Теги можно добавлять, удалять и обновлять. объект
jobType Установка типа объекта Команда
(обязательно)

JobBaseProperties

Имя Описание Ценность
{настраиваемое свойство} струна

CommandJob

Имя Описание Ценность
jobType [Обязательный] Указывает тип задания. "Command" (обязательный)
codeId Идентификатор ресурса ARM ресурса ресурса кода. струна
команда [Обязательный] Команда, выполняемая при запуске задания. Например. "Python train.py" строка (обязательно)

Ограничения целостности:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_]
вычислять [Обязательный] Привязка вычислений для задания. ComputeConfiguration (обязательно)
распределение Конфигурация распределения задания. Если задано, это должен быть один из Mpi, Tensorflow, PyTorch или NULL. distributionConfiguration
environmentId Идентификатор ресурса ARM спецификации среды для задания. струна
environmentVariables Переменные среды, включенные в задание. CommandJobEnvironmentVariables
experimentName Имя эксперимента, к которому принадлежит задание. Если задание не задано, задание помещается в эксперимент по умолчанию. струна
тождество Конфигурация удостоверения. Если задано, это должен быть один из AmlToken, ManagedIdentity или NULL.
По умолчанию AmlToken имеет значение NULL.
IdentityConfiguration
inputDataBindings Сопоставление входных привязок данных, используемых в задании. CommandJobInputDataBindings
outputDataBindings Сопоставление привязок выходных данных, используемых в задании. CommandJobOutputDataBindings
приоритет Приоритет задания для политики планирования. Применяется только к AMLCompute.
Функция частной предварительной версии и доступна только пользователям в списке разрешений.
int
Времени ожидания Максимальная длительность выполнения в формате ISO 8601, после которой задание будет отменено. Поддерживается только длительность с точностью до секунд. струна

ComputeConfiguration

Имя Описание Ценность
instanceCount Количество экземпляров или узлов. int
instanceType Тип SKU для запуска. струна
isLocal Задайте значение true для заданий, выполняющихся в локальных вычислениях. bool
местоположение Расположение для запуска виртуального кластера. струна
свойства Дополнительные свойства. ComputeConfigurationProperties
цель Идентификатор ресурса ARM целевого вычислительных ресурсов. Если ресурс не указан, будет развернут как управляемый. струна

ComputeConfigurationProperties

Имя Описание Ценность
{настраиваемое свойство} струна

DistributionConfiguration

Имя Описание Ценность
distributionType Установка типа объекта Mpi
PyTorch
TensorFlow (обязательно)

Mpi

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. Mpi (обязательно)
processCountPerInstance Количество процессов на узел MPI. int

PyTorch

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. PyTorch (обязательный)
ProcessCount Общее число процессов для распределенного задания. int

TensorFlow

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. TensorFlow (обязательный)
parameterServerCount Количество задач сервера параметров. int
workerCount Число рабочих ролей. Перезаписывает количество узлов в вычислительной привязке. int

CommandJobEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

IdentityConfiguration

Имя Описание Ценность
identityType Установка типа объекта AMLToken
Управляемое (обязательно)

AmlToken

Имя Описание Ценность
identityType [Обязательный] Указывает тип платформы удостоверений. AMLToken (обязательно)

ManagedIdentity

Имя Описание Ценность
identityType [Обязательный] Указывает тип платформы удостоверений. Managed (обязательный)
clientId Указывает назначаемое пользователем удостоверение по идентификатору клиента. Для назначаемого системой не устанавливайте это поле. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Указывает назначаемое пользователем удостоверение по идентификатору объекта. Для назначаемого системой не устанавливайте это поле. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Указывает удостоверение, назначаемое пользователем, по идентификатору ресурса ARM. Для назначаемого системой не устанавливайте это поле. струна

CommandJobInputDataBindings

Имя Описание Ценность
{настраиваемое свойство} InputDataBinding

InputDataBinding

Имя Описание Ценность
dataId Идентификатор ресурса ARM зарегистрированной dataVersion. струна
режим Механизм доступа к артефакту данных. 'Direct'
"Скачать"
EvalDownload
EvalMount
"Подключение"
ReadOnlyMount
ReadWriteMount
"Отправить"
pathOnCompute Расположение данных внутри процесса контейнера. струна

CommandJobOutputDataBindings

Имя Описание Ценность
{настраиваемое свойство} OutputDataBinding

OutputDataBinding

Имя Описание Ценность
datastoreId Идентификатор ресурса ARM хранилища данных, в котором будут храниться выходные данные. струна
режим Механизм перемещения данных в хранилище данных. 'Direct'
"Скачать"
EvalDownload
EvalMount
"Подключение"
ReadOnlyMount
ReadWriteMount
"Отправить"
pathOnCompute Расположение данных внутри процесса контейнера. струна
pathOnDatastore Путь в хранилище данных к данным. струна

SweepJob

Имя Описание Ценность
jobType [Обязательный] Указывает тип задания. "Очистка" (обязательно)
алгоритм [Обязательный] Тип алгоритмов выборки гиперпараметров "Байезиан"
"Сетка"
"Случайный" (обязательный)
вычислять [Обязательный] Привязка вычислений для задания. ComputeConfiguration (обязательно)
ранняятерминация Политики раннего завершения позволяют отменять низкопроизводительные запуски до их завершения. EarlyTerminationPolicy
experimentName Имя эксперимента, к которому принадлежит задание. Если задание не задано, задание помещается в эксперимент по умолчанию. струна
тождество Конфигурация удостоверения. Если задано, это должен быть один из AmlToken, ManagedIdentity или NULL.
По умолчанию AmlToken имеет значение NULL.
IdentityConfiguration
maxConcurrentTrials Верхняя граница числа испытаний, выполняемых параллельно. int
maxTotalTrials Верхняя граница по количеству выполняемых проб. int
объективный [Обязательный] Цель оптимизации. Objective (обязательно)
приоритет Приоритет задания для политики планирования. Применяется только к AMLCompute.
Функция частной предварительной версии и доступна только пользователям в списке разрешений.
int
searchSpace [Обязательный] Словарь, содержащий каждый параметр и его распределение. Ключ словаря — это имя параметра SweepJobSearchSpace (обязательно)
Времени ожидания Общее время ожидания в формате ISO 8601. Поддерживается только длительность с точностью до минут. струна
испытание Определение компонента пробной версии. TrialComponent

EarlyTerminationPolicy

Имя Описание Ценность
delayEvaluation Количество интервалов, с помощью которых необходимо отложить первую оценку. int
evaluationInterval Интервал (количество запусков) между оценками политики. int
policyType Установка типа объекта Банда
MedianStopping
TruncationSelection (обязательно)

BanditPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики "Банда" (обязательно)
slackAmount Абсолютное расстояние, допустимое от оптимального выполнения. int
slackFactor Соотношение допустимого расстояния от оптимального выполнения. int

MedianStoppingPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики MedianStopping (обязательно)

УсечениеSelectionPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики УсечениеSelection (обязательно)
усечениеPercentage Процент выполнения для отмены по каждому интервалу оценки. int

Объективный

Имя Описание Ценность
цель [Обязательный] Определяет поддерживаемые цели метрик для настройки гиперпараметров "Развернуть"
"Свернуть" (обязательно)
primaryMetric [Обязательный] Имя метрики для оптимизации. строка (обязательно)

Ограничения целостности:
Pattern = [a-zA-Z0-9_]

SweepJobSearchSpace

Имя Описание Ценность
{настраиваемое свойство} Для Bicep можно использовать функцию any().

TrialComponent

Имя Описание Ценность
codeId Идентификатор ресурса ARM ресурса ресурса кода. струна
команда [Обязательный] Команда, выполняемая при запуске задания. Например. "Python train.py" строка (обязательно)

Ограничения целостности:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_]
распределение Конфигурация распределения задания. Если задано, это должен быть один из Mpi, Tensorflow, PyTorch или NULL. distributionConfiguration
environmentId Идентификатор ресурса ARM спецификации среды для задания. струна
environmentVariables Переменные среды, включенные в задание. TrialComponentEnvironmentVariables
inputDataBindings Сопоставление входных привязок данных, используемых в задании. TrialComponentInputDataBindings
outputDataBindings Сопоставление привязок выходных данных, используемых в задании. TrialComponentOutputDataBindings
Времени ожидания Максимальная длительность выполнения в формате ISO 8601, после которой компонент пробной версии будет отменен.
Поддерживается только длительность с точностью до секунд.
струна

TrialComponentEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

TrialComponentInputDataBindings

Имя Описание Ценность
{настраиваемое свойство} InputDataBinding

TrialComponentOutputDataBindings

Имя Описание Ценность
{настраиваемое свойство} OutputDataBinding

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание задания классификации AutoML машинного обучения Azure

развертывание в Azure
Этот шаблон создает задание классификации AutoML машинного обучения Azure, чтобы узнать лучшую модель прогнозирования того, будет ли клиент подписаться на фиксированный срок депозита с финансовым учреждением.
создание задания команды машинного обучения Azure

развертывание в Azure
Этот шаблон создает задание команды машинного обучения Azure с помощью базового скрипта hello_world
создание задания "Очистка машинного обучения Azure"

развертывание в Azure
Этот шаблон создает задание "Очистка машинного обучения Azure" для настройки гиперпараметра.

Определение ресурса шаблона ARM

Тип ресурса рабочих областей и заданий можно развернуть с помощью операций, предназначенных для следующих задач:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.MachineLearningServices/workspaces/jobs, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.MachineLearningServices/workspaces/jobs",
  "apiVersion": "2021-03-01-preview",
  "name": "string",
  "properties": {
    "description": "string",
    "properties": {
      "{customized property}": "string"
    },
    "tags": {},
    "jobType": "string"
    // For remaining properties, see JobBase objects
  }
}

Объекты JobBase

Задайте свойство jobType, чтобы указать тип объекта.

Для команды используйте следующую команду:

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

Для используйте:

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

Объекты DistributionConfiguration

Задайте свойство distributionType, чтобы указать тип объекта.

Для Mpiиспользуйте:

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

Для PyTorchиспользуйте:

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

Для TensorFlowиспользуйте:

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

Объекты IdentityConfiguration

Задайте свойство identityType, чтобы указать тип объекта.

Для AMLTokenиспользуйте:

  "identityType": "AMLToken"

Для управляемыхиспользуйте:

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

Объекты EarlyTerminationPolicy

Задайте свойство policyType, чтобы указать тип объекта.

Для Banditиспользуйте:

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

Для MedianStoppingиспользуйте:

  "policyType": "MedianStopping"

Для TruncationSelectionиспользуйте:

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

Значения свойств

рабочие области и задания

Имя Описание Ценность
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/jobs"
apiVersion Версия API ресурсов '2021-03-01-preview'
имя Имя ресурса

Узнайте, как задать имена и типы дочерних ресурсов в шаблонах ARM JSON.
строка (обязательно)
свойства [Обязательный] Дополнительные атрибуты сущности. JobBase (обязательно)

JobBase

Имя Описание Ценность
описание Текст описания ресурса. струна
свойства Словарь свойств ресурса. JobBaseProperties
Теги Словарь тегов. Теги можно добавлять, удалять и обновлять. объект
jobType Установка типа объекта Команда
(обязательно)

JobBaseProperties

Имя Описание Ценность
{настраиваемое свойство} струна

CommandJob

Имя Описание Ценность
jobType [Обязательный] Указывает тип задания. "Command" (обязательный)
codeId Идентификатор ресурса ARM ресурса ресурса кода. струна
команда [Обязательный] Команда, выполняемая при запуске задания. Например. "Python train.py" строка (обязательно)

Ограничения целостности:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_]
вычислять [Обязательный] Привязка вычислений для задания. ComputeConfiguration (обязательно)
распределение Конфигурация распределения задания. Если задано, это должен быть один из Mpi, Tensorflow, PyTorch или NULL. distributionConfiguration
environmentId Идентификатор ресурса ARM спецификации среды для задания. струна
environmentVariables Переменные среды, включенные в задание. CommandJobEnvironmentVariables
experimentName Имя эксперимента, к которому принадлежит задание. Если задание не задано, задание помещается в эксперимент по умолчанию. струна
тождество Конфигурация удостоверения. Если задано, это должен быть один из AmlToken, ManagedIdentity или NULL.
По умолчанию AmlToken имеет значение NULL.
IdentityConfiguration
inputDataBindings Сопоставление входных привязок данных, используемых в задании. CommandJobInputDataBindings
outputDataBindings Сопоставление привязок выходных данных, используемых в задании. CommandJobOutputDataBindings
приоритет Приоритет задания для политики планирования. Применяется только к AMLCompute.
Функция частной предварительной версии и доступна только пользователям в списке разрешений.
int
Времени ожидания Максимальная длительность выполнения в формате ISO 8601, после которой задание будет отменено. Поддерживается только длительность с точностью до секунд. струна

ComputeConfiguration

Имя Описание Ценность
instanceCount Количество экземпляров или узлов. int
instanceType Тип SKU для запуска. струна
isLocal Задайте значение true для заданий, выполняющихся в локальных вычислениях. bool
местоположение Расположение для запуска виртуального кластера. струна
свойства Дополнительные свойства. ComputeConfigurationProperties
цель Идентификатор ресурса ARM целевого вычислительных ресурсов. Если ресурс не указан, будет развернут как управляемый. струна

ComputeConfigurationProperties

Имя Описание Ценность
{настраиваемое свойство} струна

DistributionConfiguration

Имя Описание Ценность
distributionType Установка типа объекта Mpi
PyTorch
TensorFlow (обязательно)

Mpi

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. Mpi (обязательно)
processCountPerInstance Количество процессов на узел MPI. int

PyTorch

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. PyTorch (обязательный)
ProcessCount Общее число процессов для распределенного задания. int

TensorFlow

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. TensorFlow (обязательный)
parameterServerCount Количество задач сервера параметров. int
workerCount Число рабочих ролей. Перезаписывает количество узлов в вычислительной привязке. int

CommandJobEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

IdentityConfiguration

Имя Описание Ценность
identityType Установка типа объекта AMLToken
Управляемое (обязательно)

AmlToken

Имя Описание Ценность
identityType [Обязательный] Указывает тип платформы удостоверений. AMLToken (обязательно)

ManagedIdentity

Имя Описание Ценность
identityType [Обязательный] Указывает тип платформы удостоверений. Managed (обязательный)
clientId Указывает назначаемое пользователем удостоверение по идентификатору клиента. Для назначаемого системой не устанавливайте это поле. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Указывает назначаемое пользователем удостоверение по идентификатору объекта. Для назначаемого системой не устанавливайте это поле. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Указывает удостоверение, назначаемое пользователем, по идентификатору ресурса ARM. Для назначаемого системой не устанавливайте это поле. струна

CommandJobInputDataBindings

Имя Описание Ценность
{настраиваемое свойство} InputDataBinding

InputDataBinding

Имя Описание Ценность
dataId Идентификатор ресурса ARM зарегистрированной dataVersion. струна
режим Механизм доступа к артефакту данных. 'Direct'
"Скачать"
EvalDownload
EvalMount
"Подключение"
ReadOnlyMount
ReadWriteMount
"Отправить"
pathOnCompute Расположение данных внутри процесса контейнера. струна

CommandJobOutputDataBindings

Имя Описание Ценность
{настраиваемое свойство} OutputDataBinding

OutputDataBinding

Имя Описание Ценность
datastoreId Идентификатор ресурса ARM хранилища данных, в котором будут храниться выходные данные. струна
режим Механизм перемещения данных в хранилище данных. 'Direct'
"Скачать"
EvalDownload
EvalMount
"Подключение"
ReadOnlyMount
ReadWriteMount
"Отправить"
pathOnCompute Расположение данных внутри процесса контейнера. струна
pathOnDatastore Путь в хранилище данных к данным. струна

SweepJob

Имя Описание Ценность
jobType [Обязательный] Указывает тип задания. "Очистка" (обязательно)
алгоритм [Обязательный] Тип алгоритмов выборки гиперпараметров "Байезиан"
"Сетка"
"Случайный" (обязательный)
вычислять [Обязательный] Привязка вычислений для задания. ComputeConfiguration (обязательно)
ранняятерминация Политики раннего завершения позволяют отменять низкопроизводительные запуски до их завершения. EarlyTerminationPolicy
experimentName Имя эксперимента, к которому принадлежит задание. Если задание не задано, задание помещается в эксперимент по умолчанию. струна
тождество Конфигурация удостоверения. Если задано, это должен быть один из AmlToken, ManagedIdentity или NULL.
По умолчанию AmlToken имеет значение NULL.
IdentityConfiguration
maxConcurrentTrials Верхняя граница числа испытаний, выполняемых параллельно. int
maxTotalTrials Верхняя граница по количеству выполняемых проб. int
объективный [Обязательный] Цель оптимизации. Objective (обязательно)
приоритет Приоритет задания для политики планирования. Применяется только к AMLCompute.
Функция частной предварительной версии и доступна только пользователям в списке разрешений.
int
searchSpace [Обязательный] Словарь, содержащий каждый параметр и его распределение. Ключ словаря — это имя параметра SweepJobSearchSpace (обязательно)
Времени ожидания Общее время ожидания в формате ISO 8601. Поддерживается только длительность с точностью до минут. струна
испытание Определение компонента пробной версии. TrialComponent

EarlyTerminationPolicy

Имя Описание Ценность
delayEvaluation Количество интервалов, с помощью которых необходимо отложить первую оценку. int
evaluationInterval Интервал (количество запусков) между оценками политики. int
policyType Установка типа объекта Банда
MedianStopping
TruncationSelection (обязательно)

BanditPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики "Банда" (обязательно)
slackAmount Абсолютное расстояние, допустимое от оптимального выполнения. int
slackFactor Соотношение допустимого расстояния от оптимального выполнения. int

MedianStoppingPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики MedianStopping (обязательно)

УсечениеSelectionPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики УсечениеSelection (обязательно)
усечениеPercentage Процент выполнения для отмены по каждому интервалу оценки. int

Объективный

Имя Описание Ценность
цель [Обязательный] Определяет поддерживаемые цели метрик для настройки гиперпараметров "Развернуть"
"Свернуть" (обязательно)
primaryMetric [Обязательный] Имя метрики для оптимизации. строка (обязательно)

Ограничения целостности:
Pattern = [a-zA-Z0-9_]

SweepJobSearchSpace

Имя Описание Ценность
{настраиваемое свойство}

TrialComponent

Имя Описание Ценность
codeId Идентификатор ресурса ARM ресурса ресурса кода. струна
команда [Обязательный] Команда, выполняемая при запуске задания. Например. "Python train.py" строка (обязательно)

Ограничения целостности:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_]
распределение Конфигурация распределения задания. Если задано, это должен быть один из Mpi, Tensorflow, PyTorch или NULL. distributionConfiguration
environmentId Идентификатор ресурса ARM спецификации среды для задания. струна
environmentVariables Переменные среды, включенные в задание. TrialComponentEnvironmentVariables
inputDataBindings Сопоставление входных привязок данных, используемых в задании. TrialComponentInputDataBindings
outputDataBindings Сопоставление привязок выходных данных, используемых в задании. TrialComponentOutputDataBindings
Времени ожидания Максимальная длительность выполнения в формате ISO 8601, после которой компонент пробной версии будет отменен.
Поддерживается только длительность с точностью до секунд.
струна

TrialComponentEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

TrialComponentInputDataBindings

Имя Описание Ценность
{настраиваемое свойство} InputDataBinding

TrialComponentOutputDataBindings

Имя Описание Ценность
{настраиваемое свойство} OutputDataBinding

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
создание задания классификации AutoML машинного обучения Azure

развертывание в Azure
Этот шаблон создает задание классификации AutoML машинного обучения Azure, чтобы узнать лучшую модель прогнозирования того, будет ли клиент подписаться на фиксированный срок депозита с финансовым учреждением.
создание задания команды машинного обучения Azure

развертывание в Azure
Этот шаблон создает задание команды машинного обучения Azure с помощью базового скрипта hello_world
создание задания "Очистка машинного обучения Azure"

развертывание в Azure
Этот шаблон создает задание "Очистка машинного обучения Azure" для настройки гиперпараметра.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса рабочих областей и заданий можно развернуть с помощью операций, предназначенных для следующих задач:

  • групп ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.MachineLearningServices/workspaces/jobs, добавьте следующий объект Terraform в шаблон.

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

Объекты JobBase

Задайте свойство jobType, чтобы указать тип объекта.

Для команды используйте следующую команду:

  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"

Для используйте:

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

Объекты DistributionConfiguration

Задайте свойство distributionType, чтобы указать тип объекта.

Для Mpiиспользуйте:

  distributionType = "Mpi"
  processCountPerInstance = int

Для PyTorchиспользуйте:

  distributionType = "PyTorch"
  processCount = int

Для TensorFlowиспользуйте:

  distributionType = "TensorFlow"
  parameterServerCount = int
  workerCount = int

Объекты IdentityConfiguration

Задайте свойство identityType, чтобы указать тип объекта.

Для AMLTokenиспользуйте:

  identityType = "AMLToken"

Для управляемыхиспользуйте:

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

Объекты EarlyTerminationPolicy

Задайте свойство policyType, чтобы указать тип объекта.

Для Banditиспользуйте:

  policyType = "Bandit"
  slackAmount = int
  slackFactor = int

Для MedianStoppingиспользуйте:

  policyType = "MedianStopping"

Для TruncationSelectionиспользуйте:

  policyType = "TruncationSelection"
  truncationPercentage = int

Значения свойств

рабочие области и задания

Имя Описание Ценность
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview"
имя Имя ресурса строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: рабочих областей
свойства [Обязательный] Дополнительные атрибуты сущности. JobBase (обязательно)

JobBase

Имя Описание Ценность
описание Текст описания ресурса. струна
свойства Словарь свойств ресурса. JobBaseProperties
Теги Словарь тегов. Теги можно добавлять, удалять и обновлять. объект
jobType Установка типа объекта Команда
(обязательно)

JobBaseProperties

Имя Описание Ценность
{настраиваемое свойство} струна

CommandJob

Имя Описание Ценность
jobType [Обязательный] Указывает тип задания. "Command" (обязательно)
codeId Идентификатор ресурса ARM ресурса ресурса кода. струна
команда [Обязательный] Команда, выполняемая при запуске задания. Например. "Python train.py" строка (обязательно)

Ограничения целостности:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_]
вычислять [Обязательный] Привязка вычислений для задания. ComputeConfiguration (обязательно)
распределение Конфигурация распределения задания. Если задано, это должен быть один из Mpi, Tensorflow, PyTorch или NULL. distributionConfiguration
environmentId Идентификатор ресурса ARM спецификации среды для задания. струна
environmentVariables Переменные среды, включенные в задание. CommandJobEnvironmentVariables
experimentName Имя эксперимента, к которому принадлежит задание. Если задание не задано, задание помещается в эксперимент по умолчанию. струна
тождество Конфигурация удостоверения. Если задано, это должен быть один из AmlToken, ManagedIdentity или NULL.
По умолчанию AmlToken имеет значение NULL.
IdentityConfiguration
inputDataBindings Сопоставление входных привязок данных, используемых в задании. CommandJobInputDataBindings
outputDataBindings Сопоставление привязок выходных данных, используемых в задании. CommandJobOutputDataBindings
приоритет Приоритет задания для политики планирования. Применяется только к AMLCompute.
Функция частной предварительной версии и доступна только пользователям в списке разрешений.
int
Времени ожидания Максимальная длительность выполнения в формате ISO 8601, после которой задание будет отменено. Поддерживается только длительность с точностью до секунд. струна

ComputeConfiguration

Имя Описание Ценность
instanceCount Количество экземпляров или узлов. int
instanceType Тип SKU для запуска. струна
isLocal Задайте значение true для заданий, выполняющихся в локальных вычислениях. bool
местоположение Расположение для запуска виртуального кластера. струна
свойства Дополнительные свойства. ComputeConfigurationProperties
цель Идентификатор ресурса ARM целевого вычислительных ресурсов. Если ресурс не указан, будет развернут как управляемый. струна

ComputeConfigurationProperties

Имя Описание Ценность
{настраиваемое свойство} струна

DistributionConfiguration

Имя Описание Ценность
distributionType Установка типа объекта Mpi
PyTorch
TensorFlow (обязательно)

Mpi

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. "Mpi" (обязательно)
processCountPerInstance Количество процессов на узел MPI. int

PyTorch

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. PyTorch (обязательно)
ProcessCount Общее число процессов для распределенного задания. int

TensorFlow

Имя Описание Ценность
distributionType [Обязательный] Указывает тип платформы распространения. TensorFlow (обязательно)
parameterServerCount Количество задач сервера параметров. int
workerCount Число рабочих ролей. Перезаписывает количество узлов в вычислительной привязке. int

CommandJobEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

IdentityConfiguration

Имя Описание Ценность
identityType Установка типа объекта AMLToken
Управляемое (обязательно)

AmlToken

Имя Описание Ценность
identityType [Обязательный] Указывает тип платформы удостоверений. AMLToken (обязательно)

ManagedIdentity

Имя Описание Ценность
identityType [Обязательный] Указывает тип платформы удостоверений. "Managed" (обязательно)
clientId Указывает назначаемое пользователем удостоверение по идентификатору клиента. Для назначаемого системой не устанавливайте это поле. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
objectId Указывает назначаемое пользователем удостоверение по идентификатору объекта. Для назначаемого системой не устанавливайте это поле. струна

Ограничения целостности:
Минимальная длина = 36
Максимальная длина = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$
resourceId Указывает удостоверение, назначаемое пользователем, по идентификатору ресурса ARM. Для назначаемого системой не устанавливайте это поле. струна

CommandJobInputDataBindings

Имя Описание Ценность
{настраиваемое свойство} InputDataBinding

InputDataBinding

Имя Описание Ценность
dataId Идентификатор ресурса ARM зарегистрированной dataVersion. струна
режим Механизм доступа к артефакту данных. "Direct"
"Скачать"
EvalDownload
EvalMount
"Подключить"
ReadOnlyMount
ReadWriteMount
"Отправить"
pathOnCompute Расположение данных внутри процесса контейнера. струна

CommandJobOutputDataBindings

Имя Описание Ценность
{настраиваемое свойство} OutputDataBinding

OutputDataBinding

Имя Описание Ценность
datastoreId Идентификатор ресурса ARM хранилища данных, в котором будут храниться выходные данные. струна
режим Механизм перемещения данных в хранилище данных. "Direct"
"Скачать"
EvalDownload
EvalMount
"Подключить"
ReadOnlyMount
ReadWriteMount
"Отправить"
pathOnCompute Расположение данных внутри процесса контейнера. струна
pathOnDatastore Путь в хранилище данных к данным. струна

SweepJob

Имя Описание Ценность
jobType [Обязательный] Указывает тип задания. "Очистка" (обязательно)
алгоритм [Обязательный] Тип алгоритмов выборки гиперпараметров "Байезиан"
"Сетка"
"Случайный" (обязательный)
вычислять [Обязательный] Привязка вычислений для задания. ComputeConfiguration (обязательно)
ранняятерминация Политики раннего завершения позволяют отменять низкопроизводительные запуски до их завершения. EarlyTerminationPolicy
experimentName Имя эксперимента, к которому принадлежит задание. Если задание не задано, задание помещается в эксперимент по умолчанию. струна
тождество Конфигурация удостоверения. Если задано, это должен быть один из AmlToken, ManagedIdentity или NULL.
По умолчанию AmlToken имеет значение NULL.
IdentityConfiguration
maxConcurrentTrials Верхняя граница числа испытаний, выполняемых параллельно. int
maxTotalTrials Верхняя граница по количеству выполняемых проб. int
объективный [Обязательный] Цель оптимизации. Objective (обязательно)
приоритет Приоритет задания для политики планирования. Применяется только к AMLCompute.
Функция частной предварительной версии и доступна только пользователям в списке разрешений.
int
searchSpace [Обязательный] Словарь, содержащий каждый параметр и его распределение. Ключ словаря — это имя параметра SweepJobSearchSpace (обязательно)
Времени ожидания Общее время ожидания в формате ISO 8601. Поддерживается только длительность с точностью до минут. струна
испытание Определение компонента пробной версии. TrialComponent

EarlyTerminationPolicy

Имя Описание Ценность
delayEvaluation Количество интервалов, с помощью которых необходимо отложить первую оценку. int
evaluationInterval Интервал (количество запусков) между оценками политики. int
policyType Установка типа объекта Банда
MedianStopping
TruncationSelection (обязательно)

BanditPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики "Банда" (обязательно)
slackAmount Абсолютное расстояние, допустимое от оптимального выполнения. int
slackFactor Соотношение допустимого расстояния от оптимального выполнения. int

MedianStoppingPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики MedianStopping (обязательно)

УсечениеSelectionPolicy

Имя Описание Ценность
policyType [Обязательный] Имя конфигурации политики "УсечениеSelection" (обязательно)
усечениеPercentage Процент выполнения для отмены по каждому интервалу оценки. int

Объективный

Имя Описание Ценность
цель [Обязательный] Определяет поддерживаемые цели метрик для настройки гиперпараметров "Развернуть"
"Свернуть" (обязательно)
primaryMetric [Обязательный] Имя метрики для оптимизации. строка (обязательно)

Ограничения целостности:
Pattern = [a-zA-Z0-9_]

SweepJobSearchSpace

Имя Описание Ценность
{настраиваемое свойство}

TrialComponent

Имя Описание Ценность
codeId Идентификатор ресурса ARM ресурса ресурса кода. струна
команда [Обязательный] Команда, выполняемая при запуске задания. Например. "Python train.py" строка (обязательно)

Ограничения целостности:
Минимальная длина = 1
Pattern = [a-zA-Z0-9_]
распределение Конфигурация распределения задания. Если задано, это должен быть один из Mpi, Tensorflow, PyTorch или NULL. distributionConfiguration
environmentId Идентификатор ресурса ARM спецификации среды для задания. струна
environmentVariables Переменные среды, включенные в задание. TrialComponentEnvironmentVariables
inputDataBindings Сопоставление входных привязок данных, используемых в задании. TrialComponentInputDataBindings
outputDataBindings Сопоставление привязок выходных данных, используемых в задании. TrialComponentOutputDataBindings
Времени ожидания Максимальная длительность выполнения в формате ISO 8601, после которой компонент пробной версии будет отменен.
Поддерживается только длительность с точностью до секунд.
струна

TrialComponentEnvironmentVariables

Имя Описание Ценность
{настраиваемое свойство} струна

TrialComponentInputDataBindings

Имя Описание Ценность
{настраиваемое свойство} InputDataBinding

TrialComponentOutputDataBindings

Имя Описание Ценность
{настраиваемое свойство} OutputDataBinding