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


Jobs - Get Job

Получает информацию о конкретной работе.

GET {endpoint}/jobs/{jobId}?api-version=2025-06-01
GET {endpoint}/jobs/{jobId}?api-version=2025-06-01&timeOut={timeOut}&$select={$select}&$expand={$expand}

Параметры URI

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

string (uri)

Конечная точка учетной записи пакетной службы (например, https://batchaccount.eastus2.batch.azure.com).

jobId
path True

string

Идентификация работы.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

$expand
query

string[]

Предложение OData $expand.

$select
query

string[]

Предложение OData $select.

timeOut
query

integer (int32)

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

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

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

string

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

return-client-request-id

boolean

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

ocp-date

string (date-time-rfc7231)

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

If-Modified-Since

string (date-time-rfc7231)

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

If-Unmodified-Since

string (date-time-rfc7231)

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

If-Match

string

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

If-None-Match

string

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

Ответы

Имя Тип Описание
200 OK

BatchJob

Запрос выполнен успешно.

Заголовки

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

BatchError

Непредвиденное сообщение об ошибке.

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

OAuth2Auth

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

Области

Имя Описание
https://batch.core.windows.net//.default

Примеры

Job get

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

GET {endpoint}/jobs/jobId?api-version=2025-06-01


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

{
  "id": "jobId",
  "url": "https://account.region.batch.azure.com/jobs/jobId",
  "eTag": "0x8D4100FC49F0278",
  "lastModified": "2025-11-19T00:05:27.5391608Z",
  "creationTime": "2025-11-19T00:05:25.311915Z",
  "state": "completed",
  "stateTransitionTime": "2025-11-19T00:05:27.578581Z",
  "previousState": "active",
  "previousStateTransitionTime": "2025-11-19T00:05:27.2137716Z",
  "priority": 0,
  "maxParallelTasks": -1,
  "allowTaskPreemption": false,
  "usesTaskDependencies": false,
  "constraints": {
    "maxWallClockTime": "P10675199DT2H48M5.4775807S",
    "maxTaskRetryCount": 0
  },
  "poolInfo": {
    "poolId": "poolId"
  },
  "executionInfo": {
    "startTime": "2025-11-19T00:05:25.3309105Z",
    "endTime": "2025-11-19T00:05:27.578581Z",
    "poolId": "poolId",
    "terminateReason": "UserTerminate"
  },
  "onAllTasksComplete": "noaction",
  "onTaskFailure": "noaction"
}

Определения

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

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

AutomaticOsUpgradePolicy

Параметры конфигурации, используемые для автоматического обновления ОС.

AutoUserScope

AutoUserScope enums

AutoUserSpecification

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

AzureBlobFileSystemConfiguration

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

AzureFileShareConfiguration

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

BatchAccessScope

BatchAccessScope enums

BatchAllTasksCompleteMode

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

BatchApplicationPackageReference

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

BatchAutoPoolSpecification

Указывает характеристики для временного пула автозаполнения. Пакетная служба создаст этот автоматический пул при отправке задания.

BatchContainerConfiguration

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

BatchDiffDiskSettings

Указывает временные параметры диска для диска операционной системы, используемого вычислительным узлом (vm).

BatchError

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

BatchErrorDetail

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

BatchErrorMessage

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

BatchErrorSourceCategory

Enums BatchErrorSourceCategory

BatchInboundNatPool

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

BatchJob

Пакетное задание Azure.

BatchJobConstraints

Ограничения выполнения для задания.

BatchJobDefaultOrder

Enums BatchJobDefaultOrder

BatchJobExecutionInfo

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

BatchJobManagerTask

Указывает сведения о задаче диспетчера заданий. Задача диспетчера заданий автоматически запускается при создании задания. Пакетная служба пытается запланировать задачу диспетчера заданий перед любыми другими задачами в задании. При сокращении пула служба пакетной службы пытается сохранить узлы, где выполняются задачи диспетчера заданий в течение максимально возможного времени (т. е. вычислительные узлы, выполняющие "обычные" задачи, удаляются перед выполнением вычислительных узлов, выполняющих задачи диспетчера заданий). Если задача диспетчера заданий завершается сбоем и должна быть перезапущена, система пытается запланировать ее с наивысшим приоритетом. Если нет доступных неактивных вычислительных узлов, система может завершить одну из выполняемых задач в пуле и вернуть ее в очередь, чтобы освободить место для перезапуска задачи диспетчера заданий. Обратите внимание, что задача диспетчера заданий в одном задании не имеет приоритета над задачами в других заданиях. В заданиях наблюдаются только приоритеты на уровне заданий. Например, если диспетчер заданий в приоритете 0 должен быть перезапущен, он не переместит задачи приоритета 1 задания. Пакетная служба будет повторять задачи при активации операции восстановления на узле. Примеры операций восстановления включают (но не ограничиваются) при перезагрузке неработоспособного узла или вычислительном узле исчезли из-за сбоя узла. Повторные попытки из-за операций восстановления не учитываются и не учитываются для maxTaskRetryCount. Даже если значение maxTaskRetryCount равно 0, может произойти внутренняя повторная попытка из-за операции восстановления. Из-за этого все задачи должны быть идемпотентными. Это означает, что задачи должны терпеть прерывание и перезапуск без повреждения или дублирования данных. Рекомендуется использовать определенную форму контрольных точек для длительных задач.

BatchJobNetworkConfiguration

(Это свойство недоступно по умолчанию. Пожалуйста, обратитесь в службу поддержки за дополнительной информацией) Конфигурация сети для задания.

BatchJobPreparationTask

Задача подготовки заданий, выполняемая перед любыми задачами задания на любом заданном вычислительном узле. Вы можете использовать подготовку задания для подготовки узла для выполнения задач для задания. Действия, часто выполняемые в процессе подготовки задания, включают в себя скачивание общих файлов ресурсов, используемых всеми задачами в задании. Задача подготовки заданий может скачать эти общие файлы ресурсов в общее расположение на узле. (AZ_BATCH_NODE_ROOT_DIR\shared) или запуск локальной службы на узле, чтобы все задачи этого задания могли взаимодействовать с ним. Если задача подготовки заданий завершается сбоем (т. е. исчерпает количество повторных попыток перед выходом с кодом выхода 0), пакетная служба не будет запускать задачи этого задания на узле. Вычислительный узел остается неисправным для выполнения задач этого задания, пока он не будет переимычен. Вычислительный узел остается активным и может использоваться для других заданий. Задача подготовки заданий может выполняться несколько раз на одном узле. Поэтому необходимо написать задачу подготовки заданий для обработки повторного выполнения. Если узел перезагружается, задача подготовки заданий выполняется снова на вычислительном узле перед планированием любой другой задачи задания, если повторно запуститьOnNodeRebootAfterSuccess или если задача подготовки задания ранее не завершена. Если узел переосмыслен, задача подготовки заданий выполняется снова перед планированием любой задачи задания. Пакетная служба будет повторять задачи при активации операции восстановления на узле. Примеры операций восстановления включают (но не ограничиваются) при перезагрузке неработоспособного узла или вычислительном узле исчезли из-за сбоя узла. Повторные попытки из-за операций восстановления не учитываются и не учитываются для maxTaskRetryCount. Даже если значение maxTaskRetryCount равно 0, может произойти внутренняя повторная попытка из-за операции восстановления. Из-за этого все задачи должны быть идемпотентными. Это означает, что задачи должны терпеть прерывание и перезапуск без повреждения или дублирования данных. Рекомендуется использовать определенную форму контрольных точек для длительных задач.

BatchJobReleaseTask

Задача выпуска задания для выполнения задания на любом вычислительном узле, где выполняется задание. Задача выпуска задания выполняется, когда задание заканчивается, из-за одного из следующих: пользователь вызывает API завершения задания или API удаления заданий, пока задание по-прежнему активно, достигнуто максимальное ограничение времени на стенные часы задания, а задание по-прежнему активно или задача диспетчера заданий завершена, и задание настроено на завершение после завершения диспетчера заданий. Задача выпуска задания выполняется на каждом узле, где выполняются задачи задания, а задача подготовки задания выполняется и завершена. Если вы повторно создайте узел после запуска задачи подготовки задания, а задание завершается без дальнейших задач задания, запущенного на этом узле (и, следовательно, задача подготовки задания не выполняется повторно), задача выпуска задания не запускается на этом вычислительном узле. Если узел перезагрузится, пока задача выпуска задания по-прежнему запущена, задача выпуска задания снова запускается при запуске вычислительного узла. Задание не помечается как завершенное до завершения всех задач выпуска задания. Задача выпуска задания выполняется в фоновом режиме. Он не занимает слот планирования; То есть он не учитывается в отношении ограничения taskSlotsPerNode, указанного в пуле.

BatchJobSchedulingError

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

BatchJobState

Enums BatchJobState

BatchJobStatistics

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

BatchMetadataItem

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

BatchNodeFillType

BatchNodeFillType enums

BatchNodeIdentityReference

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

BatchNodePlacementConfiguration

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

BatchNodePlacementPolicyType

BatchNodePlacementPolicyType enums

BatchOsDisk

Параметры диска операционной системы вычислительного узла (VM).

BatchPoolEndpointConfiguration

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

BatchPoolIdentityReference

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

BatchPoolInfo

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

BatchPoolLifetimeOption

Enums BatchPoolLifetimeOption

BatchPoolSpecification

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

BatchPublicIpAddressConfiguration

Конфигурация общедоступного IP-адреса конфигурации сети пула.

BatchStartTask

Пакетная служба будет повторять задачи при активации операции восстановления на узле. Примеры операций восстановления включают (но не ограничиваются) при перезагрузке неработоспособного узла или вычислительном узле исчезли из-за сбоя узла. Повторные попытки из-за операций восстановления не учитываются и не учитываются для maxTaskRetryCount. Даже если значение maxTaskRetryCount равно 0, может произойти внутренняя повторная попытка из-за операции восстановления. Из-за этого все задачи должны быть идемпотентными. Это означает, что задачи должны терпеть прерывание и перезапуск без повреждения или дублирования данных. Рекомендуется использовать определенную форму контрольных точек для длительных задач. В некоторых случаях запуск StartTask может выполняться повторно, даже если вычислительный узел не был перезагружен. Следует учесть, чтобы избежать запуска StartTasks, создающих отсортовый процесс или установку или запуск служб из рабочего каталога StartTask, так как это приведет к тому, что пакетная служба сможет повторно запустить StartTask.

BatchTaskConstraints

Ограничения выполнения для применения к задаче.

BatchTaskContainerSettings

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

BatchTaskFailureMode

Enums TaskFailure

BatchTaskSchedulingPolicy

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

BatchUefiSettings

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

BatchVmDiskSecurityProfile

Задает параметры профиля безопасности для управляемого диска. Примечание: Он может быть установлен только для конфиденциальных виртуальных машин и необходим при использовании конфиденциальных виртуальных машин.

BatchVmImageReference

Ссылка на образ Azure Virtual Machines Marketplace или образ коллекции вычислений Azure. Чтобы получить список всех ссылок на образы Azure Marketplace, проверенных пакетной службой Azure, см. операцию "Список поддерживаемых образов".

CachingType

Энумы CachingType

CifsMountConfiguration

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

ContainerHostBatchBindMountEntry

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

ContainerHostDataPath

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

ContainerRegistryReference

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

ContainerType

ContainerType enums

ContainerWorkingDirectory

ContainerWorkingDirectory enums

DataDisk

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

DiffDiskPlacement

Задаёт эфемерное расположение диска для диска операционной системы для всех вычислительных узлов (VM) пула. Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение операционной системы. Например, кэшировать место на диске для подготовки диска Эфемеральной ОС. Для получения дополнительной информации о требованиях к размеру диска для эфемерных ОС, пожалуйста, обратитесь к требованиям к размеру диска для виртуальных машин Windows в и https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements для виртуальных машин Linux по адресу https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

DiskCustomerManagedKey

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

DiskEncryptionConfiguration

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

DiskEncryptionSetParameters

Идентификатор ресурса ARM набора шифрования диска.

DiskEncryptionTarget

Enums DiskEncryptionTarget

DynamicVNetAssignmentScope

DynamicVNetAssignmentScope enums

ElevationLevel

Enums ElevationLevel

EnvironmentSetting

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

HostEndpointSettings

Указывает определенные параметры конечной точки узла.

HostEndpointSettingsModeTypes

HostEndpointSettingsModeTypes enums

InboundEndpointProtocol

Enums InboundEndpointProtocol

IpAddressProvisioningType

IPAddressProvisioningType enums

IPFamily

Семейства IP-адресов, используемые для указания версий IP-адресов, доступных для пула.

IPTag

Содержит тег IP, связанный с общедоступным IP-адресом.

LinuxUserConfiguration

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

LoginMode

Enums LoginMode

ManagedDisk

Параметры управляемого диска.

MountConfiguration

Файловая система для подключения на каждом узле.

NameValuePair

Представляет пару "имя-значение".

NetworkConfiguration

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

NetworkSecurityGroupRule

Правило группы безопасности сети для применения к входящей конечной точке.

NetworkSecurityGroupRuleAccess

NetworkSecurityGroupRuleAccess enums

NfsMountConfiguration

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

OutputFile

При каждой отправке файлов пакетная служба записывает два файла журнала на вычислительный узелfileuploadout.txtиfileuploaderr.txt. Эти файлы журналов используются для получения дополнительных сведений о конкретном сбое.

OutputFileBlobContainerDestination

Указывает назначение отправки файлов в контейнере хранилища BLOB-объектов Azure.

OutputFileDestination

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

OutputFileUploadCondition

Enums OutputFileUploadCondition

OutputFileUploadConfig

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

OutputFileUploadHeader

Пара "Имя-значение" заголовка HTTP

ProxyAgentSettings

Задает параметры ProxyAgent при создании виртуальной машины.

ResourceFile

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

RollingUpgradePolicy

Параметры конфигурации, используемые при выполнении последовательного обновления.

SecurityEncryptionTypes

Enums SecurityEncryptionTypes

SecurityProfile

Задает параметры профиля безопасности для масштабируемого набора виртуальных машин или виртуальной машины.

SecurityTypes

Указывает тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение.

ServiceArtifactReference

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

StorageAccountType

Перечисления StorageAccountType

UpgradeMode

Enums UpgradeMode

UpgradePolicy

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

UserAccount

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

UserIdentity

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

VirtualMachineConfiguration

Конфигурация вычислительных узлов в пуле на основе инфраструктуры виртуальных машин Azure.

VMExtension

Конфигурация расширений виртуальных машин.

WindowsConfiguration

Параметры операционной системы Windows для применения к виртуальной машине.

WindowsUserConfiguration

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

AuthenticationTokenSettings

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

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

BatchAccessScope[]

Пакетные ресурсы, к которым токен предоставляет доступ. Токен аутентификации предоставляет доступ к ограниченному набору операций пакетного сервиса. В настоящее время единственным поддерживаемым значением свойства доступа является 'job', которое предоставляет доступ ко всем операциям, связанным с задачей, содержащей задачу.

AutomaticOsUpgradePolicy

Параметры конфигурации, используемые для автоматического обновления ОС.

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

boolean

Следует ли отключить функцию отката образа ОС.

enableAutomaticOSUpgrade

boolean

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

Если для пулов windows задано значение true, WindowsConfiguration.enableAutomaticUpdates не может быть задано значение true.

osRollingUpgradeDeferral

boolean

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

useRollingUpgradePolicy

boolean

Указывает, следует ли использовать политику последовательного обновления во время автоматического обновления ОС. Автоматическое обновление ОС откатится к политике по умолчанию, если политика не определена в VMSS.

AutoUserScope

AutoUserScope enums

Значение Описание
task

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

pool

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

AutoUserSpecification

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

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

ElevationLevel

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

scope

AutoUserScope

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

AzureBlobFileSystemConfiguration

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

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

string (password)

Ключ учетной записи хранения Azure. Это свойство является взаимоисключающим как с sasKey, так и с удостоверением; необходимо указать именно один.

accountName

string

Имя учетной записи служба хранилища Azure.

blobfuseOptions

string

Дополнительные параметры командной строки для передачи команде подключения. Это параметры "net use" в Windows и "подключение" в Linux.

containerName

string

Имя контейнера хранилища BLOB-объектов Azure.

identityReference

BatchNodeIdentityReference

Ссылка на назначенную пользователю идентичность для доступа к containerName. Это свойство является взаимоисключающим как с accountKey, так и sasKey; необходимо указать именно один.

relativeMountPath

string

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

sasKey

string (password)

Маркер SAS службы хранилища Azure. Это свойство является взаимоисключающим как с accountKey, так и с удостоверением; необходимо указать именно один.

AzureFileShareConfiguration

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

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

string (password)

Ключ учетной записи хранения Azure.

accountName

string

Имя учетной записи хранения Azure.

azureFileUrl

string (uri)

URL-адрес файлов Azure. Это форма "https://{account}.file.core.windows.net/".

mountOptions

string

Дополнительные параметры командной строки для передачи команде подключения. Это параметры "net use" в Windows и "подключение" в Linux.

relativeMountPath

string

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

BatchAccessScope

BatchAccessScope enums

Значение Описание
job

Предоставляет доступ для выполнения всех операций на Задании, содержащем Задачу.

BatchAllTasksCompleteMode

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

Значение Описание
noaction

Никакие действия не выполняются. Работа остаётся активной, если не была уволена или отключена каким-либо другим способом.

terminatejob

Уволить работу. Причина прекращения работы установлена в «Все задачи выполнены».

BatchApplicationPackageReference

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

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

string

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

version

string

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

BatchAutoPoolSpecification

Указывает характеристики для временного пула автозаполнения. Пакетная служба создаст этот автоматический пул при отправке задания.

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

string

Префикс, который добавляется к уникальному идентификатору при автоматическом создании пула. Пакетный сервис присваивает каждому автопулу уникальный идентификатор при создании. Чтобы отличить пулы, созданные для разных целей, можно задать этот элемент, чтобы добавить префикс к назначенному идентификатору. Префикс может достигать до 20 символов.

keepAlive

boolean

Стоит ли поддерживать автопул после истечения срока службы. Если это ошибка, пакетная служба удаляет пул после истечения его срока жизни (как определяется настройками poolLifetimeOption); то есть, когда завершён Job или Job Schedule. Если это верно, пакетный сервис не удаляет пул автоматически. Пользователь должен удалить автоматические пулы, созданные с помощью этой опции.

pool

BatchPoolSpecification

Спецификация Pool для Auto Pool.

poolLifetimeOption

BatchPoolLifetimeOption

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

BatchContainerConfiguration

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

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

string[]

Коллекция имён изображений контейнеров. Это полная ссылка на изображение, как было бы указано в «docker pull». Изображение будет взято из стандартного реестра Docker, если только оно не полностью квалифицировано с альтернативным реестром.

containerRegistries

ContainerRegistryReference[]

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

type

ContainerType

Используемая технология контейнера.

BatchDiffDiskSettings

Указывает временные параметры диска для диска операционной системы, используемого вычислительным узлом (vm).

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

DiffDiskPlacement

Указывает временное размещение дисков для диска операционной системы для всех виртуальных машин в пуле. Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение, например место на диске кэша для подготовки диска Эфемеральной ОС. Дополнительные сведения о требованиях к размеру диска в эфемерной ОС см. в соответствии с требованиями к размеру диска операционной системы в https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements и виртуальных машинах Linux на https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.

BatchError

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

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

string

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

message

BatchErrorMessage

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

values

BatchErrorDetail[]

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

BatchErrorDetail

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

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

string

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

value

string

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

BatchErrorMessage

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

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

string

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

value

string

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

BatchErrorSourceCategory

Enums BatchErrorSourceCategory

Значение Описание
usererror

Ошибка возникла из-за пользовательской проблемы, например, неправильной настройки.

servererror

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

BatchInboundNatPool

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

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

integer (int32)

Номер порта на вычислительном узле. Это, должно быть, уникально для Batch Pool. Допустимые значения : от 1 до 65535, за исключением 29876 и 29877, так как они зарезервированы. Если указаны зарезервированные значения, запрос завершается ошибкой с кодом состояния HTTP 400.

frontendPortRangeEnd

integer (int32)

Последний номер порта в диапазоне внешних портов, которые будут использоваться для обеспечения входящего доступа к backendPort на отдельных вычислительных узлах. Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, зарезервированных пакетной службой. Все диапазоны внутри пула должны быть разными и не могут пересекаться. В каждом диапазоне должно быть не менее 40 портов. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400.

frontendPortRangeStart

integer (int32)

Первый номер порта в диапазоне внешних портов, которые будут использоваться для обеспечения входящего доступа к backendPort на отдельных вычислительных узлах. Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, которые зарезервированы. Все диапазоны внутри пула должны быть разными и не могут пересекаться. В каждом диапазоне должно быть не менее 40 портов. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400.

name

string

Имя конечной точки. Название должно быть уникальным в рамках Batch Pool, может содержать буквы, цифры, подчеркнутые, точки и дефисы. Имена должны начинаться с буквы или числа, заканчиваться буквой, числом или подчеркиванием и не может превышать 77 символов. Если указаны недопустимые значения, запрос завершается ошибкой с кодом состояния HTTP 400.

networkSecurityGroupRules

NetworkSecurityGroupRule[]

Список правил группы безопасности сети, которые будут применены к конечной точке. Максимальное количество правил, которые можно задать для всех конечных точек в пакетном пуле, составляет 25. Если правила группы безопасности сети не указаны, будет создано правило по умолчанию, чтобы разрешить входящий доступ к указанному внутреннему порту. Если максимальное число правил группы безопасности сети превышается, запрос завершается ошибкой с кодом состояния HTTP 400.

protocol

InboundEndpointProtocol

Протокол конечной точки.

BatchJob

Пакетное задание Azure.

Имя Тип Default value Описание
allowTaskPreemption

boolean

Можно ли выполнять задачи в этом задании с высоким приоритетом. (Это свойство недоступно по умолчанию. Пожалуйста, обратитесь в службу поддержки для получения дополнительной информации) Если значение установлено в True, другие задания с высоким приоритетом, отправленные в систему, будут иметь приоритет и смогут повторно ставить задачи в очередь из этого задания. После создания задания с помощью API задания обновления можно обновить allowTaskPreemption.

commonEnvironmentSettings

EnvironmentSetting[]

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

constraints

BatchJobConstraints

Ограничения выполнения для задания.

creationTime

string (date-time)

Время создания задания.

displayName

string

Отображаемое имя задания.

eTag

string

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

executionInfo

BatchJobExecutionInfo

Сведения о выполнении задания.

id

string

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

jobManagerTask

BatchJobManagerTask

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

jobPreparationTask

BatchJobPreparationTask

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

jobReleaseTask

BatchJobReleaseTask

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

lastModified

string (date-time)

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

maxParallelTasks

integer (int32)

-1

Максимальное количество задач, которые могут выполняться параллельно для задания. (Это свойство недоступно по умолчанию. Пожалуйста, обратитесь в службу поддержки для получения дополнительной информации) Значение maxParallelTasks должно быть -1 или больше 0, если указано. Если значение по умолчанию не указано, значение по умолчанию равно -1, что означает, что количество задач, которые могут выполняться одновременно, не ограничено. После создания задания с помощью API задания обновления можно обновить maxParallelTasks.

metadata

BatchMetadataItem[]

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

networkConfiguration

BatchJobNetworkConfiguration

(Это свойство недоступно по умолчанию. Пожалуйста, обратитесь в службу поддержки за дополнительной информацией) Конфигурация сети для задания.

onAllTasksComplete

BatchAllTasksCompleteMode

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

onTaskFailure

BatchTaskFailureMode

Действие пакетной службы должно выполняться при сбое любой задачи в задании. Задача считается неудачной, если имеет сбой. Параметр failureInfo устанавливается, если задача завершается с кодом выхода без нуля после исчерпания его количества повторных попыток или если возникла ошибка запуска задачи, например из-за ошибки загрузки файла ресурсов. Значение по умолчанию — noaction.

poolInfo

BatchPoolInfo

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

previousState

BatchJobState

Предыдущее состояние задания. Это свойство не задано, если задание находится в исходном состоянии "Активный".

previousStateTransitionTime

string (date-time)

Время ввода задания в предыдущее состояние. Это свойство не задано, если задание находится в исходном состоянии "Активный".

priority

integer (int32)

Приоритет задания. Значения приоритета могут варьироваться от -1000 до 1000, при этом -1000 является самым низким приоритетом, а 1000 — самым высоким приоритетом. Значение по умолчанию — 0.

state

BatchJobState

Текущее состояние задания.

stateTransitionTime

string (date-time)

Время ввода задания в текущее состояние.

stats

BatchJobStatistics

Статистика использования ресурсов в течение всего времени существования задания. Это свойство заполняется только в том случае, если пакетный заданий был получен с предложением expand, включая атрибут stats; в противном случае значение null. Статистика может быть недоступна сразу. Пакетная служба выполняет периодический свертки статистики. Типичная задержка составляет около 30 минут.

url

string (uri)

URL-адрес задания.

usesTaskDependencies

boolean

Могут ли задачи в задании определять зависимости друг от друга. Значение по умолчанию — false.

BatchJobConstraints

Ограничения выполнения для задания.

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

integer (int32)

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

maxWallClockTime

string (duration)

Максимальное прошедшее время, которое может выполнить Задание, измеряемое с момента её создания. Если задание не завершается в отведённое время, пакетная служба завершает её и все выполняющиеся задачи. В этом случае причиной прекращения будет MaxWallClockTimeExpiry. Если это свойство не указано, нет ограничения по времени на продолжительность Работы.

BatchJobDefaultOrder

Enums BatchJobDefaultOrder

Значение Описание
none

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

creationtime

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

BatchJobExecutionInfo

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

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

string (date-time)

Время завершения работы. Это свойство устанавливается только если Job находится в состоянии завершения.

poolId

string

ID пула, к которому назначена эта работа. Этот элемент содержит фактический пул, в который назначена задача. Когда вы получаете детали Job из сервиса, они также содержат элемент poolInfo, который содержит данные конфигурации пула с момента добавления или обновления Job. Этот элемент poolInfo также может содержать элемент poolId. Если да, то оба ID одинаковы. Если нет, значит, задание выполнялось в автопуле, и это свойство содержит идентификатор этого автопула.

schedulingError

BatchJobSchedulingError

Подробности о любых ошибках, с которыми столкнулась служба при запуске работы. Это свойство не устанавливается, если не было ошибки при запуске Job.

startTime

string (date-time)

Время начала работы. Именно в это время был создан Job.

terminateReason

string

Строка, описывающая причину окончания Иова. Это свойство устанавливается только если Job находится в состоянии завершения. Если пакетная служба завершает работу, она задаёт причину следующим образом: JMComplete — задача менеджера заданий выполнена, killJobOnCompletion установлена в true. MaxWallClockTimeExpiry — Работа достигла максимального ограничения WallClockTime. TerminateJobSchedule — работа выполнялась как часть расписания, и расписание завершалось. AllTasksComplete — атрибут Job onAllTasksComplete установлен на terminatejob, и все задачи в работе завершены. TaskFailed — атрибут onTaskFailure задания установлен как performExitOptionsJobAction, а задача в работе провалилась с условием выхода, указывающим jobAction terminatejob. Любая другая строка — это пользовательская причина, указанная в вызове операции «Завершить работу».

BatchJobManagerTask

Указывает сведения о задаче диспетчера заданий. Задача диспетчера заданий автоматически запускается при создании задания. Пакетная служба пытается запланировать задачу диспетчера заданий перед любыми другими задачами в задании. При сокращении пула служба пакетной службы пытается сохранить узлы, где выполняются задачи диспетчера заданий в течение максимально возможного времени (т. е. вычислительные узлы, выполняющие "обычные" задачи, удаляются перед выполнением вычислительных узлов, выполняющих задачи диспетчера заданий). Если задача диспетчера заданий завершается сбоем и должна быть перезапущена, система пытается запланировать ее с наивысшим приоритетом. Если нет доступных неактивных вычислительных узлов, система может завершить одну из выполняемых задач в пуле и вернуть ее в очередь, чтобы освободить место для перезапуска задачи диспетчера заданий. Обратите внимание, что задача диспетчера заданий в одном задании не имеет приоритета над задачами в других заданиях. В заданиях наблюдаются только приоритеты на уровне заданий. Например, если диспетчер заданий в приоритете 0 должен быть перезапущен, он не переместит задачи приоритета 1 задания. Пакетная служба будет повторять задачи при активации операции восстановления на узле. Примеры операций восстановления включают (но не ограничиваются) при перезагрузке неработоспособного узла или вычислительном узле исчезли из-за сбоя узла. Повторные попытки из-за операций восстановления не учитываются и не учитываются для maxTaskRetryCount. Даже если значение maxTaskRetryCount равно 0, может произойти внутренняя повторная попытка из-за операции восстановления. Из-за этого все задачи должны быть идемпотентными. Это означает, что задачи должны терпеть прерывание и перезапуск без повреждения или дублирования данных. Рекомендуется использовать определенную форму контрольных точек для длительных задач.

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

boolean

Может ли задача диспетчера заданий выполняться на точечном/низкоприоритетном вычислительном узле. Значение по умолчанию — true.

applicationPackageReferences

BatchApplicationPackageReference[]

Список пакетов приложений, которые пакетный сервис развернут на вычислительном узле перед запуском командной строки. Пакеты приложений загружаются и развёртываются в общей директории, а не в рабочем каталоге задач. Следовательно, если ссылка на пакет приложений уже находится на вычислительном узле и актуальна, то он не скачается повторно; используется существующая копия на Compute Node. Если ссылка на пакет приложений не может быть установлен, например, потому что пакет был удален или загрузка не удалась, задача не выполняется.

authenticationTokenSettings

AuthenticationTokenSettings

Параметры маркера проверки подлинности, который задача может использовать для выполнения операций пакетной службы. Если это свойство установлено, пакетный сервис предоставляет задаче токен аутентификации, который можно использовать для аутентификации операций пакетного сервиса без необходимости ключа доступа к аккаунту. Маркер предоставляется с помощью переменной среды AZ_BATCH_AUTHENTICATION_TOKEN. Операции, которые задача может выполнять с использованием токена, зависят от настроек. Например, задача может запрашивать разрешения на выполнение заданий, чтобы добавить другие задачи в работу, или проверять статус работы или других задач под этой задачей.

commandLine

string

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

constraints

BatchTaskConstraints

Ограничения, применимые к задаче менеджера по работе.

containerSettings

BatchTaskContainerSettings

Настройки контейнера, под которым выполняется задача Менеджера заданий. Если пул, который будет выполнять эту задачу, имеет установленную конфигурацию контейнера, то и она должна быть установлена. Если пул, выполняющий эту задачу, не имеет установленного containerConfiguration, это не должно быть установлено. Когда это указано, все каталоги рекурсивно ниже AZ_BATCH_NODE_ROOT_DIR (корня Azure Batch каталогов на узле) отображаются в контейнер, все переменные среды задачи отображаются в контейнер, и в контейнере выполняется командная строка задачи. Файлы, созданные в контейнере вне AZ_BATCH_NODE_ROOT_DIR, могут не отражаться на хост-диске, что означает, что API пакетных файлов не смогут получить доступ к этим файлам.

displayName

string

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

environmentSettings

EnvironmentSetting[]

Список настроек переменных среды для задачи менеджера заданий.

id

string

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

killJobOnCompletion

boolean

Означает ли выполнение задачи менеджера по работе с работой завершение всей работы. Если это верно, когда задача менеджера заданий завершается, пакетная служба отмечает задание как завершённое. Если какие-либо задачи всё ещё выполняются в данный момент (кроме Job Release), эти задачи завершаются. Если это ошибка, выполнение задачи менеджера не влияет на статус работы. В этом случае следует либо использовать атрибут onAllTasksComplete для завершения задания, либо чтобы клиент или пользователь явно завершил её. Примером может служить ситуация, когда менеджер заданий создаёт набор задач, но затем не принимает дальнейшей роли в их выполнении. Значение по умолчанию — true. Если вы используете атрибуты onAllTasksComplete и onTaskFailure для управления сроком жизни Job, а Job Manager Task — только для создания задач для задания (а не для мониторинга прогресса), важно установить killJobOnCompletion в false.

outputFiles

OutputFile[]

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

requiredSlots

integer (int32)

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

resourceFiles

ResourceFile[]

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

runExclusive

boolean

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

userIdentity

UserIdentity

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

BatchJobNetworkConfiguration

(Это свойство недоступно по умолчанию. Пожалуйста, обратитесь в службу поддержки за дополнительной информацией) Конфигурация сети для задания.

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

boolean

Следует ли удалять вычислительные узлы из виртуальной сети в DNC при завершении или удалении задания. Если значение true, узлы останутся присоединенными к виртуальной сети с DNC. Если значение false, узлы автоматически отступят после завершения задания. По умолчанию false.

subnetId

string

Идентификатор ресурса ARM подсети виртуальной сети, в которой вычислительные узлы, выполняющие задачи из задания, присоединяются в течение длительности задачи. Виртуальная сеть должна находиться в том же регионе и подписке, что и учетная запись пакетной службы Azure. Указанная подсеть должна иметь достаточно свободных IP-адресов для размещения количества вычислительных узлов, которые будут выполнять задачи из задания. Это может быть до количества вычислительных узлов в пуле. Субъект-служба MicrosoftAzureBatch должна иметь роль "Участник классической виртуальной машины" Role-Based управление доступом (RBAC) для указанной виртуальной сети, чтобы пакетная служба Azure может планировать задачи на узлах. Это можно проверить, проверьте, имеет ли указанная виртуальная сеть любые связанные группы безопасности сети (NSG). Если связь с узлами в указанной подсети запрещена группой безопасности сети, служба пакетной службы установит состояние вычислительных узлов неиспользуемым. Это форма /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}}. Если у указанной виртуальной сети есть связанные группы безопасности сети (NSG), необходимо включить несколько зарезервированных системных портов для входящего взаимодействия со службой пакетной службы Azure. Для пулов, созданных с конфигурацией виртуальной машины, включите порты 29876 и 29877, а также порт 22 для Linux и порт 3389 для Windows. Порт 443 также должен быть открыт для исходящих подключений для обмена данными с службой хранилища Azure. Дополнительные сведения см. в статье https://learn.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration.

