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


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

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

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

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

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

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

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

Объекты JobBase

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

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

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

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

{
  algorithm: 'string'
  compute: {
    instanceCount: int
    instanceType: 'string'
    isLocal: bool
    location: 'string'
    properties: {
      {customized property}: 'string'
    }
    target: 'string'
  }
  earlyTermination: {
    delayEvaluation: int
    evaluationInterval: int
    policyType: 'string'
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  experimentName: 'string'
  identity: {
    identityType: 'string'
    // For remaining properties, see IdentityConfiguration objects
  }
  jobType: 'Sweep'
  maxConcurrentTrials: int
  maxTotalTrials: int
  objective: {
    goal: 'string'
    primaryMetric: 'string'
  }
  priority: int
  searchSpace: {
    {customized property}: any(...)
  }
  timeout: 'string'
  trial: {
    codeId: 'string'
    command: 'string'
    distribution: {
      distributionType: 'string'
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId: 'string'
    environmentVariables: {
      {customized property}: 'string'
    }
    inputDataBindings: {
      {customized property}: {
        dataId: 'string'
        mode: 'string'
        pathOnCompute: 'string'
      }
    }
    outputDataBindings: {
      {customized property}: {
        datastoreId: 'string'
        mode: 'string'
        pathOnCompute: 'string'
        pathOnDatastore: 'string'
      }
    }
    timeout: 'string'
  }
}

Объекты IdentityConfiguration

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

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

{
  identityType: 'AMLToken'
}

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

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

Объекты DistributionConfiguration

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

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

{
  distributionType: 'Mpi'
  processCountPerInstance: int
}

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

{
  distributionType: 'PyTorch'
  processCount: int
}

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

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

Объекты EarlyTerminationPolicy

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

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

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

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

{
  policyType: 'MedianStopping'
}

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

{
  policyType: 'TruncationSelection'
  truncationPercentage: int
}

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

Microsoft.MachineLearningServices/рабочие области/задания

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

Ограничения целостности:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

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

Токен AmlToken

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

БандитПолитика

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

Командная работа

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

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

Переменные CommandJobEnvironmentVariables

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

Привязки CommandJobInputDataBindings

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

Привязки CommandJobOutputDataBindings

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

Вычислительная конфигурация

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

Свойства ComputeConfigurationProperties

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

DistributionConfiguration (РаспределениеКонфигурация)

Имя Описание Ценность
distributionType Задайте для типа Mpi значение "Mpi". Задайте для типа PyTorch значение PyTorch. Установите значение TensorFlow для типа TensorFlow. "Mpi"
"PyTorch"
TensorFlow (обязательный)

Политика досрочного прекращения

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

IdentityConfiguration (Конфигурация идентичности)

Имя Описание Ценность
тип идентификации Установите значение AMLToken для типа AmlToken. Задайте для типа ManagedIdentity значение ManagedIdentity. AMLToken
Managed (обязательный)

Привязка InputDataBinding

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

JobBase

Имя Описание Ценность
описание Текст описания ресурса. струна
тип работы Задайте для типа CommandJob значение CommandJob. Задайте значение "Sweep" для типа SweepJob. "Command"
"Очистка" (обязательно)
свойства Словарь свойств ресурса. JobBaseProperties (Свойства JobBase)
Теги Словарь тегов. Теги можно добавлять, удалять и обновлять. JobBaseTags

JobBaseProperties (Свойства JobBase)

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

JobBaseTags

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

Управляемая идентификация

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

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

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

MedianStoppingPolicy (МедианСтоппингPolicy)

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

Мпи

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

Цель

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

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

Привязка выходных данных

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

PyTorch

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

СвипДжоб

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

SweepJobSearchSpace (Пространство для поиска)

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

ТензорФлоу

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

ТриалКомпонент

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

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

TrialComponentEnvironmentVariables

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

Привязки TrialComponentInputDataBindings

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

Привязки TrialComponentOutputDataBindings

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

УсечениеSelectionPolicy

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

Примеры использования

Примеры быстрого запуска Azure

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

Bicep-файл Описание
Создание задания классификации AutoML машинного обучения Azure Этот шаблон создает задание классификации AutoML машинного обучения Azure, чтобы узнать лучшую модель прогнозирования того, будет ли клиент подписаться на фиксированный срок депозита с финансовым учреждением.
Создание задания команды машинного обучения Azure Этот шаблон создает задание команды машинного обучения Azure с помощью базового скрипта hello_world
Создание задания "Очистка машинного обучения 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": {
      "{customized property}": "string"
    },
    "jobType": "string"
    // For remaining properties, see JobBase objects
  }
}

Объекты JobBase

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

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

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

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

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

Объекты IdentityConfiguration

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

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

{
  "identityType": "AMLToken"
}

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

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

Объекты DistributionConfiguration

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

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

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

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

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

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

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

Объекты EarlyTerminationPolicy

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

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

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

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

{
  "policyType": "MedianStopping"
}

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

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

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

Microsoft.MachineLearningServices/рабочие области/задания

Имя Описание Ценность
apiVersion Версия API «2021-03-01-превью»
имя имя ресурса. струна

