az batch pool
Управление пулами пакетной службы.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
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 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-package-references]
[--auto-scale-formula]
[--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]
[--pause-time-between-batches]
[--placement]
[--policy]
[--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-environment-settings]
[--start-task-max-task-retry-count]
[--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]
[--use-rolling-upgrade-policy {false, true}]
[--vm-size]
Необязательные параметры
Следует ли включить ускоренную сеть в этом пуле. Ускорение сети обеспечивает виртуализацию одно корневых операций ввода-вывода (SR-IOV) к виртуальной машине, что может привести к повышению производительности сети. Дополнительные сведения см. в статье https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview. Задайте значение true, чтобы включить.
Конечная точка пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ENDPOINT.
Ключ учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCESS_KEY.
Имя учетной записи пакетной службы. Кроме того, задайте переменную среды: AZURE_BATCH_ACCOUNT.
Список пакетов, установленных на каждом вычислительном узле в пуле. При создании пула идентификатор приложения пакета должен быть полным (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). # pylint: disable=line-long Changes to Package references влияет на все новые узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагрузятся или переименовываются. В любом пуле имеется не более 10 ссылок на пакеты. Идентификаторы приложений с разделительным пространством с необязательной версией в формате id[#version].
Формула для требуемого количества вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение false. Требуется, если параметр enableAutoScale имеет значение true. Формула проверяется на допустимость перед созданием пула. Если формула недопустима, служба пакетной службы отклоняет запрос с подробными сведениями об ошибке. Дополнительные сведения об указании этой формулы см. в статье "Автоматическое масштабирование вычислительных узлов в пуле пакетной службы Azure" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Отложить обновление ОС на телевизорах, если они выполняют задачи. Значение True, если флаг присутствует.
Следует ли отключить функцию отката образа ОС. Значение True, если флаг присутствует.
Разделенный пробелом список DiskEncryptionTargets. текущие возможные значения включают OsDisk и TemporaryDisk.
Указывает, следует ли автоматически применять обновления ОС к экземплярам масштабируемого набора в последовательном режиме, когда становится доступной более новая версия образа ОС. :code:<br />
:code:<br />
Если задано значение true для пулов Windows, WindowsConfiguration.enableAutomaticUpdates <https://learn.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#windowsconfiguration>
_ нельзя задать значение 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://learn.microsoft.com/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 агента вычислительных узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых номеров SKU агента вычислительных узлов". Обязательно.
Укажите требования к кэшированию. Возможные значения: None, ReadOnly, ReadWrite. Значения по умолчанию: нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium.
Начальный размер диска в ГБ при создании нового диска ОС.
Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601.. Ожидаемый формат — это длительность ISO-8601.
Указывает временное размещение дисков для диска операционной системы для всех виртуальных машин в пуле. Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение, например место на диске кэша для подготовки диска Эфемеральной ОС. Дополнительные сведения о требованиях к размеру диска в эфемерной ОС см. в соответствии с требованиями к размеру диска операционной системы в https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements и виртуальных машинах Linux на https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. "cachedisk".
Тип политики размещения узлов в пулах пакетной службы. Политика выделения, используемая пакетной службой для подготовки узлов. Если оно не указано, пакетная служба будет использовать региональную политику. Известные значения: "региональные" и "зональные".
Обновите все неработоспособные экземпляры в масштабируемом наборе до всех здоровых экземпляров. Значение True, если флаг присутствует.
Время ожидания выделения вычислительных узлов в пул. Это время ожидания применяется только к масштабированию вручную; Он не действует, если параметр enableAutoScale имеет значение true. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, пакетная служба возвращает ошибку; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос). Ожидаемый формат — это длительность ISO-8601.
Пользователь может указать теги ресурсов для пула. Затем любой ресурс, созданный для пула, также будет помечен теми же тегами ресурсов.
Откат неудачных экземпляров до предыдущей модели, если политика последовательного обновления нарушена. Значение True, если флаг присутствует.
Укажите Тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение. Поведение по умолчанию: UefiSettings не будет включен, если это свойство не задано.
Командная строка StartTask. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Если командная строка ссылается на пути к файлам, она должна использовать относительный путь (относительно рабочего каталога задачи) или использовать указанную пакетную переменную среды (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Обязательно.
Список параметров переменной среды для StartTask. Разделенные пробелами значения в формате key=value.
Максимальное количество повторных попыток задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакет пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения, однако это не рекомендуется для начальной задачи или любой задачи. Значение по умолчанию равно 0 (без повторных попыток).
Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Существует максимальный размер списка файлов ресурсов. При превышении максимального размера запрос завершится ошибкой, и код ошибки ответа будет RequestEntityTooLarge. В этом случае коллекция ResourceFiles должна быть уменьшена. Это можно сделать с помощью .zip файлов, пакетов приложений или контейнеров Docker. Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Ссылки на ресурсы, разделенные пробелами, в формате 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, если флаг присутствует.
Размер виртуальных машин в пуле. Все виртуальные машины в пуле имеют одинаковый размер. Сведения о доступных размерах виртуальных машин для пулов с помощью образов из 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://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
Предложение 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]
[--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.
Обязательно. Список заменяет все существующие ссылки на пакет приложений в пуле. Изменения ссылок на пакет приложений влияют на все новые вычислительные узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагружаются или переимываются. В любом пуле имеется не более 10 ссылок на пакет приложения. Если опущен или указана пустая коллекция, все существующие ссылки на пакеты приложений удаляются из пула. В данном пуле может быть указано не более 10 ссылок.
Файл, содержащий спецификацию параметра свойства обновления пула в формате JSON(отформатированный в соответствии с текстом запроса REST API). Если этот параметр указан, все аргументы параметра обновления пула игнорируются.
Обязательно. Этот список заменяет существующие метаданные, настроенные в пуле. Если опущен или указана коллекция anempty, все существующие метаданные удаляются изPool.
Командная строка задачи запуска. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux.
Список параметров переменной среды для начальной задачи. Разделенные пробелами значения в формате key=value.
Максимальное количество попыток выполнения задачи.
Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Ссылки на ресурсы, разделенные пробелами, в формате filename=httpurl.
Следует ли пакетной службе ждать успешного завершения задачи запуска (т. е. выхода с кодом выхода 0) перед планированием любых задач на вычислительном узле. Значение True, если флаг присутствует, в противном случае используется значение False.
Требуемый режим связи узла для пула. Если этот элемент присутствует, он заменяет существующий targetNodeCommunicationMode, настроенный в пуле. Если не указано, все существующие метаданные остаются неизменными.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса 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 (недопустимый запрос). Формат длительности ISO-8601.
Требуемое количество выделенных вычислительных узлов в пуле.
Требуемое количество точечных и низкоприоритетных вычислительных узлов в пуле.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса 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]
[--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].
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе точно соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс службы был изменен с указанного времени.
Значение ETag, связанное с версией ресурса, известного клиенту. Операция будет выполнена только в том случае, если текущий ETag ресурса в службе не соответствует значению, указанному клиентом.
Метка времени, указывающая время последнего изменения ресурса, известного клиенту. Операция будет выполнена только в том случае, если ресурс службы был изменен с указанного времени.
Файл, содержащий спецификацию пула в ФОРМАТЕ JSON (отформатированный в соответствии с соответствующим текстом REST API). Если этот параметр указан, все аргументы пула игнорируются.
Список пар "имя-значение", связанных с пулом в качестве метаданных. Если этот элемент присутствует, он заменяет все существующие метаданные, настроенные в пуле. Если указать пустую коллекцию, все метаданные удаляются из пула. Если не указано, все существующие метаданные остаются неизменными. Разделенные пробелами значения в формате key=value.
Командная строка StartTask. Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Если командная строка ссылается на пути к файлам, она должна использовать относительный путь (относительно рабочего каталога задачи) или использовать указанную пакетную переменную среды (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Обязательно.
Список параметров переменной среды для StartTask. Разделенные пробелами значения в формате key=value.
Максимальное количество повторных попыток задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакет пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения, однако это не рекомендуется для начальной задачи или любой задачи. Значение по умолчанию равно 0 (без повторных попыток).
Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Существует максимальный размер списка файлов ресурсов. При превышении максимального размера запрос завершится ошибкой, и код ошибки ответа будет RequestEntityTooLarge. В этом случае коллекция ResourceFiles должна быть уменьшена. Это можно сделать с помощью .zip файлов, пакетов приложений или контейнеров Docker. Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи. Ссылки на ресурсы, разделенные пробелами, в формате filename=httpurl.
Следует ли пакетной службе ждать успешного завершения startTask (т. е. выйти с кодом выхода 0) перед планированием любых задач на вычислительном узле. Если значение true и startTask завершается сбоем на узле, пакетная служба повторяет запускTask до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает узел неиспользуемой и не будет планировать задачи. Это условие можно обнаружить с помощью сведений о состоянии вычислительного узла и сведения о сбоях. Если значение false, служба пакетной службы не будет ожидать завершения запускаTask. В этом случае другие задачи могут запускаться на вычислительном узле во время запуска StartTask; и даже если сбой StartTask, новые задачи будут продолжать планироваться на вычислительном узле. Значение по умолчанию — true. Значение True, если флаг присутствует.
Требуемый режим связи узла для пула. Если этот элемент присутствует, он заменяет существующий 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 для полных журналов отладки.