共用方式為

批次服務 REST API 版本管理

批次服務 REST API 所提供的操作可能有多個版本，以符合向下相容性，隨著 API 隨時間演進。 你必須在呼叫時指定你想使用的操作版本，並附上你的 REST 呼叫版本。 如果你的應用程式呼叫了舊版本的操作，你可以選擇繼續呼叫舊版本，或修改程式碼以呼叫較新的版本。 若未指定版本或指定錯誤版本，則會回傳錯誤。

要指定操作的版本，請設定 api-version 查詢參數。 該版本採用 Group.Major.Minor 格式，其中 Group 為 YYYY-MM-DD 整數，Minor 為整數。

最新版本：2025-06-01

舊版本

先前版本包括：

版本：2024-07-01.20.0

  • 新增計算節點釋放與啟動操作：
    • 新增ComputeNode_DeallocatePOST /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。PoolSpecificationPoolAddParameter
  • [破裂聲]從 、 、 和 中移除applicationLicenses的性質CloudPool。PoolSpecificationPoolAddParameter
  • 新增任務的容器綁定掛載支援：
    • 新增 ContainerHostBatchBindMountEntry 了帶有 source 屬性的新 isReadOnly 模型。
    • 新增ContainerHostDataPath了 、 、 VfsMountsApplicationsTaskJobPrep和 的數值 。 StartupShared
    • 已將containerHostBatchBindMounts新TaskContainerSettings內容新增至 。
  • 新增機密虛擬機支援：
    • 新增 VMDiskSecurityProfile 了帶有 securityEncryptionType 屬性的新模型。
    • 已將securityProfile新ManagedDisk內容新增至 。
    • 新增 confidentialVM 的值。SecurityProfile.securityType
  • 加入 deallocated 並deallocating作為新值 。ComputeNodeState
  • 新增了 Required deallocated 和 deallocating Properties。NodeCounts
  • 新增共享圖庫與社群圖庫圖片參考支援：
    • 加上 sharedGalleryImageIdcommunityGalleryImageId 和 屬性 。ImageReference
  • 新增 skipWithdrawFromVNet 了控制節點在工作結束後是否仍與 VNet 連接的屬性 JobNetworkConfiguration 。
  • 在 中加入 networkConfiguration 屬性 JobPatchParameter。
  • 擴充池補丁功能：新增 displayName、 vmSize、 taskSchedulingPolicyvirtualMachineConfigurationnetworkConfigurationenableInterNodeCommunicationtaskSlotsPerNodemountConfigurationupgradePolicyuserAccountsresourceTags 及屬性 至 。PoolPatchParameter 影響池子拓撲的屬性只能在池子為空時更新。
  • 新增force布林查詢參數 、 Job_DeleteJob_Terminate、 JobSchedule_Delete及JobSchedule_Terminate操作以強制執行。

版本：2024-02-01.19.0

  • 新增虛擬機池的作業系統升級政策支援：
    • 新增 UpgradePolicy 具有屬性 mode、 automaticOSUpgradePolicy、 和 rollingUpgradePolicy的新模型。 mode屬性（UpgradeMode）接受取值automatic、 manual、 rolling和 。
    • 新增AutomaticOSUpgradePolicy具有屬性disableAutomaticRollback、enableAutomaticOSUpgrade、、 useRollingUpgradePolicyosRollingUpgradeDeferral和 的新模型。
    • 新增RollingUpgradePolicy具有屬性enableCrossZoneUpgrade、maxBatchInstancePercent、 rollbackFailedInstancesOnPolicyBreachmaxUnhealthyInstancePercentmaxUnhealthyUpgradedInstancePercentpauseTimeBetweenBatchesprioritizeUnhealthyInstances和 的新模型。
    • 新增 upgradePolicy 屬性到 CloudPool、 PoolAddParameter、 PoolSpecification。
  • 新增 upgradingos 的值。ComputeNodeState
  • 新增了必要的 upgradingOS 屬性 NodeCounts ，用來報告狀態內 upgradingos 節點數量。

