Job - List From Job Schedule

CloudJobListResult

包含作業清單的回應。

標題

• client-request-id: string
• request-id: string
• ETag: string
• Last-Modified: string

BatchError

Batch 服務的錯誤。

string

授與存取權，以在包含工作的作業上執行所有作業。

string

要部署之應用程式的標識碼。
建立集區時，套件的應用程式標識碼必須完整 （/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}）。

string

要部署的應用程式版本。 如果省略，則會部署預設版本。
如果在集區上省略此專案，而且此應用程式未指定預設版本，要求會失敗，錯誤碼 InvalidApplicationPackageReferences 和 HTTP 狀態代碼 409。 如果在 Task 上省略此專案，而且此應用程式未指定預設版本，則工作會失敗，並出現前置處理錯誤。

AccessScope[]

令牌授與存取權的 Batch 資源。
驗證令牌會將存取權授與一組有限的 Batch 服務作業。 存取屬性目前唯一支援的值是 'job'，它會授與與包含Task之作業相關之所有作業的存取權。

boolean

是否應停用OS映像復原功能。

boolean

指出當較新版本的OS映像可用時，是否應該以滾動方式自動套用作業系統升級至擴展集實例。

如果 Windows 集區設為 true，WindowsConfiguration.enableAutomaticUpdates 無法設定為 true。

boolean

如果 OS 正在執行工作，請延遲 TVM 上的 OS 升級。

boolean

指出是否應在自動OS升級期間使用滾動升級原則。 如果未在 VMSS 上定義任何原則，自動 OS 升級將會回復為默認原則。

string

自動建立集區時，要新增至唯一標識符的前置詞。
Batch 服務會為每個自動集區指派建立時的唯一標識碼。 若要區分為不同用途建立的集區，您可以指定這個專案，將前置詞新增至指派的標識符。 前置詞長度最多可達 20 個字元。

boolean

是否在其存留期到期后讓自動集區保持運作。
如果為 false，Batch 服務會在其存留期之後刪除集區（由 poolLifetimeOption 設定所決定）到期;也就是作業或作業排程完成時。 如果為 true，Batch 服務不會自動刪除集區。 用戶必須刪除使用此選項建立的自動集區。

PoolSpecification

自動集區的集區規格。

PoolLifetimeOption

建立的自動集區最小存留期，以及如何將排程上的多個作業指派給集區。

string

指定工作會以在集區中的每個計算節點上建立的通用自動使用者帳戶執行。

string

指定服務應該為工作建立新的使用者。

ElevationLevel

自動使用者的提高許可權層級。
預設值為 nonAdmin。

AutoUserScope

自動用戶的範圍
預設值為集區。 如果集區正在執行 Windows，則當需要更嚴格的工作隔離時，應該指定 Task 的值。 例如，如果工作以可能會影響其他工作的方式變動登錄，或已在集區上指定憑證，而該集區上不應該由一般工作存取，但應該可供 StartTasks 存取。

string

Azure 記憶體帳戶金鑰。
此屬性與 sasKey 和身分識別互斥;必須只指定一個。

string

Azure 記憶體帳戶名稱。

string

要傳遞至掛接命令的其他命令行選項。
這些是 Windows 中的「net use」選項，Linux 中的「掛接」選項。

string

Azure Blob 記憶體容器名稱。

ComputeNodeIdentityReference

用來存取 containerName 之使用者指派身分識別的參考
此屬性與 accountKey 和 sasKey 互斥;必須只指定一個。

string

要掛接檔系統之計算節點上的相對路徑
所有文件系統都會掛接至 Batch 掛接目錄，可透過 AZ_BATCH_NODE_MOUNTS_DIR 環境變數存取。

string

Azure 記憶體 SAS 令牌。
此屬性與 accountKey 和身分識別互斥;必須只指定一個。

string

Azure 記憶體帳戶金鑰。

string

Azure 記憶體帳戶名稱。

string

Azure 檔案服務 URL。
這是格式為 『https://{account}.file.core.windows.net/』。

string

要傳遞至掛接命令的其他命令行選項。
這些是 Windows 中的「net use」選項，Linux 中的「掛接」選項。

string

要掛接檔系統之計算節點上的相對路徑
所有文件系統都會掛接至 Batch 掛接目錄，可透過 AZ_BATCH_NODE_MOUNTS_DIR 環境變數存取。

string

錯誤的識別碼。 程序代碼是不變的，而且是要以程序設計方式取用。

ErrorMessage

描述錯誤的訊息，適用於在使用者介面中顯示。

BatchErrorDetail[]

索引鍵/值組的集合，其中包含錯誤的其他詳細數據。

string

指定 Value 屬性意義的識別碼。

string

錯誤回應隨附的其他資訊。

string

磁碟的快取模式未啟用。

string

磁碟的快取模式是唯讀的。

string

磁碟的快取模式是讀取和寫入。

CertificateStoreLocation

要安裝憑證之計算節點上的證書存儲位置。
默認值為 currentuser。 此屬性僅適用於使用 Windows 計算節點設定的集區。 針對 Linux 計算節點，憑證會儲存在工作工作目錄內的目錄中，而環境變數AZ_BATCH_CERTIFICATES_DIR會提供給工作來查詢此位置。 對於可見度為 『remoteUser』 的憑證，會在使用者的主目錄中建立 『certs』 目錄（例如 /home/{user-name}/certs）和憑證放在該目錄中。

string

要安裝憑證之計算節點上的證書存儲名稱。
此屬性僅適用於使用 Windows 計算節點設定的集區。 常見的存放區名稱包括：My、Root、CA、Trust、Disallowed、TrustedPeople、TrustedPublisher、AuthRoot、AddressBook，但也可以使用任何自定義存放區名稱。 預設值為 My。

string

憑證的指紋。

string

指紋相關聯的演算法。 這必須是sha1。

CertificateVisibility[]

計算節點上的哪些用戶帳戶應該可以存取憑證的私用數據。
您可以在此集合中指定多個可見度。 預設值為 [所有帳戶]。

string

憑證應該安裝到 CurrentUser 證書存儲。

string

憑證應該安裝到 LocalMachine 證書存儲。

string

用戶從遠端訪問計算節點的用戶帳戶應該可以看到憑證。

string

執行 StartTask 的用戶帳戶應該可以看到憑證。 請注意，如果 AutoUser 範圍同時為 StartTask 和 Task 的集區，工作也會看到此憑證。

string

執行作業工作的用戶帳戶應該可以看到憑證。

string

要傳遞至掛接命令的其他命令行選項。
這些是 Windows 中的「net use」選項，Linux 中的「掛接」選項。

string

要用於驗證 CIFS 檔案系統的密碼。

string

要掛接檔系統之計算節點上的相對路徑
所有文件系統都會掛接至 Batch 掛接目錄，可透過 AZ_BATCH_NODE_MOUNTS_DIR 環境變數存取。

string

要掛接之文件系統的 URI。

string

要用於對 CIFS 檔案系統進行驗證的使用者。

boolean

此作業中的工作是否可以由其他高優先順序工作先佔
如果值設定為 True，則送出至系統的其他高優先順序工作將優先，而且能夠從此作業重新排入工作佇列。 您可以使用更新作業 API 建立作業之後，更新作業的allowTaskPreemption。

EnvironmentSetting[]

一般環境變數設定的清單。 這些環境變數是針對作業中的所有工作設定的（包括作業管理員、作業準備和作業發行工作）。
個別工作可以藉由使用不同的值來指定相同的設定名稱，來覆寫此處指定的環境設定。

JobConstraints

作業的執行條件約束。

string

作業的建立時間。

string

工作的顯示名稱。

string

作業的ETag。
這是不透明的字串。 您可以使用它來偵測作業是否已在要求之間變更。 特別是，您可以在更新作業時傳遞 ETag，以指定只有當其他人同時沒有修改作業時，您的變更才會生效。

JobExecutionInformation

作業的執行資訊。

string

可唯一識別帳戶內作業的字串。
標識符是區分大小寫和不區分大小寫的（也就是說，您可能不會在帳戶內有兩個標識符，只有大小寫不同）。

JobManagerTask

作業啟動時要啟動之作業管理員工作的詳細數據。
作業管理員工作會在建立作業時自動啟動。 Batch 服務會嘗試在作業的任何其他工作之前排程作業管理員工作。 壓縮集區時，Batch 服務會嘗試保留作業管理員工作儘可能長時間執行的節點（也就是在執行作業管理員工作的計算節點之前，會移除執行「一般」工作的計算節點）。 當作業管理員工作失敗且需要重新啟動時，系統會嘗試以最高優先順序排程它。 如果沒有可用的閑置計算節點，系統可能會終止集區中其中一個執行中的工作，並將它傳回佇列，以便讓作業管理員工作能夠重新啟動。 請注意，一個作業中的作業管理員工作不會優先於其他作業中的工作。 跨作業，只會觀察到作業層級優先順序。 例如，如果優先順序為 0 作業的作業管理員需要重新啟動，則不會取代優先順序 1 作業的工作。 批次會在節點上觸發復原作業時重試工作。 復原作業的範例包括當狀況不良的節點重新啟動或計算節點因主機失敗而消失時，包括 （但不限於） 。 由於復原作業的重試與 無關，而且不會計入 maxTaskRetryCount。 即使 maxTaskRetryCount 是 0，由於復原作業，可能會發生內部重試。 因此，所有工作都應該是等冪的。 這表示工作必須容許中斷並重新啟動，而不會造成任何損毀或重複的數據。 長時間執行工作的最佳做法是使用某種形式的檢查點。

