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

az ml job

  • Ссылка

Заметка

Эта ссылка является частью расширения машинного обучения для Azure CLI (версия 2.15.0 или более поздней). Расширение автоматически установит первый раз, когда вы запускаете команду az ml job. Узнайте больше о расширениях.

Управление заданиями Машинного обучения Azure.

Задание машинного обучения Azure выполняет задачу в заданном целевом объекте вычислений. Задания можно настроить для горизонтального масштабирования обучения модели в Azure. Машинное обучение Azure поддерживает различные типы заданий с разными возможностями. Например, самое простое задание, задание команды, выполняет команду в контейнере Docker и может использоваться для одноузлового обучения и распределенного обучения. Задание очистки выполняет гиперпараметр с помощью заданного пространства поиска для настройки гиперпараметров модели.

Задания также обеспечивают систематическое отслеживание экспериментов и рабочих процессов машинного обучения. После создания задания Azure ML сохраняет запись выполнения для задания, включающую метаданные, все метрики, журналы и артефакты, созданные во время задания, код, который был выполнен, и используемую среду машинного обучения Azure. Все записи выполнения заданий можно просмотреть в студии машинного обучения Azure.

Команды

Имя Описание Тип Состояние
az ml job archive

Архивируйте задание.

 Расширение ГА
az ml job cancel

Отмена задания.

 Расширение ГА
az ml job connect-ssh

Настройте подключение ssh и отправляет запрос службе SSH, работающей в контейнере пользователя через Tundra.

 Расширение ГА
az ml job create

Создайте задание.

 Расширение ГА
az ml job download

Скачайте все файлы, связанные с заданием.

 Расширение ГА
az ml job list

Вывод списка заданий в рабочей области.

 Расширение ГА
az ml job restore

Восстановление архивного задания.

 Расширение ГА
az ml job show

Отображение сведений о задании.

 Расширение ГА
az ml job show-services

Отображение служб задания на узел.

 Расширение ГА
az ml job stream

Потоковая передача журналов заданий в консоль.

 Расширение ГА
az ml job update

Обновление задания.

 Расширение ГА
az ml job validate

Проверка задания. Эта команда работает только для заданий конвейера.

 Расширение ГА

az ml job archive

Архивируйте задание.

Архивация задания по умолчанию скрывается из запросов списка (az ml job list). Вы по-прежнему можете ссылаться и использовать архивное задание в рабочих процессах. Архивировать можно только завершенные задания.

az ml job archive --name
                  --resource-group
                  --workspace-name

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--node-index -i

Индекс узла для подключения через SSH.

Default value: 0
--private-key-file-path -f

Путь к файлу файла закрытого ключа.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--file -f

Локальный путь к 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.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--name -n

Имя задания.

--save-as -a

Файл, в который будет записано состояние созданного задания в формате YAML.

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=value.

--skip-validation

Пропустить проверку при создании ресурса. Обратите внимание, что зависимые ресурсы не пропускают проверку при создании.

Default value: False
--stream -s

Указывает, следует ли передавать журналы задания в консоль.

Default value: False
--web -e

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

Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--all

Скачайте все выходные данные задания.

Default value: False
--download-path -p

Путь к скачиванию файлов заданий. Если опущено, файлы заданий будут скачаны в текущий каталог.

--output-name

Имя скачиваемого пользователем выходных данных. Это должно соответствовать ключу в словаре выходных данных задания. Если опущено, выходные файлы артефактов задания по умолчанию будут скачаны.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--all-results

Возвращает все результаты.

Допустимые значения: false, true
Default value: False
--archived-only

Вывод списка только архивных заданий.

Default value: False
--include-archived

Вывод списка архивированных заданий и активных заданий.

Default value: False
--max-results -r

Максимальное количество возвращаемых результатов. Значение по умолчанию — 50.

Default value: 50
--parent-job-name -p

Имя родительского задания. Отобразит список всех заданий, parent_job_name которых соответствует заданному имени.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az ml job restore

Восстановление архивного задания.

После восстановления архивного задания он больше не будет скрыт из запросов списка (az ml job list).

az ml job restore --name
                  --resource-group
                  --workspace-name

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--web -e

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

Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--node-index -i

Индекс узла, для которого должны отображаться службы.

Default value: 0
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az ml job stream

Потоковая передача журналов заданий в консоль.

az ml job stream --name
                 --resource-group
                 --workspace-name

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

az ml job update

Обновление задания.

Можно обновить только свойства тегов и свойств.

az ml job update --name
                 --resource-group
                 --workspace-name
                 [--add]
                 [--force-string]
                 [--remove]
                 [--set]
                 [--web]

Обязательные параметры

--name -n

Имя задания.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Default value: []
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Default value: False
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> ИЛИ --remove propertyToRemove.

Default value: []
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Default value: []
--web -e

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

Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.

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

Обязательные параметры

--file -f

Локальный путь к YAML-файлу, содержаму спецификацию задания Машинного обучения Azure. Справочные документы YAML для задания можно найти по адресу: https://aka.ms/ml-cli-v2-job-pipeline-yaml-reference.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Машинного обучения Azure. Вы можете настроить рабочую область по умолчанию с помощью az configure --defaults workspace=<name>.

Необязательные параметры

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=value.

Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

--help -h

Отображение этого сообщения справки и выхода.

--only-show-errors

Отображаются только ошибки, подавляющие предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.