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


Пакетная служба Microsoft.BatchAccounts/пулы

Определение ресурсов Bicep

Тип ресурса batchAccounts/пулов можно развернуть с помощью операций, предназначенных для следующих операций:

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

Формат ресурса

Чтобы создать ресурс Microsoft.Batch/batchAccounts/pools, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2024-07-01' = {
  parent: resourceSymbolicName
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  name: 'string'
  properties: {
    applicationLicenses: [
      'string'
    ]
    applicationPackages: [
      {
        id: 'string'
        version: 'string'
      }
    ]
    certificates: [
      {
        id: 'string'
        storeLocation: 'string'
        storeName: 'string'
        visibility: [
          'string'
        ]
      }
    ]
    deploymentConfiguration: {
      virtualMachineConfiguration: {
        containerConfiguration: {
          containerImageNames: [
            'string'
          ]
          containerRegistries: [
            {
              identityReference: {
                resourceId: 'string'
              }
              password: 'string'
              registryServer: 'string'
              username: 'string'
            }
          ]
          type: 'string'
        }
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        diskEncryptionConfiguration: {
          targets: [
            'string'
          ]
        }
        extensions: [
          {
            autoUpgradeMinorVersion: bool
            enableAutomaticUpgrade: bool
            name: 'string'
            protectedSettings: any(...)
            provisionAfterExtensions: [
              'string'
            ]
            publisher: 'string'
            settings: any(...)
            type: 'string'
            typeHandlerVersion: 'string'
          }
        ]
        imageReference: {
          communityGalleryImageId: 'string'
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sharedGalleryImageId: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        nodePlacementConfiguration: {
          policy: 'string'
        }
        osDisk: {
          caching: 'string'
          diskSizeGB: int
          ephemeralOSDiskSettings: {
            placement: 'CacheDisk'
          }
          managedDisk: {
            securityProfile: {
              securityEncryptionType: 'string'
            }
            storageAccountType: 'string'
          }
          writeAcceleratorEnabled: bool
        }
        securityProfile: {
          encryptionAtHost: bool
          securityType: 'string'
          uefiSettings: {
            secureBootEnabled: bool
            vTpmEnabled: bool
          }
        }
        serviceArtifactReference: {
          id: 'string'
        }
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    mountConfiguration: [
      {
        azureBlobFileSystemConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          blobfuseOptions: 'string'
          containerName: 'string'
          identityReference: {
            resourceId: 'string'
          }
          relativeMountPath: 'string'
          sasKey: 'string'
        }
        azureFileShareConfiguration: {
          accountKey: 'string'
          accountName: 'string'
          azureFileUrl: 'string'
          mountOptions: 'string'
          relativeMountPath: 'string'
        }
        cifsMountConfiguration: {
          mountOptions: 'string'
          password: 'string'
          relativeMountPath: 'string'
          source: 'string'
          userName: 'string'
        }
        nfsMountConfiguration: {
          mountOptions: 'string'
          relativeMountPath: 'string'
          source: 'string'
        }
      }
    ]
    networkConfiguration: {
      dynamicVnetAssignmentScope: 'string'
      enableAcceleratedNetworking: bool
      endpointConfiguration: {
        inboundNatPools: [
          {
            backendPort: int
            frontendPortRangeEnd: int
            frontendPortRangeStart: int
            name: 'string'
            networkSecurityGroupRules: [
              {
                access: 'string'
                priority: int
                sourceAddressPrefix: 'string'
                sourcePortRanges: [
                  'string'
                ]
              }
            ]
            protocol: 'string'
          }
        ]
      }
      publicIPAddressConfiguration: {
        ipAddressIds: [
          'string'
        ]
        provision: 'string'
      }
      subnetId: 'string'
    }
    resourceTags: {
      {customized property}: 'string'
    }
    scaleSettings: {
      autoScale: {
        evaluationInterval: 'string'
        formula: 'string'
      }
      fixedScale: {
        nodeDeallocationOption: 'string'
        resizeTimeout: 'string'
        targetDedicatedNodes: int
        targetLowPriorityNodes: int
      }
    }
    startTask: {
      commandLine: 'string'
      containerSettings: {
        containerHostBatchBindMounts: [
          {
            isReadOnly: bool
            source: 'string'
          }
        ]
        containerRunOptions: 'string'
        imageName: 'string'
        registry: {
          identityReference: {
            resourceId: 'string'
          }
          password: 'string'
          registryServer: 'string'
          username: 'string'
        }
        workingDirectory: 'string'
      }
      environmentSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      maxTaskRetryCount: int
      resourceFiles: [
        {
          autoStorageContainerName: 'string'
          blobPrefix: 'string'
          fileMode: 'string'
          filePath: 'string'
          httpUrl: 'string'
          identityReference: {
            resourceId: 'string'
          }
          storageContainerUrl: 'string'
        }
      ]
      userIdentity: {
        autoUser: {
          elevationLevel: 'string'
          scope: 'string'
        }
        userName: 'string'
      }
      waitForSuccess: bool
    }
    targetNodeCommunicationMode: 'string'
    taskSchedulingPolicy: {
      nodeFillType: 'string'
    }
    taskSlotsPerNode: int
    upgradePolicy: {
      automaticOSUpgradePolicy: {
        disableAutomaticRollback: bool
        enableAutomaticOSUpgrade: bool
        osRollingUpgradeDeferral: bool
        useRollingUpgradePolicy: bool
      }
      mode: 'string'
      rollingUpgradePolicy: {
        enableCrossZoneUpgrade: bool
        maxBatchInstancePercent: int
        maxUnhealthyInstancePercent: int
        maxUnhealthyUpgradedInstancePercent: int
        pauseTimeBetweenBatches: 'string'
        prioritizeUnhealthyInstances: bool
        rollbackFailedInstancesOnPolicyBreach: bool
      }
    }
    userAccounts: [
      {
        elevationLevel: 'string'
        linuxUserConfiguration: {
          gid: int
          sshPrivateKey: 'string'
          uid: int
        }
        name: 'string'
        password: 'string'
        windowsUserConfiguration: {
          loginMode: 'string'
        }
      }
    ]
    vmSize: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

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

Microsoft.Batch/batchAccounts/пулы

Имя Описание Ценность
тождество Тип удостоверения, используемого для пула пакетной службы. BatchPoolIdentity (Идентификация BatchPool)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 1
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9_-]+$ (обязательно)
родитель В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

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

ApplicationPackageReference

Имя Описание Ценность
идентификатор Идентификатор устанавливаемого пакета приложения. Это должно находиться внутри той же учетной записи пакетной службы, что и пул. Это может быть ссылка на определенную версию или версию по умолчанию, если она существует. строка (обязательно)
Версия Если это опущено, и для этого приложения не указана версия по умолчанию, запрос завершается сбоем с кодом ошибки InvalidApplicationPackageReferences. Если вы вызываете REST API напрямую, код состояния HTTP равен 409. струна

АвтоматическиOSUpgradePolicy

Имя Описание Ценность
disableAutomaticRollback Следует ли отключить функцию отката образа ОС. булевая переменная (bool)
enableAutomaticOSУпгрейд Указывает, следует ли автоматически применять обновления ОС к экземплярам масштабируемого набора в последовательном режиме, когда становится доступной более новая версия образа ОС.

Если для пулов windows задано значение true, WindowsConfiguration.enableAutomaticUpdates не может быть задано значение true.
булевая переменная (bool)
osRollingUpgradeDeferral Отложить обновление ОС на телевизорах, если они выполняют задачи. булевая переменная (bool)
useRollingUpgradePolicy Указывает, следует ли использовать политику последовательного обновления во время автоматического обновления ОС. Автоматическое обновление ОС откатится к политике по умолчанию, если политика не определена в VMSS. булевая переменная (bool)

АвтомасштабированиеSettings

Имя Описание Ценность
оценкаИнтервал Если опущено, значение по умолчанию — 15 минут (PT15M). струна
формула Формула для требуемого количества вычислительных узлов в пуле. строка (обязательно)

Спецификация AutoUserSpecification

Имя Описание Ценность
elevationLevel Значение по умолчанию — nonAdmin. "Администратор"
«Не-администратор»
размах Значением по умолчанию является пул. Если пул работает под управлением Windows, необходимо указать значение задачи, если требуется более строгая изоляция между задачами. Например, если задача мутирует реестр таким образом, что может повлиять на другие задачи, или если сертификаты были указаны в пуле, который не должен быть доступен обычными задачами, но должен быть доступен путем запуска задач. "Пул"
"Задача"

AzureBlobFileSystemConfiguration

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

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
Имя аккаунта Имя учетной записи хранения Azure. строка (обязательно)
blobfuseOptions Это параметры "net use" в Windows и "подключение" в Linux. струна
имяКонтейнера Имя контейнера хранилища BLOB-объектов Azure. строка (обязательно)
Справочная информация об идентичности Это свойство является взаимоисключающим как с accountKey, так и sasKey; необходимо указать именно один. Справочник по идентичности вычислительного узла
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
sasKey Это свойство является взаимоисключающим как с accountKey, так и с удостоверением; необходимо указать именно один. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.

Конфигурация AzureFileShare

Имя Описание Ценность
accountKey Ключ учетной записи хранения Azure. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
Имя аккаунта Имя учетной записи хранения Azure. строка (обязательно)
azureFileUrl Это форма "https://{account}.file.core.windows.net/". строка (обязательно)
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)

AzureProxyResourceTags

Имя Описание Ценность

BatchPoolIdentity (Идентификация BatchPool)

Имя Описание Ценность
тип Тип удостоверения, используемого для пула пакетной службы. "Нет"
UserAssigned (обязательно)
ИдентичностиНазначенныеПользователем Список удостоверений пользователей, связанных с пулом пакетной службы. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Имя Описание Ценность

СертификатСсылка

Имя Описание Ценность
идентификатор Полный идентификатор сертификата для установки в пуле. Это должно находиться внутри той же учетной записи пакетной службы, что и пул. строка (обязательно)
Местоположение магазина Значение по умолчанию — currentUser. Это свойство применимо только для пулов, настроенных с вычислительными узлами Windows. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочих каталогов задач, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. CurrentUser
LocalMachine
название магазина Это свойство применимо только для пулов, настроенных с вычислительными узлами Windows. Распространенные имена хранилищ: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, но любое пользовательское имя хранилища также можно использовать. Значением по умолчанию является My. струна
видимость Какие учетные записи пользователей на вычислительном узле должны иметь доступ к частным данным сертификата. Массив строк, содержащий любой из:
RemoteUser
StartTask
"Задача"

Конфигурация CifsMount

Имя Описание Ценность
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
пароль Пароль, используемый для проверки подлинности в файловой системе CIFS. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
источник Универсальный код ресурса (URI) файловой системы для подключения. строка (обязательно)
userName Пользователь, используемый для проверки подлинности в файловой системе CIFS. строка (обязательно)

Справочник по идентичности вычислительного узла

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

ContainerConfiguration (Конфигурация контейнера)

Имя Описание Ценность
containerImageNames Это полная ссылка на изображение, как было бы указано для параметра docker pull. Образ будет получен из реестра Docker по умолчанию, если образ не является полным с альтернативным реестром. строка[]
containerRegistries Если какие-либо образы должны быть загружены из частного реестра, для которого требуются учетные данные, эти учетные данные должны быть предоставлены здесь. ContainerRegistry[]
тип Используемая технология контейнера. «Совместимость с CriCompatible»
DockerCompatible (обязательный)

ContainerHostBatchBindMountEntry

Имя Описание Ценность
isReadOnly Если вы подключаете этот путь как режим чтения и записи, это не означает, что у всех пользователей в контейнере есть доступ на чтение и запись для пути, он зависит от доступа на виртуальной машине узла. Если этот путь подключен только для чтения, все пользователи в контейнере не смогут изменить путь. булевая переменная (bool)
источник Пути, которые будут подключены к контейнеру задачи контейнера. "Приложения"
JobPrep
"Общий"
"Startup"
"Задача"
"VfsMounts"

ContainerRegistry (ContainerRegistry)

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

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
сервер реестра Если опущено, значение по умолчанию — "docker.io". струна
имя пользователя Имя пользователя для входа на сервер реестра. струна

ДатаДиск

Имя Описание Ценность
Кэширование Значения:

none — режим кэширования для диска не включен.
readOnly — режим кэширования для диска доступен только для чтения.
readWrite — режим кэширования для диска считывается и записывается.

Значение по умолчанию для кэширования не имеет значения. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Нет"
"ReadOnly"
ReadWrite
Размер дискаГб Начальный размер диска в ГБ при создании нового диска данных. int (обязательно)
Лунь Луна используется для уникальной идентификации каждого диска данных. При подключении нескольких дисков каждый должен иметь отдельную луну. Значение должно быть от 0 до 63 включительно. int (обязательно)
Тип учетной записи хранилища Если опущено, значение по умолчанию — "Standard_LRS". Значения:

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

РазвертываниеКонфигурация

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

DiffDiskSettings (Настройки DiffDisk)

Имя Описание Ценность
размещение Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение операционной системы. Например, кэшировать место на диске для подготовки диска Эфемеральной ОС. Дополнительные сведения о требованиях к размеру диска в Эфемеральной ОС см. в разделе "Требования к размеру диска операционной системы" для виртуальных машин Windows в разделе /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements и виртуальных машин Linux в /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. CacheDisk

DiskEncryptionConfiguration (Настройка дискового шифрования)

Имя Описание Ценность
Цели В пуле Linux поддерживается только временныйdisk; В пуле Windows необходимо указать "OsDisk" и "TemporaryDisk". Массив строк, содержащий любой из:
OsDisk
"ВременныйDisk"

Окружающая средаНастройка

Имя Описание Ценность
имя Имя переменной среды. строка (обязательно)
ценность Значение переменной среды. струна

ФиксированныеScaleSettings

Имя Описание Ценность
nodeDeallocationOption Если опущено, значение по умолчанию — Requeue. "Requeue"
"СохранитьedData"
TaskCompletion
"Завершение"
resizeTimeout Значение по умолчанию — 15 минут. Значения времени ожидания используют формат ISO 8601. Например, используйте PT10M в течение 10 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, служба пакетной службы отклоняет запрос с ошибкой; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос). струна
targetDedicatedNodes По крайней мере один из целевыхDedicatedNodes, необходимо задать targetLowPriorityNodes. инт
targetLowPriorityNodes По крайней мере один из целевыхDedicatedNodes, необходимо задать targetLowPriorityNodes. инт

Ссылка на изображение