JobPreparationTask

作業準備工作。
作業準備工作是在作業的任何其他工作之前，在每個計算節點上執行的特殊工作。

JobReleaseTask

作業發行工作。
作業發行工作是工作在作業結束時執行的每個計算節點上執行的特殊工作，該節點已執行作業的任何其他工作。

string

作業的最後一次修改時間。
這是作業層級數據上次變更的時間，例如作業狀態或優先順序。 它不會考慮工作層級變更，例如新增工作或工作變更狀態。

integer

工作可以平行執行的工作數目上限。
maxParallelTasks 的值必須 -1 或大於 0，如果指定的話。 如果未指定，預設值為 -1，這表示可以一次執行的工作數目沒有限制。 您可以使用更新作業 API 建立作業之後，更新作業的 maxParallelTasks。

MetadataItem[]

與作業做為元數據相關聯的名稱/值組清單。
Batch 服務不會將任何意義指派給元數據;它僅供使用者程式代碼使用。

JobNetworkConfiguration

作業的網路組態。

OnAllTasksComplete

當作業中的所有工作都處於已完成狀態時，Batch 服務應該採取的動作。
預設值為 noaction。

OnTaskFailure

當作業中的任何工作失敗時，Batch 服務應該採取的動作。
如果失敗Info，工作會被視為失敗。 如果 Task 在結束重試計數後以非零結束代碼完成，或啟動工作時發生錯誤，例如資源文件下載錯誤，則會設定 failureInfo。 預設值為 noaction。

PoolInformation

與作業相關聯的集區設定。

JobState

作業的先前狀態。
如果作業處於初始作用中狀態，則不會設定這個屬性。

string

作業進入其先前狀態的時間。
如果作業處於初始作用中狀態，則不會設定這個屬性。

integer

作業的優先順序。
優先順序值的範圍可以從 -1000 到 1000，-1000 是最低優先順序，1000 是最高優先順序。 預設值為 0。

JobState

作業的目前狀態。

string

作業進入其目前狀態的時間。

JobStatistics

作業整個存留期的資源使用量統計數據。
只有在使用包含 『stats』 屬性的 expand 子句擷取 CloudJob 時，才會填入此屬性;否則為 null。 統計數據可能無法立即取得。 Batch 服務會定期匯總統計數據。 一般延遲約30分鐘。

string

作業的 URL。

boolean

作業中的工作是否可以定義彼此的相依性。 默認值為 false。

string

要取得下一組結果的URL。

CloudJob[]

作業清單。

string

在將任何工作指派給集區中的下一個計算節點之前，應該將盡可能多的工作指派給集區中的每個計算節點（taskSlotsPerNode）。

string

工作應該平均指派給集區中的所有計算節點。

string

使用者指派身分識別的 ARM 資源識別碼。

string[]

容器映像名稱的集合。
這是完整的映像參考，如同指定為 “docker pull”。 除非映像具有替代登錄的完整映射，否則映像會從預設 Docker 登錄進行來源。

ContainerRegistry[]

可從中提取容器的其他私人登錄。
如果必須從需要認證的私人登錄下載任何映像，則必須在這裡提供這些認證。

ContainerType

要使用的容器技術。

boolean

將此來源路徑掛接為唯讀模式或否。 默認值為 false （讀取/寫入模式）。
針對 Linux，如果您將此路徑掛接為讀取/寫入模式，這並不表示容器中的所有使用者都有路徑的讀取/寫入存取權，這取決於主機 VM 中的存取權。 如果此路徑是只讀掛接，容器內的所有使用者將無法修改路徑。

ContainerHostDataPath

掛接至容器客戶的路徑可以選取。

string

應用程式路徑。

string

作業準備工作路徑。

string

要共用其檔案之多重實例工作的路徑。

string

開始工作的路徑。

string

工作路徑。

string

路徑包含此節點上掛接的所有虛擬檔案系統。

ComputeNodeIdentityReference

使用者指派身分識別的參考，用來存取 Azure Container Registry，而不是使用者名稱和密碼。
與計算節點將使用的 Batch 集區相關聯的使用者指派身分識別參考。

string

登入登錄伺服器的密碼。

string

登錄 URL。
如果省略，預設值為 「docker.io」。。

string

要登入登錄伺服器的用戶名稱。

string

CRI 型技術將用來啟動容器。

string

Docker 相容容器技術將用來啟動容器。

string

使用容器映像中定義的工作目錄。 請注意，此目錄不會包含 Batch 下載的資源檔。

string

使用標準 Batch 服務工作工作目錄，其中包含 Batch 填入的工作資源檔。

CachingType

要針對數據磁碟啟用的快取類型。
快取的預設值為 readwrite。 如需快取選項的相關信息，請參閱：https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/。

integer

以 GB 為單位的初始磁碟大小。

integer

邏輯單元編號。
lun 可用來唯一識別每個數據磁碟。 如果連結多個磁碟，則每個磁碟都應該有相異的 Lun。 值必須介於 0 到 63 之間，且包含 。

StorageAccountType

要用於數據磁碟的記憶體帳戶類型。
如果省略，預設值為 「standard_lrs」。。

string

暫時OS磁碟會儲存在VM快取上。

DiffDiskPlacement

指定集區中所有 VM 之作業系統磁碟的暫時磁碟位置。
用戶可以在要求中使用這個屬性來選擇位置，例如快取暫時OS磁碟布建的磁碟空間。 如需暫時 OS 磁碟大小需求的詳細資訊，請參閱 https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirementshttps://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements 和 Linux VM 的暫時 OS 磁碟大小需求。

DiskEncryptionTarget[]

磁碟目標 Batch 服務的清單會在計算節點上加密。
磁碟目標 Batch 服務的清單會在計算節點上加密。

string

計算節點上的OS磁碟會加密。

string

計算節點上的暫存磁碟會加密。 在 Linux 上，此加密適用於在開機時間進行加密時的其他分割區（例如掛接的數據磁碟上的磁碟分區）。

string

動態 VNet 指派是個別作業完成。

string

未啟用動態 VNet 指派。

string

使用者是具有較高存取權的使用者，且會以完整的系統管理員許可權運作。

string

使用者是標準使用者，沒有提升許可權的存取權。

string

環境變數的名稱。

string

環境變數的值。

string

錯誤是因為內部伺服器問題所致。

string

錯誤是因為用戶問題，例如設定錯誤。

string

錯誤訊息的語言代碼

string

訊息的文字。

string

上傳輸出檔案時所要使用的標頭不區分大小寫的名稱

string

上傳輸出檔案時要使用的標頭值

string

社群資源庫映像唯一標識符
這個屬性與其他屬性互斥，而且可以從社群資源庫映像 GET 呼叫擷取。

string

用來建立節點之平臺映像或市集映像的特定版本。 只有當建立集區時為 'version' 指定的值是 'latest' 時，這個只讀字段才會與 'version' 不同。

string

Azure 虛擬機 Marketplace 映像的供應項目類型。
例如，UbuntuServer 或 WindowsServer。

string

Azure 虛擬機 Marketplace 映像的發行者。
例如，Canonical 或 MicrosoftWindowsServer。

string

共用資源庫映像唯一標識碼
這個屬性與其他屬性互斥，而且可以從共用資源庫映像 GET 呼叫擷取。

string

Azure 虛擬機 Marketplace 映像的 SKU。
例如，18.04-LTS 或 2019-Datacenter。

string

Azure 虛擬機 Marketplace 映像的版本。
您可以指定 'latest' 的值來選取最新版的映像。 如果省略，預設值為 'latest'。

string

Azure 計算資源庫映射的 ARM 資源識別碼。 將會使用此映像標識碼來建立集區中的計算節點。這是 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} 的格式 或 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageDefinitionName} ，一律預設為最新的映射版本。
這個屬性與其他 ImageReference 屬性互斥。 Azure 計算資源庫映像必須有相同區域中的複本，且必須與 Azure Batch 帳戶位於相同的訂用帳戶中。 如果未在 imageId 中指定映像版本，則會使用最新版本。 如需 Batch 計算節點代理程式與 Batch 服務通訊之防火牆設定的相關信息，請參閱 https://docs.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration。

string

針對端點使用 TCP。

string

針對端點使用UDP。

integer

計算節點上的埠號碼。
這在 Batch 集區內必須是唯一的。 可接受的值介於 1 到 65535 之間，但 29876 和 29877 除外，因為這些值是保留的。 如果提供任何保留值，要求就會失敗，且 HTTP 狀態代碼為 400。

integer