版本：2023-11-01.18.0

  • 新增了 VM 池的可信啟動/安全設定檔支援：
    • 新增 SecurityProfile 具有屬性 encryptionAtHost、 securityType、 和 uefiSettings的新模型。
    • 新增 UefiSettings 了帶有屬性 secureBootEnabled 和 vTpmEnabled的新模型。
    • 已將securityProfile新VirtualMachineConfiguration內容新增至 。
  • 新增對縮尺集的服務工件參考支援：
    • 新增 ServiceArtifactReference 了帶有必要 id 屬性（ARM resource ID）的新模型。
    • 新增 serviceArtifactReference 了設定 VirtualMachineConfiguration ，讓所有虛擬機在使用 latest 映像版本時，縮放集內的虛擬機都設定相同的映像版本。
  • 強化作業系統磁碟配置：
    • 新增 ManagedDisk 了帶有 storageAccountType 屬性的新模型。
    • 新增屬性為 OSDisk： caching， diskSizeGB， managedDiskwriteAcceleratorEnabled， 和 。
  • 加上 StandardSSDLRS （standardssd_lrs） 作為新值。StorageAccountType
  • 新增 resourceTags 屬性到 CloudPool、PoolAddParameter 和 PoolSpecification，讓使用者自訂標籤能傳播到後備Azure資源。 只有在 poolAllocationModeUserSubscription 時才適用。
  • 新增 scaleSetVmResourceId 屬性 VirtualMachineInfo ，以揭露運算節點目前虛擬機縮放集虛擬機的資源 ID。 只有當批次帳號poolAllocationMode的 。UserSubscription

版本：2023-05-01.17.0

  • [破裂聲]移除批次作業/池壽命統計 API： lifetimejobstats 和 lifetimepoolstats。
  • 在 中加入布林屬性enableAcceleratedNetworking。NetworkConfiguration
    • 此特性決定此池是否應啟用加速網路，預設值為 False。
    • 此功能是否能啟用也與是否支援作業系統/虛擬機實例有關，這應符合加速網路政策（AcceleratedNetworking Policy）。
  • 在 中加入布林屬性enableAutomaticUpgrade。VMExtension
    • 此特性決定若有更新版本的擴展，是否應自動升級。
  • 的ContainerConfiguration性質type，現在支持兩個值：DockerCompatible和CriCompatible。

版本：2022-10-01.16.0

  • 新增 NodeCommunicationMode 一個屬性，決定池如何與批次服務通訊
  • 新增 currentNodeCommunicationMode 了 類型的 NodeCommunicationMode 屬性， CloudPool 用於指照池目前通訊模式的狀態。
  • 新增 targetNodeCommunicationMode type NodeCommunicationMode 屬性於以下模型，以指代池所需的節點通訊模式：
    • PoolSpecification
    • CloudPool
    • PoolAddParameter
    • PoolPatchParameter
    • PoolUpdatePropertiesParameter

版本：2022-01-01.15.0

  • 新增 uploadHeaders 模型屬性 OutputFileBlobContainerDestination ，允許使用者在資源檔案上傳時設定自訂 HTTP 標頭。
  • 為以下模型新增 allowTaskPreemption 屬性，以支援高優先順序任務的優先權（需要 Comms-Enabled 或單一租戶池）：
    • JobSpecification
    • CloudJob
    • JobAddParameter
    • JobPatchParameter
    • JobUpdateParameter

