Compute Node - Disable Scheduling
指定したコンピューティング ノードでタスク スケジュールを無効にします。
コンピューティング ノードでタスク スケジュールを無効にできるのは、現在のスケジュール状態が有効になっている場合のみです。
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/disablescheduling?api-version=2023-11-01.18.0POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/disablescheduling?timeout={timeout}&api-version=2023-11-01.18.0URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
batch
|
path | True |
string |
すべてのAzure Batchサービス要求のベース URL。 |
|
node
|
path | True |
string |
タスクのスケジュール設定を無効にするコンピューティング ノードの ID。 |
|
pool
|
path | True |
string |
コンピューティング ノードを含むプールの ID。 |
|
api-version
|
query | True |
string |
クライアント API のバージョン。 |
|
timeout
|
query |
integer int32 |
サーバーが要求の処理に費やすことができる最大時間 (秒単位)。 既定値は 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 を直接呼び出す場合は、明示的に設定します。 |
要求本文
Media Types: "application/json; odata=minimalmetadata"
| 名前 | 型 | 説明 |
|---|---|---|
| nodeDisableSchedulingOption |
コンピューティング ノードでタスク スケジュールを無効にするときの現在実行中のタスクの操作。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 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
例
Node disable scheduling
要求のサンプル
POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/disablescheduling?api-version=2023-11-01.18.0
{
"nodeDisableSchedulingOption": "terminate"
}
応答のサンプル
定義
| 名前 | 説明 |
|---|---|
|
Batch |
Azure Batch サービスから受信したエラー応答。 |
|
Batch |
Azure Batchエラー応答に含まれる追加情報の項目。 |
|
Disable |
コンピューティング ノードでタスク スケジュールを無効にするときの現在実行中のタスクの操作。 |
|
Error |
Azure Batchエラー応答で受信したエラー メッセージ。 |
|
Node |
コンピューティング ノードでスケジュールを無効にするオプション。 |
BatchError
Azure Batch サービスから受信したエラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。 |
| message |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
|
| values |
エラーに関する追加の詳細を含むキーと値のペアのコレクション。 |
BatchErrorDetail
Azure Batchエラー応答に含まれる追加情報の項目。
| 名前 | 型 | 説明 |
|---|---|---|
| key |
string |
Value プロパティの意味を指定する識別子。 |
| value |
string |
エラー応答に含まれる追加情報。 |
DisableComputeNodeSchedulingOption
コンピューティング ノードでタスク スケジュールを無効にするときの現在実行中のタスクの操作。
| 名前 | 型 | 説明 |
|---|---|---|
| requeue |
string |
実行中のタスク プロセスを終了し、タスクを再度キューに入れ直します。 タスクは、他のコンピューティング ノードで再度実行することも、このコンピューティング ノードでタスクのスケジュール設定が再度有効になっている場合にも実行できます。 タスクが終了するとすぐにオフライン状態になります。 |
| taskcompletion |
string |
現在実行中のタスクの完了を許可します。 待機中に新しいタスクをスケジュールしません。 すべてのタスクが完了したら、オフライン状態になります。 |
| terminate |
string |
実行中のタスクを終了します。 タスクは、終了されたことを示す failureInfo で完了し、再度実行されません。 タスクが終了するとすぐにオフライン状態になります。 |
ErrorMessage
Azure Batchエラー応答で受信したエラー メッセージ。
| 名前 | 型 | 説明 |
|---|---|---|
| lang |
string |
エラー メッセージの言語コード |
| value |
string |
メッセージのテキストです。 |
NodeDisableSchedulingParameter
コンピューティング ノードでスケジュールを無効にするオプション。
| 名前 | 型 | 説明 |
|---|---|---|
| nodeDisableSchedulingOption |
コンピューティング ノードでタスク スケジュールを無効にするときの現在実行中のタスクの操作。 |