外部埠範圍中的最後一個埠號碼，用來提供個別計算節點上 backendPort 的輸入存取權。
可接受的值範圍介於 1 到 65534 之間，但 Batch 服務保留的埠從 50000 到 55000。 集區內的所有範圍都必須相異且無法重疊。 每個範圍至少必須包含 40 個埠。 如果提供任何保留或重疊的值，要求就會失敗，且 HTTP 狀態代碼為 400。

integer

外部埠範圍中的第一個埠號碼，將用來提供個別計算節點上 backendPort 的輸入存取。
可接受的值範圍介於 1 到 65534 之間，但保留的埠介於 50000 到 55000 之間。 集區內的所有範圍都必須相異且無法重疊。 每個範圍至少必須包含 40 個埠。 如果提供任何保留或重疊的值，要求就會失敗，且 HTTP 狀態代碼為 400。

string

端點的名稱。
名稱在 Batch 集區內必須是唯一的，可以包含字母、數位、底線、句號和連字元。 名稱必須以字母或數字開頭，結尾必須是字母、數位或底線，且不能超過 77 個字元。 如果提供任何無效的值，要求就會失敗，且 HTTP 狀態代碼為 400。

NetworkSecurityGroupRule[]

將套用至端點的網路安全組規則清單。
批次集區上所有端點可指定的最大規則數目為 25。 如果未指定網路安全組規則，則會建立默認規則以允許輸入存取指定的 backendPort。 如果超過網路安全組規則的最大數目，要求會失敗，並出現 HTTP 狀態代碼 400。

InboundEndpointProtocol

端點的通訊協定。

string

公用IP將由 Batch 建立和管理。 視集區的大小而定，可能會有多個公用IP。

string

將不會建立公用IP位址。

string

公用IP是由使用者提供，並且將用來布建計算節點。

integer

每個工作可重試的次數上限。 如果 Batch 服務結束代碼為非零，則會重試工作。
請注意，這個值會特別控制重試次數。 Batch 服務會嘗試每個工作一次，然後可能會重試到此限制。 例如，如果重試計數上限為 3，Batch 會嘗試工作最多 4 次（一次初始嘗試，3 次重試）。 如果重試計數上限為0，Batch服務就不會重試工作。 如果重試計數上限為 -1，Batch 服務會不限制地重試工作。 預設值為 0（沒有重試）。

string

作業可能執行的最大經過時間，從建立作業的時間計算。
如果作業未在時間限制內完成，Batch 服務就會終止它，以及仍在執行的任何工作。 在此情況下，終止原因會是 MaxWallClockTimeExpiry。 如果未指定這個屬性，則作業執行的時間長度沒有限制。

string

作業的完成時間。
只有當 Job 處於已完成狀態時，才會設定這個屬性。

string

指派此作業的集區標識碼。
此元素包含指派作業的實際集區。 當您從服務取得作業詳細數據時，它們也會包含 poolInfo 元素，其中包含新增或更新作業時的集區組態數據。 該 poolInfo 元素也可能包含 poolId 元素。 如果這樣做，這兩個標識符是相同的。 如果沒有，表示作業在自動集區上執行，而此屬性包含該自動集區的標識符。

JobSchedulingError

啟動作業時服務所遇到的任何錯誤詳細數據。
如果沒有啟動作業時發生錯誤，則不會設定這個屬性。

string

作業的開始時間。
這是建立作業的時間。

string

描述作業結束原因的字串。
只有當 Job 處於已完成狀態時，才會設定這個屬性。 如果 Batch 服務終止作業，它會設定原因，如下所示：JMComplete - 作業管理員工作已完成，而 killJobOnCompletion 已設定為 true。 MaxWallClockTimeExpiry - 作業達到其 maxWallClockTime 條件約束。 TerminateJobSchedule - 作業是以排程的一部分執行，而排程已終止。 AllTasksComplete - 作業的 onAllTasksComplete 屬性會設定為 terminatejob，而作業中的所有工作都會完成。 TaskFailed - 作業的 onTaskFailure 屬性會設定為 performExitOptionsJobAction，而作業中的 Task 失敗，並具有指定 jobAction 為 terminatejob 的結束條件。 任何其他字串都是呼叫「終止作業」作業中指定的使用者定義原因。

boolean

作業管理員工作是否可以在現成/低優先順序計算節點上執行。
默認值為 true。

ApplicationPackageReference[]

在執行命令行之前，Batch 服務會部署至計算節點的應用程式套件清單。
應用程式套件會下載並部署至共享目錄，而不是工作工作目錄。 因此，如果參考的應用程式套件已在計算節點上，且為最新狀態，則不會重新下載;會使用計算節點上的現有複本。 如果無法安裝參考的應用程式套件，例如因為套件已刪除或下載失敗，工作就會失敗。

AuthenticationTokenSettings

工作可用來執行 Batch 服務作業之驗證令牌的設定。
如果已設定此屬性，Batch 服務會提供一個驗證令牌，可用來驗證 Batch 服務作業，而不需要帳戶存取密鑰。 令牌會透過AZ_BATCH_AUTHENTICATION_TOKEN環境變數來提供。 工作可以使用令牌執行的作業取決於設定。 例如，工作可以要求作業許可權，以便將其他工作新增至作業，或檢查作業下的工作或其他工作的狀態。

string

作業管理員工作的命令行。
命令行不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。 如果您想要利用這些功能，您應該在命令行中叫用殼層，例如在 Windows 中使用 “cmd /c MyCommand”，或在 Linux 中使用 “/bin/sh -c MyCommand”。 如果命令行參考檔案路徑，它應該使用相對路徑（相對於Task工作目錄），或使用 Batch 提供的環境變數 （https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables）。

TaskConstraints

套用至作業管理員工作的條件約束。

TaskContainerSettings

作業管理員工作執行所在的容器設定。
如果執行此工作的集區已設定 containerConfiguration，也必須設定此設定。 如果將執行此工作的集區沒有 containerConfiguration 設定，則不得設定此設定。 指定此專案時，AZ_BATCH_NODE_ROOT_DIR下方的所有目錄都會遞歸地對應到容器中（節點上的 Azure Batch 目錄根目錄），所有工作環境變數都會對應到容器中，而工作命令行則會在容器中執行。 AZ_BATCH_NODE_ROOT_DIR外部容器中產生的檔案可能不會反映到主機磁碟，這表示 Batch 檔案 API 將無法存取這些檔案。

string

作業管理員工作的顯示名稱。
它不需要是唯一的，而且可以包含最大長度為 1024 的任何 Unicode 字元。

EnvironmentSetting[]

作業管理員工作的環境變數設定清單。

string

字串，可唯一識別作業內的作業管理員工作。
標識元可以包含英數位元的任何組合，包括連字元和底線，不能包含超過64個字元。

boolean

作業管理員工作完成是否表示整個作業完成。
如果為 true，當作業管理員工作完成時，Batch 服務會將作業標示為完成。 如果目前任何工作仍在執行中（作業版本除外），則會終止這些工作。 如果為 false，則作業管理員工作的完成不會影響作業狀態。 在此情況下，您應該使用 onAllTasksComplete 屬性來終止 Job，或讓用戶端或使用者明確終止作業。 其中一個範例是，如果作業管理員建立一組工作，但在執行時不會採取進一步的角色。 默認值為 true。 如果您使用 onAllTasksComplete 和 onTaskFailure 屬性來控制作業存留期，並且只使用作業管理員工作來建立作業的工作（不要監視進度），則必須將 killJobOnCompletion 設定為 false。

OutputFile[]

執行命令行之後，Batch 服務會從計算節點上傳的檔案清單。
針對多重實例工作，檔案只會從執行主要工作的計算節點上傳。

integer

工作需要執行的排程位置數目。
預設值為 1。 如果節點有足夠的可用排程位置，工作只能排程在計算節點上執行。 對於多重實例工作，不支援此屬性，而且不得指定。

ResourceFile[]

Batch 服務在執行命令行之前，會先下載至計算節點的檔案清單。
此元素底下列出的檔案位於工作的工作目錄中。 資源檔案清單的大小上限。 超過大小上限時，要求將會失敗，而回應錯誤碼會是 RequestEntityTooLarge。 如果發生這種情況，ResourceFiles 的集合必須縮小大小。 這可以使用 .zip 檔案、應用程式套件或 Docker 容器來達成。

boolean

作業管理員工作是否需要獨佔使用其執行所在的計算節點。
如果為 true，只要作業管理員正在執行，其他工作就不會在相同的節點上執行。 如果為 false，其他工作可以在計算節點上與作業管理員同時執行。 作業管理員工作通常會根據計算節點的並行工作限制計算，因此只有在計算節點允許多個並行工作時才相關。 默認值為 true。

UserIdentity

作業管理員工作執行所在的使用者身分識別。
如果省略，工作會以工作唯一的非系統管理使用者身分執行。

boolean

當作業終止或刪除時，是否要將計算節點從虛擬網路提取至 DNC。
如果為 true，節點會維持加入虛擬網路至 DNC。 如果為 false，當作業結束時，節點會自動撤銷。 默認值為 false。

string

