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


BatchPoolSpecification interface

Спецификация создания нового пула.

Свойства

applicationPackageReferences

Список пакетов, установленных на каждом вычислительном узле в пуле. При создании пула идентификатор приложения пакета должен быть полным (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Изменения ссылок на пакеты влияют на все новые узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагрузятся или переимыслятся. В любом пуле имеется не более 10 ссылок на пакеты.

autoScaleEvaluationInterval

Интервал времени, с помощью которого автоматически настраивается размер пула в соответствии с формулой автомасштабирования. Значение по умолчанию — 15 минут. Минимальное и максимальное значение — 5 минут и 168 часов соответственно. Если указать значение менее 5 минут или больше 168 часов, служба пакетной службы отклоняет запрос с ошибкой недопустимого значения свойства; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).

autoScaleFormula

Формула для требуемого количества вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение false. Требуется, если параметр enableAutoScale имеет значение true. Формула проверяется на допустимость перед созданием пула. Если формула недопустима, служба пакетной службы отклоняет запрос с подробными сведениями об ошибке.

displayName

Отображаемое имя пула. Отображаемое имя не должно быть уникальным и может содержать любые символы Юникода до максимальной длины 1024.

enableAutoScale

Следует ли автоматически настраивать размер пула с течением времени. Если значение false, необходимо указать по крайней мере один из targetDedicatedNodes и targetLowPriorityNodes. Если значение true, требуется элемент autoScaleFormula. Пул автоматически изменяет размер в соответствии с формулой. Значение по умолчанию — false.

enableInterNodeCommunication

Разрешает ли пул прямой обмен данными между вычислительными узлами. Включение обмена данными между узлами ограничивает максимальный размер пула из-за ограничений развертывания на вычислительных узлах пула. Это может привести к тому, что пул не достигает требуемого размера. Значение по умолчанию — false.

metadata

Список пар "имя-значение", связанных с пулом в качестве метаданных. Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода.

mountConfiguration

Список файловых систем для подключения на каждом узле в пуле. Это поддерживает файлы Azure, NFS, CIFS/SMB и Blobfuse.

networkConfiguration

Конфигурация сети для пула.

resizeTimeout

Время ожидания выделения вычислительных узлов в пул. Это время ожидания применяется только к масштабированию вручную; Он не действует, если параметр enableAutoScale имеет значение true. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, служба пакетной службы отклоняет запрос с ошибкой; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).

startTask

Задача, выполняемая на каждом вычислительном узле при присоединении к пулу. Задача выполняется при добавлении вычислительного узла в пул или при перезапуске вычислительного узла.

targetDedicatedNodes

Требуемое количество выделенных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.

targetLowPriorityNodes

Требуемое количество точечных и низкоприоритетных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.

taskSchedulingPolicy

Распределение задач между вычислительными узлами в пуле. Если значение не указано, по умолчанию распространяется.

taskSlotsPerNode

Количество слотов задач, которые можно использовать для выполнения параллельных задач на одном вычислительном узле в пуле. Значение по умолчанию — 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256.

upgradePolicy

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

userAccounts

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

virtualMachineConfiguration

Конфигурация виртуальной машины для пула. Это свойство должно быть указано.

vmSize

