Версионирование REST API для пакетного сервиса

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

Чтобы указать, какую версию операции использовать, установите параметр запроса api-версии . Версия выполнена в формате Group.Major.Minor, где Group находится в формате YYYY-MM-DD , Major — целое число, а Minor — целое число.

Последняя версия: 2025-06-01

Предыдущие версии

Предыдущие версии включали:

Версия: 2024-07-01.20.0

  • Добавлены операции распределения и запуска вычислительных узлов:
    • Добавлена новая ComputeNode_Deallocate операция (POST /pools/{poolId}/nodes/{nodeId}/deallocate) для размещения простоя или работающего вычислительного узла.
    • Добавлена новая ComputeNode_Start операция (POST /pools/{poolId}/nodes/{nodeId}/start) для перезапуска ранее снятого с вычислительного узла.
    • Добавлена новая NodeDeallocateParameter модель с nodeDeallocateOption свойством, указывающим, что делать с выполнением задач во время сделки.
  • [Разрыв] Удалена ComputeNode_GetRemoteDesktop операция (GET /pools/{poolId}/nodes/{nodeId}/rdp). Эта операция применялась только к пулам конфигурации облачных сервисов.
  • [Разрыв] Удалена поддержка пула конфигурации облачных сервисов:
    • Модель убрала CloudServiceConfiguration .
    • Удалённое cloudServiceConfiguration свойство из CloudPool, PoolAddParameter, и PoolSpecification.
  • [Разрыв] Удалённое applicationLicenses свойство из CloudPool, PoolAddParameter, и PoolSpecification.
  • Добавлена поддержка крепления контейнеров для задач:
    • Добавлена новая ContainerHostBatchBindMountEntry модель с source свойствами isReadOnly .
    • Добавлен новый ContainerHostDataPath enum со значениями Shared, Startup, VfsMounts, TaskJobPrep, и Applications.
    • Добавлено новое containerHostBatchBindMounts свойство TaskContainerSettingsв .
  • Добавлена поддержка Confidential VM:
    • Добавлена новая VMDiskSecurityProfile модель с особенностью securityEncryptionType .
    • Добавлено новое securityProfile свойство ManagedDiskв .
    • Добавлено confidentialVM как новое значение для SecurityProfile.securityType.
  • Добавлены deallocated и deallocating как новые значения для ComputeNodeState.
  • Добавлены новые требуемые deallocated и deallocating свойства в NodeCounts.
  • Добавлена поддержка ссылок на изображения в Shared Gallery и Community Gallery:
    • Добавлены sharedGalleryImageId и communityGalleryImageId свойства в ImageReference.
  • Добавлено skipWithdrawFromVNet свойство JobNetworkConfiguration для контроля, остаются ли узлы присоединёнными к VNet после завершения задачи.
  • Добавлено networkConfiguration свойство к JobPatchParameter.
  • Расширенные возможности патчирования пула: Добавлены displayName, vmSize, taskSlotsPerNode, enableInterNodeCommunicationtaskSchedulingPolicy, virtualMachineConfiguration, networkConfigurationuserAccountsupgradePolicymountConfigurationи resourceTags свойства к .PoolPatchParameter Свойства, влияющие на топологию пула, можно обновлять только тогда, когда пул пуст.
  • Добавлен force булевой параметр запроса к Job_Delete, Job_Terminate, JobSchedule_Deleteи JobSchedule_Terminate операции для принудительного выполнения операции.

Версия: 2024-02-01.19.0

  • Добавлена поддержка политики обновления ОС для пулов виртуальных машин:
    • Добавлена новая UpgradePolicy модель с свойствами mode, automaticOSUpgradePolicy, и rollingUpgradePolicy. Свойство mode (UpgradeMode) принимает значения automatic, manual, и rolling.
    • Добавлена новая AutomaticOSUpgradePolicy модель с свойствами disableAutomaticRollback, enableAutomaticOSUpgrade, useRollingUpgradePolicy, и osRollingUpgradeDeferral.
    • Добавлена новая RollingUpgradePolicy модель с свойствами enableCrossZoneUpgrade, maxBatchInstancePercent, maxUnhealthyInstancePercent, maxUnhealthyUpgradedInstancePercent, pauseTimeBetweenBatchesprioritizeUnhealthyInstances, , и rollbackFailedInstancesOnPolicyBreach.
    • Добавлено новое upgradePolicy свойство к CloudPool, PoolAddParameter, и PoolSpecification.
  • Добавлено upgradingos как новое значение для ComputeNodeState.
  • Добавлено новое обязательное upgradingOS свойство для NodeCounts отчёта количества узлов в upgradingos штате.