虛擬網路子網的 ARM 資源識別碼，從作業執行工作的計算節點將會在工作期間加入。
虛擬網路必須位於與 Azure Batch 帳戶相同的區域和訂用帳戶中。 指定的子網應該有足夠的可用IP位址，以容納將從作業執行工作的計算節點數目。 這最多可達集區中的計算節點數目。 'MicrosoftAzureBatch' 服務主體必須具有指定 VNet 的「傳統虛擬機參與者」Role-Based 訪問控制 （RBAC） 角色，Azure Batch 服務才能排程節點上的工作。 藉由檢查指定的 VNet 是否有任何相關聯的網路安全組 （NSG），即可驗證此情況。 如果 NSG 拒絕與指定子網中的節點通訊，Batch 服務會將計算節點的狀態設定為無法使用。 這是 /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}的格式。 如果指定的 VNet 有任何相關聯的網路安全組 （NSG），則必須啟用一些保留的系統埠，才能從 Azure Batch 服務進行輸入通訊。 針對使用虛擬機設定建立的集區，請啟用埠 29876 和 29877，以及適用於 Linux 的埠 22，以及適用於 Windows 的埠 3389。 埠 443 也需要開啟，才能對 Azure 記憶體進行通訊的輸出連線。 如需詳細資訊，請參閱：https://docs.microsoft.com/azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration

string

作業準備工作的命令行。
命令行不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。 如果您想要利用這些功能，您應該在命令行中叫用殼層，例如在 Windows 中使用 “cmd /c MyCommand”，或在 Linux 中使用 “/bin/sh -c MyCommand”。 如果命令行參考檔案路徑，它應該使用相對路徑（相對於Task工作目錄），或使用 Batch 提供的環境變數 （https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables）。

TaskConstraints

套用至作業準備工作的條件約束。

TaskContainerSettings

作業準備工作執行所在的容器設定。
指定此專案時，AZ_BATCH_NODE_ROOT_DIR下方的所有目錄都會遞歸地對應到容器中（節點上的 Azure Batch 目錄根目錄），所有工作環境變數都會對應到容器中，而工作命令行則會在容器中執行。 AZ_BATCH_NODE_ROOT_DIR外部容器中產生的檔案可能不會反映到主機磁碟，這表示 Batch 檔案 API 將無法存取這些檔案。

EnvironmentSetting[]

作業準備工作的環境變數設定清單。

string

字串，可唯一識別作業內的作業準備工作。
標識元可以包含英數位元的任何組合，包括連字元和底線，不能包含超過64個字元。 如果您未指定此屬性，Batch 服務會指派預設值 『jobpreparation』。 作業中的其他工作不能有與作業準備工作相同的標識碼。 如果您嘗試提交具有相同標識符的工作，Batch 服務會以錯誤碼 TaskIdSameAsJobPreparationTask 拒絕要求;如果您直接呼叫 REST API，HTTP 狀態代碼為 409 （衝突）。

boolean

Batch 服務是否應在計算節點重新啟動後重新執行作業準備工作。
如果重新製作計算節點的映像，或作業準備工作未完成，則作業準備工作一律會重新執行（例如，因為工作正在執行時發生重新啟動）。 因此，您應該一律撰寫作業準備工作，以具有等冪性，並在執行多次時正確運作。 默認值為 true。

ResourceFile[]

Batch 服務在執行命令行之前，會先下載至計算節點的檔案清單。
此元素底下列出的檔案位於工作的工作目錄中。 資源檔案清單的大小上限。 超過大小上限時，要求將會失敗，而回應錯誤碼會是 RequestEntityTooLarge。 如果發生這種情況，ResourceFiles 的集合必須縮小大小。 這可以使用 .zip 檔案、應用程式套件或 Docker 容器來達成。

UserIdentity

執行作業準備工作的使用者身分識別。
如果省略，工作會以 Windows 計算節點上工作唯一的非系統管理使用者身分執行，或是 Linux 計算節點上集區唯一的非系統管理使用者。

boolean

Batch 服務是否應該等候作業準備工作順利完成，再排程計算節點上作業的任何其他工作。 如果作業準備工作以結束代碼 0 結束，則作業準備工作已順利完成。
如果為 true，且作業準備工作在節點上失敗，Batch 服務會重試作業準備工作，最多重試計數上限（如條件約束元素中所指定）。 如果工作在所有重試之後仍未順利完成，Batch 服務將不會將作業的工作排程到節點。 節點會保持作用中，且有資格執行其他作業的工作。 如果為 false，Batch 服務將不會等候作業準備工作完成。 在此情況下，作業的其他工作可以在作業準備工作仍在執行時，開始在計算節點上執行;即使作業準備工作失敗，新的工作仍會繼續排程在計算節點上。 默認值為 true。

string

作業發行工作的命令行。
命令行不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。 如果您想要利用這些功能，您應該在命令行中叫用殼層，例如在 Windows 中使用 “cmd /c MyCommand”，或在 Linux 中使用 “/bin/sh -c MyCommand”。 如果命令行參考檔案路徑，它應該使用相對路徑（相對於Task工作目錄），或使用 Batch 提供的環境變數 （https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables）。

TaskContainerSettings

作業發行工作執行所在的容器設定。
指定此專案時，AZ_BATCH_NODE_ROOT_DIR下方的所有目錄都會遞歸地對應到容器中（節點上的 Azure Batch 目錄根目錄），所有工作環境變數都會對應到容器中，而工作命令行則會在容器中執行。 AZ_BATCH_NODE_ROOT_DIR外部容器中產生的檔案可能不會反映到主機磁碟，這表示 Batch 檔案 API 將無法存取這些檔案。

EnvironmentSetting[]

作業發行工作的環境變數設定清單。

string

字串，可唯一識別作業內的作業發行工作。
標識元可以包含英數位元的任何組合，包括連字元和底線，不能包含超過64個字元。 如果您未指定此屬性，Batch 服務會指派 『jobrelease』 的預設值。 作業中的其他工作不能有與作業發行工作相同的標識碼。 如果您嘗試提交具有相同標識符的工作，Batch 服務會以錯誤碼 TaskIdSameAsJobReleaseTask 拒絕要求;如果您直接呼叫 REST API，HTTP 狀態代碼為 409 （衝突）。

string

作業發行工作可以在指定的計算節點上執行的最大經過時間，從工作啟動時開始測量。 如果工作未在時間限制內完成，Batch 服務就會終止它。 預設值為15分鐘。 您可能不會指定逾時超過15分鐘。 如果您這樣做，Batch 服務會拒絕它並出現錯誤;如果您直接呼叫 REST API，則 HTTP 狀態代碼為 400 （不正確的要求）。

ResourceFile[]

Batch 服務在執行命令行之前，會先下載至計算節點的檔案清單。 資源檔案清單的大小上限。 超過大小上限時，要求將會失敗，而回應錯誤碼會是 RequestEntityTooLarge。 如果發生這種情況，ResourceFiles 的集合必須縮小大小。 這可以使用 .zip 檔案、應用程式套件或 Docker 容器來達成。
此元素底下列出的檔案位於工作的工作目錄中。

string

在計算節點上保留作業發行工作的工作目錄的最小時間。 在這段時間之後，Batch 服務可能會刪除Task目錄及其所有內容。
默認值為 7 天，也就是工作目錄將保留 7 天，除非移除計算節點或刪除作業。

UserIdentity

執行作業發行工作的使用者身分識別。
如果省略，工作會以工作唯一的非系統管理使用者身分執行。

ErrorCategory

作業排程錯誤的類別。

string

作業排程錯誤的識別碼。 程序代碼是不變的，而且是要以程序設計方式取用。

NameValuePair[]

與排程錯誤相關的其他錯誤詳細數據清單。

string

描述作業排程錯誤的訊息，適用於在使用者介面中顯示。

string

作業可供排程工作。

string

所有工作都已終止，系統將不會再接受任何工作或作業的任何進一步變更。

string

使用者已要求刪除作業，但刪除作業仍在進行中（例如，因為系統仍在終止執行工作）。

string

使用者已停用作業。 沒有執行任何工作，也不會排程任何新的工作。

string

使用者已要求停用作業，但停用作業仍在進行中（例如，等待工作終止）。

string

使用者已要求啟用作業，但啟用作業仍在進行中。

string

作業即將完成，可能是因為作業管理員工作已完成或因為使用者已終止作業，但終止作業仍在進行中（例如，因為作業釋放工作正在執行）。

string

作業中所有工作所耗用的核心模式 CPU 時間總計（加總到所有核心和所有計算節點）。

string

上次更新統計數據的時間。 所有統計數據都受限於 startTime 與 lastUpdateTime 之間的範圍。

integer

作業中在指定時間範圍內失敗的工作總數。
如果工作用盡最大重試計數而不傳回結束代碼 0，工作就會失敗。

integer

工作在指定時間範圍內成功完成的工作總數。
如果工作傳回結束代碼 0，工作就會順利完成。

integer

指定時間範圍內作業中所有工作的重試總數。

number

作業中所有工作從磁碟讀取 GiB 中的數據總量。

integer

作業中所有工作的磁碟讀取作業總數。

string

統計數據所涵蓋之時間範圍的開始時間。

string

統計數據的 URL。

string

作業中所有工作所耗用的使用者模式 CPU 時間總計（加總到所有核心和所有計算節點）。

