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


Pool - Update Properties

Обновляет свойства указанного пула.
Это полностью заменяет все обновляемые свойства пула. Например, если с пулом связана начальнаяtask, а если с этим запросом не указана начальнаяtask, служба пакетной службы удаляет существующий StartTask.

POST {batchUrl}/pools/{poolId}/updateproperties?api-version=2024-07-01.20.0
POST {batchUrl}/pools/{poolId}/updateproperties?timeout={timeout}&api-version=2024-07-01.20.0

Параметры URI

Имя В Обязательно Тип Описание
batchUrl
path True

string

Базовый URL-адрес для всех запросов пакетной службы Azure.

poolId
path True

string

Идентификатор пула для обновления.

api-version
query True

string

Версия КЛИЕНТСКОго API.

timeout
query

integer

int32

Максимальное время, которое сервер может тратить на обработку запроса в секундах. Значение по умолчанию — 30 секунд. Если значение больше 30, вместо этого будет использоваться значение по умолчанию.

Заголовок запроса

Media Types: "application/json; odata=minimalmetadata"

Имя Обязательно Тип Описание
client-request-id

string

uuid

Удостоверение запроса, созданное вызывающим пользователем, в виде GUID без украшений, таких как фигурные скобки, например 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Должен ли сервер возвращать идентификатор client-request-id в ответе.

ocp-date

string

date-time-rfc1123

Время выдачи запроса. Клиентские библиотеки обычно задают это в текущее время системных часов; задайте его явным образом, если вы вызываете REST API напрямую.

Текст запроса

Media Types: "application/json; odata=minimalmetadata"

Имя Обязательно Тип Описание
applicationPackageReferences True

ApplicationPackageReference[]

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

certificateReferences True

CertificateReference[]

Список сертификатов, которые необходимо установить на каждом вычислительном узле в пуле.
Этот список заменяет все существующие ссылки на сертификаты, настроенные в пуле. Если указать пустую коллекцию, все существующие ссылки на сертификаты удаляются из пула. Для узлов Windows пакетная служба устанавливает сертификаты в указанное хранилище сертификатов и расположение. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог.

Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширения Azure KeyVault .

metadata True

MetadataItem[]

Список пар "имя-значение", связанных с пулом в качестве метаданных.
Этот список заменяет все существующие метаданные, настроенные в пуле. Если опущен или указана пустая коллекция, все существующие метаданные удаляются из пула.

startTask

StartTask

Задача, выполняемая на каждом вычислительном узле при присоединении к пулу. Задача выполняется при добавлении вычислительного узла в пул или при перезапуске вычислительного узла.
Если этот элемент присутствует, он перезаписывает все существующие StartTask. Если опущено, из пула удаляется любой существующий startTask.

targetNodeCommunicationMode

NodeCommunicationMode

Требуемый режим связи узла для пула.
Этот параметр заменяет существующий параметр targetNodeCommunication в пуле. Если опущено, существующий параметр по умолчанию.

Ответы

Имя Тип Описание
204 No Content

Запрос к пакетной службе выполнен успешно.

Заголовки

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Ошибка из пакетной службы.

Безопасность

azure_auth

Поток кода проверки подлинности Microsoft Entra OAuth 2.0

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation Олицетворения учетной записи пользователя

Authorization

Тип: apiKey
В: header

Примеры

Pool update

Образец запроса

POST account.region.batch.azure.com/pools/poolId/updateproperties?api-version=2024-07-01.20.0



{
  "startTask": {
    "commandLine": "/bin/bash -c 'echo start task'"
  },
  "certificateReferences": [],
  "applicationPackageReferences": [],
  "metadata": []
}

Пример ответа

Определения

Имя Описание
ApplicationPackageReference

Ссылка на пакет для развертывания на вычислительных узлах.

AutoUserScope

Область для автоматического пользователя

AutoUserSpecification

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

BatchError

Ответ об ошибке, полученный из пакетной службы Azure.

BatchErrorDetail

Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.

CertificateReference

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

CertificateStoreLocation

Расположение хранилища сертификатов на вычислительном узле, в который необходимо установить сертификат.