BatchJobPreparationTask

Задача подготовки заданий, выполняемая перед любыми задачами задания на любом заданном вычислительном узле. Вы можете использовать подготовку задания для подготовки узла для выполнения задач для задания. Действия, часто выполняемые в процессе подготовки задания, включают в себя скачивание общих файлов ресурсов, используемых всеми задачами в задании. Задача подготовки заданий может скачать эти общие файлы ресурсов в общее расположение на узле. (AZ_BATCH_NODE_ROOT_DIR\shared) или запуск локальной службы на узле, чтобы все задачи этого задания могли взаимодействовать с ним. Если задача подготовки заданий завершается сбоем (т. е. исчерпает количество повторных попыток перед выходом с кодом выхода 0), пакетная служба не будет запускать задачи этого задания на узле. Вычислительный узел остается неисправным для выполнения задач этого задания, пока он не будет переимычен. Вычислительный узел остается активным и может использоваться для других заданий. Задача подготовки заданий может выполняться несколько раз на одном узле. Поэтому необходимо написать задачу подготовки заданий для обработки повторного выполнения. Если узел перезагружается, задача подготовки заданий выполняется снова на вычислительном узле перед планированием любой другой задачи задания, если повторно запуститьOnNodeRebootAfterSuccess или если задача подготовки задания ранее не завершена. Если узел переосмыслен, задача подготовки заданий выполняется снова перед планированием любой задачи задания. Пакетная служба будет повторять задачи при активации операции восстановления на узле. Примеры операций восстановления включают (но не ограничиваются) при перезагрузке неработоспособного узла или вычислительном узле исчезли из-за сбоя узла. Повторные попытки из-за операций восстановления не учитываются и не учитываются для maxTaskRetryCount. Даже если значение maxTaskRetryCount равно 0, может произойти внутренняя повторная попытка из-за операции восстановления. Из-за этого все задачи должны быть идемпотентными. Это означает, что задачи должны терпеть прерывание и перезапуск без повреждения или дублирования данных. Рекомендуется использовать определенную форму контрольных точек для длительных задач.

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