string

作業中所有工作的等候時間總計。
Task 的等候時間定義為建立工作與工作執行開始之間的經過時間。 （如果工作因為失敗而重試，則等候時間是最新的工作執行時間。此值只會在帳戶存留期統計數據中報告;它不包含在作業統計數據中。

string

作業中所有工作的總時鐘時間。
時鐘時間是從工作開始在計算節點上執行到完成時所經過的時間（如果工作當時尚未完成，則為上次更新統計數據的時間）。 如果重試工作，這包括所有工作重試的時鐘時間。

number

由作業中所有工作寫入磁碟的 GiB 數據總量。

integer

作業中所有工作的磁碟寫入作業總數。

integer

用戶帳戶的群組標識碼。
uid 和 gid 屬性必須一起指定或完全不指定。 如果未指定，則基礎操作系統會挑選 gid。

string

用戶帳戶的 SSH 私鑰。
私鑰不得受到密碼保護。 當集區的 enableInterNodeCommunication 屬性為 true 時，私鑰用於在 Linux 集區中計算節點之間自動設定非對稱密鑰型驗證（如果 enableInterNodeCommunication 為 false，則會忽略它）。 其方式是將金鑰組放入使用者的 .ssh 目錄中。 如果未指定，則計算節點之間不會設定無密碼 SSH（不會修改使用者的 .ssh 目錄）。

integer

用戶帳戶的使用者標識碼。
uid 和 gid 屬性必須一起指定或完全不指定。 如果未指定基礎操作系統，則會挑選 uid。

string

LOGON32_LOGON_BATCH Win32 登入模式。 建議針對長時間執行的平行進程使用批次登入模式。

string

LOGON32_LOGON_INTERACTIVE Win32 登入模式。 UAC 會在 Windows 集區上啟用。 如果此選項與 Windows 集區中提升許可權的使用者身分識別搭配使用，除非 Task 命令行所執行的應用程式設定為一律需要系統管理許可權，否則使用者會話將不會提升。

VMDiskSecurityProfile

指定受控磁碟的安全性配置檔設定。
指定受控磁碟的安全性配置檔設定。 附注：它只能針對機密 VM 設定，而且在使用機密 VM 時是必要的。

StorageAccountType

受控磁碟的記憶體帳戶類型。

string

元數據項目的名稱。

string

元數據專案的值。

AzureBlobFileSystemConfiguration

在每個節點上使用 Blob FUSE 掛接的 Azure 記憶體容器。
這個屬性與其他所有屬性互斥。

AzureFileShareConfiguration

要掛接在每個節點上的 Azure 檔案共用。
這個屬性與其他所有屬性互斥。

CIFSMountConfiguration

要掛接在每個節點上的 CIFS/SMB 文件系統。
這個屬性與其他所有屬性互斥。

NFSMountConfiguration

要掛接在每個節點上的NFS文件系統。
這個屬性與其他所有屬性互斥。

string

name-value 配對中的名稱。

string

名稱/值組中的值。

DynamicVNetAssignmentScope

動態 vnet 指派的範圍。

boolean

此集區是否應該啟用加速網路。
加速網路可讓單一根 I/O 虛擬化（SR-IOV）連線到 VM，這可能會導致改善網路效能。 如需詳細資訊，請參閱：https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview。

PoolEndpointConfiguration

Batch 集區中計算節點上端點的組態。

PublicIPAddressConfiguration

Batch 集區中計算節點的公用IPAddress組態。
集區網路設定的公用IP位址組態。

string

將聯結集區計算節點之虛擬網路子網的 ARM 資源識別碼。 這是 /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}的格式。
虛擬網路必須位於與 Azure Batch 帳戶相同的區域和訂用帳戶中。 指定的子網應該有足夠的可用IP位址，以容納集區中的計算節點數目。 如果子網沒有足夠的可用IP位址，集區會部分配置節點，而且會發生重設大小錯誤。 'MicrosoftAzureBatch' 服務主體必須具有指定 VNet 的「傳統虛擬機參與者」Role-Based 訪問控制 （RBAC） 角色。 指定的子網必須允許來自 Azure Batch 服務的通訊，才能排程節點上的工作。 藉由檢查指定的 VNet 是否有任何相關聯的網路安全組 （NSG），即可驗證此情況。 如果 NSG 拒絕與指定子網中的節點通訊，Batch 服務會將計算節點的狀態設定為無法使用。 僅支援ARM虛擬網路 （'Microsoft.Network/virtualNetworks'）。 如果指定的 VNet 具有任何相關聯的網路安全組 （NSG），則必須啟用一些保留的系統埠以進行輸入通訊，包括埠 29876 和 29877。 同時在埠 443 上啟用對 Azure 記憶體的輸出連線。 如需詳細資訊，請參閱：https://docs.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration

NetworkSecurityGroupRuleAccess

應該針對指定的IP位址、子網範圍或卷標採取的動作。

integer

此規則的優先順序。
集區內的優先順序必須是唯一的，且會依優先順序進行評估。 數位越低，優先順序越高。 例如，可以使用訂單號碼 150、250 和 350 來指定規則。 順序編號為 150 的規則優先於順序為 250 的規則。 允許的優先順序為 150 到 4096。 如果提供任何保留或重複的值，要求就會失敗，且 HTTP 狀態代碼為 400。

string

要符合規則的來源位址前置詞或標籤。
有效值為單一IP位址（例如10.10.10.10.10）、IP子網（例如192.168.1.0/24）、預設標記或 * （適用於所有位址）。 如果提供任何其他值，要求就會因為 HTTP 狀態代碼 400 而失敗。

string[]

要與規則相符的來源埠範圍。
有效值為 『』（針對所有埠 0 - 65535）、特定埠（即 22），或埠範圍（即 100-200）。埠的範圍必須是 0 到 65535。此集合中的每個專案不得重疊任何其他專案（範圍或個別埠）。如果提供任何其他值，要求就會因為 HTTP 狀態代碼 400 而失敗。預設值為 ''。

string

允許存取。

string

拒絕存取。

string

要傳遞至掛接命令的其他命令行選項。
這些是 Windows 中的「net use」選項，Linux 中的「掛接」選項。

string

要掛接檔系統之計算節點上的相對路徑
所有文件系統都會掛接至 Batch 掛接目錄，可透過 AZ_BATCH_NODE_MOUNTS_DIR 環境變數存取。

string

要掛接之文件系統的 URI。

string

使用傳統通訊模式的節點需要來自 「BatchNodeManagement」 埠 29876 和 29877 上的輸入 TCP 通訊。{region}“ 服務卷標和埠 443 上的輸出 TCP 通訊至 ”Storage.region“ 和 ”BatchNodeManagement“。{region}“ 服務標籤。

string

節點通訊模式會自動由 Batch 服務設定。

string

使用簡化通訊模式的節點需要埠 443 上的輸出 TCP 通訊至 “BatchNodeManagement”。{region}“ 服務標籤。 不需要開啟的輸入埠。

NodePlacementPolicyType

Batch 集區上的節點放置原則類型。
Batch 服務用來布建節點的配置原則。 如果未指定，Batch 會使用區域原則。

string

集區中的所有節點都會配置在同一個區域中。

string

集區中的節點將會分散到不同的可用性區域，並盡最大努力平衡。

string

不執行任何動作。 除非以其他方式終止或停用作業，否則作業會維持使用中狀態。

string

終止作業。 作業的 terminateReason 設定為 'AllTasksComplete'。

string

不執行任何動作。 除非以其他方式終止或停用作業，否則作業會維持使用中狀態。

string

在 Task 的 exitConditions 集合中，採取與 Task 結束條件相關聯的動作。 （如果這是 Task 所指定的，這仍然可能會導致不採取任何動作。

CachingType

指定快取需求。 可能的值為：None、ReadOnly、ReadWrite。 預設值為：標準記憶體的 [無]。 進階記憶體的 ReadOnly。
快取的預設值為 none。 如需快取選項的相關信息，請參閱：https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/。

integer

建立新的 OS 磁碟時，以 GB 為單位的初始磁碟大小。

DiffDiskSettings

指定計算節點 （VM） 所使用作業系統磁碟的暫時磁碟設定。

ManagedDisk

受控磁碟參數。

boolean

指定是否應該在磁碟上啟用或停用 writeAccelerator。

OutputFileDestination

輸出檔的目的地。

string

表示要上傳之檔案的模式。
支援相對路徑和絕對路徑。 相對路徑相對於工作工作目錄。 支援下列通配符：* 比對 0 或多個字元（例如 pattern abc* 會比對 abc 或 abcdef），** 符合任何目錄？ 會比對任何單一字元，[abc] 會比對方括弧中的一個字元，而 [a-c] 會比對範圍中的一個字元。 括弧可以包含否定，以符合未指定的任何字元（例如 [！abc] 符合任何字元，但 a、b 或 c）。 如果檔名以 「.」 開頭，則預設會忽略它，但可能藉由明確指定它來比對它（例如，.gif 不符合 .a.gif，但 會.gif 。 簡單範例：***.txt 符合任何未以 『.』 開頭的檔案，並以 Task 工作目錄或任何子目錄中的 .txt 結尾。 如果檔名包含通配符，則可以使用方括弧逸出它（例如 abc[] 會比對名為 abc的檔案）。 請注意， \ 和 / 都會被視為 Windows 上的目錄分隔符，但只有 / 在 Linux 上。 環境變數 （在 Windows 上%var% 或 Linux 上的$var）會在套用模式之前展開。