版本：2021-06-01.14.0

  • 新增將使用者指派的受管理身份給 CloudPool。 這些身份碼在池中每個節點上開放，並可用來存取各種資源。
  • 新增 identityReference 屬性於以下模型，以支援透過管理身份存取資源：
    • AzureBlobFileSystemConfiguration
    • OutputFileBlobContainerDestination
    • ContainerRegistry
    • ResourceFile
    • UploadBatchServiceLogs
  • 新增 extensions VirtualMachineConfiguration 屬性 CloudPool 以指定節點的虛擬機擴充功能
  • 新增了 VirtualMachineConfiguration 中可用區域 nodePlacementConfiguration 的功能
  • 新增 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

  • 新增利用 的特性 來VirtualMachineConfiguration加密 ComputeNode 磁碟機DiskEncryptionConfiguration的能力。
  • [破裂聲]ImageReference 的 virtualMachineImageId 性質現在只能指代Shared Image Gallery影像。
  • [破裂聲] password 請求操作體 Add Certificate 的屬性對於 PFX 格式的憑證是可選的。
  • [破裂聲]現在可以利用 PublicIPAddressConfiguration 的新 NetworkConfiguration屬性 來配置池，無需公共 IP。
  • [破裂聲]publicIPs該物業NetworkConfiguration也已更名為 ，ipAddressIds並搬入了 。PublicIPAddressConfiguration 此性質僅在 provision 性質為 時 usermanaged才能指定。

版本：2019-08-01.10.0

  • 新增了透過池中新publicIPs屬性在 的NetworkConfiguration公共 IP 集合。 這確保池中的節點擁有來自清單中使用者提供的 IP 的 IP。
  • 新增可透過 MountConfiguration 屬性掛載遠端檔案系統於池的每個節點。
  • Shared Image Gallery影像現在可以透過 ImageReference 的 virtualMachineImageId 屬性來指定，並透過影像的 Azure Resource Manager ID 來引用。
  • [破裂聲]若未指定，則 的waitForSuccessStartTask預設值為true（之前為 false）。
  • [破裂聲]若未指定，AutoUserSpecification 上的 scope 預設值現在永遠是 Pool（過去 Windows 節點為 Task，Linux 節點為 Pool）。
  • 改善了各種令人困惑或不完整的文件。

版本：2019-06-01.9.0

  • [破裂聲]被 取代 ListNodeAgentSKUs 為 ListSupportedImages。 ListSupportedImages 包含所有原始資訊 ListNodeAgentSKUs ，但格式更清晰。 新的未經驗證圖片也會被退還。 更多關於 Capabilities 及 BatchSupportEndOfLife 相關資訊可透過 ImageInformation取得。

  • 現在支援網路安全規則，根據流量的來源埠阻擋網路存取。CloudPool 此規則透過 SourcePortRanges 上的 NetworkSecurityGroupRule屬性來完成。

  • 執行容器時，Batch 現在支援在容器工作目錄或 Batch 工作工作目錄中執行工作。 這是由 上的WorkingDirectory屬性控制TaskContainerSettings。

  • 改善了各種令人困惑或不完整的文件。

版本：2018-12-01.8.0

  • [破裂聲] 移除了對 upgradeos On cloudServiceConfiguration Pool 的支援。

    • 已移除 upgradeos。
    • 已更名為targetOSVersionosVersion並移除currentOSVersion於 CloudPool。
    • 從 upgrading中刪除PoolState。

  • [破裂聲] 已移除 dataEgressGiB 並 dataIngressGiB 從 poolusagemetrics。 這些物件已不再支援。

  • [破裂聲]ResourceFile 改進

    • 新增了在 ResourceFile 中指定整個 Azure Storage 容器的功能。 目前支援三種 ResourceFile 模式：
      • httpUrl 建立 ResourceFile 指向單一 HTTP URL 的訊號。
      • storageContainerUrl 會產生一個指向Azure Blob Storage容器的 ResourceFile。
      • autoStorageContainerName 會建立一個指向批次註冊自動儲存帳戶中的 Azure Blob Storage 容器的 ResourceFile。
    • 透過此httpUrl方法提供的 ResourceFile URL 現在可以是任何 HTTP URL。 過去這些 URL 必須是 Azure Blob Storage URL。
    • blobPrefix 可用來過濾儲存容器的下載，僅過濾與前綴相符的下載。

  • [破裂聲] 從 中移除 osDisk 的屬性 VirtualMachineConfiguration。 該物業現已不再提供支持。

  • 將 上的 設為 的池，現在可以動態地為每個節點分配一個Virtual Network，該節點包括工作JobNetworkConfigurationCloudJobJobSpecification'。

    備註

    此功能處於公開預覽狀態。 除了那些聯絡我們並要求加入試點的帳號外，所有批次帳號都已停用此功能。

  • 任務的最大壽命現在是180天（之前是7天）。

  • 新增支援 Windows 池，透過 LoginMode 建立特定登入模式（batch 或 interactive）。

  • 所有任務的預設保留時間現在是七天，之前是無限長。