string

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

constraints

BatchTaskConstraints

Ограничения, применяемые к заданию подготовки к работе.

containerSettings

BatchTaskContainerSettings

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

environmentSettings

EnvironmentSetting[]

Список настроек переменных среды для задачи подготовки к работе.

id

string

Строка, которая уникально идентифицирует задачу подготовки к работе внутри работы. ID может содержать любую комбинацию буквенно-цифровых символов, включая дефисы и подчёркивания, и не может содержать более 64 символов. Если вы не указываете это свойство, пакетный сервис присваивает по умолчанию значение 'jobprepared'. Ни одна другая задача на работе не может иметь такой же идентификатор, как задание подготовки к работе. Если вы пытаетесь отправить задачу с тем же идентификатором, пакетная служба отклоняет запрос с кодом ошибки TaskIdSameAsJobPreparationTask; если вы вызываете REST API напрямую, HTTP-код статуса — 409 (Конфликт).

rerunOnNodeRebootAfterSuccess

boolean

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

resourceFiles

ResourceFile[]

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

userIdentity

UserIdentity

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

waitForSuccess

boolean

Стоит ли пакетному сервису ждать успешного завершения задачи подготовки задания, прежде чем планировать другие задачи работы на вычислительном узле. Задание по подготовке работы успешно завершено, если оно выходит с кодом выхода 0. Если это верно и задача подготовки задания не выполняется на узле, пакетная служба повторяет задачу подготовки задания до максимального количества повторных попыток (как указано в элементе constraints). Если задача всё ещё не была успешно завершена после всех повторных попыток, то пакетная служба не будет планировать задачи задачи узлу. Узел остаётся активным и имеет право выполнять задачи других задач. Если это ошибка, пакетная служба не будет ждать завершения задачи подготовки работы. В этом случае другие задачи задачи могут начать выполняться на вычислительном узле, пока задача подготовки задания ещё выполняется; и даже если задача подготовки задания не выполняется, новые задачи продолжат планироваться на вычислительном узле. Значение по умолчанию — true.