OutputFileUploadOptions

上傳作業的其他選項，包括執行上傳的條件。

string

要上傳檔案之 Azure Blob 記憶體內的容器 URL。
如果未使用受控識別，URL 必須包含將寫入許可權授與容器的共用存取簽章（SAS）。

ComputeNodeIdentityReference

使用者指派身分識別的參考，用來存取 containerUrl 所指定的 Azure Blob 記憶體
身分識別必須具有 Azure Blob 記憶體容器的寫入許可權

string

Azure 記憶體容器內的目的地 Blob 或虛擬目錄。
如果 filePattern 參考特定檔案（亦即不包含通配符），則 path 是上傳該檔案的 Blob 名稱。 如果 filePattern 包含一或多個通配符（因此可能符合多個檔案），則 path 是 Blob 虛擬目錄的名稱（前面加上每個 Blob 名稱），以上傳檔案。。 如果省略，檔案會上傳至容器的根目錄，且 Blob 名稱符合其檔名。

HttpHeader[]

要用於上傳輸出檔案的標頭名稱/值組清單
將檔案上傳至 Azure 記憶體時，將會指定這些標頭。 上傳 Blob 時允許標頭的官方檔：https://docs.microsoft.com/rest/api/storageservices/put-blob#request-headers-all-blob-types

OutputFileBlobContainerDestination

Azure Blob 記憶體中上傳檔案的位置。

string

在工作進程結束之後上傳檔案，不論結束代碼為何。

string

只有在工作進程結束且具有非零結束代碼之後，才上傳檔案。

string

只有在工作進程結束且結束代碼為 0 之後，才上傳檔案。

OutputFileUploadCondition

工作輸出檔案或檔案集應上傳的條件。
預設值為 taskcompletion。

InboundNATPool[]

輸入 NAT 集區清單，可用來在外部處理個別計算節點上的特定埠。
每個批次集區的輸入NAT集區數目上限為5。 如果超過輸入 NAT 集區的最大數目，要求會失敗，並出現 HTTP 狀態代碼 400。 如果 IPAddressProvisioningType 為 NoPublicIPAddresses，則無法指定此專案。

AutoPoolSpecification

暫存「自動集區」的特性。 Batch 服務會在提交作業時建立此自動集區。
如果自動建立集區失敗，Batch 服務會將作業移至已完成狀態，而集區建立錯誤是在作業的排程錯誤屬性中設定。 Batch 服務會管理自動集區的存留期（建立和，除非指定keepAlive，否則刪除）。 當作業作用中時，影響自動集區存留期的任何用戶動作，都會導致非預期的行為。 您必須指定集區標識碼或自動集區規格，但不能同時指定這兩者。

string

現有集區的標識碼。 作業的所有工作都會在指定的集區上執行。
您必須確定這個屬性所參考的集區存在。 如果 Batch 服務嘗試排程作業時不存在集區，則在您建立具有該標識碼的集區之前，不會執行作業的工作。請注意，Batch 服務不會拒絕作業要求;在集區存在之前，它只會執行工作。 您必須指定集區標識碼或自動集區規格，但不能同時指定這兩者。

string

集區存在其專用作業的存留期。 Batch 服務會在建立作業時建立集區。 如果 'job' 選項套用至作業排程，Batch 服務會針對排程上建立的每個作業建立新的自動集區。

string

集區存在於作業排程的存留期。 Batch 服務會在排程上建立第一個作業時建立集區。 您只能將此選項套用至作業排程，而不是套用至作業。

ApplicationPackageReference[]

要安裝在集區中每個計算節點上的套件清單。
建立集區時，套件的應用程式標識碼必須完整 （/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}）。 封裝參考的變更會影響聯結集區的所有新節點，但不會影響已在集區中的計算節點，直到重新啟動或重新映射為止。 任何指定的集區上最多有10個套件參考。

string

根據自動調整公式自動調整集區大小的時間間隔。
預設值為15分鐘。 最小值和最大值分別為 5 分鐘和 168 小時。 如果您指定的值小於 5 分鐘或大於 168 小時，Batch 服務會拒絕要求，且屬性值錯誤無效;如果您直接呼叫 REST API，則 HTTP 狀態代碼為 400 （不正確的要求）。

string

集區中所需計算節點數目的公式。
如果 enableAutoScale 設定為 false，則不得指定此屬性。 如果 enableAutoScale 設定為 true，則為必要專案。 在建立集區之前，會先檢查公式是否有效。 如果公式無效，Batch 服務會以詳細的錯誤資訊拒絕要求。

CertificateReference[]

要安裝在集區中每個計算節點上的憑證清單。
針對 Windows 節點，Batch 服務會將憑證安裝至指定的證書存儲和位置。 針對 Linux 計算節點，憑證會儲存在工作工作目錄內的目錄中，而環境變數AZ_BATCH_CERTIFICATES_DIR會提供給工作來查詢此位置。 對於可見度為 『remoteUser』 的憑證，會在使用者的主目錄中建立 『certs』 目錄（例如 /home/{user-name}/certs）和憑證放在該目錄中。

警告：這個屬性已被取代，將在 2024 年 2 月之後移除。 請改用 Azure KeyVault 擴充功能。

string

集區的顯示名稱。
顯示名稱不是唯一的，而且可以包含最大長度為 1024 的任何 Unicode 字元。

boolean

集區大小是否應該隨著時間自動調整。
如果為 false，則必須指定至少一個 targetDedicatedNodes 和 targetLowPriorityNodes。 如果為 true，則需要 autoScaleFormula 元素。 集區會根據公式自動重設大小。 默認值為 false。

boolean

集區是否允許計算節點之間的直接通訊。
啟用節點間通訊會限制集區的大小上限，因為集區的計算節點有部署限制。 這可能會導致集區無法達到其所需的大小。 默認值為 false。

MetadataItem[]

與集區相關聯的名稱/值組清單做為元數據。
Batch 服務不會將任何意義指派給元數據;它僅供使用者程式代碼使用。

MountConfiguration[]

要掛接在集區中每個節點上的檔案系統清單。
這支援 Azure 檔案服務、NFS、CIFS/SMB 和 Blobfuse。

NetworkConfiguration

集區的網路組態。
集區的網路組態。

string

將計算節點配置至集區的逾時。
此逾時僅適用於手動調整;當 enableAutoScale 設定為 true 時，它沒有任何作用。 預設值為15分鐘。 最小值為 5 分鐘。 如果您指定小於 5 分鐘的值，Batch 服務會拒絕要求併發生錯誤;如果您直接呼叫 REST API，則 HTTP 狀態代碼為 400 （不正確的要求）。

object

與集區相關聯的使用者指定標記。
要與 Azure Batch 集區相關聯的使用者定義標籤。 指定時，這些標籤會傳播至與集區相關聯的備份 Azure 資源。 只有在使用 poolAllocationMode 屬性設定為 'UserSubscription' 建立 Batch 帳戶時，才能指定這個屬性。

StartTask

在聯結集區時，要在每個計算節點上執行的工作。 當計算節點新增至集區或計算節點重新啟動時，工作就會執行。
批次會在節點上觸發復原作業時重試工作。 復原作業的範例包括當狀況不良的節點重新啟動或計算節點因主機失敗而消失時，包括 （但不限於） 。 由於復原作業的重試與 無關，而且不會計入 maxTaskRetryCount。 即使 maxTaskRetryCount 是 0，由於復原作業，可能會發生內部重試。 因此，所有工作都應該是等冪的。 這表示工作必須容許中斷並重新啟動，而不會造成任何損毀或重複的數據。 長時間執行工作的最佳做法是使用某種形式的檢查點。 在某些情況下，即使計算節點未重新啟動，StartTask 仍可能會重新執行。 請特別小心，以避免 StartTasks 從 StartTask 工作目錄建立中斷程式或安裝/啟動服務，因為這樣會阻止 Batch 重新執行 StartTask。

integer

集區中所需的專用計算節點數目。
如果 enableAutoScale 設定為 true，則不得指定此屬性。 如果 enableAutoScale 設定為 false，則您必須設定 targetDedicatedNodes、targetLowPriorityNodes 或兩者。

integer

集區中所需的現成/低優先順序計算節點數目。
如果 enableAutoScale 設定為 true，則不得指定此屬性。 如果 enableAutoScale 設定為 false，則您必須設定 targetDedicatedNodes、targetLowPriorityNodes 或兩者。

NodeCommunicationMode

集區所需的節點通訊模式。
如果省略，預設值為 Default。

TaskSchedulingPolicy

工作如何分散到集區中的計算節點。
如果未指定，則會散佈預設值。

integer

可用來在集區中單一計算節點上執行並行工作的工作位置數目。
預設值為 1。 最大值是集區 vmSize 或 256 核心數目的 4 倍小。