版本 2018-08-01.7.0

2018-08-01.7.0 版本新增功能包括：

  • 透過 ComputeNode 上的新 NodeAgentInfo 屬性查看 Azure Batch Node Agent 的版本。
  • 新增了在任務中指定 a FilterResult 的功能。 更多詳情請見此處。
    • 這使得經常被要求的伺服器端查詢情境能夠找到所有失敗的任務。
  • [破裂聲] 已將該 ValidationStatus 屬性從 TaskCounts 移除。
  • [破裂聲]DataDisk 與 OSDisk 的預設快取類型現ReadWriteNone為 。
  • [破裂聲] 將 ContainerType docker 唯一的值從 改 dockerCompatible名為 。

版本 2018-03-01.6.1

2018-03-01.6.1 版本新增功能包括：

  • 依狀態計數池節點：此版本新增了依狀態查詢池節點計數的功能，透過新的 ListPoolNodeCounts 操作。 這個操作讓你能夠查詢批次帳號中所有池的節點狀態。
  • Node agent logs：此版本新增了可透過 UploadBatchServiceLogs 操作，從特定節點上傳 Azure Batch 節點代理日誌的功能。 此日誌供 Microsoft Support 在節點發生問題時除錯使用。

版本 2017-09-01.6.0

  • Azure 混合使用效益：你現在可以建立批次 Windows VM 池，指定使用 Azure 混合使用效益授權。 使用此授權時，虛擬機價格會享有折扣。 請使用 VirtualMachineConfiguration 上的全新 LicenseType 屬性。

  • Pool VM 資料磁碟：你可以利用虛擬機器設定中新增的資料磁碟配置，將一個或多個空的資料磁碟附加到 VM 儲存池。 請使用 VirtualMachineConfiguration 上的 DataDisks 屬性。

  • （變革）自訂映像現在是使用 Azure Resource Manager 的影像資源來建立和部署，而非 blob VHD 檔案。 批次處理現在使用管理磁碟來建立池虛擬機，因此使用 映像資源 。 現在使用自訂映像建立的虛擬機池數量已無限制;此外，大型池不再需要多份 VHD blob 副本。 因此，自訂影像池的建立與擴展更容易。 欲了解更多資訊，請參閱「使用自訂映像檔建立虛擬機池」。

    • ImageReference 上的新 VirtualMachineImageId 屬性包含了對該映像的參考，而 OSDisk.ImageUris 則已不存在。

    • 因此，ImageReference 現已成為 VirtualMachineConfiguration 的必備屬性。

  • （零錢）多實例任務（使用 MultiInstanceSettings 建立）現在必須指定 CoordinationCommandLine，且 CountOfInstances 變成可選且預設為 1。

  • 新增支援使用 Docker 容器執行的任務。 要使用 Docker 容器執行任務，必須在 VirtualMachineConfiguration 中指定 ContainerConfiguration 來指定池的 ContainerConfiguration，然後在 任務上新增 TaskContainerSettings。

版本 2017-06-01.5.1

此處描述的批次 API 版本為 2017-06-01.5.1。 建議盡可能使用最新版本。

2017-06-01.5.1 版本新增功能包括：

  • 透過新的「取得任務計數」操作，支援有效率的任務計數。 透過呼叫「取得任務計數」操作，你可以統計目前進行中、執行中及已完成的任務，以及成功或失敗的任務。 欲了解更多資訊，請參閱「依州計算任務」（預覽）。
  • 支援透過新的 poolEndpointConfiguration 屬性，指定池運算節點的入站端點。 透過設定這個屬性，你可以在外部位址節點上的特定埠口。