CertificateVisibility

Какие учетные записи пользователей на вычислительном узле должны иметь доступ к частным данным сертификата.

ComputeNodeIdentityReference

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

ContainerHostBatchBindMountEntry

Вход пути и режима подключения, который требуется подключить к контейнеру задач.

ContainerHostDataPath

Пути, которые будут подключены к контейнеру задачи контейнера.

ContainerRegistry

Частный реестр контейнеров.

ContainerWorkingDirectory

Расположение рабочего каталога задачи контейнера.

ElevationLevel

Уровень повышения прав пользователя.

EnvironmentSetting

Переменная среды, устанавливаемая в процессе задачи.

ErrorMessage

Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

MetadataItem

Пара "имя-значение", связанная с ресурсом пакетной службы.

NodeCommunicationMode

Определяет, как пул взаимодействует со службой пакетной службы.

PoolUpdatePropertiesParameter

Набор изменений, внесенных в пул.

ResourceFile

Один файл или несколько файлов, которые нужно скачать на вычислительный узел.

StartTask

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

TaskContainerSettings

Параметры контейнера для задачи.

UserIdentity

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

ApplicationPackageReference

Ссылка на пакет для развертывания на вычислительных узлах.

Имя Тип Описание
applicationId

string

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

version

string

Версия приложения для развертывания. Если опущено, будет развернута версия по умолчанию.
Если это опущено в пуле, и для этого приложения версия по умолчанию не указана, запрос завершается ошибкой с кодом error InvalidApplicationPackageReferences и кодом состояния HTTP 409. Если это опущено в задаче, и для этого приложения версия по умолчанию не указана, задача завершается ошибкой предварительной обработки.

AutoUserScope

Область для автоматического пользователя

Имя Тип Описание
pool

string

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

task

string

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

AutoUserSpecification

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

Имя Тип Описание
elevationLevel

ElevationLevel

Уровень повышения прав автоматического пользователя.
Значение по умолчанию — nonAdmin.

scope

AutoUserScope

Область для автоматического пользователя
Значение по умолчанию — пул. Если пул работает под управлением Windows, необходимо указать значение задачи, если требуется более строгая изоляция между задачами. Например, если задача изменяет реестр таким образом, что может повлиять на другие задачи или сертификаты были указаны в пуле, который не должен быть доступен обычными задачами, но должен быть доступен startTasks.

BatchError

Ответ об ошибке, полученный из пакетной службы Azure.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.

message

ErrorMessage

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

values

BatchErrorDetail[]

Коллекция пар "ключ-значение", содержащая дополнительные сведения об ошибке.

BatchErrorDetail

Элемент дополнительных сведений, включенных в ответ на ошибку пакетной службы Azure.

Имя Тип Описание
key

string

Идентификатор, указывающий значение свойства Value.

value

string

Дополнительные сведения, включенные в ответ на ошибку.

CertificateReference

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

Имя Тип Описание
storeLocation

CertificateStoreLocation

Расположение хранилища сертификатов на вычислительном узле, в который необходимо установить сертификат.
Значение по умолчанию — currentuser. Это свойство применимо только для пулов, настроенных с помощью вычислительных узлов Windows. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог.

storeName

string

Имя хранилища сертификатов на вычислительном узле, в который необходимо установить сертификат.
Это свойство применимо только для пулов, настроенных с помощью вычислительных узлов Windows. Распространенные имена хранилищ: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, но любое пользовательское имя хранилища также можно использовать. Значением по умолчанию является My.

thumbprint

string

Отпечаток сертификата.

thumbprintAlgorithm

string

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

visibility

CertificateVisibility[]

Какие учетные записи пользователей на вычислительном узле должны иметь доступ к частным данным сертификата.
В этой коллекции можно указать несколько видимостей. По умолчанию используется все учетные записи.

CertificateStoreLocation

Расположение хранилища сертификатов на вычислительном узле, в который необходимо установить сертификат.

Имя Тип Описание
currentuser

string

Сертификаты должны быть установлены в хранилище сертификатов CurrentUser.

localmachine

string