Версия: 2023-11-01.18.0

  • Добавлена поддержка доверенного запуска / профилей безопасности для пулов виртуальных машин:
    • Добавлена новая SecurityProfile модель с свойствами encryptionAtHost, securityType, и uefiSettings.
    • Добавлена новая UefiSettings модель с свойствами secureBootEnabled и vTpmEnabled.
    • Добавлено новое securityProfile свойство VirtualMachineConfigurationв .
  • Добавлена поддержка сервисных артефактов для наборов масштабов:
    • Добавлена новая ServiceArtifactReference модель с необходимым id свойством (ARM resource ID).
    • Добавлено новое serviceArtifactReference свойство VirtualMachineConfiguration для установки одинаковой версии изображения для всех виртуальных машин в наборе масштабов при использовании версии latest изображения.
  • Улучшенная конфигурация диска ОС:
    • Добавлена новая ManagedDisk модель с особенностью storageAccountType .
    • Добавлены новые свойства к OSDisk: caching, diskSizeGB, managedDisk, и writeAcceleratorEnabled.
  • Добавлено StandardSSDLRS (standardssd_lrs) как новое значение для StorageAccountType.
  • Добавлено новое свойство resourceTags в CloudPool, PoolAddParameter и PoolSpecification для распространения пользовательских тегов на резервные Azure ресурсы. Применимо только в том случае, если poolAllocationModeUserSubscription.
  • Добавлено новое scaleSetVmResourceId свойство для VirtualMachineInfo открытия идентификатора ресурса текущей виртуальной машины Virtual Machine Scale Set VM вычислительного узла. Определяется только тогда, когда у пакетного аккаунта poolAllocationMode .UserSubscription

Версия: 2023-05-01.17.0

  • [Разрыв] Удален API статистики пожизненного цикла пакетных работ/пулов: lifetimejobstats и lifetimepoolstats.
  • Добавлено булево свойство enableAcceleratedNetworking к NetworkConfiguration.
    • Это свойство определяет, должен ли этот пул включать ускоренную сеть, при этом значение по умолчанию — False.
    • Возможность включения этой функции также зависит от поддержки экземпляра операционной системы/виртуальной машины, что должно соответствовать политике AcceleratedNetworking.
  • Добавлено булево свойство enableAutomaticUpgrade к VMExtension.
    • Это свойство определяет, следует ли автоматически обновлять расширение, если доступна более новая версия расширения.
  • Свойство type , ContainerConfigurationкоторое теперь поддерживает два значения: DockerCompatible и CriCompatible.

Версия: 2022-10-01.16.0

  • Добавлено новое NodeCommunicationMode свойство, определяющее, как пул взаимодействует с пакетным сервисом
  • Добавлено новое currentNodeCommunicationMode свойство типа NodeCommunicationMode в CloudPool модель, отражающее текущее состояние режима связи пула.
  • Добавлено новое targetNodeCommunicationMode свойство NodeCommunicationMode типа в следующие модели для обозначения желаемого режима связи узлов для пула:
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

Версия: 2022-01-01.15.0

  • Добавлено новое uploadHeaders свойство в OutputFileBlobContainerDestination модель, позволяющее пользователям устанавливать пользовательские HTTP-заголовки при загрузке файлов ресурсов.
  • Добавлено новое allowTaskPreemption свойство в следующие модели для поддержки упреждения задач для задач с более высоким приоритетом (требуется Comms-Enabled или Single Tenant Pool):
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