版本 2017-05-01.5.0

以下章節概述 2017-05-01.5.0 版本中新增及變更的功能。

這很重要

2017-05-01.5.0 版本包含多項重大變更。 檢視這些破壞性變更並更新您的程式碼，以便將版本編號為 2017-05-01.5.0。

低優先權計算節點

Azure Batch 現在提供低優先權的運算節點，以降低批次工作負載的成本。 低優先權虛擬機透過提供大量且經濟的運算能力，使新型批次工作負載成為可能。

低優先權節點的 REST API 有多項變更：

  • （零錢）池或池的規範中的 targetDedicated 與 currentDedicated 屬性已重新命名為 targetDedicatedNodes 與 currentComputeNodes。
  • （零錢）池的 resizeError 屬性現在變成一個稱為 resizeErrors 的集合。
  • 運算節點新增了 isDedicated 特性。 此特性對專用節點 為真 ，對低優先順序節點為 假 。
  • 工作管理員任務新增了 allowLowPriorityNode 屬性。 若此特性 成立，工作管理員任務可能會在低優先順序節點上執行。 若為 false，則 Job Manager 任務會在專用的運算節點上執行。

Linux 上的指定使用者

Azure Batch 現在提供額外支援，能在 Linux 節點上建立命名使用者。

  • 新的 linuxUserConfiguration 屬性支援在建立 Linux 使用者時指定 uid （使用者 ID）和 gid （群組 ID）。
  • （零錢）sshPrivateKey 屬性已從 userAccount 屬性移至新的 linuxUserConfiguration 屬性。 linuxUserConfiguration 屬性本身就是 userAccount 屬性的屬性。

欲了解更多有關命名使用者帳號的資訊，請參閱「在批次中執行任務」的使用者帳號。

任務資料的輸出檔案

你現在可以指定輸出檔案，在任務完成後上傳資料。

  • 新的 outputFiles 特性支援指定要上傳到Azure Storage的任務檔案。
  • exitConditions 屬性的新 fileUploadError 屬性支援根據輸出檔案的上傳狀態指定要採取的動作。

任務錯誤回報

已進行多項變更以改善任務錯誤的報告。

  • executionInfo 屬性的新結果屬性會顯示任務是否成功或失敗。
  • （零錢）executionInfo 屬性的 schedulingError 屬性已被重新命名為 failureInfo。 每當任務失敗時， failInfo 屬性都會被回傳。 這包括所有先前排程錯誤、所有回傳非零任務結束碼的情況，以及任何檔案上傳失敗。
  • （零錢）exitConditions 屬性的 schedulingError 屬性已改名為 preProcessingError，以釐清錯誤發生於任務生命週期的時間點。
  • （零錢）schedulelingErrorCateogry 屬性已重新命名為 errorCategory。

應用程式授權

你現在可以透過池或池規範上的新 applicationLicenses 屬性，要求將應用程式授權配置到你的池中。

版本 2017-01-01.4.0