Сертификаты должны быть установлены в хранилище сертификатов LocalMachine.

CertificateVisibility

Какие учетные записи пользователей на вычислительном узле должны иметь доступ к частным данным сертификата.

Имя Тип Описание
remoteuser

string

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

starttask

string

Сертификат должен быть видимым для учетной записи пользователя, в которой выполняется StartTask. Обратите внимание, что если область autoUser является пулом как для startTask, так и для задачи, этот сертификат также будет виден задаче.

task

string

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

ComputeNodeIdentityReference

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

Имя Тип Описание
resourceId

string

Идентификатор ресурса ARM назначенного пользователем удостоверения.

ContainerHostBatchBindMountEntry

Вход пути и режима подключения, который требуется подключить к контейнеру задач.

Имя Тип Описание
isReadOnly

boolean

Подключите этот исходный путь как режим только для чтения или нет. Значение по умолчанию равно false (режим чтения и записи).
Если вы подключаете этот путь как режим чтения и записи, это не означает, что у всех пользователей в контейнере есть доступ на чтение и запись для пути, он зависит от доступа на виртуальной машине узла. Если этот путь подключен только для чтения, все пользователи в контейнере не смогут изменить путь.

source

ContainerHostDataPath

Путь, подключенный к клиенту контейнера, можно выбрать.

ContainerHostDataPath

Пути, которые будут подключены к контейнеру задачи контейнера.

Имя Тип Описание
Applications

string

Путь к приложениям.

JobPrep

string

Путь задачи подготовки задания.

Shared

string

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

Startup

string

Путь к задаче запуска.

Task

string

Путь к задаче.

VfsMounts

string

Путь содержит все виртуальные файловые системы, подключенные на этом узле.

ContainerRegistry

Частный реестр контейнеров.

Имя Тип Описание
identityReference

ComputeNodeIdentityReference

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

password

string

Пароль для входа на сервер реестра.

registryServer

string

URL-адрес реестра.
Если опущено, значение по умолчанию — "docker.io".

username

string

Имя пользователя для входа на сервер реестра.

ContainerWorkingDirectory

Расположение рабочего каталога задачи контейнера.

Имя Тип Описание
containerImageDefault

string

Используйте рабочий каталог, определенный в образе контейнера. Убедитесь, что этот каталог не будет содержать файлы ресурсов, скачанные пакетной службой.

taskWorkingDirectory

string

Используйте стандартный рабочий каталог задачи пакетной службы, который будет содержать файлы ресурсов задач, заполненные пакетной службой.

ElevationLevel

Уровень повышения прав пользователя.

Имя Тип Описание
admin

string

Пользователь является пользователем с повышенными правами доступа и работает с полными разрешениями администратора.

nonadmin

string

Пользователь является стандартным пользователем без повышенного доступа.

EnvironmentSetting

Переменная среды, устанавливаемая в процессе задачи.

Имя Тип Описание
name

string

Имя переменной среды.

value

string

Значение переменной среды.

ErrorMessage

Сообщение об ошибке, полученное в ответе на ошибку пакетной службы Azure.

Имя Тип Описание
lang

string

Языковой код сообщения об ошибке

value

string

Текст сообщения.

MetadataItem

Пара "имя-значение", связанная с ресурсом пакетной службы.

Имя Тип Описание
name

string

Имя элемента метаданных.

value

string

Значение элемента метаданных.

NodeCommunicationMode

Определяет, как пул взаимодействует со службой пакетной службы.

Имя Тип Описание
classic

string

Для узлов, использующих классический режим связи, требуется входящий TCP-обмен данными через порты 29876 и 29877 из пакета BatchNodeManagement. Тег службы {region}" и исходящий TCP-обмен данными через порт 443 в хранилище.регион и BatchNodeManagement. Теги службы {region}".

default

string

Режим связи узла автоматически устанавливается пакетной службой.

simplified

string

Узлы, использующие упрощенный режим связи, требуют исходящего TCP-подключения через порт 443 к пакетной службе BatchNodeManagement. Тег службы {region}". Открытые входящие порты не требуются.

PoolUpdatePropertiesParameter

