az ml job
Note
This reference is part of the ml extension for the Azure CLI (version 2.15.0 or higher). Расширение автоматически установит первый раз, когда вы запускаете команду az ml job. Learn more about extensions.
Управление заданиями Машинного обучения Azure.
Задание машинного обучения Azure выполняет задачу в заданном целевом объекте вычислений. Задания можно настроить для горизонтального масштабирования обучения модели в Azure. Машинное обучение Azure поддерживает различные типы заданий с разными возможностями. Например, самое простое задание, задание команды, выполняет команду в контейнере Docker и может использоваться для одноузлового обучения и распределенного обучения. Задание очистки выполняет гиперпараметр с помощью заданного пространства поиска для настройки гиперпараметров модели.
Задания также обеспечивают систематическое отслеживание экспериментов и рабочих процессов машинного обучения. После создания задания Azure ML сохраняет запись выполнения для задания, включающую метаданные, все метрики, журналы и артефакты, созданные во время задания, код, который был выполнен, и используемую среду машинного обучения Azure. Все записи о выполнении заданий можно просмотреть в Студии машинного обучения Azure.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az ml job archive |
Архивируйте задание. |
Extension | GA |
az ml job cancel |
Отмена задания. |
Extension | GA |
az ml job connect-ssh |
Настройте подключение ssh и отправляет запрос службе SSH, работающей в контейнере пользователя через Tundra. |
Extension | GA |
az ml job create |
Создайте задание. |
Extension | GA |
az ml job download |
Скачайте все файлы, связанные с заданием. |
Extension | GA |
az ml job list |
Вывод списка заданий в рабочей области. |
Extension | GA |
az ml job restore |
Восстановление архивного задания. |
Extension | GA |
az ml job show |
Отображение сведений о задании. |
Extension | GA |
az ml job show-services |
Отображение служб задания на узел. |
Extension | GA |
az ml job stream |
Потоковая передача журналов заданий в консоль. |
Extension | GA |
az ml job update |
Обновление задания. |
Extension | GA |
az ml job validate |
Проверка задания. Эта команда работает только для заданий конвейера. |
Extension | GA |
az ml job archive
Архивируйте задание.
Архивация задания будет скрыта по умолчанию из запросов списка (az ml job list
). Вы по-прежнему можете ссылаться и использовать архивное задание в рабочих процессах. Архивировать можно только завершенные задания.
az ml job archive --name
--resource-group
--workspace-name
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job cancel
Отмена задания.
az ml job cancel --name
--resource-group
--workspace-name
Примеры
Отмена задания по имени
az ml job cancel --name my-job-id --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job connect-ssh
Настройте подключение ssh и отправляет запрос службе SSH, работающей в контейнере пользователя через Tundra.
az ml job connect-ssh --name
--resource-group
--workspace-name
[--node-index]
[--private-key-file-path]
Примеры
Настройте подключение ssh и отправляет запрос в службу SSH.
az ml job connect-ssh --name my-job-id --node-index 0 --private-key-file-path "C:/Temp/.ssh/id_rsa" --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Индекс узла для подключения через SSH.
Свойство | Значение |
---|---|
Default value: | 0 |
Путь к файлу файла закрытого ключа.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job create
Создайте задание.
Чтобы создать задание, обычно необходимо настроить любой код для выполнения, среду, инкапсулируя зависимости, целевой объект вычислений для выполнения задания и любые дополнительные параметры для конкретного задания. При создании задания он отправляется для выполнения в указанный вычислительный ресурс.
az ml job create --file
--resource-group
--workspace-name
[--name]
[--save-as]
[--set]
[--skip-validation]
[--stream]
[--web]
Примеры
Создание задания из файла спецификации YAML
az ml job create --file job.yml --resource-group my-resource-group --workspace-name my-workspace
Создание задания из файла спецификации YAML и открытие сведений о выполнении задания на портале Студии машинного обучения Azure
az ml job create --file job.yml --web --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Локальный путь к YAML-файлу, содержаму спецификацию задания Машинного обучения Azure. Справочные документы YAML для задания можно найти по адресу: https://aka.ms/ml-cli-v2-job-command-yaml-reference, https://aka.ms/ml-cli-v2-job-sweep-yaml-reference, https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Имя задания.
Файл, в который будет записано состояние созданного задания в формате YAML.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=value.
Пропустить проверку при создании ресурса. Обратите внимание, что зависимые ресурсы не пропускают проверку при создании.
Свойство | Значение |
---|---|
Default value: | False |
Указывает, следует ли передавать журналы задания в консоль.
Свойство | Значение |
---|---|
Default value: | False |
Отображение сведений о выполнении задания в студии машинного обучения Azure в веб-браузере.
Свойство | Значение |
---|---|
Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job download
Скачайте все файлы, связанные с заданием.
Файлы будут загружены в папку с именем задания.
az ml job download --name
--resource-group
--workspace-name
[--all]
[--download-path]
[--output-name]
Примеры
Скачивание журналов и выходных данных задания в текущий рабочий каталог
az ml job download --name my-job --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Скачайте все выходные данные задания.
Свойство | Значение |
---|---|
Default value: | False |
Путь к скачиванию файлов заданий. Если опущено, файлы заданий будут скачаны в текущий каталог.
Имя скачиваемого пользователем выходных данных. Это должно соответствовать ключу в словаре выходных данных задания. Если опущено, выходные файлы артефактов задания по умолчанию будут скачаны.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job list
Вывод списка заданий в рабочей области.
az ml job list --resource-group
--workspace-name
[--all-results {false, true}]
[--archived-only]
[--include-archived]
[--max-results]
[--parent-job-name]
Примеры
Вывод списка всех состояний заданий в рабочей области с помощью аргумента --query для выполнения запроса JMESPath в результатах команд.
az ml job list --query "[].{Name:name,Jobstatus:status}" --output table --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Возвращает все результаты.
Свойство | Значение |
---|---|
Default value: | False |
Допустимые значения: | false, true |
Вывод списка только архивных заданий.
Свойство | Значение |
---|---|
Default value: | False |
Вывод списка архивированных заданий и активных заданий.
Свойство | Значение |
---|---|
Default value: | False |
Максимальное количество возвращаемых результатов. Значение по умолчанию — 50.
Свойство | Значение |
---|---|
Default value: | 50 |
Имя родительского задания. Отобразит список всех заданий, parent_job_name которых соответствует заданному имени.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job restore
Восстановление архивного задания.
После восстановления архивного задания он больше не будет скрыт из запросов списка (az ml job list
).
az ml job restore --name
--resource-group
--workspace-name
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job show
Отображение сведений о задании.
az ml job show --name
--resource-group
--workspace-name
[--web]
Примеры
Отображение состояния задания с помощью аргумента --query для выполнения запроса JMESPath в результатах команд.
az ml job show --name my-job-id --query "{Name:name,Jobstatus:status}" --output table --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Отображение сведений о выполнении задания в студии машинного обучения Azure в веб-браузере.
Свойство | Значение |
---|---|
Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job show-services
Отображение служб задания на узел.
az ml job show-services --name
--resource-group
--workspace-name
[--node-index]
Примеры
Отображение служб задания на узел с помощью аргумента --query для выполнения запроса JMESPath в результатах команд.
az ml job show-services --name my-job-id --node-index 0 --query "{Name:name,Jobstatus:status}" --output table --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Индекс узла, для которого должны отображаться службы.
Свойство | Значение |
---|---|
Default value: | 0 |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job stream
Потоковая передача журналов заданий в консоль.
az ml job stream --name
--resource-group
--workspace-name
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job update
Обновление задания.
Можно обновить только свойства тегов и свойств.
az ml job update --name
--resource-group
--workspace-name
[--add]
[--force-string]
[--remove]
[--set]
[--web]
Обязательные параметры
Имя задания.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>
.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | [] |
При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | False |
Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | [] |
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>
.
Свойство | Значение |
---|---|
Parameter group: | Generic Update Arguments |
Default value: | [] |
Отображение сведений о выполнении задания в студии машинного обучения Azure в веб-браузере.
Свойство | Значение |
---|---|
Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |
az ml job validate
Проверка задания. Эта команда работает только для заданий конвейера.
Эта команда проверяет файл спецификации YAML, чтобы проверить, является ли он допустимым для создания задания, и возвращает все обнаруженные проблемы. Проверка в основном включает локальную проверку схемы, например отсутствующие поля, среду без указанной версии, код ссылается на несуществующий локальный путь; Он также проверяет наличие ссылочных целевых объектов вычислений в целевой рабочей области. Результат проверки будет напечатан в консоли, включая как ошибки, так и предупреждения. Только ошибки приведут к сбою проверки. Выполненная проверка задания сможет быть отправлена. Эта команда работает только для заданий конвейера.
az ml job validate --file
--resource-group
--workspace-name
[--set]
Примеры
Проверьте файл спецификации YAML, чтобы проверить, является ли он допустимым для создания задания.
az ml job validate --file job.yml --resource-group my-resource-group --workspace-name my-workspace
Обязательные параметры
Локальный путь к YAML-файлу, содержаму спецификацию задания Машинного обучения Azure. Справочные документы YAML для задания можно найти по адресу: https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>
.
Необязательные параметры
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=value.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Свойство | Значение |
---|---|
Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
Свойство | Значение |
---|---|
Default value: | False |
Output format.
Свойство | Значение |
---|---|
Default value: | json |
Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
Свойство | Значение |
---|---|
Default value: | False |