Версия: 2021-06-01.14.0

  • Добавить возможность назначать управляемые идентичности, назначенные пользователем для CloudPool. Эти идентичности доступны на каждом узле пула и могут использоваться для доступа к различным ресурсам.
  • Добавлено identityReference свойство в следующие модели для поддержки доступа к ресурсам через управляемую идентичность:
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • Добавлено новое extensions свойство в VirtualMachineConfiguration для CloudPool указания расширений виртуальных машин для узлов
  • Добавлена возможность указывать зоны доступности с помощью нового свойства nodePlacementConfiguration в VirtualMachineConfiguration
  • Добавлено новое osDisk свойство в VirtualMachineConfiguration, которое содержит настройки для диска операционной системы виртуальной машины.
    • Свойство placement на DiffDiskSettings указывает эфемерное расположение дисков для дисков операционной системы для всех виртуальных машин пула. Установка на «CacheDisk» для хранения эфемерного диска ОС в кэше виртуальной машины.
  • Добавлено maxParallelTasks свойство CloudJob для управления максимальным количеством задач, которые могут выполняться одновременно за задание (по умолчанию -1 означает неограниченное). В настоящее время эта недвижимость находится на частном предварительном просмотре.
  • Добавленное virtualMachineInfo свойство содержит ComputeNode информацию о текущем состоянии виртуальной машины, включая точную версию изображения маркетплейса, используемого виртуальной машиной.
  • Добавлено recurrenceInterval свойство для Schedule управления интервалом между временем запуска двух последовательных заданий по графику заданий.

Версия: 2020-09-01.12.0

  • [Разрыв] Заменили недвижимость maxTasksPerNode на taskSlotsPerNode бассейне. Использование этого свойства задачи в задании может потреблять динамическое количество слотов, что позволяет более тонко контролировать расход ресурсов.
  • [Разрыв] Изменил тип отклика GetTaskCounts на возврат TaskCountsResult, это сложный объект, содержащий предыдущий TaskCounts объект и новый TaskSlotCounts объект, предоставляющий аналогичную информацию в контексте используемых слотов.
  • Добавлено свойство requiredSlots задачи, позволяющее пользователю задавать количество слотов на узле.

Версия: 2020-03-01.11.0

  • Добавлена возможность шифрования дисков ComputeNode с использованием нового DiskEncryptionConfiguration свойства VirtualMachineConfiguration.
  • [Разрыв] Свойство virtualMachineImageIdImageReference теперь может относиться только к образу Shared Image Gallery.
  • [Разрыв] Свойство password тела запроса Add Certificate необязательно для сертификатов в формате PFX.
  • [Разрыв] Пулы теперь могут быть предоставлены без публичного IP, используя новое PublicIPAddressConfiguration свойство NetworkConfiguration.
  • [Разрыв] Недвижимость publicIPsNetworkConfiguration была переименована в ipAddressIds и переехала в PublicIPAddressConfiguration неё. Это свойство можно задать только тогда, когда provision свойство — usermanaged.

Версия: 2019-08-01.10.0

  • Добавлена возможность указывать набор публичных IP-адресов через NetworkConfiguration новое publicIPs свойство пула. Это гарантирует, что узлы пула имеют IP из IP, предоставленных пользователем в списке.
  • Добавлена возможность монтировать удалённые файловые системы на каждом узле пула через свойство MountConfiguration .
  • Shared Image Gallery изображения теперь могут быть указаны на свойстве virtualMachineImageIdImageReference путем ссылки на изображение через его Azure Resource Manager ID.
  • [Разрыв] Если не указано, значение по умолчанию для waitForSuccess on StartTask — true (ранее оно было false).
  • [Разрыв] Если это не указано, значение по умолчанию для scope на AutoUserSpecification теперь всегда Pool (ранее оно было Task на Windows узлах и Pool на узлах Linux).
  • Исправлены различные запутанные или неполные документы.

Версия: 2019-06-01.9.0

  • [Разрыв] Заменён ListNodeAgentSKUs на ListSupportedImages. ListSupportedImages содержит всю ту же информацию, что была изначально доступна ListNodeAgentSKUs , но в более понятном виде. Теперь также возвращаются новые, неподтверждённые изображения. Дополнительная информация о Capabilities и BatchSupportEndOfLife доступна через ImageInformation.

  • Теперь поддерживают правила сетевой безопасности, блокирующие доступ к CloudPool сети на основе исходного порта трафика. Это правило выполняется через свойство SourcePortRanges на NetworkSecurityGroupRule.

  • При запуске контейнера пакетная служба теперь поддерживает выполнение задачи в рабочем каталоге контейнера или в рабочем каталоге задачи пакетной службы. Это управляется свойствомWorkingDirectory.TaskContainerSettings

  • Исправлены различные запутанные или неполные документы.