Размер виртуальных машин в пуле. Все виртуальные машины в пуле имеют одинаковый размер. Сведения о доступных размерах виртуальных машин в пулах см. в разделе "Выбор размера виртуальной машины для вычислительных узлов" в пуле пакетной службы Azure (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

Сведения о свойстве

applicationPackageReferences

Список пакетов, установленных на каждом вычислительном узле в пуле. При создании пула идентификатор приложения пакета должен быть полным (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Изменения ссылок на пакеты влияют на все новые узлы, присоединенные к пулу, но не влияют на вычислительные узлы, которые уже находятся в пуле, пока они не перезагрузятся или переимыслятся. В любом пуле имеется не более 10 ссылок на пакеты.

applicationPackageReferences?: BatchApplicationPackageReference[]

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

autoScaleEvaluationInterval

Интервал времени, с помощью которого автоматически настраивается размер пула в соответствии с формулой автомасштабирования. Значение по умолчанию — 15 минут. Минимальное и максимальное значение — 5 минут и 168 часов соответственно. Если указать значение менее 5 минут или больше 168 часов, служба пакетной службы отклоняет запрос с ошибкой недопустимого значения свойства; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).

autoScaleEvaluationInterval?: string

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

string

autoScaleFormula

Формула для требуемого количества вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение false. Требуется, если параметр enableAutoScale имеет значение true. Формула проверяется на допустимость перед созданием пула. Если формула недопустима, служба пакетной службы отклоняет запрос с подробными сведениями об ошибке.

autoScaleFormula?: string

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

string

displayName

Отображаемое имя пула. Отображаемое имя не должно быть уникальным и может содержать любые символы Юникода до максимальной длины 1024.

displayName?: string

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

string

enableAutoScale

Следует ли автоматически настраивать размер пула с течением времени. Если значение false, необходимо указать по крайней мере один из targetDedicatedNodes и targetLowPriorityNodes. Если значение true, требуется элемент autoScaleFormula. Пул автоматически изменяет размер в соответствии с формулой. Значение по умолчанию — false.

enableAutoScale?: boolean

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

boolean

enableInterNodeCommunication

Разрешает ли пул прямой обмен данными между вычислительными узлами. Включение обмена данными между узлами ограничивает максимальный размер пула из-за ограничений развертывания на вычислительных узлах пула. Это может привести к тому, что пул не достигает требуемого размера. Значение по умолчанию — false.

enableInterNodeCommunication?: boolean

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

boolean

metadata

Список пар "имя-значение", связанных с пулом в качестве метаданных. Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода.

metadata?: BatchMetadataItem[]

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

mountConfiguration

Список файловых систем для подключения на каждом узле в пуле. Это поддерживает файлы Azure, NFS, CIFS/SMB и Blobfuse.

mountConfiguration?: MountConfiguration[]

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

networkConfiguration

Конфигурация сети для пула.

networkConfiguration?: NetworkConfiguration

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

resizeTimeout

Время ожидания выделения вычислительных узлов в пул. Это время ожидания применяется только к масштабированию вручную; Он не действует, если параметр enableAutoScale имеет значение true. Значение по умолчанию — 15 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, служба пакетной службы отклоняет запрос с ошибкой; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос).

resizeTimeout?: string

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

string

startTask

Задача, выполняемая на каждом вычислительном узле при присоединении к пулу. Задача выполняется при добавлении вычислительного узла в пул или при перезапуске вычислительного узла.

startTask?: BatchStartTask

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

targetDedicatedNodes

Требуемое количество выделенных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.

targetDedicatedNodes?: number

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

number

targetLowPriorityNodes

Требуемое количество точечных и низкоприоритетных вычислительных узлов в пуле. Это свойство не должно быть указано, если параметр enableAutoScale имеет значение true. Если параметр enableAutoScale имеет значение false, необходимо задать либо targetDedicatedNodes, targetLowPriorityNodes, либо оба.

targetLowPriorityNodes?: number

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

number

taskSchedulingPolicy

Распределение задач между вычислительными узлами в пуле. Если значение не указано, по умолчанию распространяется.

taskSchedulingPolicy?: BatchTaskSchedulingPolicy

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

taskSlotsPerNode

Количество слотов задач, которые можно использовать для выполнения параллельных задач на одном вычислительном узле в пуле. Значение по умолчанию — 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256.

taskSlotsPerNode?: number

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

number

upgradePolicy

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

upgradePolicy?: UpgradePolicy

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

userAccounts

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

userAccounts?: UserAccount[]

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

virtualMachineConfiguration

Конфигурация виртуальной машины для пула. Это свойство должно быть указано.

virtualMachineConfiguration?: VirtualMachineConfiguration

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

vmSize

Размер виртуальных машин в пуле. Все виртуальные машины в пуле имеют одинаковый размер. Сведения о доступных размерах виртуальных машин в пулах см. в разделе "Выбор размера виртуальной машины для вычислительных узлов" в пуле пакетной службы Azure (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

vmSize: string

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

string