Job Schedule - Update
指定したジョブ スケジュールのプロパティを更新します。
これにより、ジョブ スケジュールのすべての更新可能なプロパティが完全に置き換えられます。 たとえば、この要求で schedule プロパティが指定されていない場合、Batch サービスは既存のスケジュールを削除します。 ジョブ スケジュールに対する変更は、更新が行われた後にスケジュールによって作成されたジョブにのみ影響します。現在実行中のジョブは影響を受けません。
PUT {batchUrl}/jobschedules/{jobScheduleId}?api-version=2024-07-01.20.0
PUT {batchUrl}/jobschedules/{jobScheduleId}?timeout={timeout}&api-version=2024-07-01.20.0
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
batch
|
path | True |
string |
すべての Azure Batch サービス要求のベース URL。 |
job
|
path | True |
string |
更新するジョブ スケジュールの ID。 |
api-version
|
query | True |
string |
クライアント API のバージョン。 |
timeout
|
query |
integer int32 |
サーバーが要求の処理に費やすことができる最大時間 (秒単位)。 既定値は 30 秒です。 値が 30 より大きい場合は、代わりに既定値が使用されます。 |
要求ヘッダー
Media Types: "application/json; odata=minimalmetadata"
名前 | 必須 | 型 | 説明 |
---|---|---|---|
client-request-id |
string uuid |
呼び出し元によって生成された要求 ID。中かっこなどの装飾のない GUID の形式 (例: 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0)。 |
|
return-client-request-id |
boolean |
サーバーが応答で client-request-id を返す必要があるかどうか。 |
|
ocp-date |
string date-time-rfc1123 |
要求が発行された時刻。 通常、クライアント ライブラリはこれを現在のシステム クロック時間に設定します。REST API を直接呼び出す場合は、明示的に設定します。 |
|
If-Match |
string |
クライアントに認識されているリソースのバージョンに関連付けられている ETag 値。 この操作は、サービス上のリソースの現在の ETag がクライアントによって指定された値と正確に一致する場合にのみ実行されます。 |
|
If-None-Match |
string |
クライアントに認識されているリソースのバージョンに関連付けられている ETag 値。 この操作は、サービス上のリソースの現在の ETag がクライアントによって指定された値と一致しない場合にのみ実行されます。 |
|
If-Modified-Since |
string date-time-rfc1123 |
クライアントに認識されているリソースの最終変更時刻を示すタイムスタンプ。 この操作は、サービス上のリソースが指定された時刻以降に変更された場合にのみ実行されます。 |
|
If-Unmodified-Since |
string date-time-rfc1123 |
クライアントに認識されているリソースの最終変更時刻を示すタイムスタンプ。 この操作は、指定した時刻以降にサービス上のリソースが変更されていない場合にのみ実行されます。 |
要求本文
Media Types: "application/json; odata=minimalmetadata"
名前 | 必須 | 型 | 説明 |
---|---|---|---|
jobSpecification | True |
このスケジュールで作成するジョブの詳細。 |
|
schedule | True |
ジョブが作成されるスケジュール。 |
|
metadata |
ジョブ スケジュールにメタデータとして関連付けられている名前と値のペアの一覧。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
Batch サービスへの要求が成功しました。 ヘッダー
|
|
Other Status Codes |
Batch サービスからのエラー。 |
セキュリティ
azure_auth
Microsoft Entra OAuth 2.0 認証コード フロー
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
Authorization
型:
apiKey
/:
header
例
JobSchedule update
要求のサンプル
PUT account.region.batch.azure.com/jobschedules/jobScheduleId?api-version=2024-07-01.20.0
{
"schedule": {
"doNotRunUntil": "2025-01-01T12:30:00Z"
},
"jobSpecification": {
"priority": 0,
"usesTaskDependencies": false,
"constraints": {
"maxWallClockTime": "P10675199DT2H48M5.4775807S",
"maxTaskRetryCount": 0
},
"poolInfo": {
"poolId": "poolId"
}
}
}
応答のサンプル
定義
名前 | 説明 |
---|---|
Access |
トークンがアクセスを許可する Batch リソース。 |
Application |
コンピューティング ノードにデプロイするパッケージへの参照。 |
Authentication |
Batch サービス操作の実行にタスクが使用できる認証トークンの設定。 |
Automatic |
OS の自動アップグレードを実行するために使用される構成パラメーター。 |
Auto |
一時的な '自動プール' の特性を指定します。 Batch サービスは、ジョブの送信時にこの自動プールを作成します。 |
Auto |
自動ユーザーのスコープ |
Auto |
Batch サービスでタスクを実行する自動ユーザーのパラメーターを指定します。 |
Azure |
Blobfuse を使用して Azure Storage コンテナーに接続するために使用される情報。 |
Azure |
Azure ファイル共有への接続に使用される情報。 |
Batch |
Azure Batch サービスから受信したエラー応答。 |
Batch |
Azure Batch エラー応答に含まれる追加情報の項目。 |
Caching |
ディスクに対して有効にするキャッシュの種類。 |
Certificate |
プール内のコンピューティング ノードにインストールされる証明書への参照。 |
Certificate |
証明書をインストールするコンピューティング ノード上の証明書ストアの場所。 |
Certificate |
証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。 |
CIFSMount |
CIFS ファイル システムへの接続に使用される情報。 |
Compute |
プール内のコンピューティング ノード間でタスクを分散する方法。 |
Compute |
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。 |
Container |
コンテナーが有効なプールの構成。 |
Container |
タスク コンテナーにマウントするパスとマウント モードのエントリ。 |
Container |
コンテナー タスクのコンテナーにマウントされるパス。 |
Container |
プライベート コンテナー レジストリ。 |
Container |
使用するコンテナー テクノロジ。 |
Container |
コンテナータスク作業ディレクトリの場所。 |
Data |
プール内のコンピューティング ノードに関連付けられているデータ ディスクによって使用される設定。 接続されたデータ ディスクを使用する場合は、VM 内からディスクをマウントしてフォーマットして使用する必要があります。 |
Diff |
プール内のすべてのコンピューティング ノード (VM) のオペレーティング システム ディスクのエフェメラル ディスク配置を指定します。 |
Diff |
コンピューティング ノード (VM) によって使用されるオペレーティング システム ディスクのエフェメラル ディスク設定を指定します。 |
Disk |
プール内のコンピューティング ノードに適用されるディスク暗号化構成。 ディスク暗号化の構成は、Azure コンピューティング ギャラリー イメージで作成された Linux プールではサポートされていません。 |
Disk |
Batch Service がコンピューティング ノードで暗号化するディスク ターゲットの一覧。 |
Dynamic |
動的 vnet 割り当てのスコープ。 |
Elevation |
ユーザーの昇格レベル。 |
Environment |
タスク プロセスで設定する環境変数。 |
Error |
Azure Batch エラー応答で受信したエラー メッセージ。 |
Http |
HTTP ヘッダーの名前と値のペア |
Image |
Azure Virtual Machines Marketplace イメージまたは Azure コンピューティング ギャラリー イメージへの参照。 Azure Batch によって検証されたすべての Azure Marketplace イメージ参照の一覧を取得するには、「サポートされているイメージの一覧表示」操作を参照してください。 |
Inbound |
エンドポイントのプロトコル。 |
Inbound |
Batch プール内のコンピューティング ノード上の特定のポートを外部でアドレス指定するために使用できる受信 NAT プール。 |
IPAddress |
プールのパブリック IP アドレスのプロビジョニングの種類。 |
Job |
ジョブの実行制約。 |
Job |
ジョブ マネージャー タスクの詳細を指定します。 |
Job |
ジョブのネットワーク構成。 |
Job |
特定のコンピューティング ノード上のジョブのタスクの前に実行するジョブ準備タスク。 |
Job |
ジョブが実行されている任意のコンピューティング ノードでジョブの完了時に実行するジョブ解放タスク。 |
Job |
ジョブ スケジュールに対して行う一連の変更。 |
Job |
スケジュールに従って作成するジョブの詳細を指定します。 |
Linux |
Linux コンピューティング ノードでユーザー アカウントを作成するために使用されるプロパティ。 |
Login |
ユーザーのログイン モード |
Managed |
|
Metadata |
Batch サービス リソースに関連付けられている名前と値のペア。 |
Mount |
各ノードにマウントするファイル システム。 |
Network |
プールのネットワーク構成。 |
Network |
受信エンドポイントに適用するネットワーク セキュリティ グループルール。 |
Network |
指定した IP アドレス、サブネット範囲、またはタグに対して実行する必要があるアクション。 |
NFSMount |
NFS ファイル システムへの接続に使用される情報。 |
Node |
プールが Batch サービスと通信する方法を決定します。 |
Node |
プールのノード配置構成。 |
Node |
プール内のノードを割り当てる配置ポリシー。 |
On |
ジョブ内のすべてのタスクが完了状態のときに Batch サービスが実行する必要があるアクション。 |
On |
ジョブ内のタスクが失敗したときに Batch サービスが実行する必要があるアクション。 |
OSDisk |
コンピューティング ノード (VM) のオペレーティング システム ディスクの設定。 |
Output |
Batch サービスがタスク プロセスの実行を完了した後、Azure Batch コンピューティング ノードから別の場所にファイルをアップロードするための仕様。 |
Output |
Azure BLOB ストレージ コンテナー内のファイルアップロード先を指定します。 |
Output |
ファイルのアップロード先。 |
Output |
タスク出力ファイルまたは一連のファイルをアップロードする条件。 |
Output |
アップロードを実行する条件など、出力ファイルのアップロード操作に関する詳細。 |
Pool |
プールのエンドポイント構成。 |
Pool |
ジョブをプールに割り当てる方法を指定します。 |
Pool |
作成された自動プールの最小有効期間、およびスケジュール上の複数のジョブをプールに割り当てる方法。 |
Pool |
新しいプールを作成するための仕様。 |
Public |
プールのネットワーク構成のパブリック IP アドレス構成。 |
Resource |
コンピューティング ノードにダウンロードする 1 つのファイルまたは複数のファイル。 |
Rolling |
ローリング アップグレードの実行中に使用される構成パラメーター。 |
Schedule |
ジョブが作成されるスケジュール。 すべての時刻は UTC にそれぞれ固定され、夏時間の影響を受けません。 |
Security |
マネージド ディスクの EncryptionType を指定します。 VMGuestState BLOB のみを暗号化する場合は VMGuestStateOnly に、VMGuestState BLOB にファームウェアの状態を保持しない場合は NonPersistedTPM に設定されます。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合に必要です。 |
Security |
仮想マシンまたは仮想マシン スケール セットのセキュリティ プロファイル設定を指定します。 |
Security |
仮想マシンの SecurityType を指定します。 UefiSettings を有効にするには、指定した値に設定する必要があります。 |
Service |
"最新" イメージ バージョンを使用する場合に、スケール セット内のすべての仮想マシンに同じイメージ バージョンを設定するために使用されるサービス 成果物参照 ID を指定します。 |
Start |
ノードが Azure Batch サービスのプールに参加したとき、またはコンピューティング ノードが再起動または再イメージ化されたときに実行されるタスク。 |
Storage |
データ ディスクまたは OS ディスクの作成に使用するストレージ アカウントの種類。 |
Task |
タスクに適用する実行制約。 |
Task |
タスクのコンテナー設定。 |
Task |
タスクをコンピューティング ノード間で分散する方法を指定します。 |
Uefi |
仮想マシンの作成時に使用されるセキュア ブートや vTPM などのセキュリティ設定を指定します。 |
Upgrade |
スケール セット内の仮想マシンへのアップグレード モードを指定します。 |
Upgrade |
アップグレード ポリシー (自動、手動、またはローリング) について説明します。 |
User |
Azure Batch コンピューティング ノードでタスクを実行するために使用するユーザーの作成に使用されるプロパティ。 |
User |
タスクを実行するユーザー ID の定義。 |
Virtual |
Azure Virtual Machines インフラストラクチャに基づくプール内のコンピューティング ノードの構成。 |
VMDisk |
マネージド ディスクのセキュリティ プロファイル設定を指定します。 注: 機密 VM に対してのみ設定でき、機密 VM を使用する場合に必要です。 |
VMExtension |
仮想マシン拡張機能の構成。 |
Windows |
仮想マシンに適用する Windows オペレーティング システムの設定。 |
Windows |
Windows コンピューティング ノードでユーザー アカウントを作成するために使用されるプロパティ。 |
AccessScope
トークンがアクセスを許可する Batch リソース。
名前 | 型 | 説明 |
---|---|---|
job |
string |
タスクを含むジョブに対するすべての操作を実行するためのアクセス権を付与します。 |
ApplicationPackageReference
コンピューティング ノードにデプロイするパッケージへの参照。
名前 | 型 | 説明 |
---|---|---|
applicationId |
string |
デプロイするアプリケーションの ID。 |
version |
string |
デプロイするアプリケーションのバージョン。 省略すると、既定のバージョンがデプロイされます。 |
AuthenticationTokenSettings
Batch サービス操作の実行にタスクが使用できる認証トークンの設定。
名前 | 型 | 説明 |
---|---|---|
access |
トークンがアクセスを許可する Batch リソース。 |
AutomaticOSUpgradePolicy
OS の自動アップグレードを実行するために使用される構成パラメーター。
名前 | 型 | 説明 |
---|---|---|
disableAutomaticRollback |
boolean |
OS イメージのロールバック機能を無効にする必要があるかどうか。 |
enableAutomaticOSUpgrade |
boolean |
新しいバージョンの OS イメージが使用可能になったときに、OS アップグレードをスケール セット インスタンスに自動的に適用するかどうかを示します。 |
osRollingUpgradeDeferral |
boolean |
タスクを実行している場合は、TVM の OS アップグレードを延期します。 |
useRollingUpgradePolicy |
boolean |
自動 OS アップグレード中にローリング アップグレード ポリシーを使用するかどうかを示します。 VMSS でポリシーが定義されていない場合、OS の自動アップグレードは既定のポリシーにフォールバックします。 |
AutoPoolSpecification
一時的な '自動プール' の特性を指定します。 Batch サービスは、ジョブの送信時にこの自動プールを作成します。
名前 | 型 | 説明 |
---|---|---|
autoPoolIdPrefix |
string |
プールが自動的に作成されるときに一意の識別子に追加されるプレフィックス。 |
keepAlive |
boolean |
自動プールの有効期間が切れた後も有効な状態を維持するかどうかを指定します。 |
pool |
自動プールのプール仕様。 |
|
poolLifetimeOption |
作成された自動プールの最小有効期間、およびスケジュール上の複数のジョブをプールに割り当てる方法。 |
AutoUserScope
自動ユーザーのスコープ
名前 | 型 | 説明 |
---|---|---|
pool |
string |
タスクが、プール内のすべてのコンピューティング ノードで作成される共通の自動ユーザー アカウントとして実行されるように指定します。 |
task |
string |
サービスがタスクの新しいユーザーを作成することを指定します。 |
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 |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
BatchError
Azure Batch サービスから受信したエラー応答。
名前 | 型 | 説明 |
---|---|---|
code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
message |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
|
values |
エラーに関する追加の詳細を含むキーと値のペアのコレクション。 |
BatchErrorDetail
Azure Batch エラー応答に含まれる追加情報の項目。
名前 | 型 | 説明 |
---|---|---|
key |
string |
Value プロパティの意味を指定する識別子。 |
value |
string |
エラー応答に含まれる追加情報。 |
CachingType
ディスクに対して有効にするキャッシュの種類。
名前 | 型 | 説明 |
---|---|---|
none |
string |
ディスクのキャッシュ モードが有効になっていません。 |
readonly |
string |
ディスクのキャッシュ モードは読み取り専用です。 |
readwrite |
string |
ディスクのキャッシュ モードは読み取りと書き込みです。 |
CertificateReference
プール内のコンピューティング ノードにインストールされる証明書への参照。
名前 | 型 | 説明 |
---|---|---|
storeLocation |
証明書をインストールするコンピューティング ノード上の証明書ストアの場所。 |
|
storeName |
string |
証明書をインストールするコンピューティング ノード上の証明書ストアの名前。 |
thumbprint |
string |
証明書の拇印。 |
thumbprintAlgorithm |
string |
拇印が関連付けられているアルゴリズム。 これは sha1 である必要があります。 |
visibility |
証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。 |
CertificateStoreLocation
証明書をインストールするコンピューティング ノード上の証明書ストアの場所。
名前 | 型 | 説明 |
---|---|---|
currentuser |
string |
証明書は CurrentUser 証明書ストアにインストールする必要があります。 |
localmachine |
string |
証明書は LocalMachine 証明書ストアにインストールする必要があります。 |
CertificateVisibility
証明書のプライベート データにアクセスできるコンピューティング ノード上のユーザー アカウント。
名前 | 型 | 説明 |
---|---|---|
remoteuser |
string |
証明書は、ユーザーがコンピューティング ノードにリモートでアクセスするユーザー アカウントに表示される必要があります。 |
starttask |
string |
証明書は、StartTask が実行されているユーザー アカウントに表示されます。 AutoUser スコープが StartTask と Task の両方のプールである場合、この証明書はタスクにも表示されることに注意してください。 |
task |
string |
証明書は、ジョブ タスクが実行されているユーザー アカウントに表示されます。 |
CIFSMountConfiguration
CIFS ファイル システムへの接続に使用される情報。
名前 | 型 | 説明 |
---|---|---|
mountOptions |
string |
mount コマンドに渡す追加のコマンド ライン オプション。 |
password |
string |
CIFS ファイル システムに対する認証に使用するパスワード。 |
relativeMountPath |
string |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
source |
string |
マウントするファイル システムの URI。 |
username |
string |
CIFS ファイル システムに対する認証に使用するユーザー。 |
ComputeNodeFillType
プール内のコンピューティング ノード間でタスクを分散する方法。
名前 | 型 | 説明 |
---|---|---|
pack |
string |
プール内の次のコンピューティング ノードにタスクが割り当てられる前に、できるだけ多くのタスク (taskSlotsPerNode) をプール内の各コンピューティング ノードに割り当てる必要があります。 |
spread |
string |
タスクは、プール内のすべてのコンピューティング ノードに均等に割り当てる必要があります。 |
ComputeNodeIdentityReference
コンピューティング ノードが使用する Batch プールに関連付けられているユーザー割り当て ID への参照。
名前 | 型 | 説明 |
---|---|---|
resourceId |
string |
ユーザー割り当て ID の ARM リソース ID。 |
ContainerConfiguration
コンテナーが有効なプールの構成。
名前 | 型 | 説明 |
---|---|---|
containerImageNames |
string[] |
コンテナー イメージ名のコレクション。 |
containerRegistries |
コンテナーをプルできる追加のプライベート レジストリ。 |
|
type |
使用するコンテナー テクノロジ。 |
ContainerHostBatchBindMountEntry
タスク コンテナーにマウントするパスとマウント モードのエントリ。
名前 | 型 | 説明 |
---|---|---|
isReadOnly |
boolean |
このソース パスを読み取り専用モードとしてマウントするかどうか。 既定値は false (読み取り/書き込みモード) です。 |
source |
コンテナー顧客にマウントするパスを選択できます。 |
ContainerHostDataPath
コンテナー タスクのコンテナーにマウントされるパス。
名前 | 型 | 説明 |
---|---|---|
Applications |
string |
アプリケーション パス。 |
JobPrep |
string |
ジョブ準備タスクのパス。 |
Shared |
string |
複数インスタンス のタスクがファイルを共有するためのパス。 |
Startup |
string |
開始タスクのパス。 |
Task |
string |
タスク パス。 |
VfsMounts |
string |
パスには、このノードにマウントされているすべての仮想ファイル システムが含まれています。 |
ContainerRegistry
プライベート コンテナー レジストリ。
名前 | 型 | 説明 |
---|---|---|
identityReference |
ユーザー名とパスワードではなく、Azure Container Registry へのアクセスに使用するユーザー割り当て ID への参照。 |
|
password |
string |
レジストリ サーバーにログインするためのパスワード。 |
registryServer |
string |
レジストリ URL。 |
username |
string |
レジストリ サーバーにログインするユーザー名。 |
ContainerType
使用するコンテナー テクノロジ。
名前 | 型 | 説明 |
---|---|---|
criCompatible |
string |
CRI ベースのテクノロジを使用して、コンテナーを起動します。 |
dockerCompatible |
string |
Docker と互換性のあるコンテナー テクノロジを使用して、コンテナーを起動します。 |
ContainerWorkingDirectory
コンテナータスク作業ディレクトリの場所。
名前 | 型 | 説明 |
---|---|---|
containerImageDefault |
string |
コンテナー イメージで定義されている作業ディレクトリを使用します。 このディレクトリには、Batch によってダウンロードされたリソース ファイルが含まれていないことに注意してください。 |
taskWorkingDirectory |
string |
Batch によって設定されたタスク リソース ファイルが含まれる標準の Batch サービスタスク作業ディレクトリを使用します。 |
DataDisk
プール内のコンピューティング ノードに関連付けられているデータ ディスクによって使用される設定。 接続されたデータ ディスクを使用する場合は、VM 内からディスクをマウントしてフォーマットして使用する必要があります。
名前 | 型 | 説明 |
---|---|---|
caching |
データ ディスクに対して有効にするキャッシュの種類。 |
|
diskSizeGB |
integer |
初期ディスク サイズ (ギガバイト単位)。 |
lun |
integer |
論理ユニット番号。 |
storageAccountType |
データ ディスクに使用するストレージ アカウントの種類。 |
DiffDiskPlacement
プール内のすべてのコンピューティング ノード (VM) のオペレーティング システム ディスクのエフェメラル ディスク配置を指定します。
名前 | 型 | 説明 |
---|---|---|
CacheDisk |
string |
エフェメラル OS ディスクは VM キャッシュに格納されます。 |
DiffDiskSettings
コンピューティング ノード (VM) によって使用されるオペレーティング システム ディスクのエフェメラル ディスク設定を指定します。
名前 | 型 | 説明 |
---|---|---|
placement |
プール内のすべての VM のオペレーティング システム ディスクのエフェメラル ディスクの配置を指定します。 |
DiskEncryptionConfiguration
プール内のコンピューティング ノードに適用されるディスク暗号化構成。 ディスク暗号化の構成は、Azure コンピューティング ギャラリー イメージで作成された Linux プールではサポートされていません。
名前 | 型 | 説明 |
---|---|---|
targets |
Batch Service がコンピューティング ノードで暗号化するディスク ターゲットの一覧。 |
DiskEncryptionTarget
Batch Service がコンピューティング ノードで暗号化するディスク ターゲットの一覧。
名前 | 型 | 説明 |
---|---|---|
osdisk |
string |
コンピューティング ノード上の OS ディスクは暗号化されます。 |
temporarydisk |
string |
コンピューティング ノード上の一時ディスクは暗号化されます。 Linux では、起動時に暗号化が行われると、この暗号化は他のパーティション (マウントされたデータ ディスク上のパーティションなど) に適用されます。 |
DynamicVNetAssignmentScope
動的 vnet 割り当てのスコープ。
名前 | 型 | 説明 |
---|---|---|
job |
string |
動的 VNet の割り当てはジョブごとに実行されます。 |
none |
string |
動的 VNet 割り当てが有効になっていません。 |
ElevationLevel
ユーザーの昇格レベル。
名前 | 型 | 説明 |
---|---|---|
admin |
string |
ユーザーは昇格されたアクセス権を持つユーザーであり、完全な管理者権限で動作します。 |
nonadmin |
string |
ユーザーは、昇格されたアクセス権を持たない標準ユーザーです。 |
EnvironmentSetting
タスク プロセスで設定する環境変数。
名前 | 型 | 説明 |
---|---|---|
name |
string |
環境変数の名前。 |
value |
string |
環境変数の値。 |
ErrorMessage
Azure Batch エラー応答で受信したエラー メッセージ。
名前 | 型 | 説明 |
---|---|---|
lang |
string |
エラー メッセージの言語コード |
value |
string |
メッセージのテキスト。 |
HttpHeader
HTTP ヘッダーの名前と値のペア
名前 | 型 | 説明 |
---|---|---|
name |
string |
出力ファイルのアップロード時に使用するヘッダーの大文字と小文字を区別しない名前 |
value |
string |
出力ファイルのアップロード中に使用するヘッダーの値 |
ImageReference
Azure Virtual Machines Marketplace イメージまたは Azure コンピューティング ギャラリー イメージへの参照。 Azure Batch によって検証されたすべての Azure Marketplace イメージ参照の一覧を取得するには、「サポートされているイメージの一覧表示」操作を参照してください。
名前 | 型 | 説明 |
---|---|---|
communityGalleryImageId |
string |
コミュニティ ギャラリー イメージの一意識別子 |
exactVersion |
string |
ノードの作成に使用されるプラットフォーム イメージまたはマーケットプレース イメージの特定のバージョン。 この読み取り専用フィールドは、プールの作成時に 'version' に指定された値が 'latest' の場合にのみ、'version' と異なります。 |
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 イメージのバージョン。 |
virtualMachineImageId |
string |
Azure コンピューティング ギャラリー イメージの ARM リソース識別子。 プール内のコンピューティング ノードは、このイメージ ID を使用して作成されます。これは、常に最新のイメージ バージョンに既定値を設定するために、/subscriptions/{subscriptionId}/resourceGroups/{resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} または /subscriptions/{subscriptionId}/resourceGroup}/providers/Microsoft.Compute/galleryName}/images/{imageDefinitionName} の形式です。 |
InboundEndpointProtocol
エンドポイントのプロトコル。
名前 | 型 | 説明 |
---|---|---|
tcp |
string |
エンドポイントには TCP を使用します。 |
udp |
string |
エンドポイントには UDP を使用します。 |
InboundNATPool
Batch プール内のコンピューティング ノード上の特定のポートを外部でアドレス指定するために使用できる受信 NAT プール。
名前 | 型 | 説明 |
---|---|---|
backendPort |
integer |
コンピューティング ノードのポート番号。 |
frontendPortRangeEnd |
integer |
個々のコンピューティング ノードの backendPort への受信アクセスを提供するために使用される外部ポートの範囲内の最後のポート番号。 |
frontendPortRangeStart |
integer |
個々のコンピューティング ノードの backendPort への受信アクセスを提供するために使用される外部ポートの範囲内の最初のポート番号。 |
name |
string |
エンドポイントの名前。 |
networkSecurityGroupRules |
エンドポイントに適用されるネットワーク セキュリティ グループ規則の一覧。 |
|
protocol |
エンドポイントのプロトコル。 |
IPAddressProvisioningType
プールのパブリック IP アドレスのプロビジョニングの種類。
名前 | 型 | 説明 |
---|---|---|
batchmanaged |
string |
パブリック IP は Batch によって作成および管理されます。 プールのサイズによっては、複数のパブリック IP が存在する場合があります。 |
nopublicipaddresses |
string |
パブリック IP アドレスは作成されません。 |
usermanaged |
string |
パブリック IP はユーザーによって提供され、コンピューティング ノードのプロビジョニングに使用されます。 |
JobConstraints
ジョブの実行制約。
名前 | 型 | 説明 |
---|---|---|
maxTaskRetryCount |
integer |
各タスクを再試行できる最大回数。 終了コードが 0 以外の場合、Batch サービスはタスクを再試行します。 |
maxWallClockTime |
string |
ジョブが実行される可能性がある最大経過時間。ジョブが作成された時刻から測定されます。 |
JobManagerTask
ジョブ マネージャー タスクの詳細を指定します。
名前 | 型 | 説明 |
---|---|---|
allowLowPriorityNode |
boolean |
ジョブ マネージャー タスクがスポット/優先順位の低いコンピューティング ノードで実行できるかどうかを示します。 |
applicationPackageReferences |
コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにデプロイするアプリケーション パッケージの一覧。 |
|
authenticationTokenSettings |
Batch サービス操作の実行にタスクが使用できる認証トークンの設定。 |
|
commandLine |
string |
ジョブ マネージャー タスクのコマンド ライン。 |
constraints |
ジョブ マネージャー タスクに適用される制約。 |
|
containerSettings |
ジョブ マネージャー タスクを実行するコンテナーの設定。 |
|
displayName |
string |
ジョブ マネージャー タスクの表示名。 |
environmentSettings |
ジョブ マネージャー タスクの環境変数設定の一覧。 |
|
id |
string |
ジョブ内のジョブ マネージャー タスクを一意に識別する文字列。 |
killJobOnCompletion |
boolean |
ジョブ マネージャー タスクの完了がジョブ全体の完了を示すかどうか。 |
outputFiles |
コマンド ラインの実行後に Batch サービスがコンピューティング ノードからアップロードするファイルの一覧。 |
|
requiredSlots |
integer |
タスクの実行に必要なスケジュール スロットの数。 |
resourceFiles |
コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 |
|
runExclusive |
boolean |
ジョブ マネージャー タスクが実行されるコンピューティング ノードを排他的に使用する必要があるかどうか。 |
userIdentity |
ジョブ マネージャー タスクを実行するユーザー ID。 |
JobNetworkConfiguration
ジョブのネットワーク構成。
名前 | 型 | 説明 |
---|---|---|
skipWithdrawFromVNet |
boolean |
ジョブが終了または削除されたときに、仮想ネットワークから DNC にコンピューティング ノードを取り消すかどうか。 |
subnetId |
string |
ジョブからタスクを実行しているコンピューティング ノードがタスクの期間中参加する仮想ネットワーク サブネットの ARM リソース識別子。 |
JobPreparationTask
特定のコンピューティング ノード上のジョブのタスクの前に実行するジョブ準備タスク。
名前 | 型 | 説明 |
---|---|---|
commandLine |
string |
ジョブ準備タスクのコマンド ライン。 |
constraints |
ジョブ準備タスクに適用される制約。 |
|
containerSettings |
ジョブ準備タスクを実行するコンテナーの設定。 |
|
environmentSettings |
ジョブ準備タスクの環境変数設定の一覧。 |
|
id |
string |
ジョブ内のジョブ準備タスクを一意に識別する文字列。 |
rerunOnNodeRebootAfterSuccess |
boolean |
コンピューティング ノードの再起動後に Batch サービスでジョブ準備タスクを再実行する必要があるかどうか。 |
resourceFiles |
コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 |
|
userIdentity |
ジョブ準備タスクを実行するユーザー ID。 |
|
waitForSuccess |
boolean |
Batch サービスがジョブ準備タスクが正常に完了するまで待機してから、コンピューティング ノード上のジョブの他のタスクをスケジュールするかどうかを指定します。 ジョブ準備タスクが終了コード 0 で終了すると、正常に完了しました。 |
JobReleaseTask
ジョブが実行されている任意のコンピューティング ノードでジョブの完了時に実行するジョブ解放タスク。
名前 | 型 | 説明 |
---|---|---|
commandLine |
string |
ジョブ解放タスクのコマンド ライン。 |
containerSettings |
ジョブ解放タスクを実行するコンテナーの設定。 |
|
environmentSettings |
ジョブ解放タスクの環境変数設定の一覧。 |
|
id |
string |
ジョブ内のジョブ解放タスクを一意に識別する文字列。 |
maxWallClockTime |
string |
特定のコンピューティング ノードでジョブ解放タスクを実行できる最大経過時間 。タスクの開始時から測定されます。 タスクが制限時間内に完了しない場合、Batch サービスによって終了されます。 既定値は 15 分です。 タイムアウトを 15 分より長く指定することはできません。 その場合、Batch サービスはエラーで拒否します。REST API を直接呼び出す場合、HTTP 状態コードは 400 (無効な要求) です。 |
resourceFiles |
コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 リソース ファイルの一覧には最大サイズがあります。 最大サイズを超えると、要求は失敗し、応答エラー コードは RequestEntityTooLarge になります。 この場合、ResourceFiles のコレクションのサイズを小さくする必要があります。 これは、.zip ファイル、アプリケーション パッケージ、または Docker コンテナーを使用して実現できます。 |
|
retentionTime |
string |
コンピューティング ノード上のジョブ リリース タスクの Task ディレクトリを保持する最小時間。 この時間が経過すると、Batch サービスは Task ディレクトリとそのすべての内容を削除できます。 |
userIdentity |
ジョブ解放タスクを実行するユーザー ID。 |
JobScheduleUpdateParameter
ジョブ スケジュールに対して行う一連の変更。
名前 | 型 | 説明 |
---|---|---|
jobSpecification |
このスケジュールで作成するジョブの詳細。 |
|
metadata |
ジョブ スケジュールにメタデータとして関連付けられている名前と値のペアの一覧。 |
|
schedule |
ジョブが作成されるスケジュール。 |
JobSpecification
スケジュールに従って作成するジョブの詳細を指定します。
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
allowTaskPreemption |
boolean |
このジョブのタスクを他の優先度の高いジョブに割り込むことができるかどうか |
|
commonEnvironmentSettings |
一般的な環境変数の設定の一覧。 これらの環境変数は、このスケジュールで作成されたジョブ内のすべてのタスク (ジョブ マネージャー、ジョブ準備タスク、ジョブ解放タスクを含む) に設定されます。 |
||
constraints |
このスケジュールで作成されたジョブの実行制約。 |
||
displayName |
string |
このスケジュールで作成されたジョブの表示名。 |
|
jobManagerTask |
このスケジュールでジョブが開始されたときに起動されるジョブ マネージャー タスクの詳細。 |
||
jobPreparationTask |
このスケジュールで作成されたジョブのジョブ準備タスク。 |
||
jobReleaseTask |
このスケジュールで作成されたジョブのジョブ解放タスク。 |
||
maxParallelTasks |
integer |
-1 |
ジョブに対して並列に実行できるタスクの最大数。 |
metadata |
このスケジュールでメタデータとして作成された各ジョブに関連付けられている名前と値のペアの一覧。 |
||
networkConfiguration |
ジョブのネットワーク構成。 |
||
onAllTasksComplete |
このスケジュールで作成されたジョブ内のすべてのタスクが完了状態の場合に、Batch サービスが実行する必要があるアクション。 |
||
onTaskFailure |
このスケジュールで作成されたジョブでタスクが失敗した場合に Batch サービスが実行する必要があるアクション。 タスクは、failureInfo がある場合に失敗したと見なされます。 failureInfo は、再試行回数を使い果たした後にタスクが 0 以外の終了コードで完了した場合、またはリソース ファイルのダウンロード エラーが原因でタスクの開始エラーが発生した場合に設定されます。 |
||
poolInfo |
Batch サービスがこのスケジュールで作成されたジョブのタスクを実行するプール。 |
||
priority |
integer |
このスケジュールで作成されたジョブの優先順位。 |
|
usesTaskDependencies |
boolean |
ジョブ内のタスクが相互に依存関係を定義できるかどうかを示します。 既定値は false です。 |
LinuxUserConfiguration
Linux コンピューティング ノードでユーザー アカウントを作成するために使用されるプロパティ。
名前 | 型 | 説明 |
---|---|---|
gid |
integer |
ユーザー アカウントのグループ ID。 |
sshPrivateKey |
string |
ユーザー アカウントの SSH 秘密キー。 |
uid |
integer |
ユーザー アカウントのユーザー ID。 |
LoginMode
ユーザーのログイン モード
名前 | 型 | 説明 |
---|---|---|
batch |
string |
LOGON32_LOGON_BATCH Win32 ログイン モード。 バッチ ログイン モードは、実行時間の長い並列プロセスに推奨されます。 |
interactive |
string |
LOGON32_LOGON_INTERACTIVE Win32 ログイン モード。 UAC は Windows プールで有効になっています。 このオプションを Windows プール内の昇格されたユーザー ID と共に使用する場合、タスク コマンド ラインによって実行されるアプリケーションが常に管理特権を必要とするか、常に最大特権を必要とするように構成されていない限り、ユーザー セッションは昇格されません。 |
ManagedDisk
名前 | 型 | 説明 |
---|---|---|
securityProfile |
マネージド ディスクのセキュリティ プロファイル設定を指定します。 |
|
storageAccountType |
マネージド ディスクのストレージ アカウントの種類。 |
MetadataItem
Batch サービス リソースに関連付けられている名前と値のペア。
名前 | 型 | 説明 |
---|---|---|
name |
string |
メタデータ項目の名前。 |
value |
string |
メタデータ項目の値。 |
MountConfiguration
各ノードにマウントするファイル システム。
名前 | 型 | 説明 |
---|---|---|
azureBlobFileSystemConfiguration |
各ノードで BLOB FUSE を使用してマウントする Azure Storage コンテナー。 |
|
azureFileShareConfiguration |
各ノードにマウントする Azure ファイル共有。 |
|
cifsMountConfiguration |
各ノードにマウントする CIFS/SMB ファイル システム。 |
|
nfsMountConfiguration |
各ノードにマウントする NFS ファイル システム。 |
NetworkConfiguration
プールのネットワーク構成。
名前 | 型 | 説明 |
---|---|---|
dynamicVNetAssignmentScope |
動的 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 |
このルールの優先順位。 |
sourceAddressPrefix |
string |
ルールに一致する送信元アドレスプレフィックスまたはタグ。 |
sourcePortRanges |
string[] |
規則に一致するソース ポートの範囲。 |
NetworkSecurityGroupRuleAccess
指定した IP アドレス、サブネット範囲、またはタグに対して実行する必要があるアクション。
名前 | 型 | 説明 |
---|---|---|
allow |
string |
アクセスを許可します。 |
deny |
string |
アクセスを拒否します。 |
NFSMountConfiguration
NFS ファイル システムへの接続に使用される情報。
名前 | 型 | 説明 |
---|---|---|
mountOptions |
string |
mount コマンドに渡す追加のコマンド ライン オプション。 |
relativeMountPath |
string |
ファイル システムがマウントされるコンピューティング ノード上の相対パス |
source |
string |
マウントするファイル システムの URI。 |
NodeCommunicationMode
プールが Batch サービスと通信する方法を決定します。
名前 | 型 | 説明 |
---|---|---|
classic |
string |
クラシック通信モードを使用するノードでは、"BatchNodeManagement" からのポート 29876 と 29877 の受信 TCP 通信が必要です。{region}" サービス タグとポート 443 の "Storage.region" および "BatchNodeManagement" への送信 TCP 通信。{region}" サービス タグ。 |
default |
string |
ノード通信モードは、Batch サービスによって自動的に設定されます。 |
simplified |
string |
簡略化された通信モードを使用するノードでは、ポート 443 で "BatchNodeManagement" への送信 TCP 通信が必要です。{region}" サービス タグ。 開いている受信ポートは必要ありません。 |
NodePlacementConfiguration
プールのノード配置構成。
名前 | 型 | 説明 |
---|---|---|
policy |
Batch プールでのノード配置ポリシーの種類。 |
NodePlacementPolicyType
プール内のノードを割り当てる配置ポリシー。
名前 | 型 | 説明 |
---|---|---|
regional |
string |
プール内のすべてのノードは、同じリージョンに割り当てられます。 |
zonal |
string |
プール内のノードは、ベスト エフォート分散によって異なる可用性ゾーンに分散されます。 |
OnAllTasksComplete
ジョブ内のすべてのタスクが完了状態のときに Batch サービスが実行する必要があるアクション。
名前 | 型 | 説明 |
---|---|---|
noaction |
string |
遊ぶ。 他の方法で終了または無効にしない限り、ジョブはアクティブなままです。 |
terminatejob |
string |
ジョブを終了します。 ジョブの terminateReason が 'AllTasksComplete' に設定されています。 |
OnTaskFailure
ジョブ内のタスクが失敗したときに Batch サービスが実行する必要があるアクション。
名前 | 型 | 説明 |
---|---|---|
noaction |
string |
遊ぶ。 他の方法で終了または無効にしない限り、ジョブはアクティブなままです。 |
performexitoptionsjobaction |
string |
Task の exitConditions コレクションの Task 終了条件に関連付けられているアクションを実行します。 (タスクで指定されている場合は、アクションが実行されない可能性があります)。 |
OSDisk
コンピューティング ノード (VM) のオペレーティング システム ディスクの設定。
名前 | 型 | 説明 |
---|---|---|
caching |
キャッシュ要件を指定します。 使用できる値は None、ReadOnly、ReadWrite です。 既定値は、Standard Storage の場合は [なし] です。 Premium Storage の ReadOnly。 |
|
diskSizeGB |
integer |
新しい OS ディスクを作成するときの初期ディスク サイズ (GB)。 |
ephemeralOSDiskSettings |
コンピューティング ノード (VM) によって使用されるオペレーティング システム ディスクのエフェメラル ディスク設定を指定します。 |
|
managedDisk |
マネージド ディスクのパラメーター。 |
|
writeAcceleratorEnabled |
boolean |
ディスクで writeAccelerator を有効または無効にするかどうかを指定します。 |
OutputFile
Batch サービスがタスク プロセスの実行を完了した後、Azure Batch コンピューティング ノードから別の場所にファイルをアップロードするための仕様。
名前 | 型 | 説明 |
---|---|---|
destination |
出力ファイルの宛先。 |
|
filePattern |
string |
アップロードするファイルを示すパターン。 |
uploadOptions |
アップロード操作の追加オプション (アップロードを実行する条件を含む)。 |
OutputFileBlobContainerDestination
Azure BLOB ストレージ コンテナー内のファイルアップロード先を指定します。
名前 | 型 | 説明 |
---|---|---|
containerUrl |
string |
ファイルのアップロード先となる Azure Blob Storage 内のコンテナーの URL。 |
identityReference |
containerUrl で指定された Azure Blob Storage へのアクセスに使用するユーザー割り当て ID への参照 |
|
path |
string |
Azure Storage コンテナー内の宛先 BLOB または仮想ディレクトリ。 |
uploadHeaders |
出力ファイルのアップロードに使用するヘッダーの名前と値のペアの一覧 |
OutputFileDestination
ファイルのアップロード先。
名前 | 型 | 説明 |
---|---|---|
container |
ファイルのアップロード先となる Azure BLOB ストレージ内の場所。 |
OutputFileUploadCondition
タスク出力ファイルまたは一連のファイルをアップロードする条件。
名前 | 型 | 説明 |
---|---|---|
taskcompletion |
string |
終了コードが何であったかにかかわらず、タスク プロセスが終了した後にファイルをアップロードします。 |
taskfailure |
string |
タスク プロセスが 0 以外の終了コードで終了した後にのみ、ファイルをアップロードします。 |
tasksuccess |
string |
タスク プロセスが終了コード 0 で終了した後にのみ、ファイルをアップロードします。 |
OutputFileUploadOptions
アップロードを実行する条件など、出力ファイルのアップロード操作に関する詳細。
名前 | 型 | 説明 |
---|---|---|
uploadCondition |
タスク出力ファイルまたは一連のファイルをアップロードする条件。 |
PoolEndpointConfiguration
プールのエンドポイント構成。
名前 | 型 | 説明 |
---|---|---|
inboundNATPools |
個々のコンピューティング ノード上の特定のポートを外部でアドレス指定するために使用できる受信 NAT プールの一覧。 |
PoolInformation
ジョブをプールに割り当てる方法を指定します。
名前 | 型 | 説明 |
---|---|---|
autoPoolSpecification |
一時的な '自動プール' の特性。 Batch サービスは、ジョブの送信時にこの自動プールを作成します。 |
|
poolId |
string |
既存のプールの ID。 ジョブのすべてのタスクは、指定されたプールで実行されます。 |
PoolLifetimeOption
作成された自動プールの最小有効期間、およびスケジュール上の複数のジョブをプールに割り当てる方法。
名前 | 型 | 説明 |
---|---|---|
job |
string |
プールは、専用のジョブの有効期間中存在します。 Batch サービスは、ジョブの作成時にプールを作成します。 "job" オプションがジョブ スケジュールに適用されている場合、Batch サービスは、スケジュールに従って作成されたすべてのジョブに対して新しい自動プールを作成します。 |
jobschedule |
string |
プールはジョブ スケジュールの有効期間中存在します。 Batch サービスは、スケジュールに基づいて最初のジョブを作成するときにプールを作成します。 このオプションは、ジョブ ではなくジョブ スケジュールにのみ適用できます。 |
PoolSpecification
新しいプールを作成するための仕様。
名前 | 型 | 説明 |
---|---|---|
applicationPackageReferences |
プール内の各コンピューティング ノードにインストールするパッケージの一覧。 |
|
autoScaleEvaluationInterval |
string |
自動スケールの数式に従ってプール のサイズを自動的に調整する時間間隔。 |
autoScaleFormula |
string |
プール内のコンピューティング ノードの目的の数の数式。 |
certificateReferences |
プール内の各コンピューティング ノードにインストールする証明書の一覧。 警告: このプロパティは非推奨であり、2024 年 2 月以降に削除されます。 代わりに、Azure KeyVault 拡張機能 を使用してください。 |
|
displayName |
string |
プールの表示名。 |
enableAutoScale |
boolean |
プール サイズが時間の経過と同時に自動的に調整されるかどうか。 |
enableInterNodeCommunication |
boolean |
プールがコンピューティング ノード間の直接通信を許可するかどうか。 |
metadata |
メタデータとしてプールに関連付けられている名前と値のペアの一覧。 |
|
mountConfiguration |
プール内の各ノードにマウントするファイル システムの一覧。 |
|
networkConfiguration |
プールのネットワーク構成。 |
|
resizeTimeout |
string |
プールへのコンピューティング ノードの割り当てのタイムアウト。 |
resourceTags |
object |
プールに関連付けられているユーザー指定のタグ。 |
startTask |
プールに参加する各コンピューティング ノードで実行するタスク。 タスクは、コンピューティング ノードがプールに追加されたとき、またはコンピューティング ノードが再起動されたときに実行されます。 |
|
targetDedicatedNodes |
integer |
プール内の専用コンピューティング ノードの必要な数。 |
targetLowPriorityNodes |
integer |
プール内のスポット/優先順位の低いコンピューティング ノードの目的の数。 |
targetNodeCommunicationMode |
プールの目的のノード通信モード。 |
|
taskSchedulingPolicy |
プール内のコンピューティング ノード間でタスクを分散する方法。 |
|
taskSlotsPerNode |
integer |
プール内の 1 つのコンピューティング ノードで同時実行タスクを実行するために使用できるタスク スロットの数。 |
upgradePolicy |
プールのアップグレード ポリシー。 |
|
userAccounts |
プール内の各コンピューティング ノードに作成するユーザー アカウントの一覧。 |
|
virtualMachineConfiguration |
プールの仮想マシン構成。 |
|
vmSize |
string |
プール内の仮想マシンのサイズ。 プール内のすべての仮想マシンのサイズは同じです。 |
PublicIPAddressConfiguration
プールのネットワーク構成のパブリック IP アドレス構成。
名前 | 型 | 説明 |
---|---|---|
ipAddressIds |
string[] |
Batch サービスがコンピューティング ノードのプロビジョニング時に使用するパブリック IP の一覧。 |
provision |
プールのパブリック IP アドレスのプロビジョニングの種類。 |
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 を考慮してください。 このフィールドは、NodePlacementConfiguration をゾーンとして使用する場合にのみ true または false に設定できます。 |
maxBatchInstancePercent |
integer |
1 回のバッチでのローリング アップグレードによって同時にアップグレードされる仮想マシン インスタンスの合計数に対する最大割合。 これは最大であるため、以前または将来のバッチの異常なインスタンスでは、信頼性を高めるためにバッチ内のインスタンスの割合が減少する可能性があります。 このフィールドの値は、5 ~ 100 の範囲にする必要があります。 maxBatchInstancePercent と maxUnhealthyInstancePercent の両方に値が割り当てられている場合、maxBatchInstancePercent の値は maxUnhealthyInstancePercent を超えてはなりません。 |
maxUnhealthyInstancePercent |
integer |
アップグレードの結果として、またはローリング アップグレードが中止される前に仮想マシンの正常性チェックによって異常な状態で検出された場合に、同時に異常になる可能性があるスケール セット内の仮想マシン インスタンスの合計数に対する最大割合。 この制約は、バッチを開始する前にチェックされます。 このフィールドの値は、5 ~ 100 の範囲にする必要があります。 maxBatchInstancePercent と maxUnhealthyInstancePercent の両方に値が割り当てられている場合、maxBatchInstancePercent の値は maxUnhealthyInstancePercent を超えてはなりません。 |
maxUnhealthyUpgradedInstancePercent |
integer |
異常な状態にあると検出できるアップグレードされた仮想マシン インスタンスの最大割合。 このチェックは、各バッチがアップグレードされた後に行われます。 この割合を超えた場合、ローリング アップデートは中止されます。 このフィールドの値は、0 ~ 100 の範囲にする必要があります。 |
pauseTimeBetweenBatches |
string |
すべての仮想マシンの更新を 1 つのバッチで完了してから次のバッチを開始するまでの待機時間。 期間は ISO 8601 形式で指定する必要があります。 |
prioritizeUnhealthyInstances |
boolean |
正常なインスタンスの前に、スケール セット内のすべての異常なインスタンスをアップグレードします。 |
rollbackFailedInstancesOnPolicyBreach |
boolean |
ローリング アップグレード ポリシーに違反した場合、失敗したインスタンスを以前のモデルにロールバックします。 |
Schedule
ジョブが作成されるスケジュール。 すべての時刻は UTC にそれぞれ固定され、夏時間の影響を受けません。
名前 | 型 | 説明 |
---|---|---|
doNotRunAfter |
string |
このジョブ スケジュールの下にジョブが作成されない時間。 スケジュールは、この期限が過ぎ、このジョブ スケジュールにアクティブなジョブがないとすぐに完了状態に移行します。 |
doNotRunUntil |
string |
このジョブ スケジュールでジョブを作成できる最も早い時刻。 |
recurrenceInterval |
string |
ジョブ スケジュールの下の 2 つの連続するジョブの開始時刻間の時間間隔。 ジョブ スケジュールには、任意の時点でアクティブなジョブを 1 つまで指定できます。 |
startWindow |
string |
スケジュールがジョブを作成する必要があることを示す時刻から開始する時間間隔。その中でジョブを作成する必要があります。 |
SecurityEncryptionTypes
マネージド ディスクの EncryptionType を指定します。 VMGuestState BLOB のみを暗号化する場合は VMGuestStateOnly に、VMGuestState BLOB にファームウェアの状態を保持しない場合は NonPersistedTPM に設定されます。 注: 機密 VM にのみ設定でき、機密 VM を使用する場合に必要です。
名前 | 型 | 説明 |
---|---|---|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
SecurityProfile
仮想マシンまたは仮想マシン スケール セットのセキュリティ プロファイル設定を指定します。
名前 | 型 | 説明 |
---|---|---|
encryptionAtHost |
boolean |
このプロパティは、要求のユーザーが仮想マシンまたは仮想マシン スケール セットの Host Encryption を有効または無効にするために使用できます。 これにより、ホスト自体のリソース/一時ディスクを含むすべてのディスクの暗号化が有効になります。 ホスト要件での暗号化の詳細については、https://learn.microsoft.com/azure/virtual-machines/disk-encryption#supported-vm-sizesを参照してください。 |
securityType |
仮想マシンの SecurityType を指定します。 UefiSettings を有効にするには、指定した値に設定する必要があります。 |
|
uefiSettings |
仮想マシンの作成時に使用されるセキュア ブートや vTPM などのセキュリティ設定を指定します。 |
SecurityTypes
仮想マシンの SecurityType を指定します。 UefiSettings を有効にするには、指定した値に設定する必要があります。
名前 | 型 | 説明 |
---|---|---|
confidentialVM |
string |
Azure コンフィデンシャル コンピューティングは、セキュリティと機密性の高い要件を持つテナント向けの機密 VM を提供します。 これらの VM は、セキュリティ ニーズを満たすのに役立つ強力なハードウェア強制境界を提供します。 コードを変更することなく、機密 VM を移行に使用できます。プラットフォームを使用すると、VM の状態が読み取られたり変更されたりするのを防いでいます。 |
trustedLaunch |
string |
信頼できる起動は、高度で永続的な攻撃手法から保護します。 |
ServiceArtifactReference
"最新" イメージ バージョンを使用する場合に、スケール セット内のすべての仮想マシンに同じイメージ バージョンを設定するために使用されるサービス 成果物参照 ID を指定します。
名前 | 型 | 説明 |
---|---|---|
id |
string |
ServiceArtifactReference のサービス 成果物参照 ID |
StartTask
ノードが Azure Batch サービスのプールに参加したとき、またはコンピューティング ノードが再起動または再イメージ化されたときに実行されるタスク。
名前 | 型 | 説明 |
---|---|---|
commandLine |
string |
StartTask のコマンド ライン。 |
containerSettings |
StartTask を実行するコンテナーの設定。 |
|
environmentSettings |
StartTask の環境変数設定の一覧。 |
|
maxTaskRetryCount |
integer |
タスクを再試行できる最大回数。 |
resourceFiles |
コマンド ラインを実行する前に Batch サービスがコンピューティング ノードにダウンロードするファイルの一覧。 リソース ファイルの一覧には最大サイズがあります。 最大サイズを超えると、要求は失敗し、応答エラー コードは RequestEntityTooLarge になります。 この場合、ResourceFiles のコレクションのサイズを小さくする必要があります。 これは、.zip ファイル、アプリケーション パッケージ、または Docker コンテナーを使用して実現できます。 |
|
userIdentity |
StartTask を実行するユーザー ID。 |
|
waitForSuccess |
boolean |
コンピューティング ノードでタスクをスケジュールする前に、Batch サービスが StartTask が正常に完了するまで (つまり、終了コード 0 で終了する) のを待つ必要があるかどうか。 |
StorageAccountType
データ ディスクまたは OS ディスクの作成に使用するストレージ アカウントの種類。
名前 | 型 | 説明 |
---|---|---|
premium_lrs |
string |
データ ディスク/OS ディスクでは、Premium ローカル冗長ストレージを使用する必要があります。 |
standard_lrs |
string |
データ ディスク/OS ディスクでは、標準のローカル冗長ストレージを使用する必要があります。 |
standardssd_lrs |
string |
データ ディスク/OS ディスクでは、Standard SSD のローカル冗長ストレージを使用する必要があります。 |
TaskConstraints
タスクに適用する実行制約。
名前 | 型 | 説明 |
---|---|---|
maxTaskRetryCount |
integer |
タスクを再試行できる最大回数。 終了コードが 0 以外の場合、Batch サービスはタスクを再試行します。 |
maxWallClockTime |
string |
タスクが実行できる最大経過時間。タスクの開始時間から測定されます。 タスクが制限時間内に完了しない場合、Batch サービスによって終了されます。 |
retentionTime |
string |
実行が完了した時点から、実行されたコンピューティング ノードに Task ディレクトリを保持するための最小時間。 この時間が経過すると、Batch サービスは Task ディレクトリとそのすべての内容を削除できます。 |
TaskContainerSettings
タスクのコンテナー設定。
名前 | 型 | 説明 |
---|---|---|
containerHostBatchBindMounts |
コンテナー タスクにマウントするパス。 |
|
containerRunOptions |
string |
コンテナー作成コマンドの追加オプション。 |
imageName |
string |
タスクを実行するコンテナーの作成に使用するイメージ。 |
registry |
コンテナー イメージを含むプライベート レジストリ。 |
|
workingDirectory |
コンテナータスク作業ディレクトリの場所。 |
TaskSchedulingPolicy
タスクをコンピューティング ノード間で分散する方法を指定します。
名前 | 型 | 説明 |
---|---|---|
nodeFillType |
プール内のコンピューティング ノード間でタスクを分散する方法。 |
UefiSettings
仮想マシンの作成時に使用されるセキュア ブートや vTPM などのセキュリティ設定を指定します。
名前 | 型 | 説明 |
---|---|---|
secureBootEnabled |
boolean |
仮想マシンでセキュア ブートを有効にするかどうかを指定します。 |
vTpmEnabled |
boolean |
仮想マシンで vTPM を有効にするかどうかを指定します。 |
UpgradeMode
スケール セット内の仮想マシンへのアップグレード モードを指定します。
使用可能な値は次のとおりです。
手動 - スケール セット内の仮想マシンへの更新プログラムの適用を制御します。 これを行うには、manualUpgrade アクションを使用します。
自動 - スケール セット内のすべての仮想マシンが同時に自動的に更新されます。
ローリング - スケール セットは、必要に応じて一時停止時間の間にバッチで更新を実行します。
名前 | 型 | 説明 |
---|---|---|
automatic |
string |
スケール セット内のすべての仮想マシンが同時に自動的に更新されます。 |
manual |
string |
スケール セット内の仮想マシンへの更新プログラムの適用を制御します。 これを行うには、manualUpgrade アクションを使用します。 |
rolling |
string |
スケール セット内の既存のインスタンスは、アップグレードするバッチでダウンします。 アップグレードされたバッチが完了すると、インスタンスはトラフィックの取得を再開し、次のバッチが開始されます。 これは、すべてのインスタンスが -date を up-toするまで続けられます。 |
UpgradePolicy
アップグレード ポリシー (自動、手動、またはローリング) について説明します。
名前 | 型 | 説明 |
---|---|---|
automaticOSUpgradePolicy |
OS の自動アップグレードを実行するために使用される構成パラメーター。 |
|
mode |
スケール セット内の仮想マシンへのアップグレード モードを指定します。 |
|
rollingUpgradePolicy |
ローリング アップグレードの実行中に使用される構成パラメーター。 |
UserAccount
Azure Batch コンピューティング ノードでタスクを実行するために使用するユーザーの作成に使用されるプロパティ。
名前 | 型 | 説明 |
---|---|---|
elevationLevel |
ユーザー アカウントの昇格レベル。 |
|
linuxUserConfiguration |
ユーザー アカウントの Linux 固有のユーザー構成。 |
|
name |
string |
ユーザー アカウントの名前。 名前には、最大 20 文字までの Unicode 文字を含めることができます。 |
password |
string |
ユーザー アカウントのパスワード。 |
windowsUserConfiguration |
ユーザー アカウントの Windows 固有のユーザー構成。 |
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 |
ユーザーのログイン モード |