Версия: 2018-12-01.8.0

  • [Разрыв] Убрал поддержку для upgradeos On cloudServiceConfiguration Pools.

    • Удален upgradeos.
    • Переименовано targetOSVersion в osVersion и удалено currentOSVersion на CloudPool.
    • Удален из upgradingPoolState.

  • [Разрыв] Удалено dataEgressGiB и dataIngressGiB из poolusagemetrics. Эти объекты больше не поддерживаются.

  • [Разрыв]ResourceFile Улучшения

    • Добавлена возможность указывать целый контейнер Azure Storage в ResourceFile. Сейчас для ResourceFile поддерживаются три режима:
      • httpUrl создаёт ResourceFile указание на один HTTP-адрес.
      • storageContainerUrl создаёт ResourceFile, указывающий на контейнер Azure Blob Storage.
      • autoStorageContainerName создаёт ResourceFile, указывающий на контейнер Azure Blob Storage в зарегистрированной в пакетной учетной записи автохранилища.
    • URL, предоставленные ResourceFile методом httpUrl , теперь могут быть любыми HTTP-адресами. Ранее эти URL должны были быть Azure Blob Storage URL.
    • blobPrefix Можно использовать для фильтрации загрузок из контейнера хранения только до тех, что соответствуют префиксу.

  • [Разрыв] Удалено osDisk свойство из VirtualMachineConfiguration. Эта недвижимость больше не поддерживается.

  • Пулы, устанавливающие dynamicVNetAssignmentScope на NetworkConfiguration как job, теперь могут динамически назначать Virtual Network каждому узлу заданиеs tasks run on. The specific Virtual Network to join the nodes to is specified in the new JobNetworkConfigurationproperty onCloudJobandJobSpecification'.

    Замечание

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

  • Максимальный срок службы задачи теперь составляет 180 дней (ранее это было 7).

  • Добавлена поддержка Windows пулов для создания пользователей с определённым режимом входа (либо batch, либо interactive) через LoginMode.

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

Версия 2018-08-01.7.0

Новые функции в версии 2018-08-01.7.0 включают:

  • Просмотрите версию Azure Batch Node Agent через новое свойство NodeAgentInfo на ComputeNode.
  • Добавлена возможность указывать a Filter на Result задаче. Дополнительные сведения см. здесь.
    • Это позволяет часто запрашиваемому сценарию выполнения серверного запроса найти все неудачные задачи.
  • [Разрыв] Удалил ValidationStatus свойство из TaskCounts.
  • [Разрыв] Стандартный тип кэширования для DataDisk и OSDisk теперь ReadWrite вместо None.
  • [Разрыв] Переименовал единственное значение ContainerType из docker в dockerCompatible.

Версия 2018-03-01.6.1

Новые функции в версии 2018-03-01.6.1 включают:

  • Подсчёт узлов пула по состояниям: Эта версия добавляет возможность запрашивать количество узлов пула по состоянию с помощью новой операции ListPoolNodeCounts. Эта операция даёт возможность запрашивать все пулы в пакетном аккаунте по состоянию узлов.
  • Журналы агентов узлов: В этой версии добавлена возможность загружать логи агентов узлов Azure Batch с определённого узла с помощью операции UploadBatchServiceLogs. Этот лог предназначен для отладки Microsoft Support в случае возникновения проблем на узле.

Версия 2017-09-01.6.0

  • Azure Hybrid Use Advantage: теперь вы можете создавать пакетные пулы виртуальных машин Windows, указывая использование лицензии Azure Hybrid Use Benefit. При использовании этой лицензии на цену виртуальной машины применяется скидка. Используйте новое свойство LicenseType в VirtualMachineConfiguration.

  • Пул виртуальных дисков: Вы можете подключить один или несколько пустых дисков данных к пулам виртуальных машин, используя новую конфигурацию дисков данных, которая является частью конфигурации виртуальной машины. Используйте свойство DataDisks в VirtualMachineConfiguration.

  • (Ломая сдачу) Пользовательские изображения теперь создаются и развёртываются с использованием ресурсов Azure Resource Manager вместо blob VHD-файлов. Batch теперь использует управляемые диски для создания пуловых виртуальных машин и, следовательно, использует ресурс Image . Теперь нет ограничений на количество виртуальных машин в пуле, созданном с использованием пользовательского образа; кроме того, несколько копий VHD-blob для больших пулов больше не требуются. Поэтому пользовательские пулы изображений гораздо проще создавать и масштабировать. Для получения дополнительной информации см. раздел «Использовать пользовательский образ для создания пула виртуальных машин».

    • Новое свойство VirtualMachineImageId в ImageReference содержит ссылку на Image, и OSDisk.ImageUris больше не существует.

    • Из-за этого изменения ImageReference теперь является обязательным свойством VirtualMachineConfiguration.

  • (Ломает мелочь) Задачи с несколькими экземплярами (созданные с использованием MultiInstanceSettings) теперь должны указывать CoordinationCommandLine, а NumberOfInstances теперь необязательн и по умолчанию отображается на 1.

  • Добавлена поддержка задач, выполняемых с использованием контейнеров Docker. Чтобы выполнить задачу с использованием контейнера Docker, необходимо указать ContainerConfiguration в VirtualMachineConfiguration для пула, а затем добавить TaskContainerSettings в задачу.

