Pool - Update
既存のプールのプロパティを更新します。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/pools/{poolName}?api-version=2024-07-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
Batch アカウントの名前。 |
pool
|
path | True |
string minLength: 1maxLength: 64 pattern: ^[a-zA-Z0-9_-]+$ |
プール名。 これはアカウント内で一意である必要があります。 |
resource
|
path | True |
string |
Batch アカウントを含むリソース グループの名前。 |
subscription
|
path | True |
string |
Azure サブスクリプション ID。 これは GUID 形式の文字列です (例: 000000000-0000-0000-0000-000000000000) |
api-version
|
query | True |
string |
HTTP 要求で使用される API バージョン。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
If-Match |
string |
更新するプールのエンティティ状態 (ETag) バージョン。 操作を無条件に適用するには、この値を省略するか、"*" に設定できます。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
identity |
バッチ プールに使用される ID の種類。 |
|
properties.applicationLicenses |
string[] |
Batch サービスがプール内の各コンピューティング ノードで使用できるアプリケーション ライセンスの一覧。 |
properties.applicationPackages |
プール内の各コンピューティング ノードにインストールするアプリケーション パッケージの一覧。 |
|
properties.certificates |
プール内の各コンピューティング ノードにインストールする証明書の一覧。 警告: このプロパティは非推奨であり、2024 年 2 月以降に削除されます。 代わりに、Azure KeyVault 拡張機能 を使用してください。 |
|
properties.deploymentConfiguration |
このプロパティは、プール ノードがデプロイされる仮想マシンについて説明します。 |
|
properties.displayName |
string |
プールの表示名。 |
properties.interNodeCommunication |
プールがノード間の直接通信を許可するかどうか。 |
|
properties.metadata |
メタデータとしてプールに関連付けられている名前と値のペアの一覧。 |
|
properties.mountConfiguration |
プール内の各ノードにマウントするファイル システムの一覧。 |
|
properties.networkConfiguration |
プールのネットワーク構成。 |
|
properties.resourceTags |
object |
プールに関連付けられているユーザー指定のタグ。 |
properties.scaleSettings |
プール内のノード数を構成する設定。 |
|
properties.startTask |
プールに参加する各コンピューティング ノードで実行するように指定されたタスク。 |
|
properties.targetNodeCommunicationMode |
プールの目的のノード通信モード。 |
|
properties.taskSchedulingPolicy |
タスクをプール内のコンピューティング ノード間で分散する方法。 |
|
properties.taskSlotsPerNode |
integer (int32) |
プール内の 1 つのコンピューティング ノードで同時実行タスクを実行するために使用できるタスク スロットの数。 |
properties.upgradePolicy |
プールのアップグレード ポリシー。 |
|
properties.userAccounts |
プール内の各ノードに作成するユーザー アカウントの一覧。 |
|
properties.vmSize |
string |
プール内の仮想マシンのサイズ。 プール内のすべての VM のサイズは同じです。 |
tags |
object |
リソースのタグ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
操作が成功しました。 応答にはプール エンティティが含まれています。 ヘッダー ETag: string |
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Microsoft Entra OAuth 2.0 認証コード フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
Update |
Update |
Update |
Update |
UpdatePool - Enable Autoscale
要求のサンプル
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01
{
"properties": {
"scaleSettings": {
"autoScale": {
"formula": "$TargetDedicatedNodes=34"
}
}
}
}
応答のサンプル
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2017-08-29T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-29T10:22:55.9407275Z",
"vmSize": "STANDARD_D4",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-Datacenter-SmallDisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64"
}
},
"scaleSettings": {
"autoScale": {
"formula": "$TargetDedicated=34",
"evaluationInterval": "PT15M"
}
},
"autoScaleRun": {
"evaluationTime": "2017-08-29T10:22:55.9407275Z",
"results": "$TargetDedicatedNodes=34;NodeDeallocationOption=requeue"
},
"currentDedicatedNodes": 12,
"currentLowPriorityNodes": 0,
"resizeOperationStatus": {
"startTime": "2017-08-29T10:22:55.9407275Z",
"targetDedicatedNodes": 34,
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M"
}
}
}
UpdatePool - Other Properties
要求のサンプル
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01
{
"properties": {
"metadata": [
{
"name": "key1",
"value": "value1"
}
],
"applicationPackages": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/applications/app_1234"
},
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/applications/app_5678",
"version": "1.0"
}
],
"certificates": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/certificates/sha1-1234567",
"storeLocation": "LocalMachine",
"storeName": "MY"
}
],
"targetNodeCommunicationMode": "Simplified"
}
}
応答のサンプル
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2017-08-29T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-29T10:22:55.9407275Z",
"vmSize": "STANDARD_D4",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-Datacenter-SmallDisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64"
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT8M",
"nodeDeallocationOption": "TaskCompletion"
}
},
"autoScaleRun": {
"evaluationTime": "2017-08-29T10:22:55.9407275Z",
"results": "$TargetDedicatedNodes=34;NodeDeallocationOption=requeue"
},
"currentDedicatedNodes": 12,
"currentLowPriorityNodes": 0,
"resizeOperationStatus": {
"startTime": "2017-08-29T10:22:55.9407275Z",
"targetDedicatedNodes": 8,
"nodeDeallocationOption": "TaskCompletion",
"resizeTimeout": "PT8M"
},
"metadata": [
{
"name": "key1",
"value": "value1"
}
],
"applicationPackages": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/applications/app_1234"
},
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/applications/app_5678",
"version": "1.0"
}
],
"certificates": [
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool/certificates/sha1-1234567",
"storeLocation": "LocalMachine",
"storeName": "MY",
"visibility": [
"StartTask",
"Task",
"RemoteUser"
]
}
],
"targetNodeCommunicationMode": "Simplified"
}
}
UpdatePool - Remove Start Task
要求のサンプル
応答のサンプル
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2017-08-29T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-29T10:22:55.9407275Z",
"vmSize": "STANDARD_D4",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-Datacenter-SmallDisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64"
}
},
"scaleSettings": {
"autoScale": {
"formula": "$TargetDedicated=34",
"evaluationInterval": "PT15M"
}
},
"autoScaleRun": {
"evaluationTime": "2017-08-29T10:22:55.9407275Z",
"results": "$TargetDedicatedNodes=34;NodeDeallocationOption=requeue"
},
"currentDedicatedNodes": 12,
"currentLowPriorityNodes": 0,
"resizeOperationStatus": {
"startTime": "2017-08-29T10:22:55.9407275Z",
"targetDedicatedNodes": 34,
"nodeDeallocationOption": "Requeue",
"resizeTimeout": "PT15M"
}
}
}
UpdatePool - Resize Pool
要求のサンプル
PATCH https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool?api-version=2024-07-01
{
"properties": {
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 5,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT8M",
"nodeDeallocationOption": "TaskCompletion"
}
}
}
}
応答のサンプル
ETag: W/"0x8D4EDFEBFADF4AB"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/pools/testpool",
"name": "testpool",
"type": "Microsoft.Batch/batchAccounts/pools",
"etag": "W/\"0x8D4EDFEBFADF4AB\"",
"properties": {
"lastModified": "2017-08-29T10:22:55.9407275Z",
"creationTime": "2017-08-28T10:22:55.9407275Z",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-08-28T10:22:55.9407275Z",
"allocationState": "Resizing",
"allocationStateTransitionTime": "2017-08-29T10:22:55.9407275Z",
"vmSize": "STANDARD_D4",
"interNodeCommunication": "Disabled",
"taskSlotsPerNode": 1,
"taskSchedulingPolicy": {
"nodeFillType": "Spread"
},
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2016-Datacenter-SmallDisk",
"version": "latest"
},
"nodeAgentSkuId": "batch.node.windows amd64"
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 1,
"targetLowPriorityNodes": 0,
"resizeTimeout": "PT8M",
"nodeDeallocationOption": "TaskCompletion"
}
},
"autoScaleRun": {
"evaluationTime": "2017-08-29T10:22:55.9407275Z",
"results": "$TargetDedicatedNodes=34;NodeDeallocationOption=requeue"
},
"currentDedicatedNodes": 12,
"currentLowPriorityNodes": 0,
"resizeOperationStatus": {
"startTime": "2017-08-29T10:22:55.9407275Z",
"targetDedicatedNodes": 8,
"nodeDeallocationOption": "TaskCompletion",
"resizeTimeout": "PT8M"
}
}
}
定義
名前 | 説明 |
---|---|
Allocation |
プールのサイズが変更されているかどうか。 |
Application |
バッチ アカウント内のアプリケーション パッケージへのリンク |
Automatic |
OS の自動アップグレードを実行するために使用される構成パラメーター。 |
Auto |
プールの自動スケール式の実行の結果とエラー。 |
Auto |
プールを自動スケールするときに発生したエラー。 |
Auto |
プールの自動スケール設定。 |
Auto |
自動ユーザーのスコープ |
Auto |
Batch サービスでタスクを実行する自動ユーザーのパラメーターを指定します。 |
Azure |
Blobfuse を使用して Azure Storage コンテナーに接続するために使用される情報。 |
Azure |
Azure ファイル共有への接続に使用される情報。 |
Batch |
Batch プールの ID (構成されている場合)。 既存のプールの更新中にプール ID が更新された場合、プールが 0 に縮小された後に作成された新しい VM のみが更新された ID を持ちます |
Caching |
ディスクに対して有効にするキャッシュの種類。 |
Certificate |
プール内のコンピューティング ノードにインストールされる証明書への参照。 これは、プールと同じアカウント内に存在する必要があります。 |
Certificate |
証明書をインストールするコンピューティング ノード上の証明書ストアの場所。 |
Certificate |
証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。 |
CIFSMount |
CIFS ファイル システムへの接続に使用される情報。 |
Cloud |
Batch サービスからのエラー応答。 |
Cloud |
Batch サービスからのエラー応答。 |
Compute |
割り当て解除を選択した後のノードとその実行中のタスクの操作を決定します。 |
Compute |
タスクをコンピューティング ノード間で分散する方法。 |
Compute |
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。 |
Container |
コンテナーが有効なプールの構成。 |
Container |
タスク コンテナーにマウントするパスとマウント モードのエントリ。 |
Container |
コンテナー タスクのコンテナーにマウントされるパス。 |
Container |
プライベート コンテナー レジストリ。 |
Container |
使用するコンテナー テクノロジ。 |
Container |
コンテナー タスクの作業ディレクトリの場所を示すフラグ。 既定値は 'taskWorkingDirectory' です。 |
Data |
プール内のコンピューティング ノードに関連付けられているデータ ディスクによって使用される設定。 接続されたデータ ディスクを使用する場合は、VM 内からディスクをマウントしてフォーマットして使用する必要があります。 |
Deployment |
展開構成プロパティ。 |
Diff |
プール内のすべての VM のオペレーティング システム ディスクのエフェメラル ディスクの配置を指定します。 |
Diff |
仮想マシンで使用されるオペレーティング システム ディスクのエフェメラル ディスク設定を指定します。 |
Disk |
プール内のコンピューティング ノードに適用されるディスク暗号化構成。 仮想マシン イメージまたは Azure コンピューティング ギャラリー イメージを使用して作成された Linux プールでは、ディスク暗号化の構成はサポートされていません。 |
Disk |
Batch Service がコンピューティング ノードで暗号化するディスク ターゲットの一覧 |
Dynamic |
動的 vnet 割り当てのスコープ。 |
Elevation |
ユーザーの昇格レベル。 |
Environment |
タスク プロセスに設定する環境変数。 |
Fixed |
プールのスケール設定を修正しました。 |
Image |
カスタム仮想マシンの Azure Virtual Machines Marketplace イメージまたは Azure Image リソースへの参照。 Azure Batch によって検証されたすべての imageReferences の一覧を取得するには、「サポートされているノード エージェント SKU の一覧表示」操作を参照してください。 |
Inbound |
エンドポイントのプロトコル。 |
Inbound |
Batch プール内のコンピューティング ノード上の特定のポートを外部でアドレス指定するために使用できる受信 NAT プール。 |
Inter |
プールがノード間の直接通信を許可するかどうか。 |
IPAddress |
Batch プールのパブリック IP アドレスのプロビジョニングの種類。 |
Linux |
Linux ノードでユーザー アカウントを作成するために使用されるプロパティ。 |
Login |
ユーザーのログイン モード |
Managed |
|
Metadata |
Batch サービス リソースに関連付けられている名前と値のペア。 |
Mount |
各ノードにマウントするファイル システム。 |
Network |
プールのネットワーク構成。 |
Network |
受信エンドポイントに適用するネットワーク セキュリティ グループルール。 |
Network |
指定した IP アドレス、サブネット範囲、またはタグに対して実行する必要があるアクション。 |
NFSMount |
NFS ファイル システムへの接続に使用される情報。 |
Node |
プールが Batch サービスと通信する方法を決定します。 |
Node |
バッチ プールのノード配置構成。 |
Node |
プール内のノードを割り当てる配置ポリシー。 |
OSDisk |
仮想マシンのオペレーティング システム ディスクの設定。 |
Pool |
プールに関する情報を格納します。 |
Pool |
プールのエンドポイント構成。 |
Pool |
バッチ プールに使用される ID の種類。 |
Pool |
プールの現在の状態。 |
Public |
プールのネットワーク構成のパブリック IP アドレス構成。 |
Resize |
プールのサイズを変更するときに発生したエラー。 |
Resize |
現在または最後に完了したサイズ変更操作の詳細。 |
Resource |
コンピューティング ノードにダウンロードする 1 つのファイルまたは複数のファイル。 |
Rolling |
ローリング アップグレードの実行中に使用される構成パラメーター。 |
Scale |
プールのスケール設定 |
Security |
マネージド ディスクの EncryptionType を指定します。 VMGuestState BLOB のみを暗号化する場合は VMGuestStateOnly に、VMGuestState BLOB にファームウェアの状態を保持しない場合は NonPersistedTPM に設定されます。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合は必須です。 |
Security |
仮想マシンまたは仮想マシン スケール セットのセキュリティ プロファイル設定を指定します。 |
Security |
仮想マシンの SecurityType を指定します。 UefiSettings を有効にするには、指定した値に設定する必要があります。 |
Service |
"最新" イメージ バージョンを使用する場合に、スケール セット内のすべての仮想マシンに同じイメージ バージョンを設定するために使用されるサービス 成果物参照 ID を指定します。 |
Start |
コンピューティング ノードが Azure Batch サービス内のプールに参加したとき、またはコンピューティング ノードが再起動または再イメージ化されたときに実行されるタスク。 |
Storage |
データ ディスクまたは OS ディスクの作成に使用するストレージ アカウントの種類。 |
Task |
タスクのコンテナー設定。 |
Task |
タスクをコンピューティング ノード間で分散する方法を指定します。 |
Uefi |
仮想マシンの作成時に使用されるセキュア ブートや vTPM などのセキュリティ設定を指定します。 |
Upgrade |
スケール セット内の仮想マシンへのアップグレード モードを指定します。 |
Upgrade |
アップグレード ポリシー (自動、手動、またはローリング) について説明します。 |
User |
Azure Batch ノードでユーザーを作成するために使用されるプロパティ。 |
User |
関連付けられているユーザー ID の一覧。 |
User |
タスクを実行するユーザー ID の定義。 |
Virtual |
Azure Virtual Machines インフラストラクチャに基づくプール内のコンピューティング ノードの構成。 |
VMDisk |
マネージド ディスクのセキュリティ プロファイル設定を指定します。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合に必要です。 |
VMExtension |
仮想マシン拡張機能の構成。 |
Windows |
仮想マシンに適用する Windows オペレーティング システムの設定。 |
Windows |
Windows ノードでユーザー アカウントを作成するために使用されるプロパティ。 |
AllocationState
プールのサイズが変更されているかどうか。
値 | 説明 |
---|---|
Resizing |
プールのサイズが変更されています。つまり、コンピューティング ノードがプールに追加またはプールから削除されます。 |
Steady |
プールのサイズが変更されていません。 進行中のプール内のノードの数に変更はありません。 プールが作成されたとき、およびノードの数を変更する操作がプールに対して実行されていない場合、プールはこの状態になります。 |
Stopping |
プールのサイズは変更されていましたが、ユーザーはサイズ変更を停止することを要求しましたが、停止要求はまだ完了していません。 |
ApplicationPackageReference
バッチ アカウント内のアプリケーション パッケージへのリンク
名前 | 型 | 説明 |
---|---|---|
id |
string |
インストールするアプリケーション パッケージの ID。 これは、プールと同じバッチ アカウント内にある必要があります。 これは、特定のバージョンへの参照でも、存在する場合は既定のバージョンでもかまいません。 |
version |
string |
デプロイするアプリケーションのバージョン。 省略すると、既定のバージョンがデプロイされます。 |
AutomaticOSUpgradePolicy
OS の自動アップグレードを実行するために使用される構成パラメーター。
名前 | 型 | 説明 |
---|---|---|
disableAutomaticRollback |
boolean |
OS イメージのロールバック機能を無効にする必要があるかどうか。 |
enableAutomaticOSUpgrade |
boolean |
新しいバージョンの OS イメージが使用可能になったときに、OS アップグレードをスケール セット インスタンスに自動的に適用するかどうかを示します。 |
osRollingUpgradeDeferral |
boolean |
タスクを実行している場合は、TVM の OS アップグレードを延期します。 |
useRollingUpgradePolicy |
boolean |
自動 OS アップグレード中にローリング アップグレード ポリシーを使用するかどうかを示します。 VMSS でポリシーが定義されていない場合、OS の自動アップグレードは既定のポリシーにフォールバックします。 |
AutoScaleRun
プールの自動スケール式の実行の結果とエラー。
名前 | 型 | 説明 |
---|---|---|
error |
評価が失敗した場合に、プールで自動スケール式の評価中に発生したエラーの詳細。 |
|
evaluationTime |
string (date-time) |
自動スケール式が最後に評価された時刻。 |
results |
string |
自動スケール式の評価で使用されるすべての変数の最終的な値。 |
AutoScaleRunError
プールを自動スケールするときに発生したエラー。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
details |
エラーに関する追加の詳細。 |
|
message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
AutoScaleSettings
プールの自動スケール設定。
名前 | 型 | 説明 |
---|---|---|
evaluationInterval |
string (duration) |
自動スケールの数式に従ってプール サイズを自動的に調整する時間間隔。 |
formula |
string |
プール内のコンピューティング ノードの必要な数の数式。 |
AutoUserScope
自動ユーザーのスコープ
値 | 説明 |
---|---|
Pool |
タスクが、プール内のすべてのノードで作成される共通の自動ユーザー アカウントとして実行されるように指定します。 |
Task |
サービスがタスクの新しいユーザーを作成することを指定します。 |
AutoUserSpecification
Batch サービスでタスクを実行する自動ユーザーのパラメーターを指定します。
名前 | 型 | 説明 |
---|---|---|
elevationLevel |
自動ユーザーの昇格レベル。 |
|
scope |
自動ユーザーのスコープ |
AzureBlobFileSystemConfiguration
Blobfuse を使用して Azure Storage コンテナーに接続するために使用される情報。
名前 | 型 | 説明 |
---|---|---|
accountKey |
string |
Azure ストレージ アカウント キー。 |
accountName |
string |
Azure ストレージ アカウント名。 |
blobfuseOptions |
string |
mount コマンドに渡す追加のコマンド ライン オプション。 |
containerName |
string |
Azure Blob Storage コンテナー名。 |
identityReference |
containerName へのアクセスに使用するユーザー割り当て ID への参照 |
|
relativeMountPath |
string |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
sasKey |
string |
Azure Storage SAS トークン。 |
AzureFileShareConfiguration
Azure ファイル共有への接続に使用される情報。
名前 | 型 | 説明 |
---|---|---|
accountKey |
string |
Azure Storage アカウント キー。 |
accountName |
string |
Azure Storage アカウント名。 |
azureFileUrl |
string |
Azure Files の URL。 |
mountOptions |
string |
mount コマンドに渡す追加のコマンド ライン オプション。 |
relativeMountPath |
string |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
BatchPoolIdentity
Batch プールの ID (構成されている場合)。 既存のプールの更新中にプール ID が更新された場合、プールが 0 に縮小された後に作成された新しい VM のみが更新された ID を持ちます
名前 | 型 | 説明 |
---|---|---|
type |
バッチ プールに使用される ID の種類。 |
|
userAssignedIdentities |
<string,
User |
Batch プールに関連付けられているユーザー ID の一覧。 |
CachingType
ディスクに対して有効にするキャッシュの種類。
値 | 説明 |
---|---|
None |
ディスクのキャッシュ モードが有効になっていません。 |
ReadOnly |
ディスクのキャッシュ モードは読み取り専用です。 |
ReadWrite |
ディスクのキャッシュ モードは読み取りと書き込みです。 |
CertificateReference
プール内のコンピューティング ノードにインストールされる証明書への参照。 これは、プールと同じアカウント内に存在する必要があります。
名前 | 型 | 説明 |
---|---|---|
id |
string |
プールにインストールする証明書の完全修飾 ID。 これは、プールと同じバッチ アカウント内にある必要があります。 |
storeLocation |
証明書をインストールするコンピューティング ノード上の証明書ストアの場所。 |
|
storeName |
string |
証明書をインストールするコンピューティング ノード上の証明書ストアの名前。 |
visibility |
証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。 |
CertificateStoreLocation
証明書をインストールするコンピューティング ノード上の証明書ストアの場所。
値 | 説明 |
---|---|
CurrentUser |
CurrentUser 証明書ストアに証明書をインストールする必要があります。 |
LocalMachine |
証明書は LocalMachine 証明書ストアにインストールする必要があります。 |
CertificateVisibility
証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。
値 | 説明 |
---|---|
RemoteUser |
証明書は、ユーザーがノードにリモートでアクセスするユーザー アカウントに表示されます。 |
StartTask |
証明書は、開始タスクが実行されているユーザー アカウントに表示されます。 AutoUser スコープが StartTask と Task の両方のプールである場合、この証明書はタスクにも表示されることに注意してください。 |
Task |
証明書は、ジョブ タスクが実行されているユーザー アカウントに表示されます。 |
CIFSMountConfiguration
CIFS ファイル システムへの接続に使用される情報。
名前 | 型 | 説明 |
---|---|---|
mountOptions |
string |
mount コマンドに渡す追加のコマンド ライン オプション。 |
password |
string |
CIFS ファイル システムに対する認証に使用するパスワード。 |
relativeMountPath |
string |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
source |
string |
マウントするファイル システムの URI。 |
userName |
string |
CIFS ファイル システムに対する認証に使用するユーザー。 |
CloudError
Batch サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
error |
エラー応答の本文。 |
CloudErrorBody
Batch サービスからのエラー応答。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
details |
エラーに関する追加の詳細の一覧。 |
|
message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
ComputeNodeDeallocationOption
割り当て解除を選択した後のノードとその実行中のタスクの操作を決定します。
値 | 説明 |
---|---|
Requeue |
実行中のタスク プロセスを終了し、タスクを再キューします。 ノードが使用可能になると、タスクが再度実行されます。 タスクが終了したらすぐにノードを削除します。 |
RetainedData |
現在実行中のタスクの完了を許可し、すべてのタスク データ保持期間の有効期限が切れるのを待ちます。 待機中に新しいタスクをスケジュールしない。 すべてのタスク保有期間の有効期限が切れたときにノードを削除します。 |
TaskCompletion |
現在実行中のタスクの完了を許可します。 待機中に新しいタスクをスケジュールしない。 すべてのタスクが完了したら、ノードを削除します。 |
Terminate |
実行中のタスクを終了します。 タスクは、終了されたことを示す failureInfo で完了し、もう一度実行されません。 タスクが終了したらすぐにノードを削除します。 |
ComputeNodeFillType
タスクをコンピューティング ノード間で分散する方法。
値 | 説明 |
---|---|
Pack |
プール内の次のノードにタスクを割り当てる前に、できるだけ多くのタスク (taskSlotsPerNode) をプール内の各ノードに割り当てる必要があります。 |
Spread |
タスクは、プール内のすべてのノードに均等に割り当てる必要があります。 |
ComputeNodeIdentityReference
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
名前 | 型 | 説明 |
---|---|---|
resourceId |
string |
ユーザー割り当て ID の ARM リソース ID。 |
ContainerConfiguration
コンテナーが有効なプールの構成。
名前 | 型 | 説明 |
---|---|---|
containerImageNames |
string[] |
コンテナー イメージ名のコレクション。 |
containerRegistries |
コンテナーをプルできる追加のプライベート レジストリ。 |
|
type |
使用するコンテナー テクノロジ。 |
ContainerHostBatchBindMountEntry
タスク コンテナーにマウントするパスとマウント モードのエントリ。
名前 | 型 | 説明 |
---|---|---|
isReadOnly |
boolean |
このソース パスを読み取り専用モードとしてマウントするかどうか。 既定値は false (読み取り/書き込みモード) です。 |
source |
コンテナー顧客にマウントするパスを選択できます。 |
ContainerHostDataPath
コンテナー タスクのコンテナーにマウントされるパス。
値 | 説明 |
---|---|
Applications |
アプリケーション パス。 |
JobPrep |
ジョブ準備タスクのパス。 |
Shared |
複数インスタンス のタスクがファイルを共有するためのパス。 |
Startup |
開始タスクのパス。 |
Task |
タスク パス。 |
VfsMounts |
パスには、このノードにマウントされているすべての仮想ファイル システムが含まれています。 |
ContainerRegistry
プライベート コンテナー レジストリ。
名前 | 型 | 説明 |
---|---|---|
identityReference |
ユーザー名とパスワードではなく、Azure Container Registry へのアクセスに使用するユーザー割り当て ID への参照。 |
|
password |
string |
レジストリ サーバーにログインするためのパスワード。 |
registryServer |
string |
レジストリ URL。 |
username |
string |
レジストリ サーバーにログインするユーザー名。 |
ContainerType
使用するコンテナー テクノロジ。
値 | 説明 |
---|---|
CriCompatible |
CRI ベースのテクノロジを使用して、コンテナーを起動します。 |
DockerCompatible |
Docker と互換性のあるコンテナー テクノロジを使用して、コンテナーを起動します。 |
ContainerWorkingDirectory
コンテナー タスクの作業ディレクトリの場所を示すフラグ。 既定値は 'taskWorkingDirectory' です。
値 | 説明 |
---|---|
ContainerImageDefault |
コンテナー イメージを使用して作業ディレクトリを定義します。 このディレクトリには、Batch によってダウンロードされたリソース ファイルが含まれていないことに注意してください。 |
TaskWorkingDirectory |
標準の Batch サービス タスク作業ディレクトリを使用します。このディレクトリには、Batch によって設定されたタスク リソース ファイルが含まれます。 |
DataDisk
プール内のコンピューティング ノードに関連付けられているデータ ディスクによって使用される設定。 接続されたデータ ディスクを使用する場合は、VM 内からディスクをマウントしてフォーマットして使用する必要があります。
名前 | 型 | 説明 |
---|---|---|
caching |
データ ディスクに対して有効にするキャッシュの種類。 none - ディスクのキャッシュ モードが有効になっていません。 readOnly - ディスクのキャッシュ モードは読み取り専用です。 readWrite - ディスクのキャッシュ モードは読み取りと書き込みです。 キャッシュの既定値は none です。 キャッシュ オプションの詳細については、「https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/」を参照してください。 |
|
diskSizeGB |
integer (int32) |
新しいデータ ディスクを作成するときの初期ディスク サイズ (GB)。 |
lun |
integer (int32) |
論理ユニット番号。 |
storageAccountType |
データ ディスクに使用するストレージ アカウントの種類。 Standard_LRS - データ ディスクは、標準のローカル冗長ストレージを使用する必要があります。 Premium_LRS - データ ディスクでは、Premium ローカル冗長ストレージを使用する必要があります。 |
DeploymentConfiguration
展開構成プロパティ。
名前 | 型 | 説明 |
---|---|---|
virtualMachineConfiguration |
プールの仮想マシン構成。 |
DiffDiskPlacement
プール内のすべての VM のオペレーティング システム ディスクのエフェメラル ディスクの配置を指定します。
値 | 説明 |
---|---|
CacheDisk |
エフェメラル OS ディスクは VM キャッシュに格納されます。 |
DiffDiskSettings
仮想マシンで使用されるオペレーティング システム ディスクのエフェメラル ディスク設定を指定します。
名前 | 型 | 説明 |
---|---|---|
placement |
プール内のすべての VM のオペレーティング システム ディスクのエフェメラル ディスクの配置を指定します。 |
DiskEncryptionConfiguration
プール内のコンピューティング ノードに適用されるディスク暗号化構成。 仮想マシン イメージまたは Azure コンピューティング ギャラリー イメージを使用して作成された Linux プールでは、ディスク暗号化の構成はサポートされていません。
名前 | 型 | 説明 |
---|---|---|
targets |
Batch Service がコンピューティング ノードで暗号化するディスク ターゲットの一覧 |
DiskEncryptionTarget
Batch Service がコンピューティング ノードで暗号化するディスク ターゲットの一覧
値 | 説明 |
---|---|
OsDisk |
コンピューティング ノード上の OS ディスクは暗号化されます。 |
TemporaryDisk |
コンピューティング ノード上の一時ディスクは暗号化されます。 Linux では、起動時に暗号化が行われると、この暗号化は他のパーティション (マウントされたデータ ディスク上のパーティションなど) に適用されます。 |
DynamicVNetAssignmentScope
動的 vnet 割り当てのスコープ。
値 | 説明 |
---|---|
job |
動的 VNet の割り当てはジョブごとに実行されます。 この値を設定する場合は、ネットワーク構成サブネット ID も設定する必要があります。 この機能は、使用前に承認が必要です。サポートにお問い合わせください |
none |
動的 VNet 割り当てが有効になっていません。 |
ElevationLevel
ユーザーの昇格レベル。
値 | 説明 |
---|---|
Admin |
ユーザーは昇格されたアクセス権を持つユーザーであり、完全な管理者権限で動作します。 |
NonAdmin |
ユーザーは、昇格されたアクセス権を持たない標準ユーザーです。 |
EnvironmentSetting
タスク プロセスに設定する環境変数。
名前 | 型 | 説明 |
---|---|---|
name |
string |
環境変数の名前。 |
value |
string |
環境変数の値。 |
FixedScaleSettings
プールのスケール設定を修正しました。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
nodeDeallocationOption |
プール サイズが減少している場合にノードとその実行中のタスクを処理する方法を決定します。 |
||
resizeTimeout |
string (duration) |
PT15M |
プールへのコンピューティング ノードの割り当てのタイムアウト。 |
targetDedicatedNodes |
integer (int32) |
プール内の専用コンピューティング ノードの目的の数。 |
|
targetLowPriorityNodes |
integer (int32) |
プール内のスポット/優先順位の低いコンピューティング ノードの目的の数。 |
ImageReference
カスタム仮想マシンの Azure Virtual Machines Marketplace イメージまたは Azure Image リソースへの参照。 Azure Batch によって検証されたすべての imageReferences の一覧を取得するには、「サポートされているノード エージェント SKU の一覧表示」操作を参照してください。
名前 | 型 | 説明 |
---|---|---|
communityGalleryImageId |
string |
コミュニティ ギャラリー イメージの一意識別子 |
id |
string |
Azure コンピューティング ギャラリー イメージの ARM リソース識別子。 プール内のコンピューティング ノードは、このイメージ ID を使用して作成されます。これは、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{versionId} の形式です。 |
offer |
string |
Azure Virtual Machines Marketplace イメージのオファーの種類。 |
publisher |
string |
Azure Virtual Machines Marketplace イメージの発行元。 |
sharedGalleryImageId |
string |
共有ギャラリー イメージの一意識別子 |
sku |
string |
Azure Virtual Machines Marketplace イメージの SKU。 |
version |
string |
Azure Virtual Machines Marketplace イメージのバージョン。 |
InboundEndpointProtocol
エンドポイントのプロトコル。
値 | 説明 |
---|---|
TCP |
エンドポイントには TCP を使用します。 |
UDP |
エンドポイントには UDP を使用します。 |
InboundNatPool
Batch プール内のコンピューティング ノード上の特定のポートを外部でアドレス指定するために使用できる受信 NAT プール。
名前 | 型 | 説明 |
---|---|---|
backendPort |
integer (int32) |
コンピューティング ノードのポート番号。 |
frontendPortRangeEnd |
integer (int32) |
個々のコンピューティング ノードで backendPort への受信アクセスを提供するために使用される外部ポートの範囲内の最後のポート番号。 |
frontendPortRangeStart |
integer (int32) |
個々のコンピューティング ノードで backendPort への受信アクセスを提供するために使用される外部ポートの範囲内の最初のポート番号。 |
name |
string |
エンドポイントの名前。 |
networkSecurityGroupRules |
エンドポイントに適用されるネットワーク セキュリティ グループ規則の一覧。 |
|
protocol |
エンドポイントのプロトコル。 |
InterNodeCommunicationState
プールがノード間の直接通信を許可するかどうか。
値 | 説明 |
---|---|
Disabled |
仮想マシン間のネットワーク通信を無効にします。 |
Enabled |
仮想マシン間のネットワーク通信を有効にします。 |
IPAddressProvisioningType
Batch プールのパブリック IP アドレスのプロビジョニングの種類。
値 | 説明 |
---|---|
BatchManaged |
パブリック IP は Batch によって作成および管理されます。 プールのサイズによっては、複数のパブリック IP が存在する場合があります。 |
NoPublicIPAddresses |
プール内のコンピューティング ノードのパブリック IP アドレスは作成されません。 |
UserManaged |
パブリック IP はユーザーによって提供され、コンピューティング ノードのプロビジョニングに使用されます。 |
LinuxUserConfiguration
Linux ノードでユーザー アカウントを作成するために使用されるプロパティ。
名前 | 型 | 説明 |
---|---|---|
gid |
integer (int32) |
ユーザー アカウントのグループ ID。 |
sshPrivateKey |
string |
ユーザー アカウントの SSH 秘密キー。 |
uid |
integer (int32) |
ユーザー アカウントのユーザー ID。 |
LoginMode
ユーザーのログイン モード
値 | 説明 |
---|---|
Batch |
LOGON32_LOGON_BATCH Win32 ログイン モード。 バッチ ログイン モードは、実行時間の長い並列プロセスに推奨されます。 |
Interactive |
LOGON32_LOGON_INTERACTIVE Win32 ログイン モード。 一部のアプリケーションでは、対話型ログイン モードに関連付けられたアクセス許可が必要です。 タスクで使用するアプリケーションの場合は、このオプションをお勧めします。 |
ManagedDisk
名前 | 型 | 説明 |
---|---|---|
securityProfile |
マネージド ディスクのセキュリティ プロファイルを指定します。 |
|
storageAccountType |
マネージド ディスクのストレージ アカウントの種類。 |
MetadataItem
Batch サービス リソースに関連付けられている名前と値のペア。
名前 | 型 | 説明 |
---|---|---|
name |
string |
メタデータ項目の名前。 |
value |
string |
メタデータ項目の値。 |
MountConfiguration
各ノードにマウントするファイル システム。
名前 | 型 | 説明 |
---|---|---|
azureBlobFileSystemConfiguration |
各ノードで BLOB FUSE を使用してマウントする Azure Storage コンテナー。 |
|
azureFileShareConfiguration |
各ノードにマウントする Azure ファイル共有。 |
|
cifsMountConfiguration |
各ノードにマウントする CIFS/SMB ファイル システム。 |
|
nfsMountConfiguration |
各ノードにマウントする NFS ファイル システム。 |
NetworkConfiguration
プールのネットワーク構成。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
dynamicVnetAssignmentScope | none |
動的 vnet 割り当てのスコープ。 |
|
enableAcceleratedNetworking |
boolean |
このプールで高速ネットワークを有効にする必要があるかどうか。 |
|
endpointConfiguration |
Batch プール内のコンピューティング ノード上のエンドポイントの構成。 |
||
publicIPAddressConfiguration |
Batch プール内のコンピューティング ノードのパブリック IP アドレス構成。 |
||
subnetId |
string |
プールのコンピューティング ノードが参加する仮想ネットワーク サブネットの ARM リソース識別子。 これは、/subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet} の形式です。 |
NetworkSecurityGroupRule
受信エンドポイントに適用するネットワーク セキュリティ グループルール。
名前 | 型 | 説明 |
---|---|---|
access |
指定した IP アドレス、サブネット範囲、またはタグに対して実行する必要があるアクション。 |
|
priority |
integer (int32) |
このルールの優先順位。 |
sourceAddressPrefix |
string |
ルールに一致する送信元アドレスプレフィックスまたはタグ。 |
sourcePortRanges |
string[] |
規則に一致するソース ポートの範囲。 |
NetworkSecurityGroupRuleAccess
指定した IP アドレス、サブネット範囲、またはタグに対して実行する必要があるアクション。
値 | 説明 |
---|---|
Allow |
アクセスを許可します。 |
Deny |
アクセスを拒否します。 |
NFSMountConfiguration
NFS ファイル システムへの接続に使用される情報。
名前 | 型 | 説明 |
---|---|---|
mountOptions |
string |
mount コマンドに渡す追加のコマンド ライン オプション。 |
relativeMountPath |
string |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
source |
string |
マウントするファイル システムの URI。 |
NodeCommunicationMode
プールが Batch サービスと通信する方法を決定します。
値 | 説明 |
---|---|
Classic |
クラシック通信モードを使用するノードでは、"BatchNodeManagement" からのポート 29876 と 29877 の受信 TCP 通信が必要です。{region}" サービス タグとポート 443 の "Storage.region" および "BatchNodeManagement" への送信 TCP 通信。{region}" サービス タグ。 |
Default |
ノード通信モードは、Batch サービスによって自動的に設定されます。 |
Simplified |
簡易通信モードを使用するノードでは、ポート 443 で "BatchNodeManagement" への送信 TCP 通信が必要です。{region}" サービス タグ。 開いている受信ポートは必要ありません。 |
NodePlacementConfiguration
バッチ プールのノード配置構成。
名前 | 型 | 説明 |
---|---|---|
policy |
Batch プールでのノード配置ポリシーの種類。 |
NodePlacementPolicyType
プール内のノードを割り当てる配置ポリシー。
値 | 説明 |
---|---|
Regional |
プール内のすべてのノードは、同じリージョンに割り当てられます。 |
Zonal |
プール内のノードは、ベスト エフォート分散によって異なるゾーンに分散されます。 |
OSDisk
仮想マシンのオペレーティング システム ディスクの設定。
名前 | 型 | 説明 |
---|---|---|
caching |
キャッシュ要件を指定します。 使用できる値は None、ReadOnly、ReadWrite です。 既定値は、Standard Storage の場合は [なし] です。 Premium Storage の ReadOnly。 |
|
diskSizeGB |
integer (int32) |
新しい OS ディスクを作成するときの初期ディスク サイズ (GB)。 |
ephemeralOSDiskSettings |
仮想マシンで使用されるオペレーティング システム ディスクのエフェメラル ディスク設定を指定します。 |
|
managedDisk |
マネージド ディスクのパラメーター。 |
|
writeAcceleratorEnabled |
boolean |
ディスクで writeAccelerator を有効または無効にするかどうかを指定します。 |
Pool
プールに関する情報を格納します。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
etag |
string |
コンカレンシー ステートメントに使用されるリソースの ETag。 |
|
id |
string |
リソースの ID。 |
|
identity |
バッチ プールに使用される ID の種類。 |
||
name |
string |
リソースの名前。 |
|
properties.allocationState |
プールのサイズが変更されているかどうか。 |
||
properties.allocationStateTransitionTime |
string (date-time) |
プールが現在の割り当て状態になった時刻。 |
|
properties.applicationLicenses |
string[] |
Batch サービスがプール内の各コンピューティング ノードで使用できるアプリケーション ライセンスの一覧。 |
|
properties.applicationPackages |
プール内の各コンピューティング ノードにインストールするアプリケーション パッケージの一覧。 |
||
properties.autoScaleRun |
自動スケール式の最後の実行の結果とエラー。 |
||
properties.certificates |
プール内の各コンピューティング ノードにインストールする証明書の一覧。 警告: このプロパティは非推奨であり、2024 年 2 月以降に削除されます。 代わりに、Azure KeyVault 拡張機能 を使用してください。 |
||
properties.creationTime |
string (date-time) |
プールの作成時刻。 |
|
properties.currentDedicatedNodes |
integer (int32) |
プール内の現在の専用コンピューティング ノードの数。 |
|
properties.currentLowPriorityNodes |
integer (int32) |
プール内の現在のスポット/優先順位の低いコンピューティング ノードの数。 |
|
properties.currentNodeCommunicationMode |
プール通信モードの現在の状態。 |
||
properties.deploymentConfiguration |
このプロパティは、プール ノードがデプロイされる仮想マシンについて説明します。 |
||
properties.displayName |
string |
プールの表示名。 |
|
properties.interNodeCommunication |
プールがノード間の直接通信を許可するかどうか。 |
||
properties.lastModified |
string (date-time) |
プールの最終変更時刻。 |
|
properties.metadata |
メタデータとしてプールに関連付けられている名前と値のペアの一覧。 |
||
properties.mountConfiguration |
プール内の各ノードにマウントするファイル システムの一覧。 |
||
properties.networkConfiguration |
プールのネットワーク構成。 |
||
properties.provisioningState |
プールの現在の状態。 |
||
properties.provisioningStateTransitionTime |
string (date-time) |
プールが現在の状態になった時刻。 |
|
properties.resizeOperationStatus |
現在または最後に完了したサイズ変更操作に関する詳細が含まれます。 |
||
properties.resourceTags |
object |
プールに関連付けられているユーザー指定のタグ。 |
|
properties.scaleSettings |
プール内のノード数を構成する設定。 |
||
properties.startTask |
プールに参加する各コンピューティング ノードで実行するように指定されたタスク。 |
||
properties.targetNodeCommunicationMode |
プールの目的のノード通信モード。 |
||
properties.taskSchedulingPolicy |
タスクをプール内のコンピューティング ノード間で分散する方法。 |
||
properties.taskSlotsPerNode |
integer (int32) |
1 |
プール内の 1 つのコンピューティング ノードで同時実行タスクを実行するために使用できるタスク スロットの数。 |
properties.upgradePolicy |
プールのアップグレード ポリシー。 |
||
properties.userAccounts |
プール内の各ノードに作成するユーザー アカウントの一覧。 |
||
properties.vmSize |
string |
プール内の仮想マシンのサイズ。 プール内のすべての VM のサイズは同じです。 |
|
tags |
object |
リソースのタグ。 |
|
type |
string |
リソースの種類。 |
PoolEndpointConfiguration
プールのエンドポイント構成。
名前 | 型 | 説明 |
---|---|---|
inboundNatPools |
個々のコンピューティング ノード上の特定のポートを外部でアドレス指定するために使用できる受信 NAT プールの一覧。 |
PoolIdentityType
バッチ プールに使用される ID の種類。
値 | 説明 |
---|---|
None |
バッチ プールには ID が関連付けされません。 更新プールで |
UserAssigned |
Batch プールには、ユーザー割り当て ID があります。 |
PoolProvisioningState
プールの現在の状態。
値 | 説明 |
---|---|
Deleting |
ユーザーはプールの削除を要求しましたが、削除操作はまだ完了していません。 |
Succeeded |
プールは、コンピューティング ノードの可用性に応じてタスクを実行するために使用できます。 |
PublicIPAddressConfiguration
プールのネットワーク構成のパブリック IP アドレス構成。
名前 | 型 | 説明 |
---|---|---|
ipAddressIds |
string[] |
Batch サービスがコンピューティング ノードのプロビジョニング時に使用するパブリック IP の一覧。 |
provision |
プールのパブリック IP アドレスのプロビジョニングの種類 |
ResizeError
プールのサイズを変更するときに発生したエラー。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
details |
エラーに関する追加の詳細。 |
|
message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
ResizeOperationStatus
現在または最後に完了したサイズ変更操作の詳細。
名前 | 型 | 説明 |
---|---|---|
errors |
プールで最後のサイズ変更の実行中に発生したエラーの詳細。 |
|
nodeDeallocationOption |
プール サイズが減少している場合にノードとその実行中のタスクを処理する方法を決定します。 |
|
resizeTimeout |
string (duration) |
プールへのコンピューティング ノードの割り当てまたはプールからのコンピューティング ノードの削除のタイムアウト。 |
startTime |
string (date-time) |
このサイズ変更操作が開始された時刻。 |
targetDedicatedNodes |
integer (int32) |
プール内の専用コンピューティング ノードの目的の数。 |
targetLowPriorityNodes |
integer (int32) |
プール内のスポット/優先順位の低いコンピューティング ノードの目的の数。 |
ResourceFile
コンピューティング ノードにダウンロードする 1 つのファイルまたは複数のファイル。
名前 | 型 | 説明 |
---|---|---|
autoStorageContainerName |
string |
自動ストレージ アカウントのストレージ コンテナー名。 |
blobPrefix |
string |
Azure Storage コンテナーから BLOB をダウンロードするときに使用する BLOB プレフィックス。 指定したプレフィックスで始まる名前の BLOB のみがダウンロードされます。 |
fileMode |
string |
ファイルアクセス許可モード属性 (8 進数形式)。 |
filePath |
string |
タスクの作業ディレクトリを基準とした、ファイルのダウンロード先となるコンピューティング ノード上の場所。 |
httpUrl |
string |
ダウンロードするファイルの URL。 |
identityReference |
storageContainerUrl または httpUrl で指定された Azure Blob Storage へのアクセスに使用するユーザー割り当て ID への参照 |
|
storageContainerUrl |
string |
Azure Blob Storage 内の BLOB コンテナーの URL。 |
RollingUpgradePolicy
ローリング アップグレードの実行中に使用される構成パラメーター。
名前 | 型 | 説明 |
---|---|---|
enableCrossZoneUpgrade |
boolean |
アップグレード バッチを構築するときに、VMSS が AZ 境界を無視できるようにします。 バッチ サイズを決定するには、更新ドメインと maxBatchInstancePercent を考慮してください。 このフィールドが設定されていない場合、Azure Azure Batch では既定値は設定されません。 作成された VirtualMachineScaleSet の enableCrossZoneUpgrade の値は、VirtualMachineScaleSet の既定の構成によって決定されます。 このフィールドは、NodePlacementConfiguration をゾーンとして使用する場合にのみ true または false に設定できます。 |
maxBatchInstancePercent |
integer (int32) minimum: 5maximum: 100 |
1 回のバッチでのローリング アップグレードによって同時にアップグレードされる仮想マシン インスタンスの合計数に対する最大割合。 これは最大であるため、以前または将来のバッチの異常なインスタンスでは、信頼性を高めるためにバッチ内のインスタンスの割合が減少する可能性があります。 このフィールドの値は、5 ~ 100 の範囲にする必要があります。 maxBatchInstancePercent と maxUnhealthyInstancePercent の両方に値が割り当てられている場合、maxBatchInstancePercent の値は maxUnhealthyInstancePercent を超えてはなりません。 |
maxUnhealthyInstancePercent |
integer (int32) minimum: 5maximum: 100 |
アップグレードの結果として、またはローリング アップグレードが中止される前に仮想マシンの正常性チェックによって異常な状態で検出された場合に、同時に異常になる可能性があるスケール セット内の仮想マシン インスタンスの合計数に対する最大割合。 この制約は、バッチを開始する前にチェックされます。 このフィールドの値は、5 ~ 100 の範囲にする必要があります。 maxBatchInstancePercent と maxUnhealthyInstancePercent の両方に値が割り当てられている場合、maxBatchInstancePercent の値は maxUnhealthyInstancePercent を超えてはなりません。 |
maxUnhealthyUpgradedInstancePercent |
integer (int32) minimum: 0maximum: 100 |
異常な状態にあると検出できるアップグレードされた仮想マシン インスタンスの最大割合。 このチェックは、各バッチがアップグレードされた後に行われます。 この割合を超えた場合、ローリング アップデートは中止されます。 このフィールドの値は、0 ~ 100 の範囲にする必要があります。 |
pauseTimeBetweenBatches |
string |
すべての仮想マシンの更新を 1 つのバッチで完了してから次のバッチを開始するまでの待機時間。 期間は ISO 8601 形式で指定する必要があります。 |
prioritizeUnhealthyInstances |
boolean |
正常なインスタンスの前に、スケール セット内のすべての異常なインスタンスをアップグレードします。 |
rollbackFailedInstancesOnPolicyBreach |
boolean |
ローリング アップグレード ポリシーに違反した場合、失敗したインスタンスを以前のモデルにロールバックします。 |
ScaleSettings
プールのスケール設定
名前 | 型 | 説明 |
---|---|---|
autoScale |
プールの自動スケール設定。 |
|
fixedScale |
プールのスケール設定を修正しました。 |
SecurityEncryptionTypes
マネージド ディスクの EncryptionType を指定します。 VMGuestState BLOB のみを暗号化する場合は VMGuestStateOnly に、VMGuestState BLOB にファームウェアの状態を保持しない場合は NonPersistedTPM に設定されます。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合は必須です。
値 | 説明 |
---|---|
NonPersistedTPM | |
VMGuestStateOnly |
SecurityProfile
仮想マシンまたは仮想マシン スケール セットのセキュリティ プロファイル設定を指定します。
名前 | 型 | 説明 |
---|---|---|
encryptionAtHost |
boolean |
このプロパティは、要求のユーザーが仮想マシンまたは仮想マシン スケール セットの Host Encryption を有効または無効にするために使用できます。 これにより、ホスト自体のリソース/一時ディスクを含むすべてのディスクの暗号化が有効になります。 |
securityType |
仮想マシンの SecurityType を指定します。 UefiSettings を有効にするには、指定した値に設定する必要があります。 |
|
uefiSettings |
仮想マシンの作成時に使用されるセキュア ブートや vTPM などのセキュリティ設定を指定します。 |
SecurityTypes
仮想マシンの SecurityType を指定します。 UefiSettings を有効にするには、指定した値に設定する必要があります。
値 | 説明 |
---|---|
confidentialVM |
Azure コンフィデンシャル コンピューティングは、セキュリティと機密性の高い要件を持つテナント向けの機密 VM を提供します。 これらの VM は、セキュリティ ニーズを満たすのに役立つ強力なハードウェア強制境界を提供します。 コードを変更することなく、機密 VM を移行に使用できます。プラットフォームを使用すると、VM の状態が読み取られたり変更されたりするのを防いでいます。 |
trustedLaunch |
信頼できる起動は、高度で永続的な攻撃手法から保護します。 |
ServiceArtifactReference
"最新" イメージ バージョンを使用する場合に、スケール セット内のすべての仮想マシンに同じイメージ バージョンを設定するために使用されるサービス 成果物参照 ID を指定します。
名前 | 型 | 説明 |
---|---|---|
id |
string |
ServiceArtifactReference のサービス 成果物参照 ID |
StartTask
コンピューティング ノードが Azure Batch サービス内のプールに参加したとき、またはコンピューティング ノードが再起動または再イメージ化されたときに実行されるタスク。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
commandLine |
string |
開始タスクのコマンド ライン。 |
|
containerSettings |
開始タスクを実行するコンテナーの設定。 |
||
environmentSettings |
開始タスクの環境変数設定の一覧。 |
||
maxTaskRetryCount |
integer (int32) |
0 |
タスクを再試行できる最大回数。 |
resourceFiles |
コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 |
||
userIdentity |
開始タスクを実行するユーザー ID。 |
||
waitForSuccess |
boolean |
コンピューティング ノード上のタスクをスケジュールする前に、Batch サービスが開始タスクが正常に完了するまで (つまり、終了コード 0 で終了する) のを待つ必要があるかどうか。 |
StorageAccountType
データ ディスクまたは OS ディスクの作成に使用するストレージ アカウントの種類。
値 | 説明 |
---|---|
Premium_LRS |
データ ディスク/OS ディスクでは、Premium ローカル冗長ストレージを使用する必要があります。 |
StandardSSD_LRS |
データ ディスク/OS ディスクでは、Standard SSD のローカル冗長ストレージを使用する必要があります。 |
Standard_LRS |
データ ディスク/OS ディスクでは、標準のローカル冗長ストレージを使用する必要があります。 |
TaskContainerSettings
タスクのコンテナー設定。
名前 | 型 | 説明 |
---|---|---|
containerHostBatchBindMounts |
コンテナー タスクにマウントするパス。 |
|
containerRunOptions |
string |
コンテナー作成コマンドの追加オプション。 |
imageName |
string |
タスクを実行するコンテナーの作成に使用するイメージ。 |
registry |
コンテナー イメージを含むプライベート レジストリ。 |
|
workingDirectory |
コンテナー タスクの作業ディレクトリの場所を示すフラグ。 既定値は 'taskWorkingDirectory' です。 |
TaskSchedulingPolicy
タスクをコンピューティング ノード間で分散する方法を指定します。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
nodeFillType | Spread |
タスクをコンピューティング ノード間で分散する方法。 |
UefiSettings
仮想マシンの作成時に使用されるセキュア ブートや vTPM などのセキュリティ設定を指定します。
名前 | 型 | 説明 |
---|---|---|
secureBootEnabled |
boolean |
仮想マシンでセキュア ブートを有効にするかどうかを指定します。 |
vTpmEnabled |
boolean |
仮想マシンで vTPM を有効にするかどうかを指定します。 |
UpgradeMode
スケール セット内の仮想マシンへのアップグレード モードを指定します。
使用可能な値は次のとおりです。
手動 - スケール セット内の仮想マシンへの更新プログラムの適用を制御します。 これを行うには、manualUpgrade アクションを使用します。
自動 - スケール セット内のすべての仮想マシンが同時に自動的に更新されます。
ローリング - スケール セットは、必要に応じて一時停止時間の間にバッチで更新を実行します。
値 | 説明 |
---|---|
automatic |
スケール セット内のすべての仮想マシンが同時に自動的に更新されます。 |
manual |
スケール セット内の仮想マシンへの更新プログラムの適用を制御します。 これを行うには、manualUpgrade アクションを使用します。 |
rolling |
スケール セット内の既存のインスタンスは、アップグレードするバッチでダウンします。 アップグレードされたバッチが完了すると、インスタンスはトラフィックの取得を再開し、次のバッチが開始されます。 これは、すべてのインスタンスが -date を up-toするまで続けられます。 |
UpgradePolicy
アップグレード ポリシー (自動、手動、またはローリング) について説明します。
名前 | 型 | 説明 |
---|---|---|
automaticOSUpgradePolicy |
OS の自動アップグレードを実行するために使用される構成パラメーター。 |
|
mode |
スケール セット内の仮想マシンへのアップグレード モードを指定します。 |
|
rollingUpgradePolicy |
ローリング アップグレードの実行中に使用される構成パラメーター。 |
UserAccount
Azure Batch ノードでユーザーを作成するために使用されるプロパティ。
名前 | 型 | 説明 |
---|---|---|
elevationLevel |
ユーザー アカウントの昇格レベル。 |
|
linuxUserConfiguration |
ユーザー アカウントの Linux 固有のユーザー構成。 |
|
name |
string |
ユーザー アカウントの名前。 名前には、最大 20 文字までの Unicode 文字を含めることができます。 |
password |
string |
ユーザー アカウントのパスワード。 |
windowsUserConfiguration |
ユーザー アカウントの Windows 固有のユーザー構成。 |
UserAssignedIdentities
関連付けられているユーザー ID の一覧。
名前 | 型 | 説明 |
---|---|---|
clientId |
string |
ユーザー割り当て ID のクライアント ID。 |
principalId |
string |
ユーザー割り当て ID のプリンシパル ID。 |
UserIdentity
タスクを実行するユーザー ID の定義。
名前 | 型 | 説明 |
---|---|---|
autoUser |
タスクを実行する自動ユーザー。 |
|
userName |
string |
タスクを実行するユーザー ID の名前。 |
VirtualMachineConfiguration
Azure Virtual Machines インフラストラクチャに基づくプール内のコンピューティング ノードの構成。
名前 | 型 | 説明 |
---|---|---|
containerConfiguration |
プールのコンテナー構成。 |
|
dataDisks |
Data |
プール内のコンピューティング ノードに接続されているデータ ディスクの構成。 |
diskEncryptionConfiguration |
プールのディスク暗号化構成。 |
|
extensions |
プールの仮想マシン拡張機能。 |
|
imageReference |
使用する Azure Virtual Machines Marketplace イメージまたはカスタム仮想マシン イメージへの参照。 |
|
licenseType |
string |
オペレーティング システムの展開時に使用するオンプレミス ライセンスの種類。 Windows_Server - オンプレミスライセンスは Windows Server 用です。 Windows_Client - オンプレミス ライセンスは Windows クライアント用です。 |
nodeAgentSkuId |
string |
プール内のコンピューティング ノードにプロビジョニングされる Batch ノード エージェントの SKU。 |
nodePlacementConfiguration |
プールのノード配置構成。 |
|
osDisk |
仮想マシンのオペレーティング システム ディスクの設定。 |
|
securityProfile |
仮想マシンまたは仮想マシン スケール セットのセキュリティ プロファイル設定を指定します。 |
|
serviceArtifactReference |
"最新" イメージ バージョンを使用する場合に、スケール セット内のすべての仮想マシンに同じイメージ バージョンを設定するために使用されるサービス 成果物参照 ID を指定します。 |
|
windowsConfiguration |
仮想マシン上の Windows オペレーティング システムの設定。 |
VMDiskSecurityProfile
マネージド ディスクのセキュリティ プロファイル設定を指定します。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合に必要です。
名前 | 型 | 説明 |
---|---|---|
securityEncryptionType |
マネージド ディスクの EncryptionType を指定します。 VMGuestState BLOB のみを暗号化する場合は VMGuestStateOnly に、VMGuestState BLOB にファームウェアの状態を保持しない場合は NonPersistedTPM に設定されます。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合は必須です。 |
VMExtension
仮想マシン拡張機能の構成。
名前 | 型 | 説明 |
---|---|---|
autoUpgradeMinorVersion |
boolean |
展開時に使用可能な場合に、拡張機能で新しいマイナー バージョンを使用する必要があるかどうかを示します。 ただし、デプロイされると、このプロパティが true に設定されていても、再デプロイされない限り、拡張機能はマイナー バージョンをアップグレードしません。 |
enableAutomaticUpgrade |
boolean |
使用可能な拡張機能の新しいバージョンがある場合に、拡張機能をプラットフォームによって自動的にアップグレードするかどうかを示します。 |
name |
string |
仮想マシン拡張機能の名前。 |
protectedSettings |
object |
拡張機能には、protectedSettings または protectedSettingsFromKeyVault、または保護された設定をまったく含めなくなります。 |
provisionAfterExtensions |
string[] |
拡張機能名のコレクション。 |
publisher |
string |
拡張ハンドラーの発行元の名前。 |
settings |
object |
拡張機能の JSON 形式のパブリック設定。 |
type |
string |
拡張機能の種類。 |
typeHandlerVersion |
string |
スクリプト ハンドラーのバージョン。 |
WindowsConfiguration
仮想マシンに適用する Windows オペレーティング システムの設定。
名前 | 型 | 説明 |
---|---|---|
enableAutomaticUpdates |
boolean |
仮想マシンで自動更新が有効になっているかどうか。 |
WindowsUserConfiguration
Windows ノードでユーザー アカウントを作成するために使用されるプロパティ。
名前 | 型 | 説明 |
---|---|---|
loginMode |
ユーザーのログイン モード |