Pools - Evaluate Pool Auto Scale

サービス:

Batch Service

API バージョン:

2025-06-01

プールで自動スケーリング式を評価した結果を取得します。
この API は、プールに数式を適用せずに結果を返すだけなので、主に自動スケール式を検証するための API です。 数式を評価するには、プールで自動スケーリングが有効になっている必要があります。

POST {endpoint}/pools/{poolId}/evaluateautoscale?api-version=2025-06-01

省略可能なパラメーターを含む:

POST {endpoint}/pools/{poolId}/evaluateautoscale?api-version=2025-06-01&timeOut={timeOut}

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string (uri)	Batch アカウント エンドポイント (例: https://batchaccount.eastus2.batch.azure.com)。
poolId	path	True	string	自動スケーリング式を評価するためのプールのIDです。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。
timeOut	query		integer (int32)	サーバーが要求の処理に費やすことができる最大時間 (秒単位)。 既定値は 30 秒です。 値が30より大きい場合は、デフォルトが使われます。」

要求ヘッダー

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

名前	必須	型	説明
client-request-id		string	呼び出し元によって生成された要求 ID。中かっこなどの装飾のない GUID の形式 (例: 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0)。
return-client-request-id		boolean	サーバーが応答で client-request-id を返す必要があるかどうか。
ocp-date		string (date-time-rfc7231)	要求が発行された時刻。 通常、クライアント ライブラリはこれを現在のシステム クロック時間に設定します。REST API を直接呼び出す場合は、明示的に設定します。

要求本文

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

名前	必須	型	説明
autoScaleFormula	True	string	プール内のコンピューティング ノードの目的の数の数式。 式は検証され結果が計算されますが、プールには適用されません。 この式をプールに適用するには、「プールの自動スケーリングを有効にする」と入力してください。 この式の仕様については、「Azure Batch Pool(https://learn.microsoft.com/azure/batch/batch-automatic-scaling)におけるCompute Nodesを自動的にスケールさせる」をご覧ください。

応答

名前	型	説明
200 OK	AutoScaleRun	要求は成功しました。 ヘッダー DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	予期しないエラー応答。

セキュリティ

OAuth2Auth

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/v2.0/authorize

スコープ

名前	説明
https://batch.core.windows.net//.default

例

Pool evaluate autoscale

要求のサンプル

HTTP

POST {endpoint}/pools/poolId/evaluateautoscale?api-version=2025-06-01



{
  "autoScaleFormula": "$TargetDedicated=1"
}

応答のサンプル

状態コード:

200

{
  "timestamp": "2025-11-22T19:39:28.5246331Z",
  "results": "$TargetDedicated=1;$NodeDeallocationOption=requeue"
}

定義

名前	説明
AutoScaleRun	プールの自動スケール式の実行の結果とエラー。
AutoScaleRunError	プールの自動スケール式を実行または評価するときに発生したエラー。
BatchError	Azure Batch サービスから受信したエラー応答。
BatchErrorDetail	Azure Batch エラー応答に含まれる追加情報の項目。
BatchErrorMessage	Azure Batch エラー応答で受信したエラー メッセージ。
BatchPoolEvaluateAutoScaleOptions	Azure Batch プールで自動スケーリング式を評価するためのパラメーター。
NameValuePair	名前と値のペアを表します。

AutoScaleRun

Object

プールの自動スケール式の実行の結果とエラー。

名前	型	説明
error	AutoScaleRunError	評価が失敗した場合、プール上でオートスケール式を評価する際に発生したエラーの詳細。
results	string	自動スケール式の評価で使用されるすべての変数の最終的な値。 各変数値は $variable=value の形式で返され、変数はセミコロンで区切られます。
timestamp	string (date-time)	自動スケール式が最後に評価された時刻。

AutoScaleRunError

Object

プールの自動スケール式を実行または評価するときに発生したエラー。

名前	型	説明
code	string	自動スケールエラーの識別子です。 コードは不変であり、プログラムで使用することを目的としています。
message	string	ユーザーインターフェースでの表示に適した自動スケールエラーを説明するメッセージです。
values	NameValuePair[]	自動スケールエラーに関連する追加のエラー詳細のリスト。

BatchError

Object

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

名前	型	説明
code	string	エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。
message	BatchErrorMessage	ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。
values	BatchErrorDetail[]	エラーに関する追加の詳細を含むキーと値のペアのコレクション。

BatchErrorDetail

Object

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

名前	型	説明
key	string	Value プロパティの意味を指定する識別子。
value	string	エラー応答に含まれる追加情報。

BatchErrorMessage

Object

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

名前	型	説明
lang	string	エラーメッセージの言語コード。
value	string	メッセージのテキスト。

BatchPoolEvaluateAutoScaleOptions

Object

Azure Batch プールで自動スケーリング式を評価するためのパラメーター。

名前	型	説明
autoScaleFormula	string	プール内のコンピューティング ノードの目的の数の数式。 式は検証され結果が計算されますが、プールには適用されません。 この式をプールに適用するには、「プールの自動スケーリングを有効にする」と入力してください。 この式の仕様については、「Azure Batch Pool(https://learn.microsoft.com/azure/batch/batch-automatic-scaling)におけるCompute Nodesを自動的にスケールさせる」をご覧ください。

NameValuePair

Object

名前と値のペアを表します。

名前	型	説明
name	string	名前と値の組み合わせに入っている名前。
value	string	名前と値のペアの価値です。