此版本版本將所有支援延伸至前一個版本 2016-07-01.3.1。 此外，它還支援以下功能：

  • 以指定的使用者身份執行任務。

    你現在可以在以下使用者身份之一執行任務或任務集合，這些身份可透過任務資源上的 new userIdentity 屬性指定：

    • 一個你定義名稱的使用者帳號。

    • 一個自動建立的使用者帳號（自動使用者）。 自動使用者可以作為管理員使用者或非管理員使用者執行。 預設情況下，自動使用者會以非管理員使用者身份執行。

      這很重要

      userIdentity 屬性及其 elevationLevel 屬性，會替換新增任務或任務集合的請求中的 runElevated 屬性，以及取得任務資訊或列出任務的回應。

      如果你提出包含 runElevated 屬性到 Batch 服務版本 2017-01-01.4.0 的請求，該請求就會失敗。

      若要以管理員使用者身份執行，請更新應用程式使用 userIdentity 屬性，並將 elevationLevel 屬性設為 管理員。

      要以非管理員使用者身份執行，請更新應用程式使用 使用者身份 ，並將 elevationLevel 屬性設為 非管理員。 因為這個設定是預設值，你也可以省略這個設定。

  • 定義池中所有節點的使用者帳號。

    你現在可以在池中資源中定義的使用者帳號下執行任務或任務集合。 透過 Requests to Add Pool 中的 new userAccounts 屬性定義使用者帳號。 當你定義帳號時，可以指定帳號名稱、密碼、等級（admin 或非管理員）以及 SSH 私鑰（用於 Linux 池）。

    一旦你定義了使用者帳號，就可以在新增任務或任務集合的請求中，指定該使用者帳號的 userIdentity 屬性。

  • 提供任務一個令牌，讓任務執行時向批次服務進行認證。

    批次服務現在可以在任務執行時提供認證權杖。 認證權杖讓任務能向批次服務發出與該工作相關的請求，無需批次帳戶金鑰。 權杖是透過AZ_BATCH_AUTHENTICATION_TOKEN環境變數提供的。

    目前認證權杖僅支援對工作資源的呼叫操作。 認證權杖允許存取包含該任務的所有作業操作。

    要讓批次服務提供認證權杖，請在新增任務或新增任務集合請求中指定新的 authenticationTokenSettings 屬性及其 存取 屬性。

  • 指定任務失敗時要對其相依性採取的動作。

    你現在可以指定，即使依賴的任務失敗，仍會繼續執行。 將任務資源的新 dependencyAction屬性設定為 滿足，即使父任務失敗，仍能執行相依任務。 或者，將 dependencyAction 設 為阻塞 ，以防止父任務失敗時執行相依任務。

    在請求新增任務或新增任務集合時，指定 dependencyAction 屬性。

    欲了解更多關於依賴動作的使用資訊，請參見依賴動作。

  • 建立儲存池時，請使用自訂作業系統的磁碟映像檔。

    你現在可以使用自訂作業系統的磁碟映像來建立一個儲存池。

    為此，您必須在建立批次帳號時指定池將配置在用戶訂閱中，而非由批次服務管理的訂閱。 在呼叫建立帳號時，將 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。 此外，它還支援以下功能：

  • 具備建立池與自動池及網路配置的能力

    • 新增了屬性網絡配置，已在池與自動池資源中新增。 此特性可用來指定s network configuration, such as the subnet in which the pool所建立的運算節點。

  • 當所有任務完成後，自動終止工作。

    • 工作資源新增了一個 onAllTasksComplete 屬性。 你可以在建立或更新工作時指定這個屬性。

  • 當任務失敗時，自動終止或停用工作。

    • 工作資源新增了 onTaskFailure 屬性，任務資源中新增了 exitConditions 屬性。 onTaskFailure 設定顯示任務失敗是否可能對工作層級產生影響，而任務 exitConditions 屬性允許任務根據失敗性質調整工作層級的影響。

  • 將應用程式套件與任務及池子關聯起來。

    • 新增了一個屬性 applicationPackageReferences，加入任務資源和工作 jobManagerTask 設定。 此特性允許應用程式套件依任務需求隨時部署，而非在建立池時指定。 這種特性對於長期運作的池特別有價值，因為這些池可能需要在其生命週期中執行不同類型的工作或不同應用程式版本。

  • 重新啟動失敗任務的能力。

    • 新增了一個「重新啟動任務」的操作，用來將失敗任務的狀態重置為「啟動」。 這允許重試失敗，例如故障是暫時性的，或你已修復故障原因，且不必重新建立任務。

版本 2016-02-01.3.0