Имя Описание Ценность
communityGalleryImageId Это свойство является взаимоисключающим с другими свойствами и может быть получено из вызова GET коллекции сообщества. струна
идентификатор Это свойство является взаимоисключающим с другими свойствами. Образ коллекции вычислений Azure должен иметь реплики в том же регионе, что и учетная запись пакетной службы Azure. Сведения о параметрах брандмауэра для агента узла пакетной службы для взаимодействия с пакетной службой см. в статье /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. струна
предлагать Например, UbuntuServer или WindowsServer. струна
издатель Например, Canonical или MicrosoftWindowsServer. струна
sharedGalleryImageId Это свойство является взаимоисключающим с другими свойствами и может быть получено из вызова GET образа общей коллекции. струна
SKU Например, 18.04-LTS или 2022-datacenter. струна
Версия Чтобы выбрать последнюю версию образа, можно указать значение "последняя". Если опущено, значение по умолчанию — "последняя". струна

Входящий NatPool (Входящий NatPool)

Имя Описание Ценность
серверный порт Это должно быть уникальным в пуле пакетной службы. Допустимые значения : от 1 до 65535, за исключением 29876 и 29877, так как они зарезервированы. Если указаны зарезервированные значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
frontendPortRangeEnd Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, зарезервированных пакетной службой. Все диапазоны в пуле должны быть уникальными и не могут перекрываться. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
frontendPortRangeStart Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, которые зарезервированы. Все диапазоны в пуле должны быть уникальными и не могут перекрываться. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
имя Имя должно быть уникальным в пуле пакетной службы, может содержать буквы, цифры, подчеркивания, периоды и дефисы. Имена должны начинаться с буквы или числа, заканчиваться буквой, числом или подчеркиванием и не может превышать 77 символов. Если указаны недопустимые значения, запрос завершается ошибкой с кодом состояния HTTP 400. строка (обязательно)
networkSecurityGroupRules Максимальное количество правил, которые можно указать во всех конечных точках в пуле пакетной службы, равно 25. Если правила группы безопасности сети не указаны, будет создано правило по умолчанию, чтобы разрешить входящий доступ к указанному внутреннему порту. Если максимальное число правил группы безопасности сети превышается, запрос завершается ошибкой с кодом состояния HTTP 400. Правило NetworkSecurityGroup[]
протокол Протокол конечной точки. "TCP"
UDP (обязательно)

LinuxUserConfiguration

Имя Описание Ценность
гид Свойства пользовательского интерфейса и gid должны быть указаны вместе или не вообще. Если не указана базовая операционная система, выбирает гиб. инт
sshPrivateKey Закрытый ключ не должен быть защищен паролем. Закрытый ключ используется для автоматической настройки асимметричной проверки подлинности на основе ключа для SSH между узлами в пуле Linux, если свойство enableInterNodeCommunication пула имеет значение true (оно игнорируется, если enableInterNodeCommunication имеет значение false). Для этого поместите пару ключей в каталог SSH пользователя. Если он не указан, SSH без пароля не настроен между узлами (не выполняется изменение каталога SSH пользователя). струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
уникальный идентификатор (УИД) Свойства пользовательского интерфейса и gid должны быть указаны вместе или не вообще. Если базовая операционная система не указана, выбирает пользовательский интерфейс. инт

Управляемый диск

Имя Описание Ценность
securityProfile Задает параметры профиля безопасности для управляемого диска. примечание. Оно может быть задано только для конфиденциальных виртуальных машин и требуется при использовании конфиденциальных виртуальных машин. VMDiskSecurityProfile
Тип учетной записи хранилища Тип учетной записи хранения для создания дисков данных или диска ОС. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

МетаdataItem (МетаданныеItem)

Имя Описание Ценность
имя Имя элемента метаданных. строка (обязательно)
ценность Значение элемента метаданных. строка (обязательно)

МонтированиеКонфигурация

Имя Описание Ценность
azureBlobFileSystemConfiguration Это свойство является взаимоисключающим со всеми другими свойствами. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Это свойство является взаимоисключающим со всеми другими свойствами. Конфигурация AzureFileShare
Конфигурация cifsMount Это свойство является взаимоисключающим со всеми другими свойствами. Конфигурация CifsMount
Конфигурация nfsMount Это свойство является взаимоисключающим со всеми другими свойствами. NFSMountConfiguration

Сетевая конфигурация

Имя Описание Ценность
DynamicVnetAssignmentScope Область динамического назначения виртуальной сети. «Работа»
"нет"
enableAcceleratedNetworking Ускорение сети обеспечивает виртуализацию одно корневых операций ввода-вывода (SR-IOV) к виртуальной машине, что может привести к повышению производительности сети. Дополнительные сведения см. в статье /azure/virtual-network/accelerated-networking-overview. булевая переменная (bool)
конечная точкаКонфигурация Конфигурация конечной точки для пула. PoolEndpointConfiguration (Конфигурация пулаEndpoint)
publicIPAddressConfiguration Конфигурация общедоступного IP-адреса конфигурации сети пула. PublicIPAddressConfiguration (ПубличныйIPAddressConfiguration)
SubnetId Виртуальная сеть должна находиться в том же регионе и подписке, что и учетная запись пакетной службы Azure. Указанная подсеть должна иметь достаточно свободных IP-адресов для размещения количества узлов в пуле. Если подсеть не имеет достаточно свободных IP-адресов, пул частично выделяет вычислительные узлы и возникнет ошибка изменения размера. Субъект-служба MicrosoftAzureBatch должна иметь роль "Участник классической виртуальной машины" Role-Based управление доступом (RBAC) для указанной виртуальной сети. Указанная подсеть должна разрешить обмен данными из пакетной службы Azure, чтобы иметь возможность планировать задачи на вычислительных узлах. Это можно проверить, проверьте, имеет ли указанная виртуальная сеть любые связанные группы безопасности сети (NSG). Если связь с вычислительными узлами в указанной подсети запрещена группой безопасности сети, служба пакетной службы установит состояние вычислительных узлов неиспользуемым. Если указанная виртуальная сеть имеет любые связанные группы безопасности сети (NSG), для входящие подключения необходимо включить несколько зарезервированных системных портов, включая порты 29876 и 29877. Также включите исходящие подключения к службе хранилища Azure через порт 443. Дополнительные сведения см. в статье /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration струна

Правило NetworkSecurityGroupRule

Имя Описание Ценность
доступ Действие, которое следует предпринять для указанного IP-адреса, диапазона подсети или тега. "Разрешить"
"Запрет" (обязательно)
приоритет Приоритеты в пуле должны быть уникальными и оцениваются в порядке приоритета. Чем ниже число, тем выше приоритет. Например, правила можно указать с номерами заказов 150, 250 и 350. Правило с порядком 150 имеет приоритет над правилом, которое имеет порядок 250. Допустимые приоритеты — от 150 до 4096. Если указаны зарезервированные или повторяющиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
sourceAddressPrefix Допустимые значения — это один IP-адрес (например, 10.10.10.10), подсеть IP -адресов (т. е. 192.168.1.0/24), тег по умолчанию или * (для всех адресов). Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400. строка (обязательно)
sourcePortRanges Допустимые значения: "*" (для всех портов 0 – 65535) или массивов портов или диапазонов портов (т. е. 100–200). Порты должны находиться в диапазоне от 0 до 65535, а диапазоны портов или порты не могут перекрываться. Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400. Значение по умолчанию будет *. строка[]

NFSMountConfiguration

Имя Описание Ценность
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
источник Универсальный код ресурса (URI) файловой системы для подключения. строка (обязательно)

NodePlacementConfiguration (Конфигурация NodePlacement)

Имя Описание Ценность
политика Политика выделения, используемая пакетной службой для подготовки узлов. Если оно не указано, пакетная служба будет использовать региональную политику. "Региональный"
"Зональный"

OSDisk

Имя Описание Ценность
Кэширование Тип кэширования для диска. "Нет"
"ReadOnly"
ReadWrite
Размер дискаГб Начальный размер диска в ГБ при создании нового диска ОС. инт
эфемералOSDiskSettings Задает временные параметры диска для диска операционной системы, используемого виртуальной машиной. DiffDiskSettings (Настройки DiffDisk)
managedDisk Управляемый диск
writeAcceleratorEnabled Указывает, следует ли включить или отключить записьAccelerator на диске. булевая переменная (bool)

PoolEndpointConfiguration (Конфигурация пулаEndpoint)

Имя Описание Ценность
входящиеNatPools Максимальное количество входящих пулов NAT на пул пакетной службы составляет 5. Если максимальное число входящих пулов NAT превышается, запрос завершается ошибкой с кодом состояния HTTP 400. Это невозможно указать, если IPAddressProvisioningType — NoPublicIPAddresses. InboundNatPool[] (обязательно)

Свойства пула

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

Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширения Azure KeyVault .
Справка о сертификате[]
deploymentConfiguration Свойства конфигурации развертывания. РазвертываниеКонфигурация
отображаемое имя Отображаемое имя не должно быть уникальным и может содержать любые символы Юникода до максимальной длины 1024. струна
interNodeCommunication Это накладывает ограничения на назначение узлов пулу. Включение этого значения может снизить вероятность выделения запрошенного количества узлов в пуле. Если этот параметр не указан, значение по умолчанию имеет значение "Отключено". "Отключено"
"Включено"
метаданные Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода. МетаданныеItem[]
mountConfiguration Это поддерживает файлы Azure, NFS, CIFS/SMB и Blobfuse. Конфигурация монтирования[]
networkConfiguration Конфигурация сети для пула. Конфигурация сети
теги ресурса Определяемые пользователем теги, связанные с пулом пакетной службы Azure. При указании эти теги распространяются на резервные ресурсы Azure, связанные с пулом. Это свойство можно указать только при создании учетной записи пакетной службы с свойством poolAllocationMode с значением UserSubscription. PoolPropertiesResourceTags
параметры масштабирования Определяет требуемый размер пула. Это может быть "фиксированный масштаб", где указан запрошенный целевой идентификаторNodes или "автомасштабирование", определяющий формулу, которая периодически переоценится. Если это свойство не указано, пул будет иметь фиксированный масштаб с 0 targetDedicatedNodes. ScaleSettings (МасштабНастройки)
начатьЗадачу В операции PATCH (update) это свойство можно задать для пустого объекта, чтобы удалить начальную задачу из пула. СтартЗадача
targetNodeCommunicationMode Если опущено, значение по умолчанию — Default. "Классический"
По умолчанию
"Упрощено"
taskSchedulingPolicy Если значение не указано, по умолчанию распространяется. TaskSchedulingPolicy
taskSlotsPerNode Значение по умолчанию — 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256. инт
upgradeПолитика Описывает политику обновления — автоматическую, ручную или перекатную. Политика обновления
userAccounts Список учетных записей пользователей, создаваемых на каждом узле в пуле. Учетная запись пользователя[]
vmSize Сведения о доступных размерах виртуальных машин см. в разделе "Размеры виртуальных машин" в Azure (/azure/virtual-machines/sizes/overview). Пакетная служба поддерживает все размеры виртуальных машин Azure, кроме STANDARD_A0 и хранилища класса Premium (STANDARD_GS, STANDARD_DS и серии STANDARD_DSV2). струна

PoolPropertiesResourceTags

Имя Описание Ценность

PublicIPAddressConfiguration (ПубличныйIPAddressConfiguration)

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

РесурсФайл

Имя Описание Ценность
autoStorageContainerName Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. струна
BLOBPrefix Свойство допустимо, только если используется autoStorageContainerName или storageContainerUrl. Этот префикс может быть частичным именем файла или подкаталогом. Если префикс не указан, все файлы в контейнере будут скачаны. струна
Режим файла Это свойство применяется только к файлам, скачанным на вычислительные узлы Linux. Он будет игнорироваться, если он указан для resourceFile, который будет скачан на узел Windows. Если это свойство не указано для узла Linux, к файлу применяется значение по умолчанию 0770. струна
путь к файлу Если задано свойство httpUrl, файлPath является обязательным и описывает путь, в который будет скачан файл, включая имя файла. В противном случае, если задано свойство autoStorageContainerName или storageContainerUrl, filePath является необязательным и является каталогом для скачивания файлов. В случае, когда filePath используется в качестве каталога, любая структура каталогов, уже связанная с входными данными, будет сохранена в полном объеме и добавлена в указанный каталог filePath. Указанный относительный путь не может выйти из рабочего каталога задачи (например, с помощью '.'). струна
httpUrl (httpUrl) Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Если URL-адрес указывает на хранилище BLOB-объектов Azure, он должен быть доступен для чтения с вычислительных узлов. Существует три способа получить такой URL-адрес для большого двоичного объекта в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение большого двоичного объекта, использовать управляемое удостоверение с разрешением на чтение или задать ACL для большого двоичного объекта или его контейнера, чтобы разрешить общедоступный доступ. струна
Справочная информация об идентичности Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел. Справочник по идентичности вычислительного узла
storageContainerUrl Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Этот URL-адрес должен быть доступен для чтения и перечисления из вычислительных узлов. Существует три способа получить такой URL-адрес для контейнера в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение и список для контейнера, использовать управляемое удостоверение с разрешениями на чтение и список или задать ACL для контейнера, чтобы разрешить общедоступный доступ. струна

Политика скользящего обновления

Имя Описание Ценность
enableCrossZoneUpgrade Разрешить VMSS игнорировать границы AZ при создании пакетов обновления. Учитывайте домен обновления и maxBatchInstancePercent, чтобы определить размер пакета. Если это поле не задано, пакетная служба Azure не установит значение по умолчанию. Значение enableCrossZoneUpgrade в созданном VirtualMachineScaleSet будет определено конфигурацией по умолчанию в VirtualMachineScaleSet. Это поле может иметь значение true или false только при использовании NodePlacementConfiguration в качестве зонального. булевая переменная (bool)
maxBatchInstancePercent Максимальный процент общих экземпляров виртуальных машин, которые будут обновляться одновременно путем последовательного обновления в одном пакете. Так как это максимальный, неработоспособные экземпляры в предыдущих или будущих пакетах могут привести к снижению процента экземпляров в пакете, чтобы обеспечить более высокую надежность. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent. int

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

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

Ограничения целостности:
Минимальное значение = 0
Максимальное значение = 100
pauseTimeBetweenBatches Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601. струна
приоритетыUnhealthyInstances Обновите все неработоспособные экземпляры в масштабируемом наборе до всех здоровых экземпляров. булевая переменная (bool)
rollbackFailedInstancesOnPolicyBreach Откат неудачных экземпляров до предыдущей модели, если политика последовательного обновления нарушена. булевая переменная (bool)

Настройки масштабирования

Имя Описание Ценность
автомасштабирование Это свойство и фиксированное масштабирование являются взаимоисключающими, и необходимо указать одно из свойств. АвтомасштабированиеSettings
fixedScale Это свойство и автомасштабирование являются взаимоисключающими, и необходимо указать одно из свойств. ФиксированныеScaleSettings