Ограничения целостности:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (обязательно)
свойства [Обязательный] Дополнительные атрибуты сущности. JobBase (обязательно)
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/jobs"

Токен AmlToken

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

БандитПолитика

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

Командная работа

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

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

Переменные CommandJobEnvironmentVariables

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

Привязки CommandJobInputDataBindings

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

Привязки CommandJobOutputDataBindings

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

Вычислительная конфигурация

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

Свойства ComputeConfigurationProperties

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

DistributionConfiguration (РаспределениеКонфигурация)

Имя Описание Ценность
distributionType Задайте для типа Mpi значение "Mpi". Задайте для типа PyTorch значение PyTorch. Установите значение TensorFlow для типа TensorFlow. "Mpi"
"PyTorch"
TensorFlow (обязательный)

Политика досрочного прекращения

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

IdentityConfiguration (Конфигурация идентичности)

Имя Описание Ценность
тип идентификации Установите значение AMLToken для типа AmlToken. Задайте для типа ManagedIdentity значение ManagedIdentity. AMLToken
Managed (обязательный)

Привязка InputDataBinding

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

JobBase

Имя Описание Ценность
описание Текст описания ресурса. струна
тип работы Задайте для типа CommandJob значение CommandJob. Задайте значение "Sweep" для типа SweepJob. "Command"
"Очистка" (обязательно)
свойства Словарь свойств ресурса. JobBaseProperties (Свойства JobBase)
Теги Словарь тегов. Теги можно добавлять, удалять и обновлять. JobBaseTags

JobBaseProperties (Свойства JobBase)

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

JobBaseTags

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

Управляемая идентификация

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

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

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

MedianStoppingPolicy (МедианСтоппингPolicy)

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

Мпи

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

Цель

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

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

Привязка выходных данных

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

PyTorch

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

СвипДжоб

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

SweepJobSearchSpace (Пространство для поиска)

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

ТензорФлоу

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

ТриалКомпонент

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

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

TrialComponentEnvironmentVariables

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

Привязки TrialComponentInputDataBindings

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

Привязки TrialComponentOutputDataBindings

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

УсечениеSelectionPolicy

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

Примеры использования

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

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

Шаблон Описание
Создание задания классификации 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 = {
    properties = {
      description = "string"
      properties = {
        {customized property} = "string"
      }
      tags = {
        {customized property} = "string"
      }
      jobType = "string"
      // For remaining properties, see JobBase objects
    }
  }
}

Объекты JobBase

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

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

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

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

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

Объекты IdentityConfiguration

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

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

{
  identityType = "AMLToken"
}

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

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

Объекты DistributionConfiguration

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

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

{
  distributionType = "Mpi"
  processCountPerInstance = int
}

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

{
  distributionType = "PyTorch"
  processCount = int
}

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

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

Объекты EarlyTerminationPolicy

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

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

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

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

{
  policyType = "MedianStopping"
}

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

{
  policyType = "TruncationSelection"
  truncationPercentage = int
}

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

Microsoft.MachineLearningServices/рабочие области/задания

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

Ограничения целостности:
Pattern = ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$ (обязательно)
идентификатор_родителя Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: рабочие области
свойства [Обязательный] Дополнительные атрибуты сущности. JobBase (обязательно)
тип Тип ресурса "Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview"

Токен AmlToken

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

БандитПолитика

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

Командная работа

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

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

Переменные CommandJobEnvironmentVariables

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

Привязки CommandJobInputDataBindings

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

Привязки CommandJobOutputDataBindings

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

Вычислительная конфигурация

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

Свойства ComputeConfigurationProperties

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

DistributionConfiguration (РаспределениеКонфигурация)

Имя Описание Ценность
distributionType Задайте для типа Mpi значение "Mpi". Задайте для типа PyTorch значение PyTorch. Установите значение TensorFlow для типа TensorFlow. "Mpi"
"PyTorch"
TensorFlow (обязательный)

Политика досрочного прекращения

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

IdentityConfiguration (Конфигурация идентичности)

Имя Описание Ценность
тип идентификации Установите значение AMLToken для типа AmlToken. Задайте для типа ManagedIdentity значение ManagedIdentity. AMLToken
Managed (обязательный)

Привязка InputDataBinding

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

JobBase

Имя Описание Ценность
описание Текст описания ресурса. струна
тип работы Задайте для типа CommandJob значение CommandJob. Задайте значение "Sweep" для типа SweepJob. "Command"
"Очистка" (обязательно)
свойства Словарь свойств ресурса. JobBaseProperties (Свойства JobBase)
Теги Словарь тегов. Теги можно добавлять, удалять и обновлять. JobBaseTags

JobBaseProperties (Свойства JobBase)

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

JobBaseTags

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

Управляемая идентификация

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

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

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

MedianStoppingPolicy (МедианСтоппингPolicy)

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

Мпи

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

Цель

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

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

Привязка выходных данных

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

PyTorch

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

СвипДжоб

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

SweepJobSearchSpace (Пространство для поиска)

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

ТензорФлоу

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

ТриалКомпонент

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

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

TrialComponentEnvironmentVariables

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

Привязки TrialComponentInputDataBindings

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

Привязки TrialComponentOutputDataBindings

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

УсечениеSelectionPolicy

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