Версия 2017-06-01.5.1

Версия Batch API, описанная здесь, — 2017-06-01.5.1. Рекомендуется использовать последнюю версию, когда это возможно.

Новые функции в версии 2017-06-01.5.1 включают:

  • Поддержка эффективного подсчёта задач с помощью новой операции Get Task Counts. Вызвав операцию Get Task Counts, вы можете получить количество активных, выполняемых и выполненных задач, а также задач, которые были успешны или не прошли. Для получения дополнительной информации см. раздел «Подсчёт заданий для работы по штатам» (Предварительный просмотр).
  • Поддержка указания входящих конечных точек на вычислительных узлах пула через новое свойство poolEndpointConfiguration . Задавая это свойство, можно адресовать конкретные порты узла внешне.

Версия 2017-05-01.5.0

В следующих разделах описаны новые и изменённые функции версии 2017-05-01.5.0.

Это важно

Версия 2017-05-01.5.0 содержит несколько неисправных изменений. Проверьте срочные изменения и обновите код, чтобы вызвать версию 2017-05-01.5.0.

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

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

В API REST внесено несколько изменений для узлов низкого приоритета:

  • (Ломает мелочь) Свойства targetDedicated и currentDedicated спецификации пула или пула были переименованы в targetDedicatedNodes и currentComputeNodes.
  • (Ломает мелочь) Свойство resizeError пула теперь называется коллекцией resizeErrors.
  • Вычислительные узлы имеют новое свойство isDedicated . Это свойство верно для выделенных узлов и ложно для узлов с низким приоритетом.
  • Задача в диспетчере заданий имеет новое свойство allowLowPriorityNode . Если это свойство верно, задача диспетчера заданий может выполняться на узле с низким приоритетом. Если это неверно, то задача Job Manager выполняется на выделенном вычислительном узле.

Именованные пользователи на Linux

Azure Batch теперь предлагает дополнительную поддержку создания именованных пользователей на узлах Linux.

  • Новое свойство linuxUserConfiguration поддерживает указание uid (user ID) и gid (group ID) при создании пользователя Linux.
  • (Ломает мелочь) Свойство sshPrivateKey было перенесено из userAccount в новое свойство linuxUserConfiguration . Свойство linuxUserConfiguration само по себе является свойством свойства userAccount .

Для получения дополнительной информации о именованных учетных записях смотрите раздел «Выполнить задачи в разделе учетных записей пользователей в Batch».

Выходные файлы для данных задач

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

  • Новое свойство outputFiles поддерживает указание файлов задач для загрузки в Azure Storage.
  • Новое свойство fileUploadError свойства exitConditions поддерживает указание действий на основе статуса загрузки выходного файла.

Отчётность об ошибках задачи

Внесено несколько изменений для улучшения отчётности по ошибкам в задачах.

  • Свойство нового результатасвойства executionInfo указывает, была ли задача успешной или неуспешной.
  • (Ломает мелочь) Свойство schedulingError из свойства executionInfo было переименовано в failureInfo. Свойство failureInfo возвращается каждый раз, когда происходит сбой задачи. Это включает все предыдущие ошибки при планировании, все случаи, когда возвращается ненулевой код выхода задачи, а также любые сбои при загрузке файлов.
  • (Ломает мелочь) Свойство schedulingError свойства exitConditions было переименовано в preProcessingError для уточнения, когда ошибка произошла в жизненном цикле задачи.
  • (Ломает мелочь) Свойство schedulingErrorCateogry было переименовано в errorCategory.

Лицензии на применение

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

Версия 2017-01-01.4.0