BatchJobReleaseTask

Задача выпуска задания для выполнения задания на любом вычислительном узле, где выполняется задание. Задача выпуска задания выполняется, когда задание заканчивается, из-за одного из следующих: пользователь вызывает API завершения задания или API удаления заданий, пока задание по-прежнему активно, достигнуто максимальное ограничение времени на стенные часы задания, а задание по-прежнему активно или задача диспетчера заданий завершена, и задание настроено на завершение после завершения диспетчера заданий. Задача выпуска задания выполняется на каждом узле, где выполняются задачи задания, а задача подготовки задания выполняется и завершена. Если вы повторно создайте узел после запуска задачи подготовки задания, а задание завершается без дальнейших задач задания, запущенного на этом узле (и, следовательно, задача подготовки задания не выполняется повторно), задача выпуска задания не запускается на этом вычислительном узле. Если узел перезагрузится, пока задача выпуска задания по-прежнему запущена, задача выпуска задания снова запускается при запуске вычислительного узла. Задание не помечается как завершенное до завершения всех задач выпуска задания. Задача выпуска задания выполняется в фоновом режиме. Он не занимает слот планирования; То есть он не учитывается в отношении ограничения taskSlotsPerNode, указанного в пуле.

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

string

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

containerSettings

BatchTaskContainerSettings

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

environmentSettings

EnvironmentSetting[]

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

id

string