Набор изменений, внесенных в пул.

Имя Тип Описание
applicationPackageReferences

ApplicationPackageReference[]

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

certificateReferences

CertificateReference[]

Список сертификатов, которые необходимо установить на каждом вычислительном узле в пуле.
Этот список заменяет все существующие ссылки на сертификаты, настроенные в пуле. Если указать пустую коллекцию, все существующие ссылки на сертификаты удаляются из пула. Для узлов Windows пакетная служба устанавливает сертификаты в указанное хранилище сертификатов и расположение. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочей папки задачи, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог.

Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширения Azure KeyVault .

metadata

MetadataItem[]

Список пар "имя-значение", связанных с пулом в качестве метаданных.
Этот список заменяет все существующие метаданные, настроенные в пуле. Если опущен или указана пустая коллекция, все существующие метаданные удаляются из пула.

startTask

StartTask

Задача, выполняемая на каждом вычислительном узле при присоединении к пулу. Задача выполняется при добавлении вычислительного узла в пул или при перезапуске вычислительного узла.
Если этот элемент присутствует, он перезаписывает все существующие StartTask. Если опущено, из пула удаляется любой существующий startTask.

targetNodeCommunicationMode

NodeCommunicationMode

Требуемый режим связи узла для пула.
Этот параметр заменяет существующий параметр targetNodeCommunication в пуле. Если опущено, существующий параметр по умолчанию.

ResourceFile

Один файл или несколько файлов, которые нужно скачать на вычислительный узел.

Имя Тип Описание
autoStorageContainerName

string

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

blobPrefix

string

Префикс большого двоичного объекта, используемый при скачивании BLOB-объектов из контейнера службы хранилища Azure. Будут загружены только большие двоичные объекты, имена которых начинаются с указанного префикса.
Свойство допустимо, только если используется autoStorageContainerName или storageContainerUrl. Этот префикс может быть частичным именем файла или подкаталогом. Если префикс не указан, все файлы в контейнере будут скачаны.

fileMode

string

Атрибут режима разрешений файла в восьмимерном формате.
Это свойство применяется только к файлам, скачанным на вычислительные узлы Linux. Он будет игнорироваться, если он указан для resourceFile, который будет скачан на вычислительный узел Windows. Если это свойство не указано для вычислительного узла Linux, к файлу применяется значение по умолчанию 0770.

filePath

string

Расположение на вычислительном узле, на который следует скачать файлы, относительно рабочего каталога задачи.
Если задано свойство httpUrl, файлPath является обязательным и описывает путь, в который будет скачан файл, включая имя файла. В противном случае, если задано свойство autoStorageContainerName или storageContainerUrl, filePath является необязательным и является каталогом для скачивания файлов. В случае, когда filePath используется в качестве каталога, любая структура каталогов, уже связанная с входными данными, будет сохранена в полном объеме и добавлена в указанный каталог filePath. Указанный относительный путь не может выйти из рабочего каталога задачи (например, с помощью '.').

httpUrl

string

URL-адрес скачиваемого файла.
Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Если URL-адрес указывает на хранилище BLOB-объектов Azure, он должен быть доступен для чтения с вычислительных узлов. Существует три способа получить такой URL-адрес для большого двоичного объекта в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение большого двоичного объекта, использовать управляемое удостоверение с разрешением на чтение или задать ACL для большого двоичного объекта или его контейнера, чтобы разрешить общедоступный доступ.

identityReference

ComputeNodeIdentityReference

Ссылка на назначенное пользователем удостоверение для доступа к хранилищу BLOB-объектов Azure, заданному storageContainerUrl или httpUrl
Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел.

storageContainerUrl

string

URL-адрес контейнера BLOB-объектов в хранилище BLOB-объектов Azure.
Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Этот URL-адрес должен быть доступен для чтения и перечисления из вычислительных узлов. Существует три способа получить такой URL-адрес для контейнера в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение и список для контейнера, использовать управляемое удостоверение с разрешениями на чтение и список или задать ACL для контейнера, чтобы разрешить общедоступный доступ.

StartTask

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

