az batch pool
Примечание.
Эта группа команд содержит команды, определенные как в Azure CLI, так и в одном расширении. Установите каждое расширение, чтобы воспользоваться расширенными возможностями. Подробнее о расширениях.
Управление пулами пакетной службы.
Команды
| Имя | Описание | Тип | Состояние |
|---|---|---|---|
| az batch pool autoscale |
Управление автоматическим масштабированием пулов пакетной службы. |
Основные сведения | Общедоступная версия |
| az batch pool autoscale disable |
Отключает автоматическое масштабирование пула. |
Основные сведения | Общедоступная версия |
| az batch pool autoscale enable |
Включает автоматическое масштабирование пула. |
Основные сведения | Общедоступная версия |
| az batch pool autoscale evaluate |
Возвращает результат вычисления формулы автоматического масштабирования в пуле. |
Основные сведения | Общедоступная версия |
| az batch pool create |
Создайте пул пакетной службы в учетной записи. При создании пула выберите аргументы из Облачные службы конфигурации или конфигурации виртуальной машины. |
Основные сведения | Общедоступная версия |
| az batch pool create (azure-batch-cli-extensions Расширение) |
Создайте пул пакетной службы в учетной записи. При создании пула выберите аргументы из Облачные службы конфигурации или конфигурации виртуальной машины. |
Расширение | Общедоступная версия |
| az batch pool delete |
Удаляет пул из указанной учетной записи. |
Основные сведения | Общедоступная версия |
| az batch pool list |
Выводит список всех пулов в указанной учетной записи. |
Основные сведения | Общедоступная версия |
| az batch pool node-counts |
Получение счетчиков узлов для пулов пакетной службы. |
Основные сведения | Общедоступная версия |
| az batch pool node-counts list |
Возвращает количество вычислительных узлов в каждом состоянии, сгруппированных по пулу. |
Основные сведения | Общедоступная версия |
| az batch pool reset |
Обновите свойства пула пакетной службы. Неопределенные свойства, которые можно обновить, сбрасываются по умолчанию. |
Основные сведения | Общедоступная версия |
| az batch pool resize |
Изменение размера или остановка изменения размера пула пакетной службы. |
Основные сведения | Общедоступная версия |
| az batch pool set |
Обновите свойства пула пакетной службы. Обновление свойства в подгруппе приведет к сбросу неопределенных свойств этой группы. |
Основные сведения | Общедоступная версия |
| az batch pool show |
Возвращает сведения о указанном пуле. |
Основные сведения | Общедоступная версия |
| az batch pool supported-images |
Запрос сведений о образах виртуальных машин, поддерживаемых службой пакетная служба Azure. |
Основные сведения | Общедоступная версия |
| az batch pool supported-images list |
Выводит список всех образов виртуальных машин, поддерживаемых службой пакетная служба Azure. |
Основные сведения | Общедоступная версия |
| az batch pool usage-metrics |
Просмотр метрик использования пулов пакетной службы. |
Основные сведения | Общедоступная версия |
| az batch pool usage-metrics list |
Перечисляет метрики использования, агрегированные пулом по отдельным интервалам времени для указанной учетной записи. |
Основные сведения | Общедоступная версия |
az batch pool create
Создайте пул пакетной службы в учетной записи. При создании пула выберите аргументы из Облачные службы конфигурации или конфигурации виртуальной машины.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--defer-os-rolling-upgrade {false, true}]
[--disable-auto-rollback {false, true}]
[--disk-encryption-targets]
[--enable-auto-os-upgrade {false, true}]
[--enable-cross-zone-upgrade {false, true}]
[--enable-inter-node-communication]
[--enable-secure-boot {false, true}]
[--enable-vtpm {false, true}]
[--enable-write-accel {false, true}]
[--encryption-at-host {false, true}]
[--id]
[--image]
[--json-file]
[--max-batch-instance-percent]
[--max-unhealthy-instance-percent]
[--max-unhealthy-upgraded-instance-percent]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--os-family {2, 3, 4, 5, 6}]
[--os-version]
[--pause-time-between-batches]
[--placement {cachedisk}]
[--policy {regional, zonal}]
[--prioritize-unhealthy-instances {false, true}]
[--resize-timeout]
[--resource-tags]
[--rollback-failed-instances-on-policy-breach {false, true}]
[--security-type]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
[--target-communication {classic, default, simplified}]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--upgrade-policy-mode {automatic, manual, rolling}]
[--use-rolling-upgrade-policy {false, true}]
[--vm-size]Необязательные параметры
Следует ли включить ускоренную сеть в этом пуле. Ускорение сети обеспечивает виртуализацию одно корневых операций ввода-вывода (SR-IOV) к виртуальной машине, что может привести к повышению производительности сети. Дополнительные сведения см. в статье " https://learn.microsoft.com/azure/virtual- Сетевая/ускоренная сеть- обзор". Задайте значение true, чтобы включить.
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Список лицензий приложений должен быть подмножеством доступных лицензий приложения пакетной службы. Если запрашивается лицензия, которая не поддерживается, создание пула завершится ошибкой. Разделенные пробелами значения.
При создании пула идентификатор приложения пакета должен быть полным (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Изменения ссылок на пакеты влияют на все новые узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагрузятся или переимыслятся. В любом пуле имеется не более 10 ссылок на пакеты. Идентификаторы приложений с разделительным пространством с необязательной версией в формате id[#version].
Формула для требуемого количества вычислительных узлов в пуле. Формула проверка для допустимости перед созданием пула. Если формула недопустима, служба пакетной службы отклоняет запрос с подробными сведениями об ошибке. Дополнительные сведения об указании этой формулы см. в разделе https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.
Для узлов Windows пакетная служба устанавливает сертификаты в указанное хранилище сертификатов и расположение. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширение Azure KeyVault. Отпечаток сертификатов, разделенных пробелами.
Отложить обновление ОС на телевизорах, если они выполняют задачи. Значение True, если флаг присутствует.
Следует ли отключить функцию отката образа ОС. Значение True, если флаг присутствует.
Разделенный пробелом список DiskEncryptionTargets. текущие возможные значения включают OsDisk и TemporaryDisk.
Указывает, следует ли автоматически применять обновления ОС к экземплярам масштабируемого набора в последовательном режиме, когда становится доступной более новая версия образа ОС.
Если для пулов windows задано значение true, windowsConfiguration.enableAutomatic Обновления не может быть задано значение true. Значение True, если флаг присутствует.
Разрешить VMSS игнорировать границы AZ при создании пакетов обновления. Учитывайте домен обновления и maxBatchInstancePercent, чтобы определить размер пакета. Это поле может иметь значение true или false только при использовании NodePlacementConfiguration в качестве зонального. Значение True, если флаг присутствует.
Разрешает ли пул прямой обмен данными между вычислительными узлами. Включение обмена данными между узлами ограничивает максимальный размер пула из-за ограничений развертывания на вычислительных узлах пула. Это может привести к тому, что пул не достигает требуемого размера. По умолчанию используется значение false. Значение True, если флаг присутствует.
Включите безопасную загрузку.
Включите vTPM.
Укажите, следует ли включить или отключить записьAccelerator на диске.
Это свойство можно использовать пользователем в запросе, чтобы включить или отключить шифрование узла для виртуальной машины или масштабируемого набора виртуальных машин. Это позволит включить шифрование для всех дисков, включая диск Resource/Temp на самом узле. Поведение по умолчанию: шифрование на узле будет отключено, если для ресурса не задано значение true.
Обязательный. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов. Идентификатор сохраняет регистр и не учитывает регистр (т. е. у вас могут не быть двух идентификаторов пула в учетной записи, которые отличаются только по регистру).
Справочник по образам ОС. Это может быть формат publisher:offer:sku[:version], или полный идентификатор образа ARM формы "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Если формат publisher:offer:sku[:version], версия необязательна, и если не указано последнее значение, будет использоваться. Допустимые значения можно получить с помощью az batch pool supported-images list. Например: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest.
Файл, содержащий пул, создает спецификацию параметров свойств в ФОРМАТЕ JSON(отформатировано в соответствии с текстом запроса REST API). Если этот параметр указан, все аргументы параметров создания свойств пула игнорируются. См. раздел https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
Максимальный процент общих экземпляров виртуальных машин, которые будут обновляться одновременно путем последовательного обновления в одном пакете. Так как это максимальный, неработоспособные экземпляры в предыдущих или будущих пакетах могут привести к снижению процента экземпляров в пакете, чтобы обеспечить более высокую надежность. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent.
Максимальный процент общих экземпляров виртуальных машин в масштабируемом наборе, который может быть одновременно неработоспособным либо в результате обновления, либо путем обнаружения в неработоспособном состоянии работоспособности виртуальных машин проверка до прерывания обновления. Это ограничение будет проверка перед запуском любого пакета. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent.
Максимальный процент обновленных экземпляров виртуальных машин, которые можно найти в неработоспособном состоянии. Это проверка произойдет после обновления каждого пакета. Если этот процент когда-либо превышается, последовательное обновление прерывается. Значение этого поля должно быть от 0 до 100 включительно.
Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода. Разделенные пробелами значения в формате key=value.
Обязательный. Агент пакетного вычислительного узла — это программа, которая выполняется на каждом вычислительном узле в пуле, а также предоставляет интерфейс управления между вычислительным узлом и пакетной службой. Существуют различные реализации агента вычислительного узла, известного как номера SKU для разных операционных систем. Необходимо указать номер SKU агента вычислительного узла, соответствующий выбранной ссылке на изображение. Чтобы получить список поддерживаемых номеров SKU агента вычислительных узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых номеров SKU агента вычислительных узлов".
Укажите требования к кэшированию. Возможные значения: None, ReadOnly, ReadWrite. Значения по умолчанию: нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium.
Начальный размер диска в ГБ при создании нового диска ОС.
Обязательный. Возможные значения: 2 — семейство ОС 2, эквивалентное Windows Server 2008 R2 с пакетом обновления 1 (SP1). 3 — семейство ОС 3, эквивалентное Windows Server 2012. 4 — семейство ОС 4, эквивалентное Windows Server 2012 R2. 5 — семейство ОС 5, эквивалентное Windows Server 2016. 6 — семейство ОС 6, эквивалентное Windows Server 2019. Дополнительные сведения см. в статьях о выпусках гостевой ОС Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).
Значение по умолчанию — *, указывающее последнюю версию операционной системы для указанного семейства ОС.
Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601. Ожидаемый формат — это длительность ISO-8601.
Указывает временное размещение дисков для диска операционной системы для всех виртуальных машин в пуле. Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение, например место на диске кэша для подготовки диска Эфемеральной ОС. Дополнительные сведения о требованиях к размеру диска в эфемерной ОС см. в соответствии с требованиями к размеру диска Эфемерной ОС для виртуальных машин Windows на https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements виртуальных машинах Windows и виртуальных машинах https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirementsLinux.
Тип политики размещения узлов в пулах пакетной службы. Политика выделения, используемая пакетной службой для подготовки узлов. Если оно не указано, пакетная служба будет использовать региональную политику.
Обновите все неработоспособные экземпляры в масштабируемом наборе до всех здоровых экземпляров. Значение True, если флаг присутствует.
Это время ожидания применяется только к масштабированию вручную; Он не действует, если параметр enableAutoScale имеет значение true. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, пакетная служба возвращает ошибку; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос). Ожидаемый формат — это длительность ISO-8601.
Пользователь может указать теги ресурсов для пула. Затем любой ресурс, созданный для пула, также будет помечен теми же тегами ресурсов.
Откат неудачных экземпляров до предыдущей модели, если политика последовательного обновления нарушена. Значение True, если флаг присутствует.
Укажите Тип безопасности виртуальной машины. Для включения Uefi Параметры необходимо задать любое указанное значение. Поведение по умолчанию: Uefi Параметры не будет включен, если это свойство не задано.
Обязательный. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Если командная строка ссылается на пути к файлам, она должна использовать относительный путь (относительно рабочего каталога задачи) или использовать переменную предоставленной среды пакетной службы (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Ссылки на ресурсы, разделенные пробелами, в формате filename=httpurl.
Следует ли пакетной службе ждать успешного завершения startTask (т. е. выйти с кодом выхода 0) перед планированием любых задач на вычислительном узле. Если значение true и startTask завершается сбоем на узле, пакетная служба повторяет запускTask до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает узел неиспользуемой и не будет планировать задачи. Это условие можно обнаружить с помощью сведений о состоянии вычислительного узла и сведения о сбоях. Если значение false, служба пакетной службы не будет ожидать завершения запускаTask. В этом случае другие задачи могут запускаться на вычислительном узле во время запуска StartTask; и даже если сбой StartTask, новые задачи будут продолжать планироваться на вычислительном узле. Значение по умолчанию: true. Значение True, если флаг присутствует.
Тип учетной записи хранения для управляемого диска.
Требуемый режим связи узла для пула. Если этот элемент присутствует, он заменяет существующий targetNodeCommunicationMode, настроенный в пуле. Если не указано, все существующие метаданные остаются неизменными.
Требуемое количество выделенных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.
Требуемое количество точечных и низкоприоритетных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.
Если опущено, диски на вычислительных узлах в пуле не будут зашифрованы. В пуле Linux поддерживается только временныйdisk; В пуле Windows необходимо указать "OsDisk" и "TemporaryDisk". Зашифрованные целевые диски с разделителями пространства. Значения могут быть osDisk или TemporaryDisk.
Количество слотов задач, которые могут использоваться для выполнения параллельных задач на одном вычислительном узле в пуле. Значение по умолчанию равно 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256.
Режим обновления ОС пула.
Указывает, следует ли использовать политику последовательного обновления во время автоматического обновления ОС. Автоматическое обновление ОС откатится к политике по умолчанию, если политика не определена в VMSS. Значение True, если флаг присутствует.
Обязательный. Сведения о доступных размерах виртуальных машин для пулов Облачные службы (пулы, созданные с помощью cloudServiceConfiguration), см. в разделе "Размеры" для Облачные службы (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Пакетная служба поддерживает все размеры Облачные службы виртуальных машин, кроме ExtraSmall, A1V2 и A2V2. Сведения о доступных размерах виртуальных машин для пулов с помощью образов из Виртуальные машины Marketplace (пулы, созданные с помощью virtualMachineConfiguration), см. в разделе "Размеры" для Виртуальные машины (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) или "Размеры" для Виртуальные машины (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Пакетная служба поддерживает все размеры виртуальных машин Azure, кроме STANDARD_A0 и хранилища класса Premium (STANDARD_GS, STANDARD_DS и серии STANDARD_DSV2).
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool create (azure-batch-cli-extensions Расширение)
Создайте пул пакетной службы в учетной записи. При создании пула выберите аргументы из Облачные службы конфигурации или конфигурации виртуальной машины.
az batch pool create [--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--disk-encryption-targets]
[--enable-inter-node-communication]
[--id]
[--image]
[--json-file]
[--metadata]
[--node-agent-sku-id]
[--os-family]
[--os-version]
[--parameters]
[--policy]
[--resize-timeout]
[--resource-group]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--template]
[--vm-size]Необязательные параметры
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Список лицензий приложений должен быть подмножеством доступных лицензий приложения пакетной службы. Если запрашивается лицензия, которая не поддерживается, создание пула завершится ошибкой.
При создании пула идентификатор приложения пакета должен быть полным (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Изменения ссылок на пакеты влияют на все новые узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагрузятся или переимыслятся. В любом пуле имеется не более 10 ссылок на пакеты.
Это свойство не должно быть указано, если параметр enableAutoScale имеет значение false. Требуется, если параметр enableAutoScale имеет значение true. Формула проверка для допустимости перед созданием пула. Если формула недопустима, служба пакетной службы отклоняет запрос с подробными сведениями об ошибке. Дополнительные сведения об указании этой формулы см. в разделе "Автоматическое масштабирование вычислительных узлов в пуле пакетная служба Azure" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Для узлов Windows пакетная служба устанавливает сертификаты в указанное хранилище сертификатов и расположение. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширение Azure KeyVault.
Список дисковых объектов DiskEncryptionTargets с разделителями пространства. текущие возможные значения включают OsDisk и TemporaryDisk.
Разрешает ли пул прямой обмен данными между вычислительными узлами. Включение обмена данными между узлами ограничивает максимальный размер пула из-за ограничений развертывания на вычислительных узлах пула. Это может привести к тому, что пул не достигает требуемого размера. По умолчанию используется значение false.
Обязательный. Идентификатор может содержать любое сочетание буквенно-цифровых символов, включая дефисы и символы подчеркивания, и не может содержать более 64 символов. Идентификатор сохраняет регистр и не учитывает регистр (т. е. у вас могут не быть двух идентификаторов пула в учетной записи, которые отличаются только по регистру).
Справочник по образам ОС. Это может быть формат publisher:offer:sku[:version], или полный идентификатор образа ARM формы "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}". Если формат publisher:offer:sku[:version], версия необязательна, и если не указано последнее значение, будет использоваться. Допустимые значения можно получить с помощью az batch pool node-agent-skus list. Например: MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest.
Файл, содержащий пул для создания в формате JSON, если этот параметр указан, все остальные параметры игнорируются.
Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода.
Номер SKU агента пакетного узла, который необходимо подготовить на вычислительных узлах в пуле. Агент узла пакетной службы — это программа, которая выполняется на каждом узле в пуле и предоставляет интерфейс управления между узлом и пакетной службой. Существуют различные реализации агента узла, известные как номера SKU, для различных операционных систем. Необходимо указать номер SKU агента узла, соответствующий выбранной ссылке на изображение. Чтобы получить список поддерживаемых номеров SKU агента узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых SKU агента узлов".
Семейство гостевой ОС Azure для установки на виртуальных машинах в пуле. Возможные значения: 2 — семейство ОС 2, эквивалентное Windows Server 2008 R2 с пакетом обновления 1 (SP1). 3 — семейство ОС 3, эквивалентное Windows Server 2012. 4 — семейство ОС 4, эквивалентное Windows Server 2012 R2. 5 — семейство ОС 5, эквивалентное Windows Server 2016. Дополнительные сведения см. в статьях о выпусках гостевой ОС Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Допустимые значения: 2, 3, 4, 5.
Значение по умолчанию — *, указывающее последнюю версию операционной системы для указанного семейства ОС.
Значения параметров для файла шаблона JSON пула пакетной службы. Можно использовать только с --template.
Тип политики размещения узлов в пулах пакетной службы. Политика выделения, используемая пакетной службой для подготовки узлов. Если оно не указано, пакетная служба будет использовать региональную политику. Допустимые значения: региональные, зональные.
Это время ожидания применяется только к масштабированию вручную; Он не действует, если параметр enableAutoScale имеет значение true. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, пакетная служба возвращает ошибку; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).
Группа ресурсов учетной записи пакетной службы.
Командная строка задачи запуска. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux.
Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Ссылки на разделенные пробелами ресурсы в формате filename=httpurl.
Следует ли пакетной службе ждать успешного завершения задачи запуска (т. е. выхода с кодом выхода 0) перед планированием любых задач на вычислительном узле. Если значение true и задача запуска завершается сбоем на вычислительном узле, пакетная служба повторяет задачу запуска до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает вычислительный узел неиспользуемым и не запланирует задачи. Это условие можно обнаружить с помощью состояния узла и подробных сведений об ошибке планирования. Если значение false, служба пакетной службы не ожидает завершения начальной задачи. В этом случае другие задачи могут запускаться на вычислительном узле, пока задача запуска по-прежнему выполняется; и даже если задача запуска завершается сбоем, новые задачи будут продолжать планироваться на узле. Значение по умолчанию — false. Значение True, если флаг присутствует.
Требуемое количество выделенных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.
Требуемое количество точечных и низкоприоритетных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.
Если опущено, диски на вычислительных узлах в пуле не будут зашифрованы. В пуле Linux поддерживается только временныйdisk; В пуле Windows необходимо указать "OsDisk" и "TemporaryDisk". Зашифрованные целевые диски с разделителями пространства. Значения могут быть osDisk или TemporaryDisk.
Количество слотов задач, которые могут использоваться для выполнения параллельных задач на одном вычислительном узле в пуле. Значение по умолчанию равно 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256.
Файл шаблона JSON пула пакетной службы. Если этот параметр указан, все остальные параметры игнорируются.
Обязательный. Сведения о доступных размерах виртуальных машин для пулов Облачные службы (пулы, созданные с помощью cloudServiceConfiguration), см. в разделе "Размеры" для Облачные службы (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Пакетная служба поддерживает все размеры Облачные службы виртуальных машин, кроме ExtraSmall, A1V2 и A2V2. Сведения о доступных размерах виртуальных машин для пулов с помощью образов из Виртуальные машины Marketplace (пулы, созданные с помощью virtualMachineConfiguration), см. в разделе "Размеры" для Виртуальные машины (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) или "Размеры" для Виртуальные машины (Windows).https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/ Пакетная служба поддерживает все размеры виртуальных машин Azure, кроме STANDARD_A0 и хранилища класса Premium (STANDARD_GS, STANDARD_DS и серии STANDARD_DSV2).
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool delete
Удаляет пул из указанной учетной записи.
При запросе удаления пула выполняются следующие действия: состояние пула устанавливается для удаления; остановка любой текущей операции изменения размера в пуле; Пакетная служба начинает изменять размер пула до нуля вычислительных узлов; все задачи, выполняемые на существующих вычислительных узлах, завершаются и повторно запрашиваются (как если бы операция изменения размера пула была запрошена с параметром повторного запроса по умолчанию); Наконец, пул удаляется из системы. Так как выполнение задач повторно перезапущено, пользователь может повторно запустить эти задачи, обновив задание для назначения другого пула. Затем задачи могут выполняться в новом пуле. Если вы хотите переопределить поведение повторного запроса, необходимо явно вызвать изменение размера пула, чтобы уменьшить размер пула до нуля перед удалением пула. При вызове API обновления, исправления или удаления в пуле в состоянии удаления произойдет сбой с кодом состояния HTTP 409 с кодом ошибки PoolBeingDeleted.
az batch pool delete --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Обязательные параметры
Идентификатор удаленного пула.
Необязательные параметры
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс службы был изменен с указанного времени.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс в службе не был изменен с указанного времени.
Не запрашивать подтверждение.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool list
Выводит список всех пулов в указанной учетной записи.
az batch pool list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Необязательные параметры
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Предложение OData $expand.
Предложение OData $filter. Дополнительные сведения о создании этого фильтра см. в разделе https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.
Предложение OData $select.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool reset
Обновите свойства пула пакетной службы. Неопределенные свойства, которые можно обновить, сбрасываются по умолчанию.
az batch pool reset --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-wait-for-success]Обязательные параметры
Идентификатор пула для обновления.
Необязательные параметры
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Обязательный. Список заменяет все существующие ссылки на пакет приложений в пуле. Изменения ссылок на пакет приложений влияют на все новые вычислительные узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагружаются или переимываются. В любом пуле имеется не более 10 ссылок на пакет приложения. Если опущен или указана пустая коллекция, все существующие ссылки на пакеты приложений удаляются из пула. В данном пуле может быть указано не более 10 ссылок.
Обязательный. Этот список заменяет все существующие ссылки на сертификаты, настроенные в пуле. Если указать пустую коллекцию, все существующие ссылки на сертификаты удаляются из пула. Для узлов Windows пакетная служба устанавливает сертификаты в указанное хранилище сертификатов и расположение. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширение Azure KeyVault.
Файл, содержащий спецификацию параметра свойства обновления пула в формате JSON(отформатированный в соответствии с текстом запроса REST API). Если этот параметр указан, все аргументы параметра обновления пула игнорируются.
Обязательный. Этот список заменяет все существующие метаданные, настроенные в пуле. Если опущен или указана пустая коллекция, все существующие метаданные удаляются из пула.
Командная строка задачи запуска. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux.
Список параметров переменной среды для начальной задачи. Разделенные пробелами значения в формате key=value.
Максимальное количество повторных попыток для задачи.
Следует ли пакетной службе ждать успешного завершения задачи запуска (т. е. выхода с кодом выхода 0) перед планированием любых задач на вычислительном узле. Значение True, если флаг присутствует, в противном случае используется значение False.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool resize
Изменение размера или остановка изменения размера пула пакетной службы.
az batch pool resize --pool-id
[--abort]
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
[--resize-timeout]
[--target-dedicated-nodes]
[--target-low-priority-nodes]Обязательные параметры
Идентификатор пула.
Необязательные параметры
Остановите операцию изменения размера пула.
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Операция будет выполнена только в том случае, если текущий ETag ресурса точно соответствует указанному значению.
Операция будет выполнена только в том случае, если ресурс был изменен с указанной метки времени.
Операция не будет выполнена, только если текущий ETag ресурса точно соответствует указанному значению.
Операция не будет выполнена только в том случае, если ресурс был изменен с указанной метки времени.
При удалении узлов из пула, если размер пула уменьшается.
Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, пакетная служба возвращает ошибку; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).
Требуемое количество выделенных вычислительных узлов в пуле.
Требуемое количество точечных и низкоприоритетных вычислительных узлов в пуле.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool set
Обновите свойства пула пакетной службы. Обновление свойства в подгруппе приведет к сбросу неопределенных свойств этой группы.
az batch pool set --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Обязательные параметры
Идентификатор пула для обновления.
Необязательные параметры
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Изменения ссылок на пакеты влияют на все новые узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагрузятся или переимыслятся. Если этот элемент присутствует, он заменяет все существующие ссылки на пакет. Если указать пустую коллекцию, все ссылки на пакеты удаляются из пула. Если опущено, все существующие ссылки на пакеты остаются неизменными. Идентификаторы приложений с разделительным пространством с необязательной версией в формате id[#version].
Если этот элемент присутствует, он заменяет все существующие ссылки на сертификаты, настроенные в пуле. Если не указано, все существующие ссылки на сертификаты остаются неизменными. Для узлов Windows пакетная служба устанавливает сертификаты в указанное хранилище сертификатов и расположение. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширение Azure KeyVault. Отпечаток сертификатов, разделенных пробелами.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс службы был изменен с указанного времени.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс в службе не был изменен с указанного времени.
Файл, содержащий спецификацию параметра исправления пула в ФОРМАТЕ JSON (отформатированный в соответствии с соответствующим текстом REST API). Если этот параметр указан, все аргументы пула игнорируются.
Если этот элемент присутствует, он заменяет все существующие метаданные, настроенные в пуле. Если указать пустую коллекцию, все метаданные удаляются из пула. Если не указано, все существующие метаданные остаются неизменными. Разделенные пробелами значения в формате key=value.
Обязательный. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Если командная строка ссылается на пути к файлам, она должна использовать относительный путь (относительно рабочего каталога задачи) или использовать переменную предоставленной среды пакетной службы (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Разделенные пробелами значения в формате key=value.
Максимальное количество повторных попыток задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение определяет количество повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакет пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения, однако это не рекомендуется для начальной задачи или любой задачи. Значение по умолчанию — 0 (без повторных попыток).
Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Ссылки на ресурсы, разделенные пробелами, в формате filename=httpurl.
Следует ли пакетной службе ждать успешного завершения startTask (т. е. выйти с кодом выхода 0) перед планированием любых задач на вычислительном узле. Если значение true и startTask завершается сбоем на узле, пакетная служба повторяет запускTask до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает узел неиспользуемой и не будет планировать задачи. Это условие можно обнаружить с помощью сведений о состоянии вычислительного узла и сведения о сбоях. Если значение false, служба пакетной службы не будет ожидать завершения запускаTask. В этом случае другие задачи могут запускаться на вычислительном узле во время запуска StartTask; и даже если сбой StartTask, новые задачи будут продолжать планироваться на вычислительном узле. Значение по умолчанию: true. Укажите значение true или false, чтобы обновить свойство.
Требуемый режим связи узла для пула. Если этот элемент присутствует, он заменяет существующий targetNodeCommunicationMode, настроенный в пуле. Если не указано, все существующие метаданные остаются неизменными.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
az batch pool show
Возвращает сведения о указанном пуле.
az batch pool show --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]Обязательные параметры
Идентификатор пула, который требуется получить.
Необязательные параметры
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Предложение OData $expand.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс службы был изменен с указанного времени.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс в службе не был изменен с указанного времени.
Предложение OData $select.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
Отображение этого справочного сообщения и выход.
Показывать только ошибки, блокируя предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