UpgradePolicy

集區的升級原則。
描述升級原則 - 自動、手動或滾動。

UserAccount[]

要建立於集區中每個計算節點上的用戶帳戶清單。

VirtualMachineConfiguration

集區的虛擬機組態。
必須指定這個屬性。

string

集區中虛擬機的大小。 集區中的所有虛擬機大小都相同。
如需集區中虛擬機可用大小的相關信息，請參閱在 Azure Batch 集區中為計算節點選擇 VM 大小（https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes）。

string[]

布建計算節點時，Batch 服務將使用的公用IP清單。
此處指定的IP數目會限制集區大小上限 - 100個專用節點或100個現成/低優先順序節點，可以為每個公用IP配置。 例如，需要 250 個專用 VM 的集區至少需要 3 個公用 IP。 此集合的每個元素都是下列形式：/subscriptions/{subscription}/resourceGroups/{group}/providers/Microsoft.Network/publicIPAddresses/{ip}。

IPAddressProvisioningType

集區公用IP位址的布建類型。
預設值為 BatchManaged。

string

自動記憶體帳戶中的記憶體容器名稱。
autoStorageContainerName、storageContainerUrl 和 httpUrl 屬性互斥，其中一個必須指定。

string

從 Azure 記憶體容器下載 Blob 時要使用的 Blob 前置詞。 只會下載名稱開頭為指定前置詞的 Blob。
只有在使用 autoStorageContainerName 或 storageContainerUrl 時，屬性才有效。 此前置詞可以是部分檔名或子目錄。 如果未指定前置詞，則會下載容器中的所有檔案。

string

以八進位格式的檔案許可權模式屬性。
此屬性僅適用於下載至 Linux 計算節點的檔案。 如果針對將下載至 Windows 計算節點的 resourceFile 指定，則會忽略它。 如果未為 Linux 計算節點指定這個屬性，則會將預設值 0770 套用至檔案。

string

要下載檔案的計算節點位置，相對於工作的工作目錄。
如果指定 HTTPUrl 屬性，則需要 filePath，並描述將下載檔案的路徑，包括檔名。 否則，如果指定 autoStorageContainerName 或 storageContainerUrl 屬性，則 filePath 是選擇性的，而且是要下載檔案的目錄。 在 filePath 當做目錄使用的情況下，任何已經與輸入數據相關聯的目錄結構都會完整保留，並附加至指定的 filePath 目錄。 指定的相對路徑無法脫離 Task 的工作目錄（例如，使用 '..'）。

string

要下載之檔案的 URL。
autoStorageContainerName、storageContainerUrl 和 httpUrl 屬性互斥，其中一個必須指定。 如果 URL 指向 Azure Blob 記憶體，則必須從計算節點讀取它。 在 Azure 記憶體中取得 Blob 的這類 URL 有三種方式：包括授與 Blob 讀取許可權的共用存取簽章（SAS），使用具有讀取許可權的受控識別，或設定 Blob 或其容器的 ACL 以允許公用存取。

ComputeNodeIdentityReference

使用者指派身分識別的參考，用來存取 storageContainerUrl 或 HTTPUrl 所指定的 Azure Blob 記憶體
與計算節點將使用的 Batch 集區相關聯的使用者指派身分識別參考。

string

Azure Blob 記憶體中 Blob 容器的 URL。
autoStorageContainerName、storageContainerUrl 和 httpUrl 屬性互斥，其中一個必須指定。 此 URL 必須可從計算節點讀取和列出。 有三種方式可以取得 Azure 記憶體中容器的這類 URL：包括授與容器讀取和清單許可權的共用存取簽章（SAS），使用具有讀取和清單許可權的受控識別，或為容器設定 ACL 以允許公用存取。

boolean

允許 VMSS 在建構升級批次時忽略 AZ 界限。 將 Update 網域和 maxBatchInstancePercent 納入考慮，以判斷批次大小。 只有當使用 NodePlacementConfiguration 作為 Zonal 時，此欄位才能設定為 true 或 false。

integer

一個批次中滾動升級同時升級的虛擬機實例總數上限百分比。 由於這是最大值，先前或未來批次中狀況不良的實例可能會導致批次中的實例百分比降低，以確保更高的可靠性。 此欄位的值應介於 5 到 100 之間，包含。 如果 maxBatchInstancePercent 和 maxUnhealthyInstancePercent 都指派值，maxBatchInstancePercent 的值不應該超過 maxUnhealthyInstancePercent。

integer

擴展集中可同時狀況不良的虛擬機實例總數百分比上限，可能是因為升級而造成狀況不良，或在滾動升級中止之前，在虛擬機健康情況檢查中發現狀況不良狀態。 啟動任何批次之前，會先檢查此條件約束。 此欄位的值應介於 5 到 100 之間，包含。 如果 maxBatchInstancePercent 和 maxUnhealthyInstancePercent 都指派值，maxBatchInstancePercent 的值不應該超過 maxUnhealthyInstancePercent。

integer

可發現處於狀況不良狀態的已升級虛擬機實例百分比上限。 升級每個批次之後，就會進行這項檢查。 如果超過這個百分比，滾動更新就會中止。 此欄位的值應介於 0 到 100 之間，並包含。

string

完成一個批次中所有虛擬機的更新，以及開始下一個批次之間的等候時間。 持續時間應以 ISO 8601 格式指定。

boolean

在任何狀況良好的實例之前，升級擴展集中所有狀況不良的實例。

boolean

如果違反滾動升級原則，回復實例至先前的模型。

string

string

boolean

用戶可以在要求中使用這個屬性來啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密，包括主機本身的資源/暫存磁碟。 如需主機需求加密的詳細資訊，請參閱 https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizes。

SecurityTypes

指定虛擬機的 SecurityType。 它必須設定為任何指定的值，才能啟用 UefiSettings。

UefiSettings

指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。
指定建立虛擬機時所使用的安全開機和 vTPM 等安全性設定。

string

Azure 機密運算提供機密 VM 適用於具有高安全性和機密性需求的租使用者。 這些 VM 提供強式硬體強制執行的界限，以協助符合您的安全性需求。 您可以使用機密 VM 進行移轉，而不需要變更程式代碼，而平臺可保護 VM 的狀態不受讀取或修改。

string

受信任的啟動可防範進階和持續性的攻擊技術。

string

ServiceArtifactReference 的服務成品參考標識符
服務成品參考標識符的格式為 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

string

StartTask 的命令行。
命令行不會在殼層下執行，因此無法利用殼層功能，例如環境變數擴充。 如果您想要利用這些功能，您應該在命令行中叫用殼層，例如在 Windows 中使用 “cmd /c MyCommand”，或在 Linux 中使用 “/bin/sh -c MyCommand”。 如果命令行參考檔案路徑，它應該使用相對路徑（相對於Task工作目錄），或使用 Batch 提供的環境變數 （https://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables）。

TaskContainerSettings

StartTask 執行所在的容器設定。
指定此專案時，AZ_BATCH_NODE_ROOT_DIR下方的所有目錄都會遞歸地對應到容器中（節點上的 Azure Batch 目錄根目錄），所有工作環境變數都會對應到容器中，而工作命令行則會在容器中執行。 AZ_BATCH_NODE_ROOT_DIR外部容器中產生的檔案可能不會反映到主機磁碟，這表示 Batch 檔案 API 將無法存取這些檔案。

EnvironmentSetting[]

StartTask 的環境變數設定清單。

integer

重試工作的最大次數。
如果 Batch 服務結束代碼為非零，則會重試工作。 請注意，這個值會特別控制重試次數。 Batch 服務會嘗試工作一次，然後可能會重試到此限制。 例如，如果重試計數上限為 3，Batch 會嘗試工作最多 4 次（一次初始嘗試，3 次重試）。 如果重試計數上限為0，Batch服務就不會重試工作。 如果重試計數上限為 -1，Batch 服務會不限制地重試工作，但不建議用於啟動工作或任何工作。 預設值為 0（沒有重試）。

ResourceFile[]

Batch 服務在執行命令行之前，會先下載至計算節點的檔案清單。 資源檔案清單的大小上限。 超過大小上限時，要求將會失敗，而回應錯誤碼會是 RequestEntityTooLarge。 如果發生這種情況，ResourceFiles 的集合必須縮小大小。 這可以使用 .zip 檔案、應用程式套件或 Docker 容器來達成。
此元素底下列出的檔案位於工作的工作目錄中。

UserIdentity

StartTask 執行的使用者身分識別。
如果省略，工作會以工作唯一的非系統管理使用者身分執行。

boolean

在排程計算節點上的任何工作之前，Batch 服務是否應該等候 StartTask 順利完成（也就是結束代碼 0）。
如果 True 且 StartTask 在節點上失敗，Batch 服務會重試 StartTask，最多重試計數上限 （maxTaskRetryCount）。 如果工作在所有重試之後仍未順利完成，則 Batch 服務會將節點標示為無法使用，且不會排程工作。 您可以透過計算節點狀態和失敗資訊詳細資料來偵測此狀況。 如果為 false，Batch 服務將不會等候 StartTask 完成。 在此情況下，當 StartTask 仍在執行時，其他工作可以在計算節點上開始執行;即使 StartTask 失敗，新的工作仍會繼續排程在計算節點上。 默認值為 true。