Эта версия расширяет всю поддержку предыдущей версии, 2016-07-01.3.1. Кроме того, он поддерживает следующие возможности:

  • Выполните задачу под заданным идентификатором пользователя.

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

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

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

      Это важно

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

      Если вы сделаете запрос, включающий свойство runElevated до версии 2017-01-01.4.0 пакетного сервиса, запрос не выполняется.

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

      Чтобы запускаться как неадминистративный пользователь, обновите приложение на свойство userIdentity , установив свойство elevationLevel как nonAdmin. Поскольку эта настройка по умолчанию, вы также можете её опустить.

  • Определите учетные записи пользователей на всех узлах пула.

    Теперь вы можете запускать задачу или коллекцию задач под пользовательской учётной записью, которую определили в ресурсе пула. Определите пользовательскую учётную запись через новое свойство userAccounts в запросах Add Pool. При определении аккаунта можно указать имя аккаунта, пароль, уровень повышения уровня (администратор или неадминистратор) и приватный ключ SSH (для пулов Linux).

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

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

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

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

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

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

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

    Укажите свойство dependencyAction в запросах Add Task или Add Task Collection.

    Для получения дополнительной информации об использовании действий зависимостей см. раздел «Действия зависимости».

  • При создании пула используйте кастомные образы дисков ОС.

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

    Для этого необходимо указать при создании аккаунта Batch, что пулы будут предоставляться в пользовательской подписке, а не в подписке, управляемой Batch сервисом. При вызове создать аккаунт установите свойство poolAllocationMode на UserSubscription. Затем используйте свойство osDisk , чтобы указать ссылку на образ диска в запросе Add Pool.

    Это важно

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

  • Используйте аутентификация на основе Azure Active Directory для запросов к пакетному сервису.

    Azure Active Directory (Azure AD) теперь поддерживается для аутентификации вызовов в пакетный сервис.

    Если ваш пакетный аккаунт настроен на создание пулов в пользовательской подписке, то требуется аутентификация Azure AD.

Версия 2016-07-01.3.1

Эта версия расширяет всю поддержку предыдущей версии, 2016-02-01.3.0. Кроме того, он поддерживает следующие возможности:

  • Возможность создания пула и автопула с конфигурацией сети

    • Новая сеть свойств Конфигурация была добавлена как в пул, так и в автопул. Это свойство можно использовать для указания вычислительных узлов пулаs network configuration, such as the subnet in which the pool.

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

    • В ресурс заданий добавлено новое свойство на AllTasksComplete. Вы можете указать это свойство при создании или обновлении работы.

  • Автоматически завершайте или отключайте задание, если она не выполняется.

    • В ресурс задания добавлено новое свойство onTaskFailure, а в ресурс задачи добавлено новое свойство exitConditions. Настройка job onTaskFailure указывает, может ли сбой задачи повлиять на уровень работы, а свойство task exitConditions позволяет задачам адаптировать воздействие на уровне задачи в соответствии с характером сбоя.

  • Ассоциируйте пакеты приложений с задачами и пулами.

    • Новое свойство applicationPackageReferences добавлено в ресурс задачи и в настройки jobManagerTask. Это свойство позволяет внедрять пакеты приложений по требованию по мере необходимости задач, а не указывать их при создании пула. Это свойство особенно ценно для долгоживущих пулов, которые могут быть привлечены для выполнения различных типов задач или различных версий приложений на протяжении всего срока службы.

  • Возможность повторно активировать неудачную задачу.

    • Добавлена новая операция Reactivate a task для сброса состояния неудачной задачи в активное. Это позволяет повторно проверять неудачи, например, если сбой был временным или если вам удалось устранить причину отказа, не воспроизводя задачу заново.

Версия 2016-02-01.3.0