此版本版本將所有支援擴展至先前版本 2015-12-01.2.2。 此外，它還支援以下功能：

  • 具備建立池與自動池的能力，並可搭配 IaaS 虛擬機配置

    • 現有屬性 osFamily， targetOSVersion 和 currentOSVersion 會從 Pool 和 Autopool 資源的頂層屬性移動，並移入一個名為 cloudServiceConfiguration的新屬性中。

    • 新物件 virtualMachineConfiguration 會被加入池池和自動池資源中。 此特性可指定以配置包含 IaaS 虛擬機的池/自動池。

    • 新增一個 API 以取得批次服務支援的所有節點代理 SKU 資訊。 請參見支援節點代理 SKU 清單。

    • 新增 API 以取得遠端登入設定，並可遠端登入以 IaaS 虛擬機設定建立的運算節點。 請參見「取得節點遠端登入設定」。

    • 新增一個 API 來為工作新增一組任務。 參見「新增任務集合到工作」。

    • 使用者資源新增了一個可選屬性 sshPublicKey ，可用於新增或更新 Linux 運算節點上的使用者。

    • 節點資源中新增了兩個屬性 totalTasksSucceeded 和 runningTasksCount 。 這些屬性可透過「獲取節點資訊」或「列出池中的計算節點」來取得。

    • 複數型態中會新增ResourceFile一個性質fileMode。 此特性僅適用於 Linux 運算節點，Windows 運算節點則忽略此功能。

    • 複數型態中會新增FileProperties一個性質fileMode。 此屬性由 Linux 運算節點的批次服務以 GetFileProperties 或 ListFileProperties API 的一部分回傳。 此外，複雜型別下的FileProperties現有屬性creationTime會被改為可選屬性，因為 Linux 運算節點不會回傳這個屬性。

    • 複雜型態中CertificateReference現有屬性visibility的資料型態會從逗號分隔的字串修改為一組字串。 另外，現有的可見性值之一也從「rdp」改名為「remoteuser」。

  • 以下 API 的 URL 將動作名稱中的「？」改為「/」：

    • 替換池的性質

    • 關閉池的自動縮放功能

    • 啟用池的自動縮放

    • 評估自動縮放公式

    • 改變池塘大小

    • 別再改變泳池的大小了

    • 升級池中計算節點的作業系統

    • 從池中移除運算節點

    • 重新啟動節點

    • 重塑節點

    • 在節點上停用任務排程

    • 啟用節點上的任務排程

    • 停用工作排程

    • 啟用工作排程

    • 終止工作排班

    • 停用工作

    • 啟用一個工作

    • 終止一份工作

    • 終止任務

    • 取消刪除憑證

版本 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以指定計算節點。 此特性作為取得計算節點與列表計算節點的一部分回傳

  • 具備在運算節點上停用或啟用任務排程的功能

    • 在計算節點資源中新增了兩個 API：在 Compute Node 資源中新增了 Disable task scheduleling 以及 Enable task scheduleling on a node。

    • 新增一個運算節點狀態 offline 。 對於較舊的 API 版本，此狀態會映射到 unusable。

    • 計算節點資源會新增一個屬性 schedulingState 。 和 的enableddisabled可能值。

  • 具備在池/自動池上指定自動 -scale 評估間隔的能力

    • 新增一個物業 autoScaleEvaluationInterval 加入資源池。 此特性可包含於新增池、取得池、啟用自動縮放及列表池等 API 中。

    • 同樣地，對於汽車合池，則會新增一個物業 autoScaleEvaluationInterval 到 autoPoolSpecification 該物業。 此特性可包含於工作排程 API 中的新增工作、取得工作、列出工作、新增工作排程、取得工作排程、更新工作排程、列出工作排程及工作排程等功能中。

  • 任務 API 強化以回傳計算節點上任務的根目錄。

    • 新增兩個屬性 taskRootDirectory 和 taskRootDirectoryUrl 加入任務資源，可作為「獲取任務資訊」、「任務 API」一部分取得

    • 新增jobPreparationTaskExecutionInfo一個屬性taskRootDirectory，jobReleaseTaskExecutionInfo可透過「列出工作準備與工作釋放任務的狀態」取得。

  • Last updated on