Строка, которая уникально идентифицирует задачу выпуска задания внутри задачи. ID может содержать любую комбинацию буквенно-цифровых символов, включая дефисы и подчёркивания, и не может содержать более 64 символов. Если вы не указываете это свойство, пакетный сервис присваивает значение по умолчанию 'jobrelease'. Ни одна другая задача в работе не может иметь тот же идентификатор, что и задача освобождения работы. Если вы пытаетесь отправить задачу с тем же идентификатором, пакетная служба отклоняет запрос с кодом ошибки TaskIdSameAsJobReleaseTask; если вы вызываете REST API напрямую, HTTP-код статуса — 409 (Конфликт).

maxWallClockTime

string (duration)

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

resourceFiles

ResourceFile[]

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

retentionTime

string (duration)

Минимальное время для сохранения каталога задач для задачи выпуска заданий на вычислительном узле. После этого времени пакетная служба может удалить каталог задач и всё её содержимое. По умолчанию — 7 дней, то есть каталог задач сохраняется в течение 7 дней, если только вычислительный узел не будет удален или задание не будет удалено.

userIdentity

UserIdentity

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

BatchJobSchedulingError

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

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

BatchErrorSourceCategory

Категория ошибки в расписании работы.

code

string

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

details

NameValuePair[]

Список дополнительных деталей ошибок, связанных с ошибкой планирования.

message

string

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

BatchJobState

Enums BatchJobState

Значение Описание
active

Вакансия доступна для запланирования задач.

disabling

Пользователь попросил отключить задание, но операция отключения всё ещё продолжается (например, ожидание завершения задач).

disabled

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

enabling

Пользователь попросил включить Job, но операция включения всё ещё продолжается.

terminating

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

completed

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

deleting

Пользователь попросил удалить Задачу, но операция удаления всё ещё продолжается (например, потому что система всё ещё завершает выполнение Задач).

BatchJobStatistics

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

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

string (duration)

Общее время процессора в режиме ядра (сумма по всем ядрам и всем вычислительным узлам), потраченное всеми задачами в работе.

lastUpdateTime

string (date-time)

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

numFailedTasks

string (int64)

Общее количество заданий в задании, которые не были выполнены в определённый временной диапазон. Задача проваливается, если исчерпает максимальное количество повторных попыток без возврата кода выхода 0.

numSucceededTasks

string (int64)

Общее количество успешно выполненных заданий в задании за заданный временной диапазон. Задача успешно выполняется, если возвращает код выхода 0.

numTaskRetries

string (int64)

Общее количество повторных попыток по всем задачам в работе за заданный временной диапазон.

readIOGiB

number (float)

Общее количество данных в ГиБ, прочитанных с диска всеми задачами в работе.

readIOps

string (int64)

Общее количество операций чтения диска, выполненных всеми задачами в работе.

startTime

string (date-time)

Время начала времени, охватываемого статистикой.

url

string (uri)

URL статистики.

userCPUTime

string (duration)

Общее время процессора в пользовательском режиме (сумма по всем ядрам и всем вычислительным узлам), потраченное всеми задачами в работе.

waitTime

string (duration)

Общее время ожидания всех задач на работе. Время ожидания задачи определяется как прошедшее время между созданием задачи и началом её выполнения. (Если задача повторяется из-за неудач, время ожидания — это время до последнего выполнения задачи.) Это значение указывается только в статистике за всю жизнь аккаунта; она не включена в статистику вакансий.

wallClockTime

string (duration)

Общее время работы всех задач на работе. Время настенного часов — это время, прошедшее с момента начала выполнения задачи на вычислительном узле до момента её завершения (или до последнего обновления статистики, если задача к тому времени не была завершена). Если задача была повторена, это включает время настенного часов всех повторных задач.

writeIOGiB

number (float)

Общее количество данных в GiB, записанных на диск всеми задачами в работе.

writeIOps

string (int64)

Общее количество операций записи на диск, выполненных всеми задачами в задании.

BatchMetadataItem

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

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

string

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

value

string

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

BatchNodeFillType

BatchNodeFillType enums

Значение Описание
spread

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

pack

Как можно больше задач (taskSlotsPerNode) должно быть назначено каждому вычислительному узлу пула до назначения задач следующему вычислительному узлу пула.

BatchNodeIdentityReference

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

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

string (arm-id)

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

BatchNodePlacementConfiguration

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

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

BatchNodePlacementPolicyType

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

BatchNodePlacementPolicyType

BatchNodePlacementPolicyType enums

Значение Описание
regional

Все узлы в пуле будут выделены в одном регионе.

zonal

Узлы пула будут распределены по разным зонам доступности с оптимальным балансом усилий.

BatchOsDisk

Параметры диска операционной системы вычислительного узла (VM).

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

CachingType

Указывает требования к кэшированию. Возможные значения: None, ReadOnly, ReadWrite. Значения по умолчанию: нет для хранилища уровня "Стандартный". ReadOnly для хранилища Premium.

diskSizeGB

integer (int32)

Начальный размер диска в ГБ при создании нового диска ОС.

ephemeralOSDiskSettings

BatchDiffDiskSettings

Указывает временные параметры диска для диска операционной системы, используемого вычислительным узлом (vm).

managedDisk

ManagedDisk

Параметры управляемого диска.

writeAcceleratorEnabled

boolean

Указывает, следует ли включить или отключить записьAccelerator на диске.

BatchPoolEndpointConfiguration

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

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

BatchInboundNatPool[]

Список входящих NAT-пулов, которые могут использоваться для внешнего адресации конкретных портов на отдельном вычислительном узле. Максимальное количество входящих NAT пулов на один пакетный пул составляет 5. Если превышается максимальное количество входящих NAT-пулов, запрос неудачно с HTTP-кодом статуса 400. Это невозможно указать, если IPAddressProvisioningType — NoPublicIPAddresses.

BatchPoolIdentityReference

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

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

string (arm-id)

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

BatchPoolInfo

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

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

BatchAutoPoolSpecification

Характеристики временного «автопула». Пакетная служба создаст этот автоматический пул при отправке задания. Если создание автоматического пула не удаётся, пакетная служба переводит задание в состояние завершения, и ошибка создания пула устанавливается в свойстве ошибки планирования Job. Пакетная служба управляет сроком жизни (как созданием, так и, если не указано keepAlive, удалением) автопула. Любые действия пользователя, влияющие на срок службы автопула, пока работа активна, приведут к неожиданному поведению. Вам нужно указать либо Pool ID, либо спецификацию Auto Pool, но не оба.

poolId

string

ID существующего пула. Все задачи работы будут выполняться в указанном пуле. Вы должны убедиться, что пул, на который ссылается это свойство, существует. Если пула не существует в момент, когда пакетная служба пытается запланировать работу, то задачи для этой задачи не будут выполняться, пока вы не создадете пул с этим идентификатором. Обратите внимание, что пакетная служба не отклоняет запрос на задание; он просто не будет запускать задачи, пока не появится Пул. Вам нужно указать либо Pool ID, либо спецификацию Auto Pool, но не оба.

BatchPoolLifetimeOption

Enums BatchPoolLifetimeOption

Значение Описание
jobschedule

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

job

Бассейн существует на протяжении всей жизни Дела, которому он посвящён. Пакетный сервис создаёт пул, когда создаёт задание. Если опция 'job' применяется к расписанию заданий, пакетная служба создаёт новый автопул для каждой работы, созданной в расписании.

BatchPoolSpecification

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

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

BatchApplicationPackageReference[]

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

autoScaleEvaluationInterval

string (duration)

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

autoScaleFormula

string

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

displayName

string

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

enableAutoScale

boolean

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

enableInterNodeCommunication

boolean

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

metadata

BatchMetadataItem[]

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

mountConfiguration

MountConfiguration[]

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

networkConfiguration

NetworkConfiguration

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

resizeTimeout

string (duration)

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

startTask

BatchStartTask

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

targetDedicatedNodes

integer (int32)

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

targetLowPriorityNodes

integer (int32)

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

taskSchedulingPolicy

BatchTaskSchedulingPolicy

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

taskSlotsPerNode

integer (int32)

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

upgradePolicy

UpgradePolicy

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

userAccounts

UserAccount[]

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

virtualMachineConfiguration

VirtualMachineConfiguration

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

vmSize

string

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

BatchPublicIpAddressConfiguration

Конфигурация общедоступного IP-адреса конфигурации сети пула.

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

string[] (arm-id)

Список общедоступных IP-адресов, которые будет использоваться пакетной службой при подготовке вычислительных узлов. Количество IP-адресов, указанных здесь, ограничивает максимальный размер пула — 100 выделенных узлов или 100 узлов с низким приоритетом для каждого общедоступного IP-адреса. Например, для пула, нуждающегося в 250 выделенных виртуальных машинах, потребуется не менее 3 общедоступных IP-адресов. Каждый элемент этой коллекции имеет форму: /subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}.

ipFamilies

IPFamily[]

Семейства IP-адресов, используемые для указания версий IP-адресов, доступных для пула. Семейства IP-адресов используются для определения пулов с одним или двумя стеками. Для одного стека ожидаемое значение — IPv4. Для двойного стека ожидаемые значения — IPv4 и IPv6.

ipTags

IPTag[]

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

provision

IpAddressProvisioningType

Тип подготовки для общедоступных IP-адресов пула. Значение по умолчанию — BatchManaged.

BatchStartTask

Пакетная служба будет повторять задачи при активации операции восстановления на узле. Примеры операций восстановления включают (но не ограничиваются) при перезагрузке неработоспособного узла или вычислительном узле исчезли из-за сбоя узла. Повторные попытки из-за операций восстановления не учитываются и не учитываются для maxTaskRetryCount. Даже если значение maxTaskRetryCount равно 0, может произойти внутренняя повторная попытка из-за операции восстановления. Из-за этого все задачи должны быть идемпотентными. Это означает, что задачи должны терпеть прерывание и перезапуск без повреждения или дублирования данных. Рекомендуется использовать определенную форму контрольных точек для длительных задач. В некоторых случаях запуск StartTask может выполняться повторно, даже если вычислительный узел не был перезагружен. Следует учесть, чтобы избежать запуска StartTasks, создающих отсортовый процесс или установку или запуск служб из рабочего каталога StartTask, так как это приведет к тому, что пакетная служба сможет повторно запустить StartTask.

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

string

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

containerSettings

BatchTaskContainerSettings

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

environmentSettings