Имя Тип Описание
commandLine

string

Командная строка StartTask.
Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Если командная строка ссылается на пути к файлам, она должна использовать относительный путь (относительно рабочего каталога задачи) или использовать указанную пакетную переменную среды (https://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

containerSettings

TaskContainerSettings

Параметры контейнера, в котором выполняется StartTask.
При указании все каталоги рекурсивно под AZ_BATCH_NODE_ROOT_DIR (корневой каталог пакетной службы Azure на узле) сопоставляются с контейнером, все переменные среды задач сопоставляются с контейнером, а командная строка задачи выполняется в контейнере. Файлы, созданные в контейнере за пределами AZ_BATCH_NODE_ROOT_DIR, могут не отражаться на диске узла, что означает, что API пакетного файла не смогут получить доступ к этим файлам.

environmentSettings

EnvironmentSetting[]

Список параметров переменной среды для StartTask.

maxTaskRetryCount

integer

Максимальное количество повторных попыток задачи.
Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакет пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения, однако это не рекомендуется для начальной задачи или любой задачи. Значение по умолчанию равно 0 (без повторных попыток).

resourceFiles

ResourceFile[]

Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. Существует максимальный размер списка файлов ресурсов. При превышении максимального размера запрос завершится ошибкой, и код ошибки ответа будет RequestEntityTooLarge. В этом случае коллекция ResourceFiles должна быть уменьшена. Это можно сделать с помощью .zip файлов, пакетов приложений или контейнеров Docker.
Файлы, перечисленные в этом элементе, находятся в рабочем каталоге задачи.

userIdentity

UserIdentity

Удостоверение пользователя, под которым запускается StartTask.
Если опущен, задача выполняется как пользователь, отличный от администрирования, уникальным для задачи.

waitForSuccess

boolean

Следует ли пакетной службе ждать успешного завершения startTask (т. е. выйти с кодом выхода 0) перед планированием любых задач на вычислительном узле.
Если значение true и startTask завершается сбоем на узле, пакетная служба повторяет запускTask до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает узел неиспользуемой и не будет планировать задачи. Это условие можно обнаружить с помощью сведений о состоянии вычислительного узла и сведения о сбоях. Если значение false, служба пакетной службы не будет ожидать завершения запускаTask. В этом случае другие задачи могут запускаться на вычислительном узле во время запуска StartTask; и даже если сбой StartTask, новые задачи будут продолжать планироваться на вычислительном узле. Значение по умолчанию — true.

TaskContainerSettings

Параметры контейнера для задачи.

Имя Тип Описание
containerHostBatchBindMounts

ContainerHostBatchBindMountEntry[]

Пути, которые необходимо подключить к задаче контейнера.
Если этот массив имеет значение NULL или отсутствует, задача контейнера будет подключать весь временный диск диска в окнах (или AZ_BATCH_NODE_ROOT_DIR в Linux). Он не будет подключать пути к данным в контейнер, если этот массив задан как пустой.

containerRunOptions

string

Дополнительные параметры команды создания контейнера.
Эти дополнительные параметры предоставляются в качестве аргументов в команду docker create, а также те, которые управляются пакетной службой.

imageName

string

Образ, используемый для создания контейнера, в котором будет выполняться задача.
Это полная ссылка на изображение, как было бы указано в параметре docker pull. Если тег не указан как часть имени изображения, тег ":latest" используется в качестве значения по умолчанию.

registry

ContainerRegistry

Частный реестр, содержащий образ контейнера.
Этот параметр может быть опущен, если он уже предоставлен при создании пула.

workingDirectory

ContainerWorkingDirectory

Расположение рабочего каталога задачи контейнера.
Значение по умолчанию — taskWorkingDirectory.

UserIdentity

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

Имя Тип Описание
autoUser

AutoUserSpecification

Автоматический пользователь, под которым выполняется задача.
Свойства userName и autoUser являются взаимоисключающими; необходимо указать один, но не оба.

username

string

Имя удостоверения пользователя, в котором выполняется задача.
Свойства userName и autoUser являются взаимоисключающими; необходимо указать один, но не оба.