string

數據磁碟/OS 磁碟應使用進階本地備援記憶體。

string

數據磁碟/OS 磁碟應使用標準本地備援記憶體。

string

數據磁碟/OS 磁碟應使用標準 SSD 本地備援記憶體。

integer

重試工作的最大次數。 如果 Batch 服務結束代碼為非零，則會重試工作。
請注意，這個值會特別控制工作可執行檔的重試次數，因為非零結束代碼。 Batch 服務會嘗試工作一次，然後可能會重試到此限制。 例如，如果重試計數上限為 3，Batch 會嘗試工作最多 4 次（一次初始嘗試，3 次重試）。 如果重試計數上限為0，Batch服務就不會在第一次嘗試之後重試工作。 如果重試計數上限為 -1，Batch 服務會不限制地重試工作，但不建議用於啟動工作或任何工作。 預設值為 0（沒有重試）。

string

工作可能執行的最大經過時間，從工作開始的時間測量。 如果工作未在時間限制內完成，Batch 服務就會終止它。
如果未指定此專案，則工作執行的時間長度沒有限制。

string

從執行完成時起，在計算節點上保留工作目錄的時間下限。 在這段時間之後，Batch 服務可能會刪除Task目錄及其所有內容。
默認值為 7 天，也就是工作目錄將保留 7 天，除非移除計算節點或刪除作業。

ContainerHostBatchBindMountEntry[]

您要掛接至容器工作的路徑。
如果此陣列為 Null 或不存在，容器工作將會在 Windows 中掛接整個暫存磁碟驅動器（或 Linux 中的AZ_BATCH_NODE_ROOT_DIR）。 如果此陣列設定為空白，它就不會將任何數據路徑掛接至容器。

string

容器 create 命令的其他選項。
除了 Batch 服務所控制的自變數之外，這些額外的選項也會提供為 「docker create」 命令的自變數。

string

用來建立要在其中執行工作之容器的映像。
這是完整的映像參考，如同指定為 “docker pull”。 如果未提供任何標記做為 Image 名稱的一部分，則會使用標記 「：latest」 做為預設值。

ContainerRegistry

包含容器映像的私人登錄。
如果已在建立集區時提供，則可以省略此設定。

ContainerWorkingDirectory

容器工作工作目錄的位置。
默認值為 『taskWorkingDirectory』。

ComputeNodeFillType

工作如何分散到集區中的計算節點。
如果未指定，則會散佈預設值。

boolean

指定是否應在虛擬機上啟用安全開機。

boolean

指定是否應在虛擬機上啟用 vTPM。

string

擴展集中的所有虛擬機都會同時自動更新。

string

您可以控制擴展集中虛擬機更新的應用程式。 您可以使用 manualUpgrade 動作來執行此動作。

string

擴展集中的現有實例會在要升級的批次中關閉。 升級的批次完成後，實例會再次開始取得流量，下一個批次將會開始。 這會繼續執行，直到所有實例都 up-to-date 為止。

AutomaticOSUpgradePolicy

用於執行自動OS升級的組態參數。
用於執行自動OS升級的組態參數。

UpgradeMode

指定升級至擴展集中虛擬機的模式。

可能的值為：

手動 - 您可以控制擴充集中虛擬機的更新應用程式。 您可以使用 manualUpgrade 動作來執行此動作。

自動 - 擴展集中的所有虛擬機都會同時自動更新。

滾動 - 擴展集會在兩者之間執行選擇性暫停時間的批次更新。

RollingUpgradePolicy

執行滾動升級時所使用的組態參數。
執行滾動升級時所使用的組態參數。

ElevationLevel

用戶帳戶的提高許可權層級。
預設值為 nonAdmin。

LinuxUserConfiguration

用戶帳戶的 Linux 特定用戶設定。
如果在 Windows 集區上指定，則會忽略這個屬性。 如果未指定，則會使用預設選項建立使用者。

string

用戶帳戶的名稱。 名稱可以包含最多 20 個字元的任何 Unicode 字元。

string

用戶帳戶的密碼。

WindowsUserConfiguration

用戶帳戶的 Windows 特定用戶設定。
只有在用戶位於 Windows 集區時，才能指定這個屬性。 如果未指定且在 Windows 集區上，則會使用預設選項建立使用者。

AutoUserSpecification

工作執行所在的自動使用者。
userName 和 autoUser 屬性互斥;您必須指定一個，但不能同時指定兩者。

string

執行工作的使用者身分識別名稱。
userName 和 autoUser 屬性互斥;您必須指定一個，但不能同時指定兩者。

ContainerConfiguration

集區的容器組態。
如果指定，會在集區中的每個計算節點上執行安裝程式，以允許工作在容器中執行。 此集區上執行的所有一般工作和作業管理員工作都必須指定 containerSettings 屬性，而所有其他工作都可以指定它。

DataDisk[]

連結至集區中計算節點的數據磁碟設定。
如果集區中的計算節點必須連結空的數據磁碟，則必須指定這個屬性。 這無法更新。 每個計算節點都會取得自己的磁碟（磁碟不是檔案共用）。 無法連結現有的磁碟，每個連結的磁碟都是空的。 從集區移除計算節點時，也會刪除與該節點相關聯的磁碟和所有數據。 磁碟在連接之後不會格式化，因此必須先格式化，才能使用 - 如需詳細資訊，請參閱 https://docs.microsoft.com/azure/virtual-machines/linux/classic/attach-disk#initialize-a-new-data-disk-in-linux 和 https://docs.microsoft.com/azure/virtual-machines/windows/attach-disk-ps#add-an-empty-data-disk-to-a-virtual-machine。

DiskEncryptionConfiguration

集區的磁碟加密組態。
如果指定，則會在節點布建期間，在集區中的每個節點上執行加密。

VMExtension[]

集區的虛擬機擴充功能。
如果指定，此組態中提及的擴充功能將會安裝在每個節點上。

ImageReference

Azure 虛擬機 Marketplace 映像或要使用的自定義虛擬機映像參考。

string

部署作業系統時要使用的內部部署授權類型。
這隻適用於包含 Windows 作業系統的映像，而且只有在您持有將部署之計算節點的有效內部部署授權時，才應該使用。 如果省略，則不會套用任何內部部署授權折扣。 值為：

Windows_Server - 內部部署授權適用於 Windows Server。 Windows_Client - 內部部署授權適用於 Windows 用戶端。

string

要布建在集區中計算節點上的 Batch 計算節點代理程式的 SKU。
Batch Compute Node 代理程式是在集區中的每個計算節點上執行的程式，並提供計算節點與 Batch 服務之間的命令與控制介面。 針對不同的操作系統，計算節點代理程式有不同的實作，稱為 SKU。 您必須指定符合選取的映像參考的計算節點代理程式 SKU。 若要取得支援的計算節點代理程式 SKU 清單及其已驗證的映像參考清單，請參閱「列出支援的計算節點代理程式 SKU」作業。

NodePlacementConfiguration

集區的節點放置組態。
此設定會指定集區中節點實際配置方式的規則。

OSDisk

虛擬機操作系統磁碟的設定。

SecurityProfile

指定虛擬機或虛擬機擴展集的安全性配置檔設定。
指定虛擬機或虛擬機擴展集的安全性配置檔設定。

ServiceArtifactReference

指定使用 'latest' 映射版本時，用來為擴展集中所有虛擬機設定相同映像版本的服務成品參考標識符。
服務成品參考標識符的格式為 /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/gallerys/{galleryName}/serviceArtifacts/{serviceArtifactName}/vmArtifactsProfiles/{vmArtifactsProfilesName}

WindowsConfiguration

虛擬機上的 Windows 作業系統設定。
如果 imageReference 屬性指定 Linux OS 映射，則不得指定這個屬性。

SecurityEncryptionTypes

指定受控磁碟的 EncryptionType。 它設定為 VMGuestStateOnly，以便只加密 VMGuestState Blob，而 NonPersistedTPM 則不會保存 VMGuestState Blob 中的韌體狀態。 附注：它只能設定為機密 VM，而且在使用機密 VM 時為必要專案。

boolean

指出如果部署期間有新的次要版本，擴充功能是否應該使用較新的次要版本。 不過，部署之後，除非重新部署，否則擴充功能不會升級次要版本，即使此屬性設定為 true 也一定會升級。

boolean

指出如果有較新版本的延伸模組可用，平臺是否應該自動升級延伸模組。

string

虛擬機擴充功能的名稱。

object

延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault 或完全沒有受保護的設定。

string[]

延伸模組名稱的集合。
必須布建此延伸模組之後的延伸模組名稱集合。

string

擴充處理程序發行者的名稱。

object

擴充功能的 JSON 格式化公用設定。

string

延伸模組的類型。

string

腳本處理程式的版本。

boolean

虛擬機上是否啟用自動更新。
如果省略，預設值為 true。

LoginMode

使用者的登入模式
預設值為 『batch』。