EnvironmentSetting[]

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

maxTaskRetryCount

integer (int32)

Максимальное количество повторных попыток задачи. Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 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.

BatchTaskConstraints

Ограничения выполнения для применения к задаче.

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

integer (int32)

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

maxWallClockTime

string (duration)

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

retentionTime

string (duration)

Минимальное время для сохранения каталога задачи на вычислительном узле, где он выполнялся, начинается с момента завершения выполнения. После этого времени пакетная служба может удалить каталог задач и всё её содержимое. По умолчанию — 7 дней, то есть каталог задач сохраняется в течение 7 дней, если только вычислительный узел не будет удален или задание не будет удалено.

BatchTaskContainerSettings

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

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

ContainerHostBatchBindMountEntry[]

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

containerRunOptions

string

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

imageName

string

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

registry

ContainerRegistryReference

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

workingDirectory

ContainerWorkingDirectory

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

BatchTaskFailureMode

Enums TaskFailure

Значение Описание
noaction

Никакие действия не выполняются. Работа остаётся активной, если не была уволена или отключена каким-либо другим способом.

performexitoptionsjobaction

Уволить работу. Причина прекращения работы установлена в «Все задачи выполнены».

BatchTaskSchedulingPolicy

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

Имя Тип Default value Описание
jobDefaultOrder

BatchJobDefaultOrder

none

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

nodeFillType

BatchNodeFillType

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

BatchUefiSettings

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

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

boolean

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

vTpmEnabled

boolean

Указывает, следует ли включить vTPM на виртуальной машине.

BatchVmDiskSecurityProfile

Задает параметры профиля безопасности для управляемого диска. Примечание: Он может быть установлен только для конфиденциальных виртуальных машин и необходим при использовании конфиденциальных виртуальных машин.

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

SecurityEncryptionTypes

Указывает тип шифрования управляемого диска. Он имеет значение VMGuestStateOnly для шифрования только большого двоичного объекта VMGuestState и NonPersistedTPM для сохранения состояния встроенного ПО в BLOB-объекте VMGuestState. Примечание: Он может быть установлен только для конфиденциальных виртуальных машин и требуется при использовании конфиденциальных виртуальных машин.

BatchVmImageReference

Ссылка на образ Azure Virtual Machines Marketplace или образ коллекции вычислений Azure. Чтобы получить список всех ссылок на образы Azure Marketplace, проверенных пакетной службой Azure, см. операцию "Список поддерживаемых образов".

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

string

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

exactVersion

string

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

offer

string

Тип предложения изображения Azure Virtual Machines Marketplace. Например, UbuntuServer или WindowsServer.

publisher

string

Издатель изображения Azure Virtual Machines Marketplace. Например, Canonical или MicrosoftWindowsServer.

sharedGalleryImageId

string

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

sku

string

SKU изображения Azure Virtual Machines Marketplace. Например, 18.04-LTS или 2019-Datacenter.

version

string

Версия изображения Azure Virtual Machines Marketplace. Для выбора последней версии изображения можно задать значение 'lastest'. Если опущено, значение по умолчанию — "последняя".

virtualMachineImageId

string (arm-id)

Идентификатор ресурса ARM образа коллекции вычислений Azure. Вычислительные узлы в пуле будут созданы с использованием этого идентификатора изображения. Это в виде /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} или /subscriptions/{subscriptionId}/resourceGroup/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} для постоянного выбора последней версии изображения. Это свойство взаимоисключается с другими свойствами ImageReference. Образ вычислительной галереи Azure должен иметь реплики в том же регионе и находиться в той же подписке, что и аккаунт Azure Batch. Если версия изображения не указана в imageId, будет использована последняя версия. Для получения информации о настройках межсетевого экрана для агента Batch Compute Node для взаимодействия с сервисом Batch см. https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

CachingType

Энумы CachingType

Значение Описание
none

Режим кэширования для диска не включен.

readonly

Режим кэширования для диска доступен только для чтения.

readwrite

Режим кэширования для диска считывается и записывается.

CifsMountConfiguration

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

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

string

Дополнительные параметры командной строки для передачи команде подключения. Это параметры "net use" в Windows и "подключение" в Linux.

password

string (password)

Пароль, используемый для проверки подлинности в файловой системе CIFS.

relativeMountPath

string

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

source

string

Универсальный код ресурса (URI) файловой системы для подключения.

username

string

Пользователь, используемый для проверки подлинности в файловой системе CIFS.

ContainerHostBatchBindMountEntry

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

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

boolean

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

source

ContainerHostDataPath

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

ContainerHostDataPath

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

Значение Описание
Shared

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

Startup

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

VfsMounts

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

Task

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

JobPrep

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

Applications

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

ContainerRegistryReference

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

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

BatchNodeIdentityReference

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

password

string (password)

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

registryServer

string (uri)

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

username

string

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

ContainerType

ContainerType enums

Значение Описание
dockerCompatible

Для запуска контейнеров будет использоваться технология совместимого контейнера Docker.

criCompatible

Технология на основе CRI будет использоваться для запуска контейнеров.

ContainerWorkingDirectory

ContainerWorkingDirectory enums

Значение Описание
taskWorkingDirectory

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

containerImageDefault

Используйте рабочую директорию, определённую в контейнере Image. Обратите внимание, что эта папка не будет содержать файлы ресурсов, загруженные Batch.

DataDisk

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

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

CachingType

Тип кэширования для дисков данных. Значение по умолчанию для кэширования — readwrite. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.

diskSizeGB

integer (int32)

Начальный размер диска в гигабайтах.

lun

integer (int32)

Номер логического блока. Параметр logicalUnitNumber используется для уникальной идентификации каждого диска данных. При присоединении нескольких дисков каждый должен иметь отдельный логический номерUnitNumber. Значение должно быть от 0 до 63 включительно.

managedDisk

ManagedDisk

Параметры управляемого диска.

storageAccountType

StorageAccountType

Тип учетной записи хранения, используемый для диска данных. Если опущено, значение по умолчанию — "standard_lrs".

DiffDiskPlacement

Задаёт эфемерное расположение диска для диска операционной системы для всех вычислительных узлов (VM) пула. Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение операционной системы. Например, кэшировать место на диске для подготовки диска Эфемеральной ОС. Для получения дополнительной информации о требованиях к размеру диска для эфемерных ОС, пожалуйста, обратитесь к требованиям к размеру диска для виртуальных машин Windows в и https://learn.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements для виртуальных машин Linux по адресу https://learn.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements

Значение Описание
cachedisk

Диск операционной системы в эфемерном режиме хранится в кэше виртуальной машины.

DiskCustomerManagedKey

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

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

BatchPoolIdentityReference

Ссылка на один из идентификаторов пула для шифрования диска. Это удостоверение будет использоваться для доступа к KeyVault.

keyUrl

string

Полный url-адрес ключа версии, указывающий на ключ в KeyVault. Сегмент версии URL-адреса требуется независимо от значения rotationToLatestKeyVersionEnabled.

rotationToLatestKeyVersionEnabled

boolean

Установите этот флаг в значение true, чтобы включить автоматическое обновление шифрования диска до последней версии ключа. По умолчанию — false.

DiskEncryptionConfiguration

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

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

DiskCustomerManagedKey

Ссылка на ключ, управляемый клиентом, для шифрования диска ОС. Ключ, управляемый клиентом, зашифрует диск ОС с помощью EncryptionAtRest, и по умолчанию мы также зашифруем диск с данными. Его можно использовать только в том случае, если пул настроен с помощью удостоверения и OsDisk установлен в качестве одного из целевых объектов DiskEncryption.

targets

DiskEncryptionTarget[]

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

DiskEncryptionSetParameters

Идентификатор ресурса ARM набора шифрования диска.

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

string (arm-id)

Идентификатор ресурса ARM набора шифрования диска. Ресурс должен находиться в той же подписке, что и аккаунт пакетной службы.

DiskEncryptionTarget

Enums DiskEncryptionTarget

Значение Описание
osdisk

Диск ОС на вычислительном узле шифруется.

temporarydisk

Временный диск на вычислительном узле шифруется. В Linux это шифрование применяется к другим секциям (например, на подключенных дисках данных) при выполнении шифрования во время загрузки.

DynamicVNetAssignmentScope

DynamicVNetAssignmentScope enums

Значение Описание
none

Динамическое назначение виртуальной сети не включено.

job

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

ElevationLevel

Enums ElevationLevel

Значение Описание
nonadmin

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

admin

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

EnvironmentSetting

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

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

string

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

value

string

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

HostEndpointSettings

Указывает определенные параметры конечной точки узла.

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

string

Указывает ссылку на идентификатор ресурса InVMAccessControlProfileVersion в виде /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}.

mode

HostEndpointSettingsModeTypes

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

HostEndpointSettingsModeTypes

HostEndpointSettingsModeTypes enums

Значение Описание
Audit

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

Enforce

Режим принудительного применения — рекомендуемый режим работы, и система будет применять политику контроля доступа. Это свойство нельзя использовать вместе с 'inVMAccessControlProfileReferenceId'.

InboundEndpointProtocol

Enums InboundEndpointProtocol

Значение Описание
tcp

Используйте TCP для конечной точки.

udp

Используйте UDP для конечной точки.

IpAddressProvisioningType

IPAddressProvisioningType enums

Значение Описание
batchmanaged

Общедоступный IP-адрес будет создан и управляется пакетной службой. В зависимости от размера пула может быть несколько общедоступных IP-адресов.

usermanaged

Общедоступные IP-адреса предоставляются пользователем и будут использоваться для подготовки вычислительных узлов.

nopublicipaddresses

Публичный IP-адрес не будет создан.

IPFamily

Семейства IP-адресов, используемые для указания версий IP-адресов, доступных для пула.

Значение Описание
IPv4

IPv4 доступен для пула.

IPv6

IPv6 доступен для пула.

IPTag

Содержит тег IP, связанный с общедоступным IP-адресом.

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

string

Тип IP-тега. Пример: FirstPartyUsage.

tag

string

Значение тега IP, связанного с общедоступным IP-адресом. Пример: SQL.

LinuxUserConfiguration

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

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

integer (int32)

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

sshPrivateKey

string (password)

Приватный ключ SSH для учётной записи пользователя. Закрытый ключ не должен быть защищен паролем. Приватный ключ используется для автоматической настройки асимметричной аутентификации на основе SSH между вычислительными узлами в Linux-пуле, когда свойство enableInterNodeCommunication пула верно (оно игнорируется, если enableInterNodeCommunication ошибочно). Для этого поместите пару ключей в каталог SSH пользователя. Если не указано, SSH без пароля не настраивается между вычислительными узлами (не изменяется каталог .ssh пользователя).

uid

integer (int32)

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

LoginMode

Enums LoginMode

Значение Описание
batch

Режим входа LOGON32_LOGON_BATCH Win32. Для длительных параллельных процессов рекомендуется использовать режим входа пакетной службы.

interactive

Режим входа LOGON32_LOGON_INTERACTIVE Win32. UAC включён в пулах конфигурации Windows VirtualMachineConfiguration. Если эта опция используется с повышенной пользовательской идентификацией в пуле конфигурации Windows VirtualMachine, пользовательская сессия не будет повышена, если приложение, выполняемое командной строкой задачи, не настроено так, чтобы всегда требовать административных прав или всегда требовать максимальные права.

ManagedDisk

Параметры управляемого диска.

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

DiskEncryptionSetParameters

Указывает идентификатор ресурса набора шифрования управляемых пользователем дисков для управляемого диска. Его можно установить только в режиме UserSubscription.

securityProfile

BatchVmDiskSecurityProfile

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

storageAccountType

StorageAccountType

Тип учетной записи хранения для управляемого диска.

MountConfiguration

Файловая система для подключения на каждом узле.

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

AzureBlobFileSystemConfiguration

Контейнер службы хранилища Azure для подключения с помощью FUSE BLOB-объектов на каждом узле. Это свойство является взаимоисключающим со всеми другими свойствами.

azureFileShareConfiguration

AzureFileShareConfiguration

Общая папка Azure для подключения к каждому узлу. Это свойство является взаимоисключающим со всеми другими свойствами.

cifsMountConfiguration

CifsMountConfiguration

Файловая система CIFS/SMB для подключения на каждом узле. Это свойство является взаимоисключающим со всеми другими свойствами.

nfsMountConfiguration

NfsMountConfiguration

Файловая система NFS для подключения на каждом узле. Это свойство является взаимоисключающим со всеми другими свойствами.

NameValuePair

Представляет пару "имя-значение".

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

string

Имя в паре имя-значение.

value

string

Значение в паре имя-значение.

NetworkConfiguration

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

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

DynamicVNetAssignmentScope

Область динамического назначения виртуальной сети.

enableAcceleratedNetworking

boolean

Следует ли включить ускоренную сеть в этом пуле. Ускорение сети обеспечивает виртуализацию одно корневых операций ввода-вывода (SR-IOV) к виртуальной машине, что может привести к повышению производительности сети. Дополнительные сведения см. в статье https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

endpointConfiguration

BatchPoolEndpointConfiguration

Конфигурация конечных точек на вычислительных узлах в пакетном пуле.

publicIPAddressConfiguration

BatchPublicIpAddressConfiguration

Конфигурация public IPAddress для вычислительных узлов в пуле пакетной службы.

subnetId

string

Идентификатор ресурса ARM подсети виртуальной сети, к которой присоединяются вычислительные узлы пула. Это форма /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}}. Виртуальная сеть должна находиться в том же регионе и подписке, что и учетная запись пакетной службы Azure. Указанная подсеть должна иметь достаточно свободных IP-адресов для размещения количества вычислительных узлов в пуле. Если в подсети недостаточно свободных IP-адресов, пул частично выделит узлы, и возникает ошибка изменения размера. Субъект-служба MicrosoftAzureBatch должна иметь роль "Участник классической виртуальной машины" Role-Based управление доступом (RBAC) для указанной виртуальной сети. Указанная подсеть должна обеспечивать связь с сервисом Azure Batch для планирования задач на узлах. Это можно проверить, проверьте, имеет ли указанная виртуальная сеть любые связанные группы безопасности сети (NSG). Если связь с узлами в указанной подсети запрещена группой безопасности сети, служба пакетной службы установит состояние вычислительных узлов неиспользуемым. Поддерживаются только виртуальные сети ARM ('Microsoft.Network/virtualNetworks'). Если в указанной VNet есть соответствующие группы сетевой безопасности (NSG), то для входящей связи необходимо включить несколько зарезервированных системных портов, включая порты 29876 и 29877. Также включите исходящие подключения к службе хранилища Azure через порт 443. Дополнительные сведения см. в статье https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRule

Правило группы безопасности сети для применения к входящей конечной точке.

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

NetworkSecurityGroupRuleAccess

Действие, которое следует предпринять для указанного IP-адреса, диапазона подсети или тега.

priority

integer (int32)

Приоритет для этого правила. Приоритеты внутри пула должны быть уникальными и оцениваться в порядке приоритета. Чем ниже число, тем выше приоритет. Например, правила можно указать с номерами заказов 150, 250 и 350. Правило с порядком 150 имеет приоритет над правилом, которое имеет порядок 250. Допустимые приоритеты — от 150 до 4096. Если указаны зарезервированные или повторяющиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400.

sourceAddressPrefix

string

Префикс исходного адреса или тег, соответствующий правилу. Допустимые значения — это один IP-адрес (например, 10.10.10.10), подсеть IP -адресов (т. е. 192.168.1.0/24), тег по умолчанию или * (для всех адресов). Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400.

sourcePortRanges

string[]

Диапазоны исходных портов, которые соответствуют правилу. Допустимые значения — '' (для всех портов 0 - 65535), конкретный порт (например, 22) или диапазон портов (например, 100-200). Порты должны находиться в диапазоне от 0 до 65535. Каждая запись в этой коллекции не должна пересекаться с какими-либо другими записями (ни с линейкой, ни с отдельным портом). Если указаны другие значения, запрос не проходит с HTTP-кодом статуса 400. Значение по умолчанию — ''.

NetworkSecurityGroupRuleAccess

NetworkSecurityGroupRuleAccess enums

Значение Описание
allow

Разрешить доступ.

deny

Запретить доступ.

NfsMountConfiguration

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

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

string

Дополнительные параметры командной строки для передачи команде подключения. Это параметры "net use" в Windows и "подключение" в Linux.

relativeMountPath

string

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

source

string

Универсальный код ресурса (URI) файловой системы для подключения.

OutputFile

При каждой отправке файлов пакетная служба записывает два файла журнала на вычислительный узелfileuploadout.txtиfileuploaderr.txt. Эти файлы журналов используются для получения дополнительных сведений о конкретном сбое.

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

OutputFileDestination

Пункт назначения для выходных файлов.

filePattern

string

Шаблон, указывающий, какие файлы загружать. Поддерживаются как относительные, так и абсолютные пути. Относительные пути относятся к рабочему каталогу задач. Поддерживаются следующие джокеры: * совпадает с 0 или более символами (например, шаблон abc* совпадает с abc или abcdef), ** совпадает с любой каталогом, ? совпадает с любым символом, [ABC] совпадает с одним символом в скобках, а [a-c] совпадает с одним символом в диапазоне. В скобках может быть отрицание, соответствующее любому символу, не указанному (например, [!abc] совпадает с любым символом, кроме a, b или c). Если имя файла начинается с «.», оно по умолчанию игнорируется, но может быть сопоставлено явным указанием ( например,.gif не будет совпадать с .a.gif, а.gif будет совпадать ). Простой пример: ***.txt совпадает с любым файлом, который не начинается с '.' и заканчивается .txt в рабочем каталоге задачи или любом подкаталоге. Если имя файла содержит джокер-символ, его можно скрыть с помощью скобок (например, abc[] совпадёт с файлом с названием abc). Обратите внимание, что и \, и / рассматриваются как разделители каталогов в Windows, но только / есть в Linux. Переменные окружения (%var% в Windows или $var на Linux) расширяются до применения паттерна.

uploadOptions

OutputFileUploadConfig

Дополнительные опции для загрузки, включая условия для загрузки.

OutputFileBlobContainerDestination

Указывает назначение отправки файлов в контейнере хранилища BLOB-объектов Azure.

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

string (uri)

URL контейнера в Azure Blob Storage, куда можно загрузить файл(ы). Если не используется управляемая идентичность, URL должен содержать подпись общего доступа (SAS), предоставляющая разрешения на запись контейнера.

identityReference

BatchNodeIdentityReference

Ссылка на назначенную пользователю идентичность для доступа к Azure Blob Storage, указанной в containerUrl. Идентичность должна иметь доступ к записи в контейнер хранения Azure Blob.

path

string

Целевой blob или виртуальный каталог внутри контейнера Azure Storage. Если filePattern относится к конкретному файлу (то есть не содержит джокеров), то path — это название blob, в который нужно загрузить этот файл. Если filePattern содержит один или несколько диких карт (и, следовательно, может совпадать с несколькими файлами), то path — это название виртуальной папки blob (которая предупреждается к именю каждого blob), куда можно загрузить файл(и). Если файлы опущены, файл(ы) загружаются в корень контейнера с именем blob, соответствующим их имени.

uploadHeaders

OutputFileUploadHeader[]

Список пар имя-значение для заголовков, используемых при загрузке выходных файлов. Эти заголовки будут указаны при загрузке файлов в Azure Storage. Официальный документ о разрешённых заголовках при загрузке blobs: https://learn.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types.

OutputFileDestination

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

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

OutputFileBlobContainerDestination

Место в хранилище Azure blob, куда загружаются файлы.

OutputFileUploadCondition

Enums OutputFileUploadCondition

Значение Описание
tasksuccess

Загружайте файл(ы) только после выхода процесса задачи с кодом выхода 0.

taskfailure

Загружайте файл(ы) только после выхода процесса задачи с ненулевой кодом выхода.

taskcompletion

Загрузите файл(ы) после завершения процесса задачи, независимо от кода выхода.

OutputFileUploadConfig

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

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

OutputFileUploadCondition

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

OutputFileUploadHeader

Пара "Имя-значение" заголовка HTTP

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

string

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

value

string

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

ProxyAgentSettings

Задает параметры ProxyAgent при создании виртуальной машины.

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

boolean

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

imds

HostEndpointSettings

Настройки для конечной точки IMDS.

wireServer

HostEndpointSettings

Параметры конечной точки WireServer.

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 (uri)

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

identityReference

BatchNodeIdentityReference

Ссылка на идентификатор, назначенную пользователю для доступа к Azure Blob Storage, указанную в storageContainerUrl или httpUrl.

storageContainerUrl

string (uri)

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

RollingUpgradePolicy

Параметры конфигурации, используемые при выполнении последовательного обновления.

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

boolean

Разрешить VMSS игнорировать границы AZ при создании пакетов обновления. Учитывайте домен обновления и maxBatchInstancePercent, чтобы определить размер пакета. Это поле может иметь значение true или false только при использовании NodePlacementConfiguration в качестве зонального.

maxBatchInstancePercent

integer (int32)

Максимальный процент общих экземпляров виртуальных машин, которые будут обновляться одновременно путем последовательного обновления в одном пакете. Так как это максимальный, неработоспособные экземпляры в предыдущих или будущих пакетах могут привести к снижению процента экземпляров в пакете, чтобы обеспечить более высокую надежность. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent.

maxUnhealthyInstancePercent

integer (int32)

Максимальный процент всех экземпляров виртуальных машин в масштабируемом наборе, которые могут быть одновременно неработоспособными, либо в результате обновления, либо путем обнаружения в неработоспособном состоянии проверки работоспособности виртуальной машины до завершения последовательного обновления. Это ограничение будет проверено перед запуском любого пакета. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent.

maxUnhealthyUpgradedInstancePercent

integer (int32)

Максимальный процент обновленных экземпляров виртуальных машин, которые можно найти в неработоспособном состоянии. Эта проверка произойдет после обновления каждого пакета. Если этот процент когда-либо превышается, последовательное обновление прерывается. Значение этого поля должно быть от 0 до 100 включительно.

pauseTimeBetweenBatches

string (duration)

Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601..

prioritizeUnhealthyInstances

boolean

Обновите все неработоспособные экземпляры в масштабируемом наборе до всех здоровых экземпляров.

rollbackFailedInstancesOnPolicyBreach

boolean

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

SecurityEncryptionTypes

Enums SecurityEncryptionTypes

Значение Описание
DiskWithVMGuestState

Для параметра EncryptionType управляемого диска задано значение DiskWithVMGuestState для шифрования управляемого диска вместе с большим двоичным объектом VMGuestState. Он не поддерживается в дисках с данными.

NonPersistedTPM

Для параметра EncryptionType управляемого диска задано значение NonPersistedTPM, чтобы состояние встроенного ПО не сохранялось в большом двоичном объекте VMGuestState.

VMGuestStateOnly

Для параметра EncryptionType управляемого диска задано значение VMGuestStateOnly для шифрования только большого двоичного объекта VMGuestState.

SecurityProfile

Задает параметры профиля безопасности для масштабируемого набора виртуальных машин или виртуальной машины.

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

boolean

Это свойство можно использовать пользователем в запросе, чтобы включить или отключить шифрование узла для виртуальной машины или масштабируемого набора виртуальных машин. Это позволит включить шифрование для всех дисков, включая диск Resource/Temp на самом узле. Дополнительные сведения о шифровании в требованиях к узлам см. в https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes.

proxyAgentSettings

ProxyAgentSettings

Задает параметры ProxyAgent при создании виртуальной машины.

securityType

SecurityTypes

Указывает тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение.

uefiSettings

BatchUefiSettings

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

SecurityTypes

Указывает тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение.

Значение Описание
trustedLaunch

Доверенный запуск защищает от сложных и постоянных атак.

confidentialvm

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

ServiceArtifactReference

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

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

string

Идентификатор ссылки на сервисный артефакт в ServiceArtifactReference. Идентификатор ссылки на артефакт службы в виде /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

StorageAccountType

Перечисления StorageAccountType

Значение Описание
standard_lrs

Диск данных должен использовать стандартное локально избыточное хранилище.

premium_lrs

Диск данных должен использовать локально избыточное хранилище класса "Премиум".

standardssd_lrs

Диск данных или диск ОС должен использовать локально избыточное хранилище SSD уровня "Стандартный".

UpgradeMode

Enums UpgradeMode

Значение Описание
automatic

Все виртуальные машины в масштабируемом наборе автоматически обновляются одновременно.

manual

Вы управляете применением обновлений для виртуальных машин в масштабируемом наборе. Это можно сделать с помощью действия manualUpgrade.

rolling

Существующие экземпляры в масштабируемом наборе удаляются в пакетах для обновления. После завершения обновленного пакета экземпляры начнут принимать трафик снова, а следующий пакет начнется. Это продолжается до тех пор, пока все экземпляры не будут доставлены up-to-date.

UpgradePolicy

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

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

AutomaticOsUpgradePolicy

Параметры конфигурации, используемые для автоматического обновления ОС. Параметры конфигурации, используемые для автоматического обновления ОС.

mode

UpgradeMode

Задает режим обновления до виртуальных машин в масштабируемом наборе.

Возможны следующие значения:

вручную. Вы управляете приложением обновлений виртуальных машин в масштабируемом наборе. Это можно сделать с помощью действия manualUpgrade.

автоматическое. Все виртуальные машины в масштабируемом наборе автоматически обновляются одновременно.

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

rollingUpgradePolicy

RollingUpgradePolicy

Параметры конфигурации, используемые при выполнении последовательного обновления.

UserAccount

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

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

ElevationLevel

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

linuxUserConfiguration

LinuxUserConfiguration

Конфигурация пользователя, специфичная для Linux, для учетной записи пользователя. Это свойство игнорируется, если оно указано в пуле Windows. Если это не указано, пользователь создается с параметрами по умолчанию.

name

string

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

password

string (password)

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

windowsUserConfiguration

WindowsUserConfiguration

Настройка пользователя, специфичная для Windows, для учетной записи пользователя. Это свойство можно задать только если пользователь находится в Windows-пуле. Если это не указано и находится в Пуле Windows, пользователь создаётся с настройками по умолчанию.

UserIdentity

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

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

AutoUserSpecification

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

username

string

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

VirtualMachineConfiguration

Конфигурация вычислительных узлов в пуле на основе инфраструктуры виртуальных машин Azure.

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

BatchContainerConfiguration

Конфигурация контейнера для пула. Если указано, настройка выполняется на каждом вычислительном узле пула, чтобы задачи могли выполняться в контейнерах. Все обычные задачи и задачи менеджера заданий, выполняемые в этом пуле, должны указывать свойство containerSettings, и все остальные задачи могут его указывать.

dataDisks

DataDisk[]

Конфигурация для дисков данных, подключённых к вычислительным узлам в пуле. Это свойство должно быть указано, если вычислительные узлы пула должны иметь пустые диски с данными. Это невозможно обновить. Каждый вычислительный узел получает свой собственный диск (диск не является файловым ресурсом). Существующие диски нельзя подключить, каждый подключённый диск пуст. Когда вычислительный узел удаляется из пула, диск и все связанные с ним данные также удаляются. Диск не форматируется после прикрепления, его необходимо отформатировать до использования — для получения дополнительной информации см. https://learn.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux и https://learn.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine.

diskEncryptionConfiguration

DiskEncryptionConfiguration

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

extensions

VMExtension[]

Расширение виртуальной машины для пула. При указании расширения, упомянутые в этой конфигурации, будут установлены на каждом узле.

imageReference

BatchVmImageReference

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

licenseType

string

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

Windows_Server . Локальная лицензия предназначена для Windows Server. Windows_Client . Локальная лицензия предназначена для клиента Windows.

nodeAgentSKUId

string

Номер SKU агента пакетного вычислительного узла для подготовки на вычислительных узлах в пуле. Агент пакетного вычислительного узла — это программа, которая выполняется на каждом вычислительном узле в пуле, а также предоставляет интерфейс управления между вычислительным узлом и пакетной службой. Существуют различные реализации агента вычислительного узла, известного как номера SKU для разных операционных систем. Необходимо указать номер SKU агента вычислительного узла, соответствующий выбранной ссылке на изображение. Чтобы получить список поддерживаемых номеров SKU агента вычислительных узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых номеров SKU агента вычислительных узлов".

nodePlacementConfiguration

BatchNodePlacementConfiguration

Конфигурация размещения узлов для пула. Эта конфигурация будет указывать правила по тому, как узлы в пуле будут физически выделены.

osDisk

BatchOsDisk

Параметры диска операционной системы виртуальной машины.

securityProfile

SecurityProfile

Задает параметры профиля безопасности для масштабируемого набора виртуальных машин или виртуальной машины.

serviceArtifactReference

ServiceArtifactReference

Указывает идентификатор ссылки на артефакт службы, используемый для задания одной версии образа для всех виртуальных машин в масштабируемом наборе при использовании последней версии образа. Идентификатор ссылки на артефакт службы в виде /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

windowsConfiguration

WindowsConfiguration

Параметры операционной системы Windows на виртуальной машине. Это свойство не должно указываться, если imageReference указывает образ ОС Linux.

VMExtension

Конфигурация расширений виртуальных машин.

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

boolean

Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true.

enableAutomaticUpgrade

boolean

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

name

string

Имя расширения виртуальной машины.

protectedSettings

object

Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров.

provisionAfterExtensions

string[]

Коллекция имен расширений. Коллекция имен расширений, после которой необходимо подготовить это расширение.

publisher

string

Имя издателя обработчика расширений.

settings

object

Форматированные общедоступные параметры JSON для расширения.

type

string

Тип расширения.

typeHandlerVersion

string

Версия обработчика скрипта.

WindowsConfiguration

Параметры операционной системы Windows для применения к виртуальной машине.

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

boolean

Включена ли автоматическая установка обновлений на виртуальной машине. Если опущено, значение по умолчанию имеет значение true.

WindowsUserConfiguration

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

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

LoginMode

Режим входа для пользователя. По умолчанию — «пакет».