Управление версиями API-интерфейса REST пакетной службы
Операции, предоставляемые API REST пакетной службы, могут иметь несколько версий для обеспечения обратной совместимости, так как API со временем развивается. При вызове операции необходимо указать, какую версию следует использовать, предоставляя эту версию в вызове REST. Если приложение вызывает более старую версию операции, можно продолжать вызывать старую версию или изменить код для вызова более новой версии. Если версия не указана или указана неправильная версия, возвращается ошибка.
Чтобы указать используемую версию операции, задайте параметр запроса api-version . Версия имеет формат Group.Major.Minor, где Group задается в формате "ГГГГ-ММ-ДД", а Major и Minor являются целыми числами.
Последняя версия: 2023-05-01.17.0
- [Критический] Удален API статистики времени существования пакетного задания или пула:
lifetimejobstats
иlifetimepoolstats
. - Добавлено логическое свойство
enableAcceleratedNetworking
дляNetworkConfiguration
.- Это свойство определяет, должен ли этот пул включать ускоренную сеть со значением по умолчанию False.
- Возможность включения этой функции также связана с тем, поддерживается ли экземпляр операционной системы или виртуальной машины, что должно соответствовать политике AcceleratedNetworking.
- Добавлено логическое свойство
enableAutomaticUpgrade
дляVMExtension
.- Это свойство определяет, должно ли расширение автоматически обновляться платформой при наличии более новой версии расширения.
- Свойство
type
ContainerConfiguration
объекта , которое теперь поддерживает два значения:DockerCompatible
иCriCompatible
.
Предыдущие версии
К предыдущим версиям относятся:
- 2022-10-01.16.0
- 2022-01-01.15.0
- 2021-06-01.14.0
- 2020-09-01.12.0
- 2020-03-01.11.0
- 2019-08-01.10.0
- 2019-06-01.9.0
- 2018-12-01.8.0
- 2018-08-01.7.0
- 2018-03-01.6.1
- 2017-09-01.6.0
- 2017-06-01.5.1
- 2017-05-01.5.0
- 2017-01-01.4.0
- 2016-07-01.3.1
- 2016-02-01.3.0
- 2015-12-01.2.2
- 2015-11-01.2.1
- 2015-06-01.2.0
- 2015-03-01.1.1
- 2014-10-01.1.0
Версия: 2022-10-01.16.0
- Добавлено новое
NodeCommunicationMode
свойство, определяющее, как пул взаимодействует с пакетной службой. - Добавлено новое
currentNodeCommunicationMode
свойство типа дляNodeCommunicationMode
модели,CloudPool
которое будет ссылаться на текущее состояние режима связи пула. - Добавлено новое
targetNodeCommunicationMode
свойство типа дляNodeCommunicationMode
следующих моделей, чтобы ссылаться на требуемый режим связи узла для пула:
Версия: 2022-01-01.01.15.0
- Добавлено новое
uploadHeaders
свойство в модель, позволяющееOutputFileBlobContainerDestination
пользователям задавать пользовательские http-заголовки при отправке файлов ресурсов. - Добавлено новое
allowTaskPreemption
свойство для следующих моделей для поддержки вытеснения задач с более высоким приоритетом (требуется Comms-Enabled или пул с одним клиентом):
Версия: 06.06.2021.01.14.0
- Добавлена возможность назначать управляемые удостоверения, назначаемые пользователем, в
CloudPool
. Эти удостоверения будут доступны на каждом узле в пуле и могут использоваться для доступа к различным ресурсам. - Добавлено
identityReference
свойство для следующих моделей для поддержки доступа к ресурсам через управляемое удостоверение: - Добавлено новое
extensions
свойство для VirtualMachineConfiguration в дляCloudPool
указания расширений виртуальных машин для узлов. - Добавлена возможность указывать зоны доступности с помощью нового свойства
nodePlacementConfiguration
в VirtualMachineConfiguration. - Добавлено новое
osDisk
свойство для VirtualMachineConfiguration, которое содержит параметры для диска операционной системы виртуальной машины.- Свойство
placement
вDiffDiskSettings
указывает временное размещение дисков операционной системы для всех виртуальных машин в пуле. Если задать для него значение CacheDisk, временный диск ОС будет сохранен в кэше виртуальной машины.
- Свойство
- Добавлено
maxParallelTasks
свойство onCloudJob
для управления максимальным числом задач, которые могут выполняться одновременно для каждого задания (по умолчанию — -1, что означает неограниченное число). Это свойство в настоящее время находится в закрытой предварительной версии. - Добавлено
virtualMachineInfo
свойство , вComputeNode
котором содержатся сведения о текущем состоянии виртуальной машины, включая точную версию образа Marketplace, используемого виртуальной машиной. - Добавлено
recurrenceInterval
свойство для управленияSchedule
интервалом между временем начала двух последовательных заданий в расписании заданий.
Версия: 09.09.2020
- [Критический] Свойство заменено
maxTasksPerNode
taskSlotsPerNode
на в пуле. Использование этого свойства задач в задании может использовать динамическое количество слотов, что позволяет более точно контролировать потребление ресурсов. - [Критический] Изменен тип
GetTaskCounts
ответа для возвратаTaskCountsResult
, который представляет собой сложный объект, содержащий предыдущийTaskCounts
объект, и новыйTaskSlotCounts
объект, предоставляющий аналогичную информацию в контексте используемых слотов. - Добавлено свойство
requiredSlots
для задачи, позволяющее пользователю указать, сколько слотов на узле он должен занять.
Версия: 03.03.2020.01.11.0
- Добавлена возможность шифрования дисков ComputeNode с помощью нового
DiskEncryptionConfiguration
свойстваVirtualMachineConfiguration
. - [Критический] Теперь
virtualMachineImageId
свойствоImageReference
может ссылаться только на Общая коллекция образов изображение. - [Критический] Свойство
password
текстаAdd Certificate
запроса операции является необязательным для сертификатов в формате PFX. - [Критический] Пулы теперь можно подготовить без общедоступного IP-адреса с помощью нового
PublicIPAddressConfiguration
свойстваNetworkConfiguration
. - [Критический] Свойство
publicIPs
такжеNetworkConfiguration
переименовано в иipAddressIds
перемещено вPublicIPAddressConfiguration
. Это свойство можно указать, только еслиprovision
свойство имеет значениеusermanaged
.
Версия: 08.08.2019
- Добавлена возможность указывать коллекцию общедоступных IP-адресов
NetworkConfiguration
через новоеpublicIPs
свойство в пуле. Это гарантирует, что узлы в пуле будут иметь IP-адрес из списка предоставленных пользователем IP-адресов. - Добавлена возможность подключения удаленных файловых систем на каждом узле пула с помощью
MountConfiguration
свойства . - Общая коллекция образов изображения теперь можно указать в свойстве
virtualMachineImageId
,ImageReference
ссылаясь на образ с помощью идентификатора Resource Manager Azure. - [Критический] Если значение не указано, значение по умолчанию для
waitForSuccess
параметра onStartTask
равноtrue
(ранее это былоfalse
). - [Критический] Если значение не указано, значение по умолчанию для
scope
on теперь всегдаPool
(ранее это былоTask
на узлах Windows иPool
НаAutoUserSpecification
узлах Linux). - Улучшены различные запутанные или неполные документы.
Версия: 06.06.2019
[Критический] Заменено на
ListNodeAgentSKUs
ListSupportedImages
.ListSupportedImages
содержит все те же сведения, которые изначально были доступны вListNodeAgentSKUs
, но в более четком формате. Теперь также возвращаются новые непроверенные образы. Дополнительные сведения оCapabilities
иBatchSupportEndOfLife
доступны черезImageInformation
.Теперь поддерживают правила безопасности сети, блокирующие сетевой доступ к на
CloudPool
основе исходного порта трафика. Это выполняется с помощью свойстваSourcePortRanges
дляNetworkSecurityGroupRule
.Что касается выполнения контейнеров, пакетная служба теперь поддерживает выполнение задачи в рабочей папке контейнера или рабочей папке задачи пакетной службы. Выбор зависит от параметра
WorkingDirectory
вTaskContainerSettings
.Улучшены различные запутанные или неполные документы.
Версия: 12.01.8.02018
[Критический] Удалена поддержка в
upgradeos
cloudServiceConfiguration
пулах.[Критический] Удалены
dataEgressGiB
иdataIngressGiB
изpoolusagemetrics
. Эти свойства больше не поддерживаются.[Критический]
ResourceFile
Улучшения- Добавлена возможность указать весь контейнер службы хранилища Azure в ResourceFile. Теперь существует три поддерживаемых режима для ResourceFile:
-
httpUrl
создает объект , указывающийResourceFile
на один URL-адрес HTTP. -
storageContainerUrl
создает объект , указывающийResourceFile
на контейнер Хранилище BLOB-объектов Azure. -
autoStorageContainerName
создает объект , указывающийResourceFile
на контейнер Хранилище BLOB-объектов Azure в учетной записи зарегистрированного автоматического хранения пакетной службы.
-
- URL-адреса, предоставленные
ResourceFile
httpUrl
с помощью метода , теперь могут быть любым URL-адресом HTTP. Ранее это должен был быть URL-адрес Хранилище BLOB-объектов Azure. -
blobPrefix
можно использовать для фильтрации загрузок из контейнера хранилища только для тех, которые соответствуют префиксу.
- Добавлена возможность указать весь контейнер службы хранилища Azure в ResourceFile. Теперь существует три поддерживаемых режима для ResourceFile:
[Критический] Удалено
osDisk
свойство изVirtualMachineConfiguration
. Это свойство более не поддерживается.Пулы, задающие
dynamicVNetAssignmentScope
NetworkConfiguration
значение on,job
теперь могут динамически назначать виртуальная сеть каждому узлу, на которых выполняются задачи задания. Конкретный виртуальная сеть для соединения узлов указывается в новомJobNetworkConfiguration
свойстве вCloudJob
иJobSpecification
.Примечание
Эта функция предоставляется в общедоступной предварительной версии. Она отключена для всех учетных записей пакетной службы, за исключением тех, которые связались с нами и просили принять пилотное развертывание.
Максимальный срок существования задачи теперь составляет 180 дней (ранее — 7).
Добавлена поддержка в пулах Windows для создания пользователей с определенным режимом входа (
batch
илиinteractive
) черезLoginMode
.Время хранения по умолчанию для всех задач теперь составляет 7 дней, ранее оно было бесконечным.
Версия 2018-08-01.7.0
Новые функции в версии 2018-08-01.7.0:
- Просмотрите версию агента пакетная служба Azure Node с помощью нового свойства NodeAgentInfo в ComputeNode.
- Добавлена возможность указывать в
Filter
Result
задаче. Подробнее см. здесь.- Это позволяет часто запрашивать сценарий выполнения запроса на стороне сервера для поиска всех задач, которые завершили сбой.
-
[Критический] Удалено
ValidationStatus
свойство из TaskCounts. -
[Критический] По умолчанию для DataDisk и OSDisk используется
ReadWrite
тип кэширования вместоNone
. -
[Критический] Переименовано единственное значение ContainerType с
docker
наdockerCompatible
.
Версия 2018-03-01.6.1
Новые функции в версии 2018-03-01.6.1:
- Количество узлов пула по состоянию. Эта версия добавляет возможность запрашивать количество узлов пула по состоянию с помощью новой операции ListPoolNodeCounts . Эта операция позволяет запрашивать все пулы в учетной записи пакетной службы для состояний узлов, включая создание, простой, автономный, вытесненный, перезагрузку, повторное создание образа, запуск и другие.
- Журналы агента узла. В этой версии добавлена возможность отправки пакетная служба Azure журналов агента узла с определенного узла с помощью операции UploadBatchServiceLogs. Он предназначен для использования при отладке служба поддержки Майкрософт, если на узле возникают проблемы.
Версия 2017-09-01.6.0
Преимущество гибридного использования Azure. Теперь можно создать пулы виртуальных машин Windows пакетной службы, указав, что будет использоваться лицензирование Преимущества гибридного использования Azure. При использовании этого лицензирования к цене виртуальной машины применяется скидка. Используйте новое свойство LicenseTypeв VirtualMachineConfiguration.
Диски данных виртуальных машин пула. Вы можете подключить один или несколько пустых дисков данных к пулам виртуальных машин с помощью новой конфигурации диска данных, которая является частью конфигурации виртуальной машины. Используйте свойство DataDisksв VirtualMachineConfiguration.
(Критическое изменение) Пользовательские образы теперь создаются и развертываются с помощью azure Resource Manager ресурсов образов вместо VHD-файлов больших двоичных объектов. Пакетная служба теперь использует управляемые диски для создания виртуальных машин пула и, следовательно, использует ресурс образа . Теперь количество виртуальных машин в пуле, созданном с помощью пользовательского образа, не ограничено. Кроме того, несколько копий большого двоичного объекта VHD для больших пулов больше не требуются. Поэтому пулы пользовательских образов гораздо проще создавать и масштабировать. Дополнительные сведения см. в статье Использование управляемого пользовательского образа для создания пула виртуальных машин.
Новое свойство VirtualMachineImageId в ImageReference содержит ссылку на Image, а OSDisk.ImageUris больше не существует.
Из-за этого изменения ImageReference теперь является обязательным свойством VirtualMachineConfiguration.
(Критическое изменение) Задачи с несколькими экземплярами (созданные с помощью MultiInstanceSettings) теперь должны указывать CoordinationCommandLine, а NumberOfInstances теперь является необязательным и по умолчанию имеет значение 1.
Добавлена поддержка задач, выполняемых с помощью контейнеров Docker. Чтобы выполнить задачу с помощью контейнера Docker, необходимо указать ContainerConfiguration в VirtualMachineConfiguration для пула, а затем добавить TaskContainerSettings в задачу.
Версия 2017-06-01.5.1
Описанная здесь версия API пакетной службы — 2017-06-01.5.1. По возможности рекомендуется использовать последнюю версию.
Новые функции в версии 2017-06-01.5.1:
- Поддержка эффективного подсчета задач с помощью новой операции Получения количества задач . Вызвав операцию 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 теперь предлагает низкоприоритетные вычислительные узлы, чтобы снизить затраты на рабочие нагрузки пакетной службы. Виртуальные машины с низким приоритетом позволяют использовать новые типы рабочих нагрузок пакетной службы, предоставляя большой объем вычислительных ресурсов по доступной цене.
Существует несколько изменений в REST API для узлов с низким приоритетом:
- (Критическое изменение) Свойства targetDedicated и currentDedicated пула или спецификации пула были переименованы в targetDedicatedNodes и currentComputeNodes.
- (Критическое изменение) Свойство resizeError пула теперь является коллекцией resizeErrors.
- Вычислительные узлы имеют новое свойство isDedicated . Это свойство имеет значение true для выделенных узлов и false для узлов с низким приоритетом.
- Задача диспетчера заданий имеет новое свойство allowLowPriorityNode . Если это свойство имеет значение true, задача диспетчера заданий может выполняться на низкоприоритетном узле. Если значение равно false, задача диспетчера заданий будет выполняться на выделенном вычислительном узле.
Именованные пользователи в Linux
пакетная служба Azure теперь предлагает дополнительную поддержку для создания именованных пользователей на узлах Linux.
- Новое свойство linuxUserConfiguration поддерживает указание uid (идентификатор пользователя) и gid (идентификатор группы) при создании пользователя Linux.
- (Критическое изменение) Свойство sshPrivateKey перемещено из свойства userAccount в новое свойство linuxUserConfiguration . Свойство linuxUserConfiguration само по себе является свойством свойства userAccount .
Дополнительные сведения об именованных учетных записях пользователей см. в разделе Выполнение задач в учетных записях пользователей в пакетной службе.
Выходные файлы для данных задачи
Теперь можно указать выходные файлы для отправки данных задачи после завершения задачи.
- Новое свойство outputFiles поддерживает указание файлов задач для отправки в службу хранилища Azure.
- Новое свойство fileUploadError свойства exitConditions поддерживает указание действий, выполняемых на основе состояния отправки выходного файла.
Отчеты об ошибках задач
Для улучшения отчетов об ошибках задач было внесено несколько изменений.
- Новое свойство result свойства 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 в запросах к добавлению пула. При определении учетной записи можно указать имя учетной записи, пароль, уровень повышения прав (администратор или не администратор) и закрытый ключ SSH (для пулов Linux).
Определив учетную запись пользователя, вы можете указать ее для свойства userIdentity в запросах, добавляющих задачу или коллекцию задач.
Предоставьте задаче маркер для проверки подлинности в пакетной службе при выполнении задачи.
Пакетная служба теперь может предоставлять маркер проверки подлинности для задачи при ее запуске. Маркер проверки подлинности позволяет задаче отправлять запросы, связанные с заданием, в пакетную службу без ключей учетной записи пакетной службы. Маркер предоставляется с помощью переменной среды AZ_BATCH_AUTHENTICATION_TOKEN.
В настоящее время маркеры проверки подлинности поддерживаются только для вызова операций в ресурсе задания. Маркер проверки подлинности предоставляет доступ ко всем операциям задания, содержащего задачу.
Чтобы пакетная служба предоставила маркер проверки подлинности, укажите новое свойство authenticationTokenSettings вместе со свойством доступа в запросах на добавление задачи или добавить коллекцию задач.
Укажите действие, выполняемое с зависимостями задачи, если задача завершается сбоем.
Теперь можно указать, что зависимые задачи продолжаются, даже если задача, от которую они зависят, завершается сбоем. Задайте новое свойство dependencyAction ресурса задачи, чтобы оно соответствовало выполнению зависимых задач, даже если родительская задача завершается сбоем. Кроме того, присвойте dependencyActionзначение блокировать , чтобы предотвратить выполнение зависимых задач в случае сбоя родительской задачи.
Укажите свойство dependencyAction в запросах добавить задачу или Добавить коллекцию задач.
Дополнительные сведения об использовании действий зависимостей см. в разделе Действия зависимостей.
Используйте пользовательские образы дисков ОС при создании пула.
Теперь для создания пула можно использовать пользовательские образы дисков ОС.
Для этого при создании учетной записи пакетной службы необходимо указать, что пулы должны быть подготовлены в пользовательской подписке, а не в подписке, управляемой пакетной службой. При вызове метода Create Account задайте для свойства poolAllocationMode значение UserSubscription. Затем используйте свойство osDisk , чтобы указать ссылку на образ диска в запросе на добавление пула.
Важно!
Если при создании учетной записи пакетной службы вы указываете, что пулы должны быть подготовлены в пользовательской подписке, для всех запросов, выполненных с помощью этой учетной записи, необходимо использовать проверку подлинности на основе Azure Active Directory.
Используйте проверку подлинности на основе Azure Active Directory для запросов к пакетной службе.
Azure Active Directory (Azure AD) теперь поддерживает проверку подлинности вызовов пакетной службы.
Если учетная запись пакетной службы настроена для подготовки пулов в пользовательской подписке, то требуется Azure AD проверка подлинности.
Версия 2016-07-01.3.1
Этот выпуск версии расширяет всю поддержку предыдущей версии, 2016-02-01.3.0. Кроме того, он поддерживает следующие возможности:
Возможность создания пула и автоматического пула с конфигурацией сети
- К ресурсам пула и автоматического пула добавлено новое свойство networkConfiguration . Это свойство можно использовать для указания конфигурации сети пула, например подсети, в которой создаются вычислительные узлы пула.
Автоматическое завершение задания по завершении всех задач.
- В ресурс задания добавлено новое свойство onAllTasksComplete . Это можно указать при создании или обновлении задания.
Автоматическое завершение или отключение задания при сбое задачи.
- В ресурс задания добавлено новое свойство onTaskFailure , а в ресурс задачи — новое свойство exitConditions . Параметр задания onTaskFailure указывает, может ли сбой задачи влиять на уровень задания, а свойство task exitConditions позволяет задачам адаптировать влияние на уровень задания в соответствии с характером сбоя.
Связать пакеты приложений с задачами, а также пулами.
- В ресурс задачи и параметры задания jobManagerTask добавлено новое свойство applicationPackageReferences . Это позволяет развертывать пакеты приложений по запросу, так как задачи требуют их, а не указывать во время создания пула. Это особенно полезно для пулов с длительным сроком существования, которые могут вызываться для выполнения различных типов заданий или разных версий приложений в течение их жизненного цикла, или при наличии большого пакета приложений, который требуется не всем задачам.
Возможность повторной активации неудачной задачи.
- Добавлена новая операция Повторная активация задачи для сброса состояния невыполненой задачи до активного. Это позволяет повторять сбои, например, если сбой был временным или вы смогли устранить причину сбоя без повторного создания задачи.
Версия 2016-02-01.3.0
В этом выпуске расширена поддержка предыдущей версии 2015-12-01.2.2. Кроме того, он поддерживает следующие возможности:
Возможность создания пула и автоматического пула с конфигурацией виртуальной машины IaaS
Существующие свойства osFamily, targetOSVersion и currentOSVersion перемещаются из свойств верхнего уровня ресурсов пула и пула и перемещаются в новое свойство cloudServiceConfiguration.
Новое свойство virtualMachineConfiguration добавляется к ресурсам пула и автопуля. Это свойство можно указать для настройки пула или автоматического пула с виртуальными машинами IaaS.
Добавлен новый API для получения сведений обо всех номерах SKU агента узла, поддерживаемых пакетной службой. См. раздел Список поддерживаемых номеров SKU агента узла.
Добавлен новый API для получения параметров удаленного входа, которые можно использовать для удаленного входа на вычислительный узел, созданный с помощью конфигурации виртуальной машины IaaS. См . раздел Получение параметров удаленного входа для узла.
Добавляется новый API для добавления коллекции задач в задание. См . раздел Добавление коллекции задач в задание.
В ресурс User добавляется новое необязательное свойство "sshPublicKey", которое можно использовать для добавления или обновления пользователей на вычислительном узле Linux.
В ресурс Node добавлены два новых свойства totalTasksSucceeded и runningTasksCount. Эти свойства можно получить, выбрав Получение сведений об узле или Перечисление вычислительных узлов в пуле.
К сложному типу ResourceFile добавляется новое свойство fileMode. Это свойство применяется только к вычислительным узлам Linux и игнорируется для вычислительных узлов Windows.
К сложному типу FileProperties добавляется новое свойство fileMode. Это свойство возвращается пакетной службой для вычислительных узлов 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)
В ресурс Task добавляется новое необязательное свойство multiInstanceSettings, которое при необходимости можно включить в API добавления задачи, получения задачи и списка задач.
Новый API Список подзадач задачи добавляется для получения сведений о подзадачах.
В recentTasks для вычислительного узла добавляется новое необязательное свойство subtaskId. Это свойство возвращается в процессе получения вычислительного узла и перечисления вычислительных узлов.
Возможность отключения или включения планирования задач на вычислительном узле
В ресурсе вычислительного узла добавляются два новых API Отключить планирование задач на узле и Включить планирование задач на узле.
Добавлено новое состояние вычислительного узла "вне сети". Для более старых версий API это состояние сопоставляется с непригодным для использования.
В ресурс вычислительного узла добавляется новое свойство schedulingState. Возможные значения для "enabled" и "disabled".
Возможность указывать интервал оценки автомасштабирования в пуле или автопуле
В ресурс пула добавляется новое свойство autoScaleEvaluationInterval. Это свойство можно включить в API добавления пула, получения пула, включения автомасштабирования и списка пулов.
Аналогичным образом для автоматических пулов в свойство autoPoolSpecification добавляется новое свойство autoScaleEvaluationInterval. Это свойство может быть включено в раздел Добавление задания, Получение задания, Перечисление заданий, Добавление расписания заданий, Получение расписания заданий, Обновление расписания заданий, Перечисление расписаний заданий и Список заданий в API-интерфейсах расписания заданий.
Расширение API задач для возврата корневого каталога задачи на вычислительном узле.
В ресурс Task добавлены два новых свойства taskRootDirectory и taskRootDirectoryUrl, которые можно получить в разделе Получение сведений о задаче, API списка задач.
В jobPreparationTaskExecutionInfo и jobReleaseTaskExecutionInfo добавляется новое свойство taskRootDirectory, которое можно получить с помощью списка состояния задач подготовки и освобождения задания для API задания.