Этот выпуск расширяет всю поддержку предыдущей версии, 2015-12-01.2.2. Кроме того, он поддерживает следующие возможности:

  • Возможность создания пула и автопула с конфигурацией виртуальной машины IaaS

    • Существующие объекты osFamilyперемещаются currentOSVersion из верхнего уровня ресурсов Pool и Autopool и перемещаются внутрь нового объекта под названием cloudServiceConfiguration. targetOSVersion

    • К ресурсам Пула и Автопула добавлена новая недвижимость virtualMachineConfiguration . Это свойство можно задать для настройки пула/автопула с виртуальными машинами IaaS.

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

    • Добавлен новый API для получения удалённых настроек входа, которые можно использовать для удалённого входа в вычислительный узел, созданный с конфигурацией IaaS VM. См. Получить настройки удалёного входа для узла.

    • Добавляется новый API для добавления коллекции задач в задание. См. Добавить набор задач в работу.

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

    • Два новых свойства totalTasksSucceeded добавляются runningTasksCount в ресурс узлов. Эти свойства можно получить с помощью Получить информацию о узле или Перечислить вычислительные узлы в пуле.

    • К типу ResourceFile комплекса добавляется новое свойствоfileMode. Это свойство применяется только к вычислительным узлам Linux и игнорируется для вычислительных узлов Windows.

    • К типу FileProperties комплекса добавляется новое свойствоfileMode. Это свойство возвращается сервисом Batch для вычислительных узлов Linux в составе API GetFileProperties или ListFileProperties. Кроме того, существующее свойство creationTime в FileProperties комплексном типе изменяется на необязательное, поскольку оно не возвращается для вычислительных узлов Linux.

    • Тип данных существующего свойства visibility внутри CertificateReference комплексного типа изменяется из строки с запятыми значениями в набор строк. Также одно из существующих значений видимости переименовано с «rdp» в «remoteuser».

  • URL-адреса следующих API изменяются так, чтобы вместо имени действия «?» было заменено на «/»:

    • Замена свойств пула

    • Отключите автоматическое масштабирование в пуле

    • Включите автоматическое масштабирование пула

    • Оценить формулу автоматического масштабирования

    • Измените размер бассейна

    • Перестаньте менять размер бассейна

    • Обновление операционной системы вычислительных узлов в пуле

    • Удаление вычислительных узлов из пула

    • Перезагрузка узла

    • Переобразить узел

    • Отключить планирование задач на узле

    • Включить планирование задач на узле

    • Отключить график работы

    • Включите расписание работы

    • Расторгите рабочий график

    • Отключить работу

    • Включите работу

    • Уволить работу

    • Завершить задачу

    • Отменить удаление сертификата

Версия 2015-12-01.2.2

Эта версия расширяет всю поддержку предыдущей версии 2015-11-01.2.1. Кроме того, он поддерживает следующие возможности:

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

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

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

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

В этой версии есть следующие другие изменения:

  • Стандартный тайм-аут при изменении размера пула изменился на 15 минут.

Версия 2015-11-01.2.1

Эта версия расширяет всю поддержку предыдущей версии 2015-06-01.2.0. Кроме того, он поддерживает следующие возможности:

  • Возможность добавлять и запускать многоэкземплярные задачи (например, MPI)

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

    • Добавлен новый API Список подзадач задачи добавляется для получения информации о подзадачах.

    • Для вычислительного узла добавляется recentTasks новое необязательное свойствоsubtaskId. Это свойство возвращается в рамках Get Compute Node и List Compute Nodes

  • Возможность отключить или включить планирование задач на вычислительном узле

    • В ресурсе вычислительного узла добавлены два новых API: отключить планирование задач на узле и включить планирование задач на узле.

    • Добавляется новое состояние offline вычислительного узла. Для старых версий API это состояние отображается на unusable.

    • В ресурс вычислительного узла добавляется новое свойство schedulingState . Возможные значения для enabled и disabled.

  • Возможность указывать интервал автооценки -scale в пуле/автопуле

    • Добавлена новая недвижимость autoScaleEvaluationInterval для пулового ресурса. Это свойство может быть включено в API Add Pool, Get Pool, Enable Auto -Scale и List Pools.

    • Аналогично, для автопулов в свойство добавляется autoPoolSpecification новое свойствоautoScaleEvaluationInterval. Это свойство может быть включено в API Добавить работу, Получить работу, Перечислить вакансии, Добавить расписание заданий, Получить расписание заданий, Обновить расписание заданий, Список расписаний заданий и Список вакансий в API расписания заданий.

  • Улучшение API задач для возврата корневого каталога задачи на вычислительном узле.

    • Два новых свойства taskRootDirectory добавлены taskRootDirectoryUrl в ресурс задачи, которые можно получить в рамках Получить информацию о задаче, Список задач API

    • Добавляется jobPreparationTaskExecutionInfo новое свойствоtaskRootDirectory, jobReleaseTaskExecutionInfo которое можно получить через List статус задач подготовки и освобождения заданий для API.

  • Last updated on