Профиль безопасности

Имя Описание Ценность
encryptionAtHost Это свойство можно использовать пользователем в запросе, чтобы включить или отключить шифрование узла для виртуальной машины или масштабируемого набора виртуальных машин. Это позволит включить шифрование для всех дисков, включая диск Resource/Temp на самом узле. булевая переменная (bool)
securityType Указывает тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение. "confidentialVM"
'trustedLaunch'
uefiНастройки Указывает параметры безопасности, такие как безопасная загрузка и vTPM, используемые при создании виртуальной машины. Настройки Uefi

Справочник по артефактам

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

СтартЗадача

Имя Описание Ценность
командная строка Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Требуется, если указаны другие свойства startTask. струна
Настройки контейнера При указании все каталоги рекурсивно под AZ_BATCH_NODE_ROOT_DIR (корнем каталогов пакетной службы Azure на узле) сопоставляются с контейнером, все переменные среды задач сопоставляются с контейнером, а командная строка задачи выполняется в контейнере. TaskContainerSettings (ЗадачиКонтейнерНастройки)
средаНастройки Список параметров переменной среды для начальной задачи. Окружающая средаНастройка[]
maxTaskRetryCount Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения. Значение по умолчанию — 0 инт
Файлы ресурсов Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. РесурсФайл[]
userIdentity Если этот параметр не указан, задача выполняется как пользователь, не являющийся администратором, уникальным для задачи. Идентификация пользователя
waitForSuccess Если значение true и задача запуска завершается сбоем на вычислительном узле, пакетная служба повторяет задачу запуска до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает вычислительный узел неиспользуемым и не запланирует задачи. Это условие можно обнаружить с помощью состояния узла и подробных сведений об ошибке планирования. Если значение false, служба пакетной службы не ожидает завершения начальной задачи. В этом случае другие задачи могут запускаться на вычислительном узле, пока задача запуска по-прежнему выполняется; и даже если задача запуска завершается сбоем, новые задачи будут продолжать планироваться на узле. Значение по умолчанию — true. булевая переменная (bool)

TaskContainerSettings (ЗадачиКонтейнерНастройки)

Имя Описание Ценность
containerHostBatchBindMounts Если этот массив имеет значение NULL или отсутствует, задача контейнера будет подключать весь временный диск диска в окнах (или AZ_BATCH_NODE_ROOT_DIR в Linux). Он не будет подключать пути к данным в контейнер, если этот массив задан как пустой. ContainerHostBatchBindMountEntry[]
containerRunOptions Эти дополнительные параметры предоставляются в качестве аргументов в команду docker create, а также те, которые управляются пакетной службой. струна
названиеИзображения Это полная ссылка на изображение, как было бы указано для параметра docker pull. Если тег не указан как часть имени изображения, тег ":latest" используется в качестве значения по умолчанию. строка (обязательно)
регистратура Этот параметр может быть опущен, если он уже был предоставлен при создании пула. ContainerRegistry (ContainerRegistry)
workingDirectory Флаг, указывающий, где находится рабочий каталог задачи контейнера. Значение по умолчанию — taskWorkingDirectory. ContainerImageDefault
TaskWorkingDirectory

TaskSchedulingPolicy

Имя Описание Ценность
nodeFillType Порядок распределения задач между вычислительными узлами. "Pack"
"Распространение" (обязательно)

Настройки Uefi

Имя Описание Ценность
secureBootEnabled Указывает, следует ли включить безопасную загрузку на виртуальной машине. булевая переменная (bool)
Включен vTpm Указывает, следует ли включить vTPM на виртуальной машине. булевая переменная (bool)

Политика обновления

Имя Описание Ценность
autoicOSUpgradePolicy Параметры конфигурации, используемые для автоматического обновления ОС. АвтоматическиOSUpgradePolicy
режим Задает режим обновления до виртуальных машин в масштабируемом наборе.

Возможные значения:

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

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

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

Учетная запись пользователя

Имя Описание Ценность
elevationLevel nonAdmin — автоматический пользователь является стандартным пользователем без повышенного доступа. администратор . Автоматический пользователь является пользователем с повышенным доступом и работает с полными разрешениями администратора. Значение по умолчанию — nonAdmin. "Администратор"
«Не-администратор»
linuxUserConfiguration Это свойство игнорируется, если указано в пуле Windows. Если это не указано, пользователь создается с параметрами по умолчанию. LinuxUserConfiguration
имя Имя учетной записи пользователя. Имена могут содержать любые символы Юникода до максимальной длины 20. строка (обязательно)
пароль Пароль для учетной записи пользователя. струна

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

UserAssignedIdentity (Пользовательские идентификаторы)

Имя Описание Ценность

Идентификатор пользователя

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

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

Имя Описание Ценность
Конфигурация контейнера Если задано, программа установки выполняется на каждом узле в пуле, чтобы разрешить выполнение задач в контейнерах. Все обычные задачи и задачи диспетчера заданий, выполняемые в этом пуле, должны указывать свойство containerSettings, а все остальные задачи могут указывать его. ContainerConfiguration (Конфигурация контейнера)
Диски данных Это свойство должно быть указано, если вычислительные узлы в пуле должны иметь пустые диски данных, подключенные к ним. Диск данных[]
diskEncryptionConfiguration При указании шифрование выполняется на каждом узле в пуле во время подготовки узлов. DiskEncryptionConfiguration (Настройка дискового шифрования)
Расширения При указании расширения, упомянутые в этой конфигурации, будут установлены на каждом узле. VMExtension[]
ImageReference Ссылка на образ Виртуальной машины Azure Marketplace или ресурс образа Azure настраиваемой виртуальной машины. Чтобы получить список всех образовReference, проверенных пакетной службой Azure, см. операцию "Список поддерживаемых номеров SKU агента узлов". ImageReference (обязательно)
тип лицензии Это относится только к образам, содержащим операционную систему Windows, и следует использовать только при удержании допустимых локальных лицензий для узлов, которые будут развернуты. Если не указано, скидка на лицензирование в локальной среде не применяется. Значения:

Windows_Server . Локальная лицензия предназначена для Windows Server.
Windows_Client . Локальная лицензия предназначена для клиента Windows.
струна
nodeAgentSkuId Агент узла пакетной службы — это программа, которая выполняется на каждом узле в пуле и предоставляет интерфейс управления между узлом и пакетной службой. Существуют различные реализации агента узла, известного как номера SKU для разных операционных систем. Необходимо указать номер SKU агента узла, соответствующий выбранной ссылке на изображение. Чтобы получить список поддерживаемых номеров SKU агента узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых SKU агента узлов". строка (обязательно)
nodePlacementConfiguration Эта конфигурация будет указывать правила по тому, как узлы в пуле будут физически выделены. NodePlacementConfiguration (Конфигурация NodePlacement)
osDisk Содержит конфигурацию для эфемерных параметров OSDisk. OSDisk
securityProfile Задает параметры профиля безопасности для масштабируемого набора виртуальных машин или виртуальной машины. Профиль безопасности
serviceArtifactReference Идентификатор ссылки на артефакт службы в виде /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} Справочник по артефактам
windowsКонфигурация Это свойство не должно быть указано, если imageReference указывает образ ОС Linux. WindowsКонфигурация

VMDiskSecurityProfile

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

VMExtension

Имя Описание Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. булевая переменная (bool)
включитьАвтоматическоеОбновление Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. булевая переменная (bool)
имя Имя расширения виртуальной машины. строка (обязательно)
защищенныеНастройки Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. любой
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. строка[]
издатель Имя издателя обработчика расширений. строка (обязательно)
Параметры Форматированные общедоступные параметры JSON для расширения. любой
тип Тип расширений. строка (обязательно)
версияТипаОбработчика Версия обработчика скрипта. струна

WindowsКонфигурация

Имя Описание Ценность
enableAutomaticUpdates Если опущено, значение по умолчанию имеет значение true. булевая переменная (bool)

WindowsUserConfiguration

Имя Описание Ценность
loginMode Задает режим входа для пользователя. Значение по умолчанию — Interactive. Пакетная служба
"Интерактивный"

Примеры использования

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл Описание
пул пакетной службы Azure без общедоступных IP-адресов Этот шаблон создает упрощенный пул обмена данными с узлами пакетной службы Azure без общедоступных IP-адресов.

Определение ресурса шаблона ARM

Тип ресурса batchAccounts/пулов можно развернуть с помощью операций, предназначенных для следующих операций:

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

Формат ресурса

Чтобы создать ресурс Microsoft.Batch/batchAccounts/pools, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Batch/batchAccounts/pools",
  "apiVersion": "2024-07-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "properties": {
    "applicationLicenses": [ "string" ],
    "applicationPackages": [
      {
        "id": "string",
        "version": "string"
      }
    ],
    "certificates": [
      {
        "id": "string",
        "storeLocation": "string",
        "storeName": "string",
        "visibility": [ "string" ]
      }
    ],
    "deploymentConfiguration": {
      "virtualMachineConfiguration": {
        "containerConfiguration": {
          "containerImageNames": [ "string" ],
          "containerRegistries": [
            {
              "identityReference": {
                "resourceId": "string"
              },
              "password": "string",
              "registryServer": "string",
              "username": "string"
            }
          ],
          "type": "string"
        },
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "diskEncryptionConfiguration": {
          "targets": [ "string" ]
        },
        "extensions": [
          {
            "autoUpgradeMinorVersion": "bool",
            "enableAutomaticUpgrade": "bool",
            "name": "string",
            "protectedSettings": {},
            "provisionAfterExtensions": [ "string" ],
            "publisher": "string",
            "settings": {},
            "type": "string",
            "typeHandlerVersion": "string"
          }
        ],
        "imageReference": {
          "communityGalleryImageId": "string",
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sharedGalleryImageId": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "nodePlacementConfiguration": {
          "policy": "string"
        },
        "osDisk": {
          "caching": "string",
          "diskSizeGB": "int",
          "ephemeralOSDiskSettings": {
            "placement": "CacheDisk"
          },
          "managedDisk": {
            "securityProfile": {
              "securityEncryptionType": "string"
            },
            "storageAccountType": "string"
          },
          "writeAcceleratorEnabled": "bool"
        },
        "securityProfile": {
          "encryptionAtHost": "bool",
          "securityType": "string",
          "uefiSettings": {
            "secureBootEnabled": "bool",
            "vTpmEnabled": "bool"
          }
        },
        "serviceArtifactReference": {
          "id": "string"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "mountConfiguration": [
      {
        "azureBlobFileSystemConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "blobfuseOptions": "string",
          "containerName": "string",
          "identityReference": {
            "resourceId": "string"
          },
          "relativeMountPath": "string",
          "sasKey": "string"
        },
        "azureFileShareConfiguration": {
          "accountKey": "string",
          "accountName": "string",
          "azureFileUrl": "string",
          "mountOptions": "string",
          "relativeMountPath": "string"
        },
        "cifsMountConfiguration": {
          "mountOptions": "string",
          "password": "string",
          "relativeMountPath": "string",
          "source": "string",
          "userName": "string"
        },
        "nfsMountConfiguration": {
          "mountOptions": "string",
          "relativeMountPath": "string",
          "source": "string"
        }
      }
    ],
    "networkConfiguration": {
      "dynamicVnetAssignmentScope": "string",
      "enableAcceleratedNetworking": "bool",
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "backendPort": "int",
            "frontendPortRangeEnd": "int",
            "frontendPortRangeStart": "int",
            "name": "string",
            "networkSecurityGroupRules": [
              {
                "access": "string",
                "priority": "int",
                "sourceAddressPrefix": "string",
                "sourcePortRanges": [ "string" ]
              }
            ],
            "protocol": "string"
          }
        ]
      },
      "publicIPAddressConfiguration": {
        "ipAddressIds": [ "string" ],
        "provision": "string"
      },
      "subnetId": "string"
    },
    "resourceTags": {
      "{customized property}": "string"
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "string",
        "formula": "string"
      },
      "fixedScale": {
        "nodeDeallocationOption": "string",
        "resizeTimeout": "string",
        "targetDedicatedNodes": "int",
        "targetLowPriorityNodes": "int"
      }
    },
    "startTask": {
      "commandLine": "string",
      "containerSettings": {
        "containerHostBatchBindMounts": [
          {
            "isReadOnly": "bool",
            "source": "string"
          }
        ],
        "containerRunOptions": "string",
        "imageName": "string",
        "registry": {
          "identityReference": {
            "resourceId": "string"
          },
          "password": "string",
          "registryServer": "string",
          "username": "string"
        },
        "workingDirectory": "string"
      },
      "environmentSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "maxTaskRetryCount": "int",
      "resourceFiles": [
        {
          "autoStorageContainerName": "string",
          "blobPrefix": "string",
          "fileMode": "string",
          "filePath": "string",
          "httpUrl": "string",
          "identityReference": {
            "resourceId": "string"
          },
          "storageContainerUrl": "string"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "elevationLevel": "string",
          "scope": "string"
        },
        "userName": "string"
      },
      "waitForSuccess": "bool"
    },
    "targetNodeCommunicationMode": "string",
    "taskSchedulingPolicy": {
      "nodeFillType": "string"
    },
    "taskSlotsPerNode": "int",
    "upgradePolicy": {
      "automaticOSUpgradePolicy": {
        "disableAutomaticRollback": "bool",
        "enableAutomaticOSUpgrade": "bool",
        "osRollingUpgradeDeferral": "bool",
        "useRollingUpgradePolicy": "bool"
      },
      "mode": "string",
      "rollingUpgradePolicy": {
        "enableCrossZoneUpgrade": "bool",
        "maxBatchInstancePercent": "int",
        "maxUnhealthyInstancePercent": "int",
        "maxUnhealthyUpgradedInstancePercent": "int",
        "pauseTimeBetweenBatches": "string",
        "prioritizeUnhealthyInstances": "bool",
        "rollbackFailedInstancesOnPolicyBreach": "bool"
      }
    },
    "userAccounts": [
      {
        "elevationLevel": "string",
        "linuxUserConfiguration": {
          "gid": "int",
          "sshPrivateKey": "string",
          "uid": "int"
        },
        "name": "string",
        "password": "string",
        "windowsUserConfiguration": {
          "loginMode": "string"
        }
      }
    ],
    "vmSize": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

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

Microsoft.Batch/batchAccounts/пулы

Имя Описание Ценность
apiVersion Версия API '2024-07-01'
тождество Тип удостоверения, используемого для пула пакетной службы. BatchPoolIdentity (Идентификация BatchPool)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 1
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9_-]+$ (обязательно)
свойства Свойства, связанные с пулом. Свойства пула
Теги Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
тип Тип ресурса "Microsoft.Batch/batchAccounts/pools"

