Pools - Enable Pool Auto Scale

Szolgáltatás:: Batch Service

API-verzió:: 2025-06-01

Engedélyezi a készlet automatikus skálázását.
Ha a készleten átméretezési művelet van folyamatban, nem engedélyezheti az automatikus skálázást a készleten. Ha a készlet automatikus méretezése jelenleg le van tiltva, a kérés részeként meg kell adnia egy érvényes automatikus méretezési képletet. Ha a készlet automatikus méretezése már engedélyezve van, megadhat egy új automatikus skálázási képletet és/vagy egy új kiértékelési időközt. Ezt az API-t nem hívhatja meg 30 másodpercenként többször ugyanarra a készletre.

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

Opcionális paraméterekkel:

POST {endpoint}/pools/{poolId}/enableautoscale?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	A lekérendő készlet 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.
If-Modified-Since	string (date-time-rfc7231)	Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta módosult.
If-Unmodified-Since	string (date-time-rfc7231)	Az ügyfél által ismert erőforrás utolsó módosítási idejét jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás a megadott időpont óta nem módosult.
If-Match	string	Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban pontosan megegyezik az ügyfél által megadott értékkel.
If-None-Match	string	Az ügyfél által ismert erőforrás verziójához társított ETag-érték. A művelet csak akkor lesz végrehajtva, ha az erőforrás aktuális ETagje a szolgáltatásban nem egyezik meg az ügyfél által megadott értékkel.

Kérelem törzse

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

Name	Típus	Description
autoScaleEvaluationInterval	string (duration)	Az az időintervallum, amellyel automatikusan módosíthatja a készlet méretét az automatikus skálázási képletnek megfelelően. Az alapértelmezett érték 15 perc. A minimális és a maximális érték 5 perc, illetve 168 óra. Ha 5 percnél rövidebb vagy 168 óránál hosszabb értéket ad meg, a Batch szolgáltatás érvénytelen tulajdonságérték-hibával utasítja el a kérelmet; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Ha új intervallumot adsz be, akkor a meglévő automatikus méretezési értékelési ütemtervet leállítják, és új automatikus méretezési ütemtervet indítunk, amelynek kezdeti ideje az időpont, amikor ezt a kérelmet kiadták. Az időtartam ISO 8601 formátumban van megadva.
autoScaleFormula	string	A készletben lévő számítási csomópontok kívánt számának képlete. Az alapértelmezett érték 15 perc. A minimális és a maximális érték 5 perc, illetve 168 óra. Ha 5 percnél rövidebb vagy 168 óránál hosszabb értéket ad meg, a Batch szolgáltatás érvénytelen tulajdonságérték-hibával utasítja el a kérelmet; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Ha új intervallumot adsz be, akkor a meglévő automatikus méretezési értékelési ütemtervet leállítják, és új automatikus méretezési ütemtervet indítunk, amelynek kezdeti ideje az időpont, amikor ezt a kérelmet kiadták.

Válaszok

Name	Típus	Description
200 OK		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

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 enable autoscale

Mintakérelem

HTTP

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



{
  "autoScaleFormula": "$TargetDedicated=0",
  "autoScaleEvaluationInterval": "PT8M"
}

Mintaválasz

Állapotkód:: 200

Definíciók

Name	Description
BatchError	Hibaválasz érkezett az Azure Batch szolgáltatástól.
BatchErrorDetail	Egy további információ egy Azure Batch hibaválaszban található.
BatchErrorMessage	Egy hibaüzenet, amelyet Azure Batch hibaválaszban kaptak.
BatchPoolEnableAutoScaleOptions	Paraméterek az automatikus skálázás engedélyezéséhez egy Azure Batch Pool-on.

BatchError

Tárgy

Hibaválasz érkezett az Azure Batch szolgáltatástól.

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

Egy további információ egy Azure Batch hibaválaszban található.

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

Egy hibaüzenet, amelyet Azure Batch hibaválaszban kaptak.

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

BatchPoolEnableAutoScaleOptions

Tárgy

Paraméterek az automatikus skálázás engedélyezéséhez egy Azure Batch Pool-on.

Name	Típus	Description
autoScaleEvaluationInterval	string (duration)	Az az időintervallum, amellyel automatikusan módosíthatja a készlet méretét az automatikus skálázási képletnek megfelelően. Az alapértelmezett érték 15 perc. A minimális és a maximális érték 5 perc, illetve 168 óra. Ha 5 percnél rövidebb vagy 168 óránál hosszabb értéket ad meg, a Batch szolgáltatás érvénytelen tulajdonságérték-hibával utasítja el a kérelmet; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Ha új intervallumot adsz be, akkor a meglévő automatikus méretezési értékelési ütemtervet leállítják, és új automatikus méretezési ütemtervet indítunk, amelynek kezdeti ideje az időpont, amikor ezt a kérelmet kiadták. Az időtartam ISO 8601 formátumban van megadva.
autoScaleFormula	string	A készletben lévő számítási csomópontok kívánt számának képlete. Az alapértelmezett érték 15 perc. A minimális és a maximális érték 5 perc, illetve 168 óra. Ha 5 percnél rövidebb vagy 168 óránál hosszabb értéket ad meg, a Batch szolgáltatás érvénytelen tulajdonságérték-hibával utasítja el a kérelmet; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Ha új intervallumot adsz be, akkor a meglévő automatikus méretezési értékelési ütemtervet leállítják, és új automatikus méretezési ütemtervet indítunk, amelynek kezdeti ideje az időpont, amikor ezt a kérelmet kiadták.