Pools - Evaluate Pool Auto Scale

Szolgáltatás:: Batch Service

API-verzió:: 2025-06-01

Lekéri a készlet automatikus méretezési képletének kiértékelésének eredményét.
Ez az API elsősorban egy automatikus skálázási képlet ellenőrzésére szolgál, mivel egyszerűen visszaadja az eredményt anélkül, hogy a képletet a készletre alkalmazták volna. A készletnek engedélyeznie kell az automatikus skálázást egy képlet kiértékeléséhez.

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

Opcionális paraméterekkel:

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
endpoint	path	True	string (uri)	Batch-fiók végpontja (például: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	Az automatikus skálázási képlet értékelésére szolgáló Pool azonosítója.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.
timeOut	query		integer (int32)	A kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor az alapértelmezett értéket használják helyette.".

Kérelem fejléce

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

Name	Típus	Description
client-request-id	string	A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.
ocp-date	string (date-time-rfc7231)	A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha közvetlenül a REST API-t hívja meg.

Kérelem törzse

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

Name	Kötelező	Típus	Description
autoScaleFormula	True	string	A készletben lévő számítási csomópontok kívánt számának képlete. A képletet validálják és az eredményeit kiszámítják, de nem alkalmazzák a Poolra. A képlet alkalmazásához a Poolra a 'Automatikus skálázás engedélyezése egy Poolon'. További információért a formula meghatározásáról lásd: Automatikus számítási csomópontok egy Azure Batch Poolban (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

Válaszok

Name	Típus	Description
200 OK	AutoScaleRun	A kérés sikeres volt. Fejlécek DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Váratlan hibaválasz.

Name

Típus

Description

200 OK

AutoScaleRun

A kérés sikeres volt.

Fejlécek

DataServiceId: string
ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Váratlan hibaválasz.

Biztonság

OAuth2Auth

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Hatókörök

Name	Description
https://batch.core.windows.net//.default

Példák

Pool evaluate autoscale

Mintakérelem

HTTP

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



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

Mintaválasz

Állapotkód:: 200

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

Definíciók

Name	Description
AutoScaleRun	A készlet automatikus skálázási képletének végrehajtásából származó eredmények és hibák.
AutoScaleRunError	Hiba történt egy készlet automatikus skálázási képletének végrehajtásakor vagy kiértékelésekor.
BatchError	Az Azure Batch szolgáltatástól kapott hibaválasz.
BatchErrorDetail	Az Azure Batch-hibaválaszban szereplő további információk egy eleme.
BatchErrorMessage	Hibaüzenet érkezett egy Azure Batch-hibaválaszban.
BatchPoolEvaluateAutoScaleOptions	Az automatikus skálázási képlet kiértékelésére szolgáló paraméterek egy Azure Batch-készleten.
NameValuePair	Név-érték párokat jelöl.

AutoScaleRun

Tárgy

A készlet automatikus skálázási képletének végrehajtásából származó eredmények és hibák.

Name	Típus	Description
error	AutoScaleRunError	A hiba részletei a Poolon az automatikus skálázási képlet értékelésekor történtek, ha az értékelés sikertelen volt.
results	string	Az automatikus skálázási képlet kiértékelése során használt összes változó végső értékei. Az egyes változóértékek $variable=érték formában jelennek meg, a változókat pedig pontosvesszők választják el egymástól.
timestamp	string (date-time)	Az automatikus skálázási képlet utolsó kiértékelésének időpontja.

AutoScaleRunError

Tárgy

Hiba történt egy készlet automatikus skálázási képletének végrehajtásakor vagy kiértékelésekor.

Name	Típus	Description
code	string	Az automatikus skálázási hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	string	Egy üzenet, amely az automatikus skálázási hibát írja le, és alkalmas felhasználói felületen való megjelenítésre.
values	NameValuePair[]	Az automatikus skálázási hibához kapcsolódó további hibarészletek listája.

BatchError

Tárgy

Az Azure Batch szolgáltatástól kapott hibaválasz.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	BatchErrorMessage	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
values	BatchErrorDetail[]	Kulcs-érték párok gyűjteménye, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

Tárgy

Az Azure Batch-hibaválaszban szereplő további információk egy eleme.

Name	Típus	Description
key	string	Az Érték tulajdonság jelentését meghatározó azonosító.
value	string	A hibaválasz további információi.

BatchErrorMessage

Tárgy

Hibaüzenet érkezett egy Azure Batch-hibaválaszban.

Name	Típus	Description
lang	string	A hibaüzenet nyelvkódja.
value	string	Az üzenet szövege.

BatchPoolEvaluateAutoScaleOptions

Tárgy

Az automatikus skálázási képlet kiértékelésére szolgáló paraméterek egy Azure Batch-készleten.

Name	Típus	Description
autoScaleFormula	string	A készletben lévő számítási csomópontok kívánt számának képlete. A képletet validálják és az eredményeit kiszámítják, de nem alkalmazzák a Poolra. A képlet alkalmazásához a Poolra a 'Automatikus skálázás engedélyezése egy Poolon'. További információért a formula meghatározásáról lásd: Automatikus számítási csomópontok egy Azure Batch Poolban (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

NameValuePair

Tárgy

Név-érték párokat jelöl.

Name	Típus	Description
name	string	A név a név-érték párban.
value	string	Az érték a név-érték párban.