ApplicationPackageReference

Имя Описание Ценность
идентификатор Идентификатор устанавливаемого пакета приложения. Это должно находиться внутри той же учетной записи пакетной службы, что и пул. Это может быть ссылка на определенную версию или версию по умолчанию, если она существует. строка (обязательно)
Версия Если это опущено, и для этого приложения не указана версия по умолчанию, запрос завершается сбоем с кодом ошибки InvalidApplicationPackageReferences. Если вы вызываете REST API напрямую, код состояния HTTP равен 409. струна

АвтоматическиOSUpgradePolicy

Имя Описание Ценность
disableAutomaticRollback Следует ли отключить функцию отката образа ОС. булевая переменная (bool)
enableAutomaticOSУпгрейд Указывает, следует ли автоматически применять обновления ОС к экземплярам масштабируемого набора в последовательном режиме, когда становится доступной более новая версия образа ОС.

Если для пулов windows задано значение true, WindowsConfiguration.enableAutomaticUpdates не может быть задано значение true.
булевая переменная (bool)
osRollingUpgradeDeferral Отложить обновление ОС на телевизорах, если они выполняют задачи. булевая переменная (bool)
useRollingUpgradePolicy Указывает, следует ли использовать политику последовательного обновления во время автоматического обновления ОС. Автоматическое обновление ОС откатится к политике по умолчанию, если политика не определена в VMSS. булевая переменная (bool)

АвтомасштабированиеSettings

Имя Описание Ценность
оценкаИнтервал Если опущено, значение по умолчанию — 15 минут (PT15M). струна
формула Формула для требуемого количества вычислительных узлов в пуле. строка (обязательно)

Спецификация AutoUserSpecification

Имя Описание Ценность
elevationLevel Значение по умолчанию — nonAdmin. "Администратор"
«Не-администратор»
размах Значением по умолчанию является пул. Если пул работает под управлением Windows, необходимо указать значение задачи, если требуется более строгая изоляция между задачами. Например, если задача мутирует реестр таким образом, что может повлиять на другие задачи, или если сертификаты были указаны в пуле, который не должен быть доступен обычными задачами, но должен быть доступен путем запуска задач. "Пул"
"Задача"

AzureBlobFileSystemConfiguration

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

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
Имя аккаунта Имя учетной записи хранения Azure. строка (обязательно)
blobfuseOptions Это параметры "net use" в Windows и "подключение" в Linux. струна
имяКонтейнера Имя контейнера хранилища BLOB-объектов Azure. строка (обязательно)
Справочная информация об идентичности Это свойство является взаимоисключающим как с accountKey, так и sasKey; необходимо указать именно один. Справочник по идентичности вычислительного узла
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
sasKey Это свойство является взаимоисключающим как с accountKey, так и с удостоверением; необходимо указать именно один. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.

Конфигурация AzureFileShare

Имя Описание Ценность
accountKey Ключ учетной записи хранения Azure. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
Имя аккаунта Имя учетной записи хранения Azure. строка (обязательно)
azureFileUrl Это форма "https://{account}.file.core.windows.net/". строка (обязательно)
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)

AzureProxyResourceTags

Имя Описание Ценность

BatchPoolIdentity (Идентификация BatchPool)

Имя Описание Ценность
тип Тип удостоверения, используемого для пула пакетной службы. "Нет"
UserAssigned (обязательно)
ИдентичностиНазначенныеПользователем Список удостоверений пользователей, связанных с пулом пакетной службы. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Имя Описание Ценность

СертификатСсылка

Имя Описание Ценность
идентификатор Полный идентификатор сертификата для установки в пуле. Это должно находиться внутри той же учетной записи пакетной службы, что и пул. строка (обязательно)
Местоположение магазина Значение по умолчанию — currentUser. Это свойство применимо только для пулов, настроенных с вычислительными узлами Windows. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочих каталогов задач, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. CurrentUser
LocalMachine
название магазина Это свойство применимо только для пулов, настроенных с вычислительными узлами Windows. Распространенные имена хранилищ: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, но любое пользовательское имя хранилища также можно использовать. Значением по умолчанию является My. струна
видимость Какие учетные записи пользователей на вычислительном узле должны иметь доступ к частным данным сертификата. Массив строк, содержащий любой из:
RemoteUser
StartTask
"Задача"

Конфигурация CifsMount

Имя Описание Ценность
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
пароль Пароль, используемый для проверки подлинности в файловой системе CIFS. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
источник Универсальный код ресурса (URI) файловой системы для подключения. строка (обязательно)
userName Пользователь, используемый для проверки подлинности в файловой системе CIFS. строка (обязательно)

Справочник по идентичности вычислительного узла

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

ContainerConfiguration (Конфигурация контейнера)

Имя Описание Ценность
containerImageNames Это полная ссылка на изображение, как было бы указано для параметра docker pull. Образ будет получен из реестра Docker по умолчанию, если образ не является полным с альтернативным реестром. строка[]
containerRegistries Если какие-либо образы должны быть загружены из частного реестра, для которого требуются учетные данные, эти учетные данные должны быть предоставлены здесь. ContainerRegistry[]
тип Используемая технология контейнера. «Совместимость с CriCompatible»
DockerCompatible (обязательный)

ContainerHostBatchBindMountEntry

Имя Описание Ценность
isReadOnly Если вы подключаете этот путь как режим чтения и записи, это не означает, что у всех пользователей в контейнере есть доступ на чтение и запись для пути, он зависит от доступа на виртуальной машине узла. Если этот путь подключен только для чтения, все пользователи в контейнере не смогут изменить путь. булевая переменная (bool)
источник Пути, которые будут подключены к контейнеру задачи контейнера. "Приложения"
JobPrep
"Общий"
"Startup"
"Задача"
"VfsMounts"

ContainerRegistry (ContainerRegistry)

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

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
сервер реестра Если опущено, значение по умолчанию — "docker.io". струна
имя пользователя Имя пользователя для входа на сервер реестра. струна

ДатаДиск

Имя Описание Ценность
Кэширование Значения:

none — режим кэширования для диска не включен.
readOnly — режим кэширования для диска доступен только для чтения.
readWrite — режим кэширования для диска считывается и записывается.

Значение по умолчанию для кэширования не имеет значения. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Нет"
"ReadOnly"
ReadWrite
Размер дискаГб Начальный размер диска в ГБ при создании нового диска данных. int (обязательно)
Лунь Луна используется для уникальной идентификации каждого диска данных. При подключении нескольких дисков каждый должен иметь отдельную луну. Значение должно быть от 0 до 63 включительно. int (обязательно)
Тип учетной записи хранилища Если опущено, значение по умолчанию — "Standard_LRS". Значения:

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

РазвертываниеКонфигурация

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

DiffDiskSettings (Настройки DiffDisk)

Имя Описание Ценность
размещение Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение операционной системы. Например, кэшировать место на диске для подготовки диска Эфемеральной ОС. Дополнительные сведения о требованиях к размеру диска в Эфемеральной ОС см. в разделе "Требования к размеру диска операционной системы" для виртуальных машин Windows в разделе /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements и виртуальных машин Linux в /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. CacheDisk

DiskEncryptionConfiguration (Настройка дискового шифрования)

Имя Описание Ценность
Цели В пуле Linux поддерживается только временныйdisk; В пуле Windows необходимо указать "OsDisk" и "TemporaryDisk". Массив строк, содержащий любой из:
OsDisk
"ВременныйDisk"

Окружающая средаНастройка

Имя Описание Ценность
имя Имя переменной среды. строка (обязательно)
ценность Значение переменной среды. струна

ФиксированныеScaleSettings

Имя Описание Ценность
nodeDeallocationOption Если опущено, значение по умолчанию — Requeue. "Requeue"
"СохранитьedData"
TaskCompletion
"Завершение"
resizeTimeout Значение по умолчанию — 15 минут. Значения времени ожидания используют формат ISO 8601. Например, используйте PT10M в течение 10 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, служба пакетной службы отклоняет запрос с ошибкой; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос). струна
targetDedicatedNodes По крайней мере один из целевыхDedicatedNodes, необходимо задать targetLowPriorityNodes. инт
targetLowPriorityNodes По крайней мере один из целевыхDedicatedNodes, необходимо задать targetLowPriorityNodes. инт

Ссылка на изображение

Имя Описание Ценность
communityGalleryImageId Это свойство является взаимоисключающим с другими свойствами и может быть получено из вызова GET коллекции сообщества. струна
идентификатор Это свойство является взаимоисключающим с другими свойствами. Образ коллекции вычислений Azure должен иметь реплики в том же регионе, что и учетная запись пакетной службы Azure. Сведения о параметрах брандмауэра для агента узла пакетной службы для взаимодействия с пакетной службой см. в статье /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. струна
предлагать Например, UbuntuServer или WindowsServer. струна
издатель Например, Canonical или MicrosoftWindowsServer. струна
sharedGalleryImageId Это свойство является взаимоисключающим с другими свойствами и может быть получено из вызова GET образа общей коллекции. струна
SKU Например, 18.04-LTS или 2022-datacenter. струна
Версия Чтобы выбрать последнюю версию образа, можно указать значение "последняя". Если опущено, значение по умолчанию — "последняя". струна

Входящий NatPool (Входящий NatPool)

Имя Описание Ценность
серверный порт Это должно быть уникальным в пуле пакетной службы. Допустимые значения : от 1 до 65535, за исключением 29876 и 29877, так как они зарезервированы. Если указаны зарезервированные значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
frontendPortRangeEnd Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, зарезервированных пакетной службой. Все диапазоны в пуле должны быть уникальными и не могут перекрываться. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
frontendPortRangeStart Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, которые зарезервированы. Все диапазоны в пуле должны быть уникальными и не могут перекрываться. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
имя Имя должно быть уникальным в пуле пакетной службы, может содержать буквы, цифры, подчеркивания, периоды и дефисы. Имена должны начинаться с буквы или числа, заканчиваться буквой, числом или подчеркиванием и не может превышать 77 символов. Если указаны недопустимые значения, запрос завершается ошибкой с кодом состояния HTTP 400. строка (обязательно)
networkSecurityGroupRules Максимальное количество правил, которые можно указать во всех конечных точках в пуле пакетной службы, равно 25. Если правила группы безопасности сети не указаны, будет создано правило по умолчанию, чтобы разрешить входящий доступ к указанному внутреннему порту. Если максимальное число правил группы безопасности сети превышается, запрос завершается ошибкой с кодом состояния HTTP 400. Правило NetworkSecurityGroup[]
протокол Протокол конечной точки. "TCP"
UDP (обязательно)

LinuxUserConfiguration

Имя Описание Ценность
гид Свойства пользовательского интерфейса и gid должны быть указаны вместе или не вообще. Если не указана базовая операционная система, выбирает гиб. инт
sshPrivateKey Закрытый ключ не должен быть защищен паролем. Закрытый ключ используется для автоматической настройки асимметричной проверки подлинности на основе ключа для SSH между узлами в пуле Linux, если свойство enableInterNodeCommunication пула имеет значение true (оно игнорируется, если enableInterNodeCommunication имеет значение false). Для этого поместите пару ключей в каталог SSH пользователя. Если он не указан, SSH без пароля не настроен между узлами (не выполняется изменение каталога SSH пользователя). струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
уникальный идентификатор (УИД) Свойства пользовательского интерфейса и gid должны быть указаны вместе или не вообще. Если базовая операционная система не указана, выбирает пользовательский интерфейс. инт

Управляемый диск

Имя Описание Ценность
securityProfile Задает параметры профиля безопасности для управляемого диска. примечание. Оно может быть задано только для конфиденциальных виртуальных машин и требуется при использовании конфиденциальных виртуальных машин. VMDiskSecurityProfile
Тип учетной записи хранилища Тип учетной записи хранения для создания дисков данных или диска ОС. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

МетаdataItem (МетаданныеItem)

Имя Описание Ценность
имя Имя элемента метаданных. строка (обязательно)
ценность Значение элемента метаданных. строка (обязательно)

МонтированиеКонфигурация

Имя Описание Ценность
azureBlobFileSystemConfiguration Это свойство является взаимоисключающим со всеми другими свойствами. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Это свойство является взаимоисключающим со всеми другими свойствами. Конфигурация AzureFileShare
Конфигурация cifsMount Это свойство является взаимоисключающим со всеми другими свойствами. Конфигурация CifsMount
Конфигурация nfsMount Это свойство является взаимоисключающим со всеми другими свойствами. NFSMountConfiguration

Сетевая конфигурация

Имя Описание Ценность
DynamicVnetAssignmentScope Область динамического назначения виртуальной сети. «Работа»
"нет"
enableAcceleratedNetworking Ускорение сети обеспечивает виртуализацию одно корневых операций ввода-вывода (SR-IOV) к виртуальной машине, что может привести к повышению производительности сети. Дополнительные сведения см. в статье /azure/virtual-network/accelerated-networking-overview. булевая переменная (bool)
конечная точкаКонфигурация Конфигурация конечной точки для пула. PoolEndpointConfiguration (Конфигурация пулаEndpoint)
publicIPAddressConfiguration Конфигурация общедоступного IP-адреса конфигурации сети пула. PublicIPAddressConfiguration (ПубличныйIPAddressConfiguration)
SubnetId Виртуальная сеть должна находиться в том же регионе и подписке, что и учетная запись пакетной службы Azure. Указанная подсеть должна иметь достаточно свободных IP-адресов для размещения количества узлов в пуле. Если подсеть не имеет достаточно свободных IP-адресов, пул частично выделяет вычислительные узлы и возникнет ошибка изменения размера. Субъект-служба MicrosoftAzureBatch должна иметь роль "Участник классической виртуальной машины" Role-Based управление доступом (RBAC) для указанной виртуальной сети. Указанная подсеть должна разрешить обмен данными из пакетной службы Azure, чтобы иметь возможность планировать задачи на вычислительных узлах. Это можно проверить, проверьте, имеет ли указанная виртуальная сеть любые связанные группы безопасности сети (NSG). Если связь с вычислительными узлами в указанной подсети запрещена группой безопасности сети, служба пакетной службы установит состояние вычислительных узлов неиспользуемым. Если указанная виртуальная сеть имеет любые связанные группы безопасности сети (NSG), для входящие подключения необходимо включить несколько зарезервированных системных портов, включая порты 29876 и 29877. Также включите исходящие подключения к службе хранилища Azure через порт 443. Дополнительные сведения см. в статье /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration струна

Правило NetworkSecurityGroupRule

