Batch Service REST API のバージョン管理
Batch Service REST API によって提供される操作には、時間の経過に伴う API の変化に対応する下位互換性のため、複数のバージョンが存在する場合があります。 REST 呼び出しでバージョンを指定して呼び出す場合は、使用する操作のバージョンを指定する必要があります。 使用しているアプリケーションが旧バージョンの操作を呼び出す場合、旧バージョンの呼び出しをそのまま使用することも、コードを変更して新しいバージョンを呼び出すこともできます。 バージョンが指定されていない場合、または正しくないバージョンが指定されている場合は、エラーが返されます。
使用する操作のバージョンを指定するには、 api-version クエリ パラメーターを設定します。 バージョンは Group.Major.Minor の形式です。ここで、Group は YYYY-MM-DD の形式で、Major と Minor は整数です。
最新バージョン: 2023-05-01.17.0
- [破壊的]バッチ ジョブ/プールの有効期間統計 API と
lifetimejobstats
lifetimepoolstats
が削除されました。 - ブール型プロパティ
enableAcceleratedNetworking
を にNetworkConfiguration
追加しました。- このプロパティは、このプールで高速ネットワークを有効にする必要があるかどうかを決定します。既定値は False です。
- この機能を有効にできるかどうかは、オペレーティング システム/VM インスタンスがサポートされているかどうかにも関連しています。これは、AcceleratedNetworking ポリシーに合わせて調整する必要があります。
- ブール型プロパティ
enableAutomaticUpgrade
を にVMExtension
追加しました。- このプロパティは、使用可能な拡張機能の新しいバージョンがある場合に、プラットフォームによって拡張機能を自動的にアップグレードするかどうかを決定します。
- の プロパティ
type
ContainerConfiguration
。 と の 2 つの値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
- プールが Batch サービスと通信する方法を決定する新しい
NodeCommunicationMode
プロパティを追加しました - プール通信モードの現在の
NodeCommunicationMode
状態をCloudPool
参照する型の新しいcurrentNodeCommunicationMode
プロパティをモデルに追加しました。 - プールの
NodeCommunicationMode
目的のノード通信モードを参照するために、次のモデルに型の新しいtargetNodeCommunicationMode
プロパティを追加しました。
バージョン: 2022-01-01.15.0
- ユーザーがリソース ファイルのアップロード時
OutputFileBlobContainerDestination
にカスタム HTTP ヘッダーを設定できるように、モデルに新しいuploadHeaders
プロパティを追加しました。 - 優先度の高いタスクのタスクプリエンプションをサポートするために、次のモデルに新しい
allowTaskPreemption
プロパティを追加しました (Comms-Enabledまたはシングル テナント プールが必要)。
バージョン: 2021-06-01.14.0
- ユーザー割り当てマネージド ID を に割り当てる機能を
CloudPool
追加します。 これらの ID は、プール内の各ノードで使用できるようになり、さまざまなリソースにアクセスするために使用できます。 - マネージド ID を介したリソースへのアクセスをサポートするために、次のモデルに プロパティを追加しました
identityReference
。 - ノードの仮想マシン拡張機能を指定するために、VirtualMachineConfiguration に
CloudPool
新しいextensions
プロパティを追加しました -
VirtualMachineConfiguration の新しいプロパティ
nodePlacementConfiguration
を使用して可用性ゾーンを指定する機能を追加しました - 仮想マシンのオペレーティング システム ディスクの設定を含む VirtualMachineConfiguration に新しい
osDisk
プロパティを追加しました。- の
DiffDiskSettings
プロパティはplacement
、プール内のすべての VM のオペレーティング システム ディスクのエフェメラル ディスクの配置を指定します。 "CacheDisk" に設定すると、エフェメラル OS ディスクが VM キャッシュに格納されます。
- の
- に プロパティ
CloudJob
を追加maxParallelTasks
して、ジョブごとに同時に実行できるタスクの最大数を制御しました (既定値は -1 は無制限です)。 このプロパティは現在、プライベート プレビュー段階です。 - VM が
ComputeNode
使用しているマーケットプレース イメージの正確なバージョンなど、仮想マシンの現在の状態に関する情報を含む プロパティが追加されましたvirtualMachineInfo
。 - ジョブ スケジュールの
Schedule
下で連続する 2 つのジョブの開始時刻の間隔を制御する プロパティを に追加しましたrecurrenceInterval
。
バージョン: 2020-09-01.12.0
- [破壊的]プールの プロパティ
maxTasksPerNode
をtaskSlotsPerNode
に置き換えます。 ジョブでこのプロパティ タスクを使用すると、動的な数のスロットを使用して、リソースの消費量をよりきめ細かく制御できます。 - [破壊的]の応答の種類
GetTaskCounts
が を返TaskCountsResult
すように変更しました。これは、前TaskCounts
のオブジェクトと、使用されているスロットのコンテキストで同様の情報を提供する新しいTaskSlotCounts
オブジェクトを含む複合オブジェクトです。 - タスクにプロパティ
requiredSlots
を追加しました。これにより、ユーザーはノード上のスロットの数を指定できます。
バージョン: 2020-03-01.11.0
- の新しい
DiskEncryptionConfiguration
プロパティを使用して ComputeNode ディスク ドライブを暗号化する機能がVirtualMachineConfiguration
追加されました。 - [破壊的]の
ImageReference
プロパティはvirtualMachineImageId
、Shared Image Galleryイメージのみを参照できるようになりました。 - [破壊的]
password
PFX 形式の証明書では、操作の要求本文のAdd Certificate
プロパティは省略可能です。 - [破壊的]の新しい
PublicIPAddressConfiguration
プロパティNetworkConfiguration
を使用して、パブリック IP なしでプールをプロビジョニングできるようになりました。 - [破壊的]の
publicIPs
NetworkConfiguration
プロパティの名前が にipAddressIds
変更され、 も にPublicIPAddressConfiguration
移動されました。 このプロパティは、 プロパティがusermanaged
の場合provision
にのみ指定できます。
バージョン: 2019-08-01.10.0
- プールの新しい
publicIPs
プロパティを使用して、 のNetworkConfiguration
パブリック IP のコレクションを指定する機能が追加されました。 これにより、プール内のノードには、ユーザーが指定した IP の一覧から IP が割り当てられていることが保証されます。 - プロパティを使用して、プールの各ノードにリモート ファイル システムをマウントする機能が
MountConfiguration
追加されました。 - Shared Image Galleryイメージは、Azure Resource Manager ID を使用してイメージを参照することで、 の
ImageReference
プロパティで指定virtualMachineImageId
できるようになりました。 - [破壊的]指定しない場合、 の
StartTask
既定値waitForSuccess
は です (以前はtrue
でしたfalse
)。 - [破壊的]指定しない場合、on の既定値
scope
は常にPool
になります (以前は Windows ノードとPool
Linux ノード上でしたTask
)。AutoUserSpecification
- さまざまな混乱や不完全なドキュメントを改善しました。
バージョン: 2019-06-01.9.0
[破壊的]に
ListSupportedImages
置き換えられましたListNodeAgentSKUs
。ListSupportedImages
には、最初に使用できるListNodeAgentSKUs
のと同じ情報がすべて含まれていますが、より明確な形式で格納されます。 検証されていない新しいイメージも返されるようになりました。 とBatchSupportEndOfLife
に関するCapabilities
追加情報は、 を介してImageInformation
アクセスできます。トラフィックの送信元ポートに基づいて へのネットワーク アクセスを
CloudPool
ブロックするネットワーク セキュリティ規則がサポートされるようになりました。 これを行うには、NetworkSecurityGroupRule
のSourcePortRanges
プロパティを使用します。コンテナーを実行するときに、Batch でコンテナーの作業ディレクトリまたは Batch タスクの作業ディレクトリでのタスクの実行がサポートされるようになりました。 これは
TaskContainerSettings
のWorkingDirectory
プロパティで制御されます。さまざまな混乱や不完全なドキュメントを改善しました。
バージョン: 2018-12-01.8.0
[破壊的] プールでの の
upgradeos
サポートがcloudServiceConfiguration
削除されました。[破壊的]から
poolusagemetrics
とdataIngressGiB
を削除しましたdataEgressGiB
。 これらのプロパティはサポートされなくなりました。[破壊的]
ResourceFile
改善-
ResourceFile で Azure Storage コンテナー全体を指定する機能を追加しました。 ResourceFile では、次の 3 つのモードがサポートされるようになりました。
-
httpUrl
は、単一のResourceFile
HTTP URL を指す を作成します。 -
storageContainerUrl
は、ResourceFile
Azure Blob Storage コンテナーを指す を作成します。 -
autoStorageContainerName
は、ResourceFile
Batch 登録済み自動ストレージ アカウント内のAzure Blob Storage コンテナーを指す を作成します。
-
- メソッドを介して に
ResourceFile
提供される URL は、任意のhttpUrl
HTTP URL にできるようになりました。 以前は、これらはAzure Blob Storage URL である必要がありました。 -
blobPrefix
を使用して、ストレージ コンテナーからのダウンロードをフィルター処理して、プレフィックスに一致するものだけにできます。
-
ResourceFile で Azure Storage コンテナー全体を指定する機能を追加しました。 ResourceFile では、次の 3 つのモードがサポートされるようになりました。
[破壊的]から プロパティを
VirtualMachineConfiguration
削除しましたosDisk
。 このプロパティはサポートされなくなりました。を に
NetworkConfiguration
job
設定dynamicVNetAssignmentScope
したプールで、ジョブのタスクが実行される各ノードにVirtual Networkを動的に割り当てることができるようになりました。 ノードを結合する特定のVirtual Networkは、 およびJobSpecification
の新しいJobNetworkConfiguration
プロパティCloudJob
で指定されます。注意
この機能はパブリック プレビュー段階にあります。 これは、当社に連絡し、パイロットへの参加を要求したアカウントを除き、すべての Batch アカウントで無効になります。
タスクの最大有効期間は 180 日になりました (以前は 7 日でした)。
を使用して特定のログイン モード (
batch
またはinteractive
) を使用してユーザーを作成するための Windows プールのサポートをLoginMode
追加しました。すべてのタスクの既定のタスク保持時間は 7 日になり、以前は無限になりました。
バージョン 2018-08-01.7.0
バージョン 2018-08-01.7.0 の新機能は次のとおりです。
- ComputeNode の新しい NodeAgentInfo プロパティを使用して、Azure Batch Node エージェントのバージョンを表示します。
- タスクの の を指定
Filter
Result
する機能を追加しました。 詳細については、こちらを参照してください。- これにより、サーバー側のクエリを実行して、失敗したすべてのタスクを検索する、要求の多いシナリオが可能になります。
-
[破壊的]
ValidationStatus
TaskCounts から プロパティを削除しました。 -
[破壊的]DataDisk と OSDisk の既定のキャッシュの種類は、 ではなく
None
になりましたReadWrite
。 -
[破壊的]ContainerType の唯一の値の名前を から
docker
に変更dockerCompatible
しました。
バージョン 2018-03-01.6.1
バージョン 2018-03-01.6.1 の新機能は次のとおりです。
- 状態別のプール ノード数: このバージョンでは、新しい ListPoolNodeCounts 操作を使用して、状態別にプール ノード数を照会する機能が追加されます。 この操作により、Batch アカウント内のすべてのプールに対して、作成、アイドル状態、オフライン状態、割り込み状態、再起動、再イメージ化、起動など、ノードの状態を照会できます。
- ノード エージェント ログ: このバージョンでは、UploadBatchServiceLogs 操作を使用して、Azure Batchノード エージェント ログを特定のノードからアップロードする機能が追加されます。 これは、ノードで問題が発生した場合にMicrosoft サポートによるデバッグで使用するためのものです。
バージョン 2017-09-01.6.0
Azure ハイブリッド使用特典: Azure ハイブリッド使用特典ライセンスを使用することを指定する Batch Windows VM プールを作成できるようになりました。 このライセンスを使用すると、VM の価格に割引が適用されます。 VirtualMachineConfiguration で新しい LicenseType プロパティを使用します。
プール VM データ ディスク: 仮想マシン構成の一部である新しいデータ ディスク構成を使用して、1 つ以上の空のデータ ディスクを VM プールにアタッチできます。 VirtualMachineConfiguration で DataDisks プロパティを使用します。
(破壊的変更)カスタム イメージは、BLOB VHD ファイルではなく Azure Resource Manager イメージ リソースを使用して作成およびデプロイされるようになりました。 Batch はマネージド ディスクを使用してプール VM を作成し、そのため イメージ リソースを使用するようになりました。 カスタム イメージを使用して作成されたプール内の VM の数に制限がなくなりました。また、大規模なプール用の VHD BLOB の複数のコピーは不要になりました。 そのため、カスタム イメージ プールの作成とスケーリングがはるかに簡単になります。 詳細については、「 カスタム イメージを使用して仮想マシンのプールを作成する」を参照してください。
ImageReference の新しい VirtualMachineImageId プロパティには Image への参照が含まれており、OSDisk.ImageUris は存在しなくなりました。
この変更により、 ImageReference は VirtualMachineConfiguration の必須プロパティになりました。
(破壊的変更)マルチインスタンス タスク ( MultiInstanceSettings を使用して作成) で CoordinationCommandLine を指定する必要があり、 NumberOfInstances は省略可能になり、既定値は 1 になりました。
Docker コンテナーを使用して実行されるタスクのサポートが追加されました。 Docker コンテナーを使用してタスクを実行するには、プールの VirtualMachineConfiguration で ContainerConfiguration を指定し、タスクに TaskContainerSettings を追加する必要があります。
バージョン 2017-06-01.5.1
ここで説明する Batch 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では、Batch ワークロードのコストを削減するために、優先順位の低いコンピューティング ノードが提供されるようになりました。 優先順位の低い VM は経済的であり、大量の計算能力を提供することで新しい種類の Batch ワークロードを作成できます。
優先順位の低いノードの REST API には、いくつかの変更があります。
- (破壊的変更)プールまたはプール仕様の targetDedicated プロパティと currentDedicated プロパティの名前が targetDedicatedNodes および currentComputeNodes に変更されました。
- (破壊的変更)プールの resizeError プロパティが resizeErrors と呼ばれるコレクションになりました。
- コンピューティング ノードには、新しい isDedicated プロパティがあります。 このプロパティは専用ノードの 場合は true 、優先順位の低いノードの 場合は false です。
- ジョブ マネージャー タスクには、新しい allowLowPriorityNode プロパティがあります。 このプロパティが true の場合、ジョブ マネージャー タスクは優先順位の低いノードで実行される可能性があります。 false の場合、ジョブ マネージャー タスクは専用のコンピューティング ノードで実行されます。
Linux 上の名前付きユーザー
Azure Batchでは、Linux ノードで名前付きユーザーを作成するための追加のサポートが提供されるようになりました。
- 新しい linuxUserConfiguration プロパティでは、Linux ユーザーの作成時 に uid (ユーザー ID) と gid (グループ ID) を指定できます。
- (破壊的変更) sshPrivateKey プロパティが userAccount プロパティから新しい linuxUserConfiguration プロパティに移動されました。 linuxUserConfiguration プロパティ自体は userAccount プロパティのプロパティです。
名前付きユーザー アカウントの詳細については、「 Batch でユーザー アカウントでタスクを実行する」を参照してください。
タスク データの出力ファイル
タスクの完了後に、タスク データをアップロードする出力ファイルを指定できるようになりました。
- 新しい outputFiles プロパティでは、Azure Storage にアップロードするタスク ファイルの指定がサポートされています。
- exitConditions プロパティの新しい fileUploadError プロパティは、出力ファイルのアップロード状態に基づいて実行するアクションの指定をサポートします。
タスク エラーレポート
タスク エラーのレポートを改善するために、いくつかの変更が行われました。
- executionInfo プロパティの新しい result プロパティは、タスクが成功したか失敗したかを示します。
- (破壊的変更)executionInfo プロパティの schedulingError プロパティの名前が failureInfo に変更されました。 failureInfo プロパティは、タスクエラーが発生するたびに返されます。 これには、以前のすべてのスケジュール エラー ケース、0 以外のタスク終了コードが返されるすべてのケース、およびファイルアップロードエラーが含まれます。
- (破壊的変更)exitConditions プロパティの schedulingError プロパティの名前が preProcessingError に変更され、タスクのライフサイクルでエラーがいつ発生したかを明確にしました。
- (破壊的変更) schedulingErrorCateogry プロパティの名前が errorCategory に変更されました。
アプリケーション ライセンス
プールまたはプール仕様の新しい applicationLicenses プロパティを使用して、プールにアプリケーション ライセンスをプロビジョニングするように要求できるようになりました。
バージョン 2017-01-01.4.0
このバージョン リリースでは、以前のバージョン 2016-07-01.3.1 のすべてのサポートが拡張されています。 さらに、次の機能もサポートしています。
指定したユーザー ID でタスクを実行します。
タスク リソースの新しい userIdentity プロパティで指定された、次のいずれかのユーザー ID でタスクまたはタスク コレクションを実行できるようになりました。
定義した名前を持つユーザー アカウント。
自動的に作成されるユーザー アカウント (自動ユーザー)。 自動ユーザーは、管理ユーザーまたは非管理ユーザーとして実行できます。 既定では、自動ユーザーは非管理ユーザーとして実行されます。
重要
userIdentity プロパティは、その elevationLevel プロパティで、タスクまたはタスク コレクションを追加する要求の runElevated プロパティと、タスクまたはタスクの一覧に関する情報を取得する応答で置き換えられます。
batch サービスのバージョン 2017-01-01.4.0 に runElevated プロパティを含む要求を行うと、要求は失敗します。
管理ユーザーとして実行するには、アプリケーションを userIdentity プロパティを使用するように更新し、 elevationLevel プロパティを admin に設定 します。
非管理ユーザーとして実行するには、アプリケーションを userIdentity プロパティを使用するように更新し、 elevationLevel プロパティを nonAdmin に設定します。 これは既定値であるため、設定を省略することもできます。
プール内のすべてのノードにわたってユーザー アカウントを定義します。
プール リソースで定義したユーザー アカウントでタスクまたはタスク コレクションを実行できるようになりました。 プールの追加要求で、新しい userAccounts プロパティを使用してユーザー アカウントを定義します。 アカウントを定義するときに、アカウント名、パスワード、昇格レベル (管理者または管理者以外)、SSH 秘密キー (Linux プールの場合) を指定できます。
ユーザー アカウントを定義したら、タスクまたはタスク コレクションを追加する要求で userIdentity プロパティのユーザー アカウントを指定できます。
タスクの実行時に Batch サービスに対して認証するトークンをタスクに提供します。
Batch サービスは、実行時にタスクに認証トークンを提供できるようになりました。 認証トークンを使用すると、Batch アカウント キーを使用せずに、ジョブに関連する要求を Batch サービスに発行できます。 トークンは、AZ_BATCH_AUTHENTICATION_TOKEN環境変数を介して提供されます。
現在、認証トークンは、ジョブ リソースに対する操作の呼び出しでのみサポートされています。 認証トークンは、タスクを含むジョブのすべての操作へのアクセスを許可します。
Batch サービスに認証トークンを提供するには、新しい authenticationTokenSettings プロパティとその アクセス プロパティを、 タスクの追加 または タスク コレクションの追加の要求で指定します。
タスクが失敗した場合にタスクの依存関係に対して実行するアクションを指定します。
依存するタスクが失敗した場合でも、依存タスクを続行することを指定できるようになりました。 親タスクが失敗した場合でも依存タスクを実行するために、タスク リソースの新しい dependencyAction プロパティを 満たすように 設定します。 または、 dependencyAction を ブロック に設定して、親タスクが失敗した場合に依存タスクが実行されないようにします。
[タスクの追加] または [タスク コレクションの追加] の要求で dependencyAction プロパティを指定します。
依存関係アクションの使用の詳細については、「 依存関係アクション」を参照してください。
プールの作成時にカスタム OS ディスク イメージを使用します。
これで、カスタム OS ディスク イメージを使用してプールを作成できるようになりました。
そのためには、Batch サービスによって管理されるサブスクリプションではなく、ユーザー サブスクリプションでプールをプロビジョニングする Batch アカウントをいつ作成するかを指定する必要があります。 Create Account の呼び出しで、poolAllocationMode プロパティを UserSubscription に設定します。 次に、 osDisk プロパティを使用して、 プールの追加要求でディスク イメージへの参照を指定します。
重要
Batch アカウントを作成するときに、プールをユーザー サブスクリプションでプロビジョニングするように指定した場合は、そのアカウントを介して行われたすべての要求に対して Azure Active Directory ベースの認証を使用する必要があります。
Batch サービスへの要求には、Azure Active Directory ベースの認証を使用します。
Batch サービスへの呼び出しを認証するために、Azure Active Directory (Azure AD) がサポートされるようになりました。
Batch アカウントがユーザー サブスクリプションでプールをプロビジョニングするように設定されている場合は、Azure AD 認証を使用する必要があります。
バージョン 2016-07-01.3.1
このバージョン リリースでは、以前のバージョン 2016-02-01.3.0 のすべてのサポートが拡張されています。 さらに、次の機能もサポートしています。
ネットワーク構成を使用してプールと自動プールを作成する機能
- プールリソースと自動プール リソースの両方に、新しいプロパティ networkConfiguration が追加されました。 このプロパティを使用すると、プールのコンピューティング ノードが作成されるサブネットなど、プールのネットワーク構成を指定できます。
すべてのタスクが完了したら、ジョブを自動的に終了します。
- ジョブ リソース に、新しいプロパティ onAllTasksComplete が追加されました。 これは、ジョブを作成または更新するときに指定できます。
タスクが失敗したときにジョブを自動的に終了または無効にします。
- ジョブ リソース に新しいプロパティ onTaskFailure が追加され、新しいプロパティ exitConditions がタスク リソースに追加されました。 ジョブ onTaskFailure 設定は、タスクの失敗にジョブ レベルの影響があるかどうかを示し、タスク exitConditions プロパティを使用すると、タスクはジョブ レベルの影響をエラーの性質に合わせて調整できます。
アプリケーション パッケージをタスクとプールに関連付けます。
- 新しいプロパティ applicationPackageReferences がタスク リソースとジョブ jobManagerTask 設定に追加されました。 これにより、アプリケーション パッケージは、プールの作成時に指定する必要はなく、タスクに必要な場合に必要に応じて展開できます。 これは、有効期間中に異なる種類のジョブや異なるアプリケーション バージョンを実行するために 呼び出される可能性がある長時間のプール、またはすべてのタスクで必要とされない大規模なアプリケーション パッケージがある場合に特に役立ちます。
失敗したタスクを再アクティブ化する機能。
- 失敗したタスクの状態をアクティブにリセットするために、新しい操作 [タスクの 再アクティブ化 ] が追加されました。 これにより、エラーが一時的であった場合や、タスクを再作成せずにエラーの原因を修正できた場合など、エラーを再試行できます。
バージョン 2016-02-01.3.0
このバージョン リリースでは、以前のバージョン 2015-12-01.2.2 のすべてのサポートが拡張されています。 さらに、次の機能もサポートしています。
IaaS VM 構成を使用してプールと自動プールを作成する機能
既存のプロパティ 'osFamily'、'targetOSVersion' および 'currentOSVersion' は、Pool リソースと Autopool リソースの最上位プロパティから移動され、'cloudServiceConfiguration' という新しいプロパティ内に移動されます。
新しいプロパティ 'virtualMachineConfiguration' が Pool リソースと Autopool リソースの両方に追加されます。 このプロパティは、IaaS VM を使用してプール/自動プールを構成するために指定できます。
Batch サービスでサポートされているすべてのノード エージェント SKU に関する情報を取得するために、新しい API が追加されます。 「サポートされているノード エージェント SKU の一覧表示」を参照してください。
新しい API が追加され、IaaS VM 構成で作成されたコンピューティング ノードにリモートでログインするために使用できるリモート ログイン設定を取得できます。 「ノードのリモート ログイン設定を取得する」を参照してください。
ジョブにタスクのコレクションを追加するために、新しい API が追加されます。 「ジョブにタスクのコレクションを追加する」を参照してください。
新しい省略可能なプロパティ 'sshPublicKey' が User リソースに追加され、Linux コンピューティング ノードでユーザーを追加または更新するために使用できます。
2 つの新しいプロパティ 'totalTasksSucceeded' と 'runningTasksCount' が Node リソースに追加されます。 これらのプロパティは、 ノードに関する情報の取得 または プール内のコンピューティング ノードの一覧表示を使用して取得できます。
新しいプロパティ 'fileMode' が 'ResourceFile' 複合型に追加されます。 このプロパティは Linux コンピューティング ノードにのみ適用され、Windows コンピューティング ノードでは無視されます。
新しいプロパティ 'fileMode' が 'FileProperties' 複合型に追加されます。 このプロパティは、GetFileProperties または ListFileProperties API の一部として、Linux コンピューティング ノードの Batch サービスによって返されます。 また、'FileProperties' 複合型の既存のプロパティ 'creationTime' は、Linux コンピューティング ノードではこのプロパティが返されないため、省略可能なプロパティに変更されます。
'CertificateReference' 複合型内の既存のプロパティ 'visibility' のデータ型は、コンマ区切りの値を持つ文字列から文字列のコレクションに変更されます。 また、可視性の既存の値の 1 つが "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' が追加されます。 このプロパティは、コンピューティング ノードの取得とコンピューティング ノードの一覧表示の一部として返されます
コンピューティング ノードでタスク スケジュールを無効または有効にする機能
2 つの新しい API ノードのタスク スケジュールを無効にし、ノードのタスク スケジュールを有効にするがコンピューティング ノード リソースに追加されます。
新しいコンピューティング ノードの状態 'offline' が追加されます。 古い API バージョンの場合、この状態は "使用不可" にマップされます。
新しいプロパティ 'schedulingState' がコンピューティング ノード リソースに追加されます。 'enabled' と 'disabled' に指定できる値。
プール/自動プールで自動スケーリング評価間隔を指定する機能
新しいプロパティ 'autoScaleEvaluationInterval' がプール リソースに追加されます。 このプロパティは、プールの追加、プールの取得、自動スケーリングの有効化、およびプール API の一覧表示に含めることができます。
同様に、自動プールの場合は、新しいプロパティ 'autoScaleEvaluationInterval' が 'autoPoolSpecification' プロパティに追加されます。 このプロパティは、[ジョブの追加]、[ジョブの取得]、[ジョブの一覧表示]、[ジョブ スケジュールの追加]、[ジョブ スケジュールの取得]、[ジョブ スケジュールの更新]、[ジョブ スケジュールの一覧表示]、[ジョブ スケジュールの一覧表示] API に含めることができます。
コンピューティング ノード上のタスクのルート ディレクトリを返すタスク API の機能強化。
タスクに関する情報の取得の一部として取得できる 2 つの新しいプロパティ 'taskRootDirectory' と 'taskRootDirectoryUrl' が Task リソースに追加されました。タスク API の一覧表示
新しいプロパティ 'taskRootDirectory' が 'jobPreparationTaskExecutionInfo' および 'jobReleaseTaskExecutionInfo' に追加され、ジョブ API のジョブ準備タスクとジョブ リリース タスクの状態を一覧表示して取得できます。