次の方法で共有


Compute Node - Reboot

指定したコンピューティング ノードを再起動します。
コンピューティング ノードは、アイドル状態または実行中の状態の場合にのみ再起動できます。

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2024-07-01.20.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?timeout={timeout}&api-version=2024-07-01.20.0

URI パラメーター

名前 / 必須 説明
batchUrl
path True

string

すべての Azure Batch サービス要求のベース URL。

nodeId
path True

string

再起動するコンピューティング ノードの ID。

poolId
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 を直接呼び出す場合は、明示的に設定します。

要求本文

Media Types: "application/json; odata=minimalmetadata"

名前 説明
nodeRebootOption

ComputeNodeRebootOption

コンピューティング ノードを再起動するタイミングと、現在実行中のタスクの操作。
既定値は requeue です。

応答

名前 説明
202 Accepted

Batch サービスへの要求が成功しました。

ヘッダー

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

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 reboot

要求のサンプル

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reboot?api-version=2024-07-01.20.0



{
  "nodeRebootOption": "terminate"
}

応答のサンプル

定義

名前 説明
BatchError

Azure Batch サービスから受信したエラー応答。

BatchErrorDetail

Azure Batch エラー応答に含まれる追加情報の項目。

ComputeNodeRebootOption

コンピューティング ノードを再起動するタイミングと、現在実行中のタスクの操作。

ErrorMessage

Azure Batch エラー応答で受信したエラー メッセージ。

NodeRebootParameter

コンピューティング ノードを再起動するためのオプション。

BatchError

Azure Batch サービスから受信したエラー応答。

名前 説明
code

string

エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。

message

ErrorMessage

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

values

BatchErrorDetail[]

エラーに関する追加の詳細を含むキーと値のペアのコレクション。

BatchErrorDetail

Azure Batch エラー応答に含まれる追加情報の項目。

名前 説明
key

string

Value プロパティの意味を指定する識別子。

value

string

エラー応答に含まれる追加情報。

ComputeNodeRebootOption

コンピューティング ノードを再起動するタイミングと、現在実行中のタスクの操作。

説明
requeue

実行中のタスク プロセスを終了し、タスクを再キューします。 コンピューティング ノードが使用可能になると、タスクが再度実行されます。 タスクが終了したらすぐにコンピューティング ノードを再起動します。

retaineddata

現在実行中のタスクの完了を許可し、すべてのタスク データ保有期間の有効期限が切れるのを待ちます。 待機中に新しいタスクをスケジュールしません。 すべてのタスクのリテンション期間が経過したら、コンピューティング ノードを再起動します。

taskcompletion

現在実行中のタスクの完了を許可します。 待機中に新しいタスクをスケジュールしません。 すべてのタスクが完了したら、コンピューティング ノードを再起動します。

terminate

実行中のタスクを終了します。 タスクは、終了されたことを示す failureInfo で完了し、もう一度実行されません。 タスクが終了したらすぐにコンピューティング ノードを再起動します。

ErrorMessage

Azure Batch エラー応答で受信したエラー メッセージ。

名前 説明
lang

string

エラー メッセージの言語コード

value

string

メッセージのテキスト。

NodeRebootParameter

コンピューティング ノードを再起動するためのオプション。

名前 説明
nodeRebootOption

ComputeNodeRebootOption

コンピューティング ノードを再起動するタイミングと、現在実行中のタスクの操作。
既定値は requeue です。