Имя Описание Ценность
доступ Действие, которое следует предпринять для указанного IP-адреса, диапазона подсети или тега. "Разрешить"
"Запрет" (обязательно)
приоритет Приоритеты в пуле должны быть уникальными и оцениваются в порядке приоритета. Чем ниже число, тем выше приоритет. Например, правила можно указать с номерами заказов 150, 250 и 350. Правило с порядком 150 имеет приоритет над правилом, которое имеет порядок 250. Допустимые приоритеты — от 150 до 4096. Если указаны зарезервированные или повторяющиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
sourceAddressPrefix Допустимые значения — это один IP-адрес (например, 10.10.10.10), подсеть IP -адресов (т. е. 192.168.1.0/24), тег по умолчанию или * (для всех адресов). Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400. строка (обязательно)
sourcePortRanges Допустимые значения: "*" (для всех портов 0 – 65535) или массивов портов или диапазонов портов (т. е. 100–200). Порты должны находиться в диапазоне от 0 до 65535, а диапазоны портов или порты не могут перекрываться. Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400. Значение по умолчанию будет *. строка[]

NFSMountConfiguration

Имя Описание Ценность
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
источник Универсальный код ресурса (URI) файловой системы для подключения. строка (обязательно)

NodePlacementConfiguration (Конфигурация NodePlacement)

Имя Описание Ценность
политика Политика выделения, используемая пакетной службой для подготовки узлов. Если оно не указано, пакетная служба будет использовать региональную политику. "Региональный"
"Зональный"

OSDisk

Имя Описание Ценность
Кэширование Тип кэширования для диска. "Нет"
"ReadOnly"
ReadWrite
Размер дискаГб Начальный размер диска в ГБ при создании нового диска ОС. инт
эфемералOSDiskSettings Задает временные параметры диска для диска операционной системы, используемого виртуальной машиной. DiffDiskSettings (Настройки DiffDisk)
managedDisk Управляемый диск
writeAcceleratorEnabled Указывает, следует ли включить или отключить записьAccelerator на диске. булевая переменная (bool)

PoolEndpointConfiguration (Конфигурация пулаEndpoint)

Имя Описание Ценность
входящиеNatPools Максимальное количество входящих пулов NAT на пул пакетной службы составляет 5. Если максимальное число входящих пулов NAT превышается, запрос завершается ошибкой с кодом состояния HTTP 400. Это невозможно указать, если IPAddressProvisioningType — NoPublicIPAddresses. InboundNatPool[] (обязательно)

Свойства пула

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

Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширения Azure KeyVault .
Справка о сертификате[]
deploymentConfiguration Свойства конфигурации развертывания. РазвертываниеКонфигурация
отображаемое имя Отображаемое имя не должно быть уникальным и может содержать любые символы Юникода до максимальной длины 1024. струна
interNodeCommunication Это накладывает ограничения на назначение узлов пулу. Включение этого значения может снизить вероятность выделения запрошенного количества узлов в пуле. Если этот параметр не указан, значение по умолчанию имеет значение "Отключено". "Отключено"
"Включено"
метаданные Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода. МетаданныеItem[]
mountConfiguration Это поддерживает файлы Azure, NFS, CIFS/SMB и Blobfuse. Конфигурация монтирования[]
networkConfiguration Конфигурация сети для пула. Конфигурация сети
теги ресурса Определяемые пользователем теги, связанные с пулом пакетной службы Azure. При указании эти теги распространяются на резервные ресурсы Azure, связанные с пулом. Это свойство можно указать только при создании учетной записи пакетной службы с свойством poolAllocationMode с значением UserSubscription. PoolPropertiesResourceTags
параметры масштабирования Определяет требуемый размер пула. Это может быть "фиксированный масштаб", где указан запрошенный целевой идентификаторNodes или "автомасштабирование", определяющий формулу, которая периодически переоценится. Если это свойство не указано, пул будет иметь фиксированный масштаб с 0 targetDedicatedNodes. ScaleSettings (МасштабНастройки)
начатьЗадачу В операции PATCH (update) это свойство можно задать для пустого объекта, чтобы удалить начальную задачу из пула. СтартЗадача
targetNodeCommunicationMode Если опущено, значение по умолчанию — Default. "Классический"
По умолчанию
"Упрощено"
taskSchedulingPolicy Если значение не указано, по умолчанию распространяется. TaskSchedulingPolicy
taskSlotsPerNode Значение по умолчанию — 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256. инт
upgradeПолитика Описывает политику обновления — автоматическую, ручную или перекатную. Политика обновления
userAccounts Список учетных записей пользователей, создаваемых на каждом узле в пуле. Учетная запись пользователя[]
vmSize Сведения о доступных размерах виртуальных машин см. в разделе "Размеры виртуальных машин" в Azure (/azure/virtual-machines/sizes/overview). Пакетная служба поддерживает все размеры виртуальных машин Azure, кроме STANDARD_A0 и хранилища класса Premium (STANDARD_GS, STANDARD_DS и серии STANDARD_DSV2). струна

PoolPropertiesResourceTags

Имя Описание Ценность

PublicIPAddressConfiguration (ПубличныйIPAddressConfiguration)

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

РесурсФайл

Имя Описание Ценность
autoStorageContainerName Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. струна
BLOBPrefix Свойство допустимо, только если используется autoStorageContainerName или storageContainerUrl. Этот префикс может быть частичным именем файла или подкаталогом. Если префикс не указан, все файлы в контейнере будут скачаны. струна
Режим файла Это свойство применяется только к файлам, скачанным на вычислительные узлы Linux. Он будет игнорироваться, если он указан для resourceFile, который будет скачан на узел Windows. Если это свойство не указано для узла Linux, к файлу применяется значение по умолчанию 0770. струна
путь к файлу Если задано свойство httpUrl, файлPath является обязательным и описывает путь, в который будет скачан файл, включая имя файла. В противном случае, если задано свойство autoStorageContainerName или storageContainerUrl, filePath является необязательным и является каталогом для скачивания файлов. В случае, когда filePath используется в качестве каталога, любая структура каталогов, уже связанная с входными данными, будет сохранена в полном объеме и добавлена в указанный каталог filePath. Указанный относительный путь не может выйти из рабочего каталога задачи (например, с помощью '.'). струна
httpUrl (httpUrl) Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Если URL-адрес указывает на хранилище BLOB-объектов Azure, он должен быть доступен для чтения с вычислительных узлов. Существует три способа получить такой URL-адрес для большого двоичного объекта в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение большого двоичного объекта, использовать управляемое удостоверение с разрешением на чтение или задать ACL для большого двоичного объекта или его контейнера, чтобы разрешить общедоступный доступ. струна
Справочная информация об идентичности Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел. Справочник по идентичности вычислительного узла
storageContainerUrl Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Этот URL-адрес должен быть доступен для чтения и перечисления из вычислительных узлов. Существует три способа получить такой URL-адрес для контейнера в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение и список для контейнера, использовать управляемое удостоверение с разрешениями на чтение и список или задать ACL для контейнера, чтобы разрешить общедоступный доступ. струна

Политика скользящего обновления

Имя Описание Ценность
enableCrossZoneUpgrade Разрешить VMSS игнорировать границы AZ при создании пакетов обновления. Учитывайте домен обновления и maxBatchInstancePercent, чтобы определить размер пакета. Если это поле не задано, пакетная служба Azure не установит значение по умолчанию. Значение enableCrossZoneUpgrade в созданном VirtualMachineScaleSet будет определено конфигурацией по умолчанию в VirtualMachineScaleSet. Это поле может иметь значение true или false только при использовании NodePlacementConfiguration в качестве зонального. булевая переменная (bool)
maxBatchInstancePercent Максимальный процент общих экземпляров виртуальных машин, которые будут обновляться одновременно путем последовательного обновления в одном пакете. Так как это максимальный, неработоспособные экземпляры в предыдущих или будущих пакетах могут привести к снижению процента экземпляров в пакете, чтобы обеспечить более высокую надежность. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent. int

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

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

Ограничения целостности:
Минимальное значение = 0
Максимальное значение = 100
pauseTimeBetweenBatches Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601. струна
приоритетыUnhealthyInstances Обновите все неработоспособные экземпляры в масштабируемом наборе до всех здоровых экземпляров. булевая переменная (bool)
rollbackFailedInstancesOnPolicyBreach Откат неудачных экземпляров до предыдущей модели, если политика последовательного обновления нарушена. булевая переменная (bool)

Настройки масштабирования

Имя Описание Ценность
автомасштабирование Это свойство и фиксированное масштабирование являются взаимоисключающими, и необходимо указать одно из свойств. АвтомасштабированиеSettings
fixedScale Это свойство и автомасштабирование являются взаимоисключающими, и необходимо указать одно из свойств. ФиксированныеScaleSettings

Профиль безопасности

Имя Описание Ценность
encryptionAtHost Это свойство можно использовать пользователем в запросе, чтобы включить или отключить шифрование узла для виртуальной машины или масштабируемого набора виртуальных машин. Это позволит включить шифрование для всех дисков, включая диск Resource/Temp на самом узле. булевая переменная (bool)
securityType Указывает тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение. "confidentialVM"
'trustedLaunch'
uefiНастройки Указывает параметры безопасности, такие как безопасная загрузка и vTPM, используемые при создании виртуальной машины. Настройки Uefi

Справочник по артефактам

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

СтартЗадача

Имя Описание Ценность
командная строка Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Требуется, если указаны другие свойства startTask. струна
Настройки контейнера При указании все каталоги рекурсивно под AZ_BATCH_NODE_ROOT_DIR (корнем каталогов пакетной службы Azure на узле) сопоставляются с контейнером, все переменные среды задач сопоставляются с контейнером, а командная строка задачи выполняется в контейнере. TaskContainerSettings (ЗадачиКонтейнерНастройки)
средаНастройки Список параметров переменной среды для начальной задачи. Окружающая средаНастройка[]
maxTaskRetryCount Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения. Значение по умолчанию — 0 инт
Файлы ресурсов Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. РесурсФайл[]
userIdentity Если этот параметр не указан, задача выполняется как пользователь, не являющийся администратором, уникальным для задачи. Идентификация пользователя
waitForSuccess Если значение true и задача запуска завершается сбоем на вычислительном узле, пакетная служба повторяет задачу запуска до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает вычислительный узел неиспользуемым и не запланирует задачи. Это условие можно обнаружить с помощью состояния узла и подробных сведений об ошибке планирования. Если значение false, служба пакетной службы не ожидает завершения начальной задачи. В этом случае другие задачи могут запускаться на вычислительном узле, пока задача запуска по-прежнему выполняется; и даже если задача запуска завершается сбоем, новые задачи будут продолжать планироваться на узле. Значение по умолчанию — true. булевая переменная (bool)

TaskContainerSettings (ЗадачиКонтейнерНастройки)

Имя Описание Ценность
containerHostBatchBindMounts Если этот массив имеет значение NULL или отсутствует, задача контейнера будет подключать весь временный диск диска в окнах (или AZ_BATCH_NODE_ROOT_DIR в Linux). Он не будет подключать пути к данным в контейнер, если этот массив задан как пустой. ContainerHostBatchBindMountEntry[]
containerRunOptions Эти дополнительные параметры предоставляются в качестве аргументов в команду docker create, а также те, которые управляются пакетной службой. струна
названиеИзображения Это полная ссылка на изображение, как было бы указано для параметра docker pull. Если тег не указан как часть имени изображения, тег ":latest" используется в качестве значения по умолчанию. строка (обязательно)
регистратура Этот параметр может быть опущен, если он уже был предоставлен при создании пула. ContainerRegistry (ContainerRegistry)
workingDirectory Флаг, указывающий, где находится рабочий каталог задачи контейнера. Значение по умолчанию — taskWorkingDirectory. ContainerImageDefault
TaskWorkingDirectory

TaskSchedulingPolicy

Имя Описание Ценность
nodeFillType Порядок распределения задач между вычислительными узлами. "Pack"
"Распространение" (обязательно)

Настройки Uefi

Имя Описание Ценность
secureBootEnabled Указывает, следует ли включить безопасную загрузку на виртуальной машине. булевая переменная (bool)
Включен vTpm Указывает, следует ли включить vTPM на виртуальной машине. булевая переменная (bool)

Политика обновления

Имя Описание Ценность
autoicOSUpgradePolicy Параметры конфигурации, используемые для автоматического обновления ОС. АвтоматическиOSUpgradePolicy
режим Задает режим обновления до виртуальных машин в масштабируемом наборе.

Возможные значения:

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

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

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

Учетная запись пользователя

Имя Описание Ценность
elevationLevel nonAdmin — автоматический пользователь является стандартным пользователем без повышенного доступа. администратор . Автоматический пользователь является пользователем с повышенным доступом и работает с полными разрешениями администратора. Значение по умолчанию — nonAdmin. "Администратор"
«Не-администратор»
linuxUserConfiguration Это свойство игнорируется, если указано в пуле Windows. Если это не указано, пользователь создается с параметрами по умолчанию. LinuxUserConfiguration
имя Имя учетной записи пользователя. Имена могут содержать любые символы Юникода до максимальной длины 20. строка (обязательно)
пароль Пароль для учетной записи пользователя. струна

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

UserAssignedIdentity (Пользовательские идентификаторы)

Имя Описание Ценность

Идентификатор пользователя

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

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

Имя Описание Ценность
Конфигурация контейнера Если задано, программа установки выполняется на каждом узле в пуле, чтобы разрешить выполнение задач в контейнерах. Все обычные задачи и задачи диспетчера заданий, выполняемые в этом пуле, должны указывать свойство containerSettings, а все остальные задачи могут указывать его. ContainerConfiguration (Конфигурация контейнера)
Диски данных Это свойство должно быть указано, если вычислительные узлы в пуле должны иметь пустые диски данных, подключенные к ним. Диск данных[]
diskEncryptionConfiguration При указании шифрование выполняется на каждом узле в пуле во время подготовки узлов. DiskEncryptionConfiguration (Настройка дискового шифрования)
Расширения При указании расширения, упомянутые в этой конфигурации, будут установлены на каждом узле. VMExtension[]
ImageReference Ссылка на образ Виртуальной машины Azure Marketplace или ресурс образа Azure настраиваемой виртуальной машины. Чтобы получить список всех образовReference, проверенных пакетной службой Azure, см. операцию "Список поддерживаемых номеров SKU агента узлов". ImageReference (обязательно)
тип лицензии Это относится только к образам, содержащим операционную систему Windows, и следует использовать только при удержании допустимых локальных лицензий для узлов, которые будут развернуты. Если не указано, скидка на лицензирование в локальной среде не применяется. Значения:

Windows_Server . Локальная лицензия предназначена для Windows Server.
Windows_Client . Локальная лицензия предназначена для клиента Windows.
струна
nodeAgentSkuId Агент узла пакетной службы — это программа, которая выполняется на каждом узле в пуле и предоставляет интерфейс управления между узлом и пакетной службой. Существуют различные реализации агента узла, известного как номера SKU для разных операционных систем. Необходимо указать номер SKU агента узла, соответствующий выбранной ссылке на изображение. Чтобы получить список поддерживаемых номеров SKU агента узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых SKU агента узлов". строка (обязательно)
nodePlacementConfiguration Эта конфигурация будет указывать правила по тому, как узлы в пуле будут физически выделены. NodePlacementConfiguration (Конфигурация NodePlacement)
osDisk Содержит конфигурацию для эфемерных параметров OSDisk. OSDisk
securityProfile Задает параметры профиля безопасности для масштабируемого набора виртуальных машин или виртуальной машины. Профиль безопасности
serviceArtifactReference Идентификатор ссылки на артефакт службы в виде /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} Справочник по артефактам
windowsКонфигурация Это свойство не должно быть указано, если imageReference указывает образ ОС Linux. WindowsКонфигурация

VMDiskSecurityProfile

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

VMExtension

Имя Описание Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. булевая переменная (bool)
включитьАвтоматическоеОбновление Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. булевая переменная (bool)
имя Имя расширения виртуальной машины. строка (обязательно)
защищенныеНастройки Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. любой
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. строка[]
издатель Имя издателя обработчика расширений. строка (обязательно)
Параметры Форматированные общедоступные параметры JSON для расширения. любой
тип Тип расширений. строка (обязательно)
версияТипаОбработчика Версия обработчика скрипта. струна

WindowsКонфигурация

Имя Описание Ценность
enableAutomaticUpdates Если опущено, значение по умолчанию имеет значение true. булевая переменная (bool)

WindowsUserConfiguration

Имя Описание Ценность
loginMode Задает режим входа для пользователя. Значение по умолчанию — Interactive. Пакетная служба
"Интерактивный"

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон Описание
пул пакетной службы Azure без общедоступных IP-адресов

развертывание в Azure
Этот шаблон создает упрощенный пул обмена данными с узлами пакетной службы Azure без общедоступных IP-адресов.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса batchAccounts/пулов можно развернуть с помощью операций, предназначенных для следующих операций:

  • групп ресурсов

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

Формат ресурса

Чтобы создать ресурс Microsoft.Batch/batchAccounts/pools, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/pools@2024-07-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      applicationLicenses = [
        "string"
      ]
      applicationPackages = [
        {
          id = "string"
          version = "string"
        }
      ]
      certificates = [
        {
          id = "string"
          storeLocation = "string"
          storeName = "string"
          visibility = [
            "string"
          ]
        }
      ]
      deploymentConfiguration = {
        virtualMachineConfiguration = {
          containerConfiguration = {
            containerImageNames = [
              "string"
            ]
            containerRegistries = [
              {
                identityReference = {
                  resourceId = "string"
                }
                password = "string"
                registryServer = "string"
                username = "string"
              }
            ]
            type = "string"
          }
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          diskEncryptionConfiguration = {
            targets = [
              "string"
            ]
          }
          extensions = [
            {
              autoUpgradeMinorVersion = bool
              enableAutomaticUpgrade = bool
              name = "string"
              protectedSettings = ?
              provisionAfterExtensions = [
                "string"
              ]
              publisher = "string"
              settings = ?
              type = "string"
              typeHandlerVersion = "string"
            }
          ]
          imageReference = {
            communityGalleryImageId = "string"
            id = "string"
            offer = "string"
            publisher = "string"
            sharedGalleryImageId = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          nodePlacementConfiguration = {
            policy = "string"
          }
          osDisk = {
            caching = "string"
            diskSizeGB = int
            ephemeralOSDiskSettings = {
              placement = "CacheDisk"
            }
            managedDisk = {
              securityProfile = {
                securityEncryptionType = "string"
              }
              storageAccountType = "string"
            }
            writeAcceleratorEnabled = bool
          }
          securityProfile = {
            encryptionAtHost = bool
            securityType = "string"
            uefiSettings = {
              secureBootEnabled = bool
              vTpmEnabled = bool
            }
          }
          serviceArtifactReference = {
            id = "string"
          }
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      mountConfiguration = [
        {
          azureBlobFileSystemConfiguration = {
            accountKey = "string"
            accountName = "string"
            blobfuseOptions = "string"
            containerName = "string"
            identityReference = {
              resourceId = "string"
            }
            relativeMountPath = "string"
            sasKey = "string"
          }
          azureFileShareConfiguration = {
            accountKey = "string"
            accountName = "string"
            azureFileUrl = "string"
            mountOptions = "string"
            relativeMountPath = "string"
          }
          cifsMountConfiguration = {
            mountOptions = "string"
            password = "string"
            relativeMountPath = "string"
            source = "string"
            userName = "string"
          }
          nfsMountConfiguration = {
            mountOptions = "string"
            relativeMountPath = "string"
            source = "string"
          }
        }
      ]
      networkConfiguration = {
        dynamicVnetAssignmentScope = "string"
        enableAcceleratedNetworking = bool
        endpointConfiguration = {
          inboundNatPools = [
            {
              backendPort = int
              frontendPortRangeEnd = int
              frontendPortRangeStart = int
              name = "string"
              networkSecurityGroupRules = [
                {
                  access = "string"
                  priority = int
                  sourceAddressPrefix = "string"
                  sourcePortRanges = [
                    "string"
                  ]
                }
              ]
              protocol = "string"
            }
          ]
        }
        publicIPAddressConfiguration = {
          ipAddressIds = [
            "string"
          ]
          provision = "string"
        }
        subnetId = "string"
      }
      resourceTags = {
        {customized property} = "string"
      }
      scaleSettings = {
        autoScale = {
          evaluationInterval = "string"
          formula = "string"
        }
        fixedScale = {
          nodeDeallocationOption = "string"
          resizeTimeout = "string"
          targetDedicatedNodes = int
          targetLowPriorityNodes = int
        }
      }
      startTask = {
        commandLine = "string"
        containerSettings = {
          containerHostBatchBindMounts = [
            {
              isReadOnly = bool
              source = "string"
            }
          ]
          containerRunOptions = "string"
          imageName = "string"
          registry = {
            identityReference = {
              resourceId = "string"
            }
            password = "string"
            registryServer = "string"
            username = "string"
          }
          workingDirectory = "string"
        }
        environmentSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        maxTaskRetryCount = int
        resourceFiles = [
          {
            autoStorageContainerName = "string"
            blobPrefix = "string"
            fileMode = "string"
            filePath = "string"
            httpUrl = "string"
            identityReference = {
              resourceId = "string"
            }
            storageContainerUrl = "string"
          }
        ]
        userIdentity = {
          autoUser = {
            elevationLevel = "string"
            scope = "string"
          }
          userName = "string"
        }
        waitForSuccess = bool
      }
      targetNodeCommunicationMode = "string"
      taskSchedulingPolicy = {
        nodeFillType = "string"
      }
      taskSlotsPerNode = int
      upgradePolicy = {
        automaticOSUpgradePolicy = {
          disableAutomaticRollback = bool
          enableAutomaticOSUpgrade = bool
          osRollingUpgradeDeferral = bool
          useRollingUpgradePolicy = bool
        }
        mode = "string"
        rollingUpgradePolicy = {
          enableCrossZoneUpgrade = bool
          maxBatchInstancePercent = int
          maxUnhealthyInstancePercent = int
          maxUnhealthyUpgradedInstancePercent = int
          pauseTimeBetweenBatches = "string"
          prioritizeUnhealthyInstances = bool
          rollbackFailedInstancesOnPolicyBreach = bool
        }
      }
      userAccounts = [
        {
          elevationLevel = "string"
          linuxUserConfiguration = {
            gid = int
            sshPrivateKey = "string"
            uid = int
          }
          name = "string"
          password = "string"
          windowsUserConfiguration = {
            loginMode = "string"
          }
        }
      ]
      vmSize = "string"
    }
  }
}

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

Microsoft.Batch/batchAccounts/пулы

Имя Описание Ценность
тождество Тип удостоверения, используемого для пула пакетной службы. BatchPoolIdentity (Идентификация BatchPool)
имя Имя ресурса струна

Ограничения целостности:
Минимальная длина = 1
Максимальная длина = 64
Pattern = ^[a-zA-Z0-9_-]+$ (обязательно)
идентификатор_родителя Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: batchAccounts
свойства Свойства, связанные с пулом. Свойства пула
Теги Теги ресурсов Словарь имен и значений тегов.
тип Тип ресурса "Microsoft.Batch/batchAccounts/pools@2024-07-01"

ApplicationPackageReference

Имя Описание Ценность
идентификатор Идентификатор устанавливаемого пакета приложения. Это должно находиться внутри той же учетной записи пакетной службы, что и пул. Это может быть ссылка на определенную версию или версию по умолчанию, если она существует. строка (обязательно)
Версия Если это опущено, и для этого приложения не указана версия по умолчанию, запрос завершается сбоем с кодом ошибки InvalidApplicationPackageReferences. Если вы вызываете REST API напрямую, код состояния HTTP равен 409. струна

АвтоматическиOSUpgradePolicy

Имя Описание Ценность
disableAutomaticRollback Следует ли отключить функцию отката образа ОС. булевая переменная (bool)
enableAutomaticOSУпгрейд Указывает, следует ли автоматически применять обновления ОС к экземплярам масштабируемого набора в последовательном режиме, когда становится доступной более новая версия образа ОС.

Если для пулов windows задано значение true, WindowsConfiguration.enableAutomaticUpdates не может быть задано значение true.
булевая переменная (bool)
osRollingUpgradeDeferral Отложить обновление ОС на телевизорах, если они выполняют задачи. булевая переменная (bool)
useRollingUpgradePolicy Указывает, следует ли использовать политику последовательного обновления во время автоматического обновления ОС. Автоматическое обновление ОС откатится к политике по умолчанию, если политика не определена в VMSS. булевая переменная (bool)

АвтомасштабированиеSettings

Имя Описание Ценность
оценкаИнтервал Если опущено, значение по умолчанию — 15 минут (PT15M). струна
формула Формула для требуемого количества вычислительных узлов в пуле. строка (обязательно)

Спецификация AutoUserSpecification

Имя Описание Ценность
elevationLevel Значение по умолчанию — nonAdmin. "Администратор"
«Не-администратор»
размах Значением по умолчанию является пул. Если пул работает под управлением Windows, необходимо указать значение задачи, если требуется более строгая изоляция между задачами. Например, если задача мутирует реестр таким образом, что может повлиять на другие задачи, или если сертификаты были указаны в пуле, который не должен быть доступен обычными задачами, но должен быть доступен путем запуска задач. "Пул"
"Задача"

AzureBlobFileSystemConfiguration

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

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
Имя аккаунта Имя учетной записи хранения Azure. строка (обязательно)
blobfuseOptions Это параметры "net use" в Windows и "подключение" в Linux. струна
имяКонтейнера Имя контейнера хранилища BLOB-объектов Azure. строка (обязательно)
Справочная информация об идентичности Это свойство является взаимоисключающим как с accountKey, так и sasKey; необходимо указать именно один. Справочник по идентичности вычислительного узла
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
sasKey Это свойство является взаимоисключающим как с accountKey, так и с удостоверением; необходимо указать именно один. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.

Конфигурация AzureFileShare

Имя Описание Ценность
accountKey Ключ учетной записи хранения Azure. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
Имя аккаунта Имя учетной записи хранения Azure. строка (обязательно)
azureFileUrl Это форма "https://{account}.file.core.windows.net/". строка (обязательно)
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)

AzureProxyResourceTags

Имя Описание Ценность

BatchPoolIdentity (Идентификация BatchPool)

Имя Описание Ценность
тип Тип удостоверения, используемого для пула пакетной службы. "Нет"
UserAssigned (обязательно)
ИдентичностиНазначенныеПользователем Список удостоверений пользователей, связанных с пулом пакетной службы. BatchPoolIdentityUserAssignedIdentities

BatchPoolIdentityUserAssignedIdentities

Имя Описание Ценность

СертификатСсылка

Имя Описание Ценность
идентификатор Полный идентификатор сертификата для установки в пуле. Это должно находиться внутри той же учетной записи пакетной службы, что и пул. строка (обязательно)
Местоположение магазина Значение по умолчанию — currentUser. Это свойство применимо только для пулов, настроенных с вычислительными узлами Windows. Для вычислительных узлов Linux сертификаты хранятся в каталоге рабочих каталогов задач, а переменная среды AZ_BATCH_CERTIFICATES_DIR предоставляется задаче для запроса к этому расположению. Для сертификатов с видимостью remoteUser каталог "certs" создается в домашнем каталоге пользователя (например, /home/{user-name}/certs) и сертификаты помещаются в этот каталог. CurrentUser
LocalMachine
название магазина Это свойство применимо только для пулов, настроенных с вычислительными узлами Windows. Распространенные имена хранилищ: My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, но любое пользовательское имя хранилища также можно использовать. Значением по умолчанию является My. струна
видимость Какие учетные записи пользователей на вычислительном узле должны иметь доступ к частным данным сертификата. Массив строк, содержащий любой из:
RemoteUser
StartTask
"Задача"

Конфигурация CifsMount

Имя Описание Ценность
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
пароль Пароль, используемый для проверки подлинности в файловой системе CIFS. струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра. (обязательно)
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
источник Универсальный код ресурса (URI) файловой системы для подключения. строка (обязательно)
userName Пользователь, используемый для проверки подлинности в файловой системе CIFS. строка (обязательно)

Справочник по идентичности вычислительного узла

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

ContainerConfiguration (Конфигурация контейнера)

Имя Описание Ценность
containerImageNames Это полная ссылка на изображение, как было бы указано для параметра docker pull. Образ будет получен из реестра Docker по умолчанию, если образ не является полным с альтернативным реестром. строка[]
containerRegistries Если какие-либо образы должны быть загружены из частного реестра, для которого требуются учетные данные, эти учетные данные должны быть предоставлены здесь. ContainerRegistry[]
тип Используемая технология контейнера. «Совместимость с CriCompatible»
DockerCompatible (обязательный)

ContainerHostBatchBindMountEntry

Имя Описание Ценность
isReadOnly Если вы подключаете этот путь как режим чтения и записи, это не означает, что у всех пользователей в контейнере есть доступ на чтение и запись для пути, он зависит от доступа на виртуальной машине узла. Если этот путь подключен только для чтения, все пользователи в контейнере не смогут изменить путь. булевая переменная (bool)
источник Пути, которые будут подключены к контейнеру задачи контейнера. "Приложения"
JobPrep
"Общий"
"Startup"
"Задача"
"VfsMounts"

ContainerRegistry (ContainerRegistry)

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

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
сервер реестра Если опущено, значение по умолчанию — "docker.io". струна
имя пользователя Имя пользователя для входа на сервер реестра. струна

ДатаДиск

Имя Описание Ценность
Кэширование Значения:

none — режим кэширования для диска не включен.
readOnly — режим кэширования для диска доступен только для чтения.
readWrite — режим кэширования для диска считывается и записывается.

Значение по умолчанию для кэширования не имеет значения. Сведения о параметрах кэширования см. в статье https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.
"Нет"
"ReadOnly"
ReadWrite
Размер дискаГб Начальный размер диска в ГБ при создании нового диска данных. int (обязательно)
Лунь Луна используется для уникальной идентификации каждого диска данных. При подключении нескольких дисков каждый должен иметь отдельную луну. Значение должно быть от 0 до 63 включительно. int (обязательно)
Тип учетной записи хранилища Если опущено, значение по умолчанию — "Standard_LRS". Значения:

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

РазвертываниеКонфигурация

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

DiffDiskSettings (Настройки DiffDisk)

Имя Описание Ценность
размещение Это свойство можно использовать пользователем в запросе, чтобы выбрать расположение операционной системы. Например, кэшировать место на диске для подготовки диска Эфемеральной ОС. Дополнительные сведения о требованиях к размеру диска в Эфемеральной ОС см. в разделе "Требования к размеру диска операционной системы" для виртуальных машин Windows в разделе /azure/virtual-machines/windows/ephemeral-os-disks#size-requirements и виртуальных машин Linux в /azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. CacheDisk

DiskEncryptionConfiguration (Настройка дискового шифрования)

Имя Описание Ценность
Цели В пуле Linux поддерживается только временныйdisk; В пуле Windows необходимо указать "OsDisk" и "TemporaryDisk". Массив строк, содержащий любой из:
OsDisk
"ВременныйDisk"

Окружающая средаНастройка

Имя Описание Ценность
имя Имя переменной среды. строка (обязательно)
ценность Значение переменной среды. струна

ФиксированныеScaleSettings

Имя Описание Ценность
nodeDeallocationOption Если опущено, значение по умолчанию — Requeue. "Requeue"
"СохранитьedData"
TaskCompletion
"Завершение"
resizeTimeout Значение по умолчанию — 15 минут. Значения времени ожидания используют формат ISO 8601. Например, используйте PT10M в течение 10 минут. Минимальное значение — 5 минут. Если указать значение менее 5 минут, служба пакетной службы отклоняет запрос с ошибкой; Если вы вызываете REST API напрямую, код состояния HTTP равен 400 (недопустимый запрос). струна
targetDedicatedNodes По крайней мере один из целевыхDedicatedNodes, необходимо задать targetLowPriorityNodes. инт
targetLowPriorityNodes По крайней мере один из целевыхDedicatedNodes, необходимо задать targetLowPriorityNodes. инт

Ссылка на изображение

Имя Описание Ценность
communityGalleryImageId Это свойство является взаимоисключающим с другими свойствами и может быть получено из вызова GET коллекции сообщества. струна
идентификатор Это свойство является взаимоисключающим с другими свойствами. Образ коллекции вычислений Azure должен иметь реплики в том же регионе, что и учетная запись пакетной службы Azure. Сведения о параметрах брандмауэра для агента узла пакетной службы для взаимодействия с пакетной службой см. в статье /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration. струна
предлагать Например, UbuntuServer или WindowsServer. струна
издатель Например, Canonical или MicrosoftWindowsServer. струна
sharedGalleryImageId Это свойство является взаимоисключающим с другими свойствами и может быть получено из вызова GET образа общей коллекции. струна
SKU Например, 18.04-LTS или 2022-datacenter. струна
Версия Чтобы выбрать последнюю версию образа, можно указать значение "последняя". Если опущено, значение по умолчанию — "последняя". струна

Входящий NatPool (Входящий NatPool)

Имя Описание Ценность
серверный порт Это должно быть уникальным в пуле пакетной службы. Допустимые значения : от 1 до 65535, за исключением 29876 и 29877, так как они зарезервированы. Если указаны зарезервированные значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
frontendPortRangeEnd Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, зарезервированных пакетной службой. Все диапазоны в пуле должны быть уникальными и не могут перекрываться. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
frontendPortRangeStart Допустимые значения варьируются от 1 до 65534, за исключением портов от 50000 до 55000, которые зарезервированы. Все диапазоны в пуле должны быть уникальными и не могут перекрываться. Если указаны зарезервированные или перекрывающиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
имя Имя должно быть уникальным в пуле пакетной службы, может содержать буквы, цифры, подчеркивания, периоды и дефисы. Имена должны начинаться с буквы или числа, заканчиваться буквой, числом или подчеркиванием и не может превышать 77 символов. Если указаны недопустимые значения, запрос завершается ошибкой с кодом состояния HTTP 400. строка (обязательно)
networkSecurityGroupRules Максимальное количество правил, которые можно указать во всех конечных точках в пуле пакетной службы, равно 25. Если правила группы безопасности сети не указаны, будет создано правило по умолчанию, чтобы разрешить входящий доступ к указанному внутреннему порту. Если максимальное число правил группы безопасности сети превышается, запрос завершается ошибкой с кодом состояния HTTP 400. Правило NetworkSecurityGroup[]
протокол Протокол конечной точки. "TCP"
UDP (обязательно)

LinuxUserConfiguration

Имя Описание Ценность
гид Свойства пользовательского интерфейса и gid должны быть указаны вместе или не вообще. Если не указана базовая операционная система, выбирает гиб. инт
sshPrivateKey Закрытый ключ не должен быть защищен паролем. Закрытый ключ используется для автоматической настройки асимметричной проверки подлинности на основе ключа для SSH между узлами в пуле Linux, если свойство enableInterNodeCommunication пула имеет значение true (оно игнорируется, если enableInterNodeCommunication имеет значение false). Для этого поместите пару ключей в каталог SSH пользователя. Если он не указан, SSH без пароля не настроен между узлами (не выполняется изменение каталога SSH пользователя). струна

Ограничения целостности:
Конфиденциальное значение. Передайте в качестве безопасного параметра.
уникальный идентификатор (УИД) Свойства пользовательского интерфейса и gid должны быть указаны вместе или не вообще. Если базовая операционная система не указана, выбирает пользовательский интерфейс. инт

Управляемый диск

Имя Описание Ценность
securityProfile Задает параметры профиля безопасности для управляемого диска. примечание. Оно может быть задано только для конфиденциальных виртуальных машин и требуется при использовании конфиденциальных виртуальных машин. VMDiskSecurityProfile
Тип учетной записи хранилища Тип учетной записи хранения для создания дисков данных или диска ОС. "Premium_LRS"
"StandardSSD_LRS"
"Standard_LRS"

МетаdataItem (МетаданныеItem)

Имя Описание Ценность
имя Имя элемента метаданных. строка (обязательно)
ценность Значение элемента метаданных. строка (обязательно)

МонтированиеКонфигурация

Имя Описание Ценность
azureBlobFileSystemConfiguration Это свойство является взаимоисключающим со всеми другими свойствами. AzureBlobFileSystemConfiguration
azureFileShareConfiguration Это свойство является взаимоисключающим со всеми другими свойствами. Конфигурация AzureFileShare
Конфигурация cifsMount Это свойство является взаимоисключающим со всеми другими свойствами. Конфигурация CifsMount
Конфигурация nfsMount Это свойство является взаимоисключающим со всеми другими свойствами. NFSMountConfiguration

Сетевая конфигурация

Имя Описание Ценность
DynamicVnetAssignmentScope Область динамического назначения виртуальной сети. «Работа»
"нет"
enableAcceleratedNetworking Ускорение сети обеспечивает виртуализацию одно корневых операций ввода-вывода (SR-IOV) к виртуальной машине, что может привести к повышению производительности сети. Дополнительные сведения см. в статье /azure/virtual-network/accelerated-networking-overview. булевая переменная (bool)
конечная точкаКонфигурация Конфигурация конечной точки для пула. PoolEndpointConfiguration (Конфигурация пулаEndpoint)
publicIPAddressConfiguration Конфигурация общедоступного IP-адреса конфигурации сети пула. PublicIPAddressConfiguration (ПубличныйIPAddressConfiguration)
SubnetId Виртуальная сеть должна находиться в том же регионе и подписке, что и учетная запись пакетной службы Azure. Указанная подсеть должна иметь достаточно свободных IP-адресов для размещения количества узлов в пуле. Если подсеть не имеет достаточно свободных IP-адресов, пул частично выделяет вычислительные узлы и возникнет ошибка изменения размера. Субъект-служба MicrosoftAzureBatch должна иметь роль "Участник классической виртуальной машины" Role-Based управление доступом (RBAC) для указанной виртуальной сети. Указанная подсеть должна разрешить обмен данными из пакетной службы Azure, чтобы иметь возможность планировать задачи на вычислительных узлах. Это можно проверить, проверьте, имеет ли указанная виртуальная сеть любые связанные группы безопасности сети (NSG). Если связь с вычислительными узлами в указанной подсети запрещена группой безопасности сети, служба пакетной службы установит состояние вычислительных узлов неиспользуемым. Если указанная виртуальная сеть имеет любые связанные группы безопасности сети (NSG), для входящие подключения необходимо включить несколько зарезервированных системных портов, включая порты 29876 и 29877. Также включите исходящие подключения к службе хранилища Azure через порт 443. Дополнительные сведения см. в статье /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration струна

Правило NetworkSecurityGroupRule

Имя Описание Ценность
доступ Действие, которое следует предпринять для указанного IP-адреса, диапазона подсети или тега. "Разрешить"
"Запрет" (обязательно)
приоритет Приоритеты в пуле должны быть уникальными и оцениваются в порядке приоритета. Чем ниже число, тем выше приоритет. Например, правила можно указать с номерами заказов 150, 250 и 350. Правило с порядком 150 имеет приоритет над правилом, которое имеет порядок 250. Допустимые приоритеты — от 150 до 4096. Если указаны зарезервированные или повторяющиеся значения, запрос завершается ошибкой с кодом состояния HTTP 400. int (обязательно)
sourceAddressPrefix Допустимые значения — это один IP-адрес (например, 10.10.10.10), подсеть IP -адресов (т. е. 192.168.1.0/24), тег по умолчанию или * (для всех адресов). Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400. строка (обязательно)
sourcePortRanges Допустимые значения: "*" (для всех портов 0 – 65535) или массивов портов или диапазонов портов (т. е. 100–200). Порты должны находиться в диапазоне от 0 до 65535, а диапазоны портов или порты не могут перекрываться. Если указаны другие значения, запрос завершается ошибкой с кодом состояния HTTP 400. Значение по умолчанию будет *. строка[]

NFSMountConfiguration

Имя Описание Ценность
Варианты монтирования Это параметры "net use" в Windows и "подключение" в Linux. струна
relativeMountPath Все файловые системы подключены относительно каталога подключений пакетной службы, доступные с помощью переменной среды AZ_BATCH_NODE_MOUNTS_DIR. строка (обязательно)
источник Универсальный код ресурса (URI) файловой системы для подключения. строка (обязательно)

NodePlacementConfiguration (Конфигурация NodePlacement)

Имя Описание Ценность
политика Политика выделения, используемая пакетной службой для подготовки узлов. Если оно не указано, пакетная служба будет использовать региональную политику. "Региональный"
"Зональный"

OSDisk

Имя Описание Ценность
Кэширование Тип кэширования для диска. "Нет"
"ReadOnly"
ReadWrite
Размер дискаГб Начальный размер диска в ГБ при создании нового диска ОС. инт
эфемералOSDiskSettings Задает временные параметры диска для диска операционной системы, используемого виртуальной машиной. DiffDiskSettings (Настройки DiffDisk)
managedDisk Управляемый диск
writeAcceleratorEnabled Указывает, следует ли включить или отключить записьAccelerator на диске. булевая переменная (bool)

PoolEndpointConfiguration (Конфигурация пулаEndpoint)

Имя Описание Ценность
входящиеNatPools Максимальное количество входящих пулов NAT на пул пакетной службы составляет 5. Если максимальное число входящих пулов NAT превышается, запрос завершается ошибкой с кодом состояния HTTP 400. Это невозможно указать, если IPAddressProvisioningType — NoPublicIPAddresses. InboundNatPool[] (обязательно)

Свойства пула

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

Предупреждение. Это свойство устарело и будет удалено после февраля 2024 года. Вместо этого используйте расширения Azure KeyVault .
Справка о сертификате[]
deploymentConfiguration Свойства конфигурации развертывания. РазвертываниеКонфигурация
отображаемое имя Отображаемое имя не должно быть уникальным и может содержать любые символы Юникода до максимальной длины 1024. струна
interNodeCommunication Это накладывает ограничения на назначение узлов пулу. Включение этого значения может снизить вероятность выделения запрошенного количества узлов в пуле. Если этот параметр не указан, значение по умолчанию имеет значение "Отключено". "Отключено"
"Включено"
метаданные Пакетная служба не назначает никакое значение метаданным; он предназначен исключительно для использования пользовательского кода. МетаданныеItem[]
mountConfiguration Это поддерживает файлы Azure, NFS, CIFS/SMB и Blobfuse. Конфигурация монтирования[]
networkConfiguration Конфигурация сети для пула. Конфигурация сети
теги ресурса Определяемые пользователем теги, связанные с пулом пакетной службы Azure. При указании эти теги распространяются на резервные ресурсы Azure, связанные с пулом. Это свойство можно указать только при создании учетной записи пакетной службы с свойством poolAllocationMode с значением UserSubscription. PoolPropertiesResourceTags
параметры масштабирования Определяет требуемый размер пула. Это может быть "фиксированный масштаб", где указан запрошенный целевой идентификаторNodes или "автомасштабирование", определяющий формулу, которая периодически переоценится. Если это свойство не указано, пул будет иметь фиксированный масштаб с 0 targetDedicatedNodes. ScaleSettings (МасштабНастройки)
начатьЗадачу В операции PATCH (update) это свойство можно задать для пустого объекта, чтобы удалить начальную задачу из пула. СтартЗадача
targetNodeCommunicationMode Если опущено, значение по умолчанию — Default. "Классический"
По умолчанию
"Упрощено"
taskSchedulingPolicy Если значение не указано, по умолчанию распространяется. TaskSchedulingPolicy
taskSlotsPerNode Значение по умолчанию — 1. Максимальное значение меньше 4 раза меньше числа ядер vmSize пула или 256. инт
upgradeПолитика Описывает политику обновления — автоматическую, ручную или перекатную. Политика обновления
userAccounts Список учетных записей пользователей, создаваемых на каждом узле в пуле. Учетная запись пользователя[]
vmSize Сведения о доступных размерах виртуальных машин см. в разделе "Размеры виртуальных машин" в Azure (/azure/virtual-machines/sizes/overview). Пакетная служба поддерживает все размеры виртуальных машин Azure, кроме STANDARD_A0 и хранилища класса Premium (STANDARD_GS, STANDARD_DS и серии STANDARD_DSV2). струна

PoolPropertiesResourceTags

Имя Описание Ценность

PublicIPAddressConfiguration (ПубличныйIPAddressConfiguration)

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

РесурсФайл

Имя Описание Ценность
autoStorageContainerName Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. струна
BLOBPrefix Свойство допустимо, только если используется autoStorageContainerName или storageContainerUrl. Этот префикс может быть частичным именем файла или подкаталогом. Если префикс не указан, все файлы в контейнере будут скачаны. струна
Режим файла Это свойство применяется только к файлам, скачанным на вычислительные узлы Linux. Он будет игнорироваться, если он указан для resourceFile, который будет скачан на узел Windows. Если это свойство не указано для узла Linux, к файлу применяется значение по умолчанию 0770. струна
путь к файлу Если задано свойство httpUrl, файлPath является обязательным и описывает путь, в который будет скачан файл, включая имя файла. В противном случае, если задано свойство autoStorageContainerName или storageContainerUrl, filePath является необязательным и является каталогом для скачивания файлов. В случае, когда filePath используется в качестве каталога, любая структура каталогов, уже связанная с входными данными, будет сохранена в полном объеме и добавлена в указанный каталог filePath. Указанный относительный путь не может выйти из рабочего каталога задачи (например, с помощью '.'). струна
httpUrl (httpUrl) Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Если URL-адрес указывает на хранилище BLOB-объектов Azure, он должен быть доступен для чтения с вычислительных узлов. Существует три способа получить такой URL-адрес для большого двоичного объекта в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение большого двоичного объекта, использовать управляемое удостоверение с разрешением на чтение или задать ACL для большого двоичного объекта или его контейнера, чтобы разрешить общедоступный доступ. струна
Справочная информация об идентичности Ссылка на назначенное пользователем удостоверение, связанное с пулом пакетной службы, который будет использовать вычислительный узел. Справочник по идентичности вычислительного узла
storageContainerUrl Свойства autoStorageContainerName, storageContainerUrl и httpUrl являются взаимоисключающими, и один из них должен быть указан. Этот URL-адрес должен быть доступен для чтения и перечисления из вычислительных узлов. Существует три способа получить такой URL-адрес для контейнера в хранилище Azure: включить подписанный URL-адрес (SAS), предоставляющий разрешения на чтение и список для контейнера, использовать управляемое удостоверение с разрешениями на чтение и список или задать ACL для контейнера, чтобы разрешить общедоступный доступ. струна

Политика скользящего обновления

Имя Описание Ценность
enableCrossZoneUpgrade Разрешить VMSS игнорировать границы AZ при создании пакетов обновления. Учитывайте домен обновления и maxBatchInstancePercent, чтобы определить размер пакета. Если это поле не задано, пакетная служба Azure не установит значение по умолчанию. Значение enableCrossZoneUpgrade в созданном VirtualMachineScaleSet будет определено конфигурацией по умолчанию в VirtualMachineScaleSet. Это поле может иметь значение true или false только при использовании NodePlacementConfiguration в качестве зонального. булевая переменная (bool)
maxBatchInstancePercent Максимальный процент общих экземпляров виртуальных машин, которые будут обновляться одновременно путем последовательного обновления в одном пакете. Так как это максимальный, неработоспособные экземпляры в предыдущих или будущих пакетах могут привести к снижению процента экземпляров в пакете, чтобы обеспечить более высокую надежность. Значение этого поля должно составлять от 5 до 100 включительно. Если значение maxBatchInstancePercent и maxUnhealthyInstancePercent присваивается значением, значение maxBatchInstancePercent не должно превышать maxUnhealthyInstancePercent. int

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

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

Ограничения целостности:
Минимальное значение = 0
Максимальное значение = 100
pauseTimeBetweenBatches Время ожидания между завершением обновления для всех виртуальных машин в одном пакете и запуском следующего пакета. Длительность времени должна быть указана в формате ISO 8601. струна
приоритетыUnhealthyInstances Обновите все неработоспособные экземпляры в масштабируемом наборе до всех здоровых экземпляров. булевая переменная (bool)
rollbackFailedInstancesOnPolicyBreach Откат неудачных экземпляров до предыдущей модели, если политика последовательного обновления нарушена. булевая переменная (bool)

Настройки масштабирования

Имя Описание Ценность
автомасштабирование Это свойство и фиксированное масштабирование являются взаимоисключающими, и необходимо указать одно из свойств. АвтомасштабированиеSettings
fixedScale Это свойство и автомасштабирование являются взаимоисключающими, и необходимо указать одно из свойств. ФиксированныеScaleSettings

Профиль безопасности

Имя Описание Ценность
encryptionAtHost Это свойство можно использовать пользователем в запросе, чтобы включить или отключить шифрование узла для виртуальной машины или масштабируемого набора виртуальных машин. Это позволит включить шифрование для всех дисков, включая диск Resource/Temp на самом узле. булевая переменная (bool)
securityType Указывает тип безопасности виртуальной машины. Для включения UefiSettings необходимо задать любое указанное значение. "confidentialVM"
'trustedLaunch'
uefiНастройки Указывает параметры безопасности, такие как безопасная загрузка и vTPM, используемые при создании виртуальной машины. Настройки Uefi

Справочник по артефактам

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

СтартЗадача

Имя Описание Ценность
командная строка Командная строка не выполняется под оболочкой и поэтому не может воспользоваться преимуществами функций оболочки, таких как расширение переменной среды. Если вы хотите воспользоваться такими функциями, необходимо вызвать оболочку в командной строке, например с помощью cmd /c MyCommand в Windows или "/bin/sh -c MyCommand" в Linux. Требуется, если указаны другие свойства startTask. струна
Настройки контейнера При указании все каталоги рекурсивно под AZ_BATCH_NODE_ROOT_DIR (корнем каталогов пакетной службы Azure на узле) сопоставляются с контейнером, все переменные среды задач сопоставляются с контейнером, а командная строка задачи выполняется в контейнере. TaskContainerSettings (ЗадачиКонтейнерНастройки)
средаНастройки Список параметров переменной среды для начальной задачи. Окружающая средаНастройка[]
maxTaskRetryCount Пакетная служба повторяет задачу, если его код выхода не является ненулевой. Обратите внимание, что это значение специально управляет числом повторных попыток. Пакетная служба попытается выполнить задачу один раз, а затем повторите попытку до этого ограничения. Например, если максимальное число повторных попыток равно 3, пакетная служба пытается выполнить задачу до 4 раз (одна начальная попытка и 3 повторные попытки). Если максимальное число повторных попыток равно 0, пакетная служба не повторяет задачу. Если максимальное число повторных попыток равно -1, пакетная служба повторяет задачу без ограничения. Значение по умолчанию — 0 инт
Файлы ресурсов Список файлов, которые служба пакетной службы скачивает на вычислительный узел перед выполнением командной строки. РесурсФайл[]
userIdentity Если этот параметр не указан, задача выполняется как пользователь, не являющийся администратором, уникальным для задачи. Идентификация пользователя
waitForSuccess Если значение true и задача запуска завершается сбоем на вычислительном узле, пакетная служба повторяет задачу запуска до максимального количества повторных попыток (maxTaskRetryCount). Если задача по-прежнему не выполнена успешно после всех повторных попыток, служба пакетной службы помечает вычислительный узел неиспользуемым и не запланирует задачи. Это условие можно обнаружить с помощью состояния узла и подробных сведений об ошибке планирования. Если значение false, служба пакетной службы не ожидает завершения начальной задачи. В этом случае другие задачи могут запускаться на вычислительном узле, пока задача запуска по-прежнему выполняется; и даже если задача запуска завершается сбоем, новые задачи будут продолжать планироваться на узле. Значение по умолчанию — true. булевая переменная (bool)

TaskContainerSettings (ЗадачиКонтейнерНастройки)

Имя Описание Ценность
containerHostBatchBindMounts Если этот массив имеет значение NULL или отсутствует, задача контейнера будет подключать весь временный диск диска в окнах (или AZ_BATCH_NODE_ROOT_DIR в Linux). Он не будет подключать пути к данным в контейнер, если этот массив задан как пустой. ContainerHostBatchBindMountEntry[]
containerRunOptions Эти дополнительные параметры предоставляются в качестве аргументов в команду docker create, а также те, которые управляются пакетной службой. струна
названиеИзображения Это полная ссылка на изображение, как было бы указано для параметра docker pull. Если тег не указан как часть имени изображения, тег ":latest" используется в качестве значения по умолчанию. строка (обязательно)
регистратура Этот параметр может быть опущен, если он уже был предоставлен при создании пула. ContainerRegistry (ContainerRegistry)
workingDirectory Флаг, указывающий, где находится рабочий каталог задачи контейнера. Значение по умолчанию — taskWorkingDirectory. ContainerImageDefault
TaskWorkingDirectory

TaskSchedulingPolicy

Имя Описание Ценность
nodeFillType Порядок распределения задач между вычислительными узлами. "Pack"
"Распространение" (обязательно)

Настройки Uefi

Имя Описание Ценность
secureBootEnabled Указывает, следует ли включить безопасную загрузку на виртуальной машине. булевая переменная (bool)
Включен vTpm Указывает, следует ли включить vTPM на виртуальной машине. булевая переменная (bool)

Политика обновления

Имя Описание Ценность
autoicOSUpgradePolicy Параметры конфигурации, используемые для автоматического обновления ОС. АвтоматическиOSUpgradePolicy
режим Задает режим обновления до виртуальных машин в масштабируемом наборе.

Возможные значения:

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

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

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

Учетная запись пользователя

Имя Описание Ценность
elevationLevel nonAdmin — автоматический пользователь является стандартным пользователем без повышенного доступа. администратор . Автоматический пользователь является пользователем с повышенным доступом и работает с полными разрешениями администратора. Значение по умолчанию — nonAdmin. "Администратор"
«Не-администратор»
linuxUserConfiguration Это свойство игнорируется, если указано в пуле Windows. Если это не указано, пользователь создается с параметрами по умолчанию. LinuxUserConfiguration
имя Имя учетной записи пользователя. Имена могут содержать любые символы Юникода до максимальной длины 20. строка (обязательно)
пароль Пароль для учетной записи пользователя. струна

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

UserAssignedIdentity (Пользовательские идентификаторы)

Имя Описание Ценность

Идентификатор пользователя

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

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

Имя Описание Ценность
Конфигурация контейнера Если задано, программа установки выполняется на каждом узле в пуле, чтобы разрешить выполнение задач в контейнерах. Все обычные задачи и задачи диспетчера заданий, выполняемые в этом пуле, должны указывать свойство containerSettings, а все остальные задачи могут указывать его. ContainerConfiguration (Конфигурация контейнера)
Диски данных Это свойство должно быть указано, если вычислительные узлы в пуле должны иметь пустые диски данных, подключенные к ним. Диск данных[]
diskEncryptionConfiguration При указании шифрование выполняется на каждом узле в пуле во время подготовки узлов. DiskEncryptionConfiguration (Настройка дискового шифрования)
Расширения При указании расширения, упомянутые в этой конфигурации, будут установлены на каждом узле. VMExtension[]
ImageReference Ссылка на образ Виртуальной машины Azure Marketplace или ресурс образа Azure настраиваемой виртуальной машины. Чтобы получить список всех образовReference, проверенных пакетной службой Azure, см. операцию "Список поддерживаемых номеров SKU агента узлов". ImageReference (обязательно)
тип лицензии Это относится только к образам, содержащим операционную систему Windows, и следует использовать только при удержании допустимых локальных лицензий для узлов, которые будут развернуты. Если не указано, скидка на лицензирование в локальной среде не применяется. Значения:

Windows_Server . Локальная лицензия предназначена для Windows Server.
Windows_Client . Локальная лицензия предназначена для клиента Windows.
струна
nodeAgentSkuId Агент узла пакетной службы — это программа, которая выполняется на каждом узле в пуле и предоставляет интерфейс управления между узлом и пакетной службой. Существуют различные реализации агента узла, известного как номера SKU для разных операционных систем. Необходимо указать номер SKU агента узла, соответствующий выбранной ссылке на изображение. Чтобы получить список поддерживаемых номеров SKU агента узлов вместе со списком проверенных ссылок на образы, см. в разделе "Список поддерживаемых SKU агента узлов". строка (обязательно)
nodePlacementConfiguration Эта конфигурация будет указывать правила по тому, как узлы в пуле будут физически выделены. NodePlacementConfiguration (Конфигурация NodePlacement)
osDisk Содержит конфигурацию для эфемерных параметров OSDisk. OSDisk
securityProfile Задает параметры профиля безопасности для масштабируемого набора виртуальных машин или виртуальной машины. Профиль безопасности
serviceArtifactReference Идентификатор ссылки на артефакт службы в виде /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName} Справочник по артефактам
windowsКонфигурация Это свойство не должно быть указано, если imageReference указывает образ ОС Linux. WindowsКонфигурация

VMDiskSecurityProfile

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

VMExtension

Имя Описание Ценность
автоматическое обновление минорной версии Указывает, следует ли использовать более новую дополнительную версию, если она доступна во время развертывания. Однако после развертывания расширение не будет обновлять дополнительные версии без повторного развертывания, даже если это свойство не имеет значения true. булевая переменная (bool)
включитьАвтоматическоеОбновление Указывает, следует ли автоматически обновлять расширение платформой, если доступна более новая версия расширения. булевая переменная (bool)
имя Имя расширения виртуальной машины. строка (обязательно)
защищенныеНастройки Расширение может содержать защищенные параметрыSettings или protectedSettingsFromKeyVault или не иметь защищенных параметров. любой
provisionAfterExtensions Коллекция имен расширений, после которой необходимо подготовить это расширение. строка[]
издатель Имя издателя обработчика расширений. строка (обязательно)
Параметры Форматированные общедоступные параметры JSON для расширения. любой
тип Тип расширений. строка (обязательно)
версияТипаОбработчика Версия обработчика скрипта. струна

WindowsКонфигурация

Имя Описание Ценность
enableAutomaticUpdates Если опущено, значение по умолчанию имеет значение true. булевая переменная (bool)

WindowsUserConfiguration

Имя Описание Ценность
loginMode Задает режим входа для пользователя. Значение по умолчанию — Interactive. Пакетная служба
"Интерактивный"