Pools - Resize Pool

Szolgáltatás:: Batch Service

API-verzió:: 2025-06-01

Módosítja a készlethez rendelt számítási csomópontok számát.
A készletet csak akkor méretezheti át, ha a foglalási állapota állandó. Ha a készlet már átméretezve van, a kérés a 409-ben megadott állapotkóddal meghiúsul. Amikor átméretez egy készletet, a készlet foglalási állapota állandóról átméretezésre változik. Az automatikus skálázáshoz konfigurált készletek nem méretezhetők át. Ha megpróbálja ezt megtenni, a Batch szolgáltatás 409-et ad vissza. Ha lefelé méretez át egy készletet, a Batch szolgáltatás kiválasztja az eltávolítani kívánt számítási csomópontokat. Adott számítási csomópontok eltávolításához használja a készletben a Compute Nodes API eltávolítását.

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

Opcionális paraméterekkel:

POST {endpoint}/pools/{poolId}/resize?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
nodeDeallocationOption	BatchNodeDeallocationOption	Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó tevékenységeivel, ha a készlet mérete csökken. Az alapértelmezett érték az újrakérés.
resizeTimeout	string (duration)	A csomópontok készletbe foglalásának vagy a számítási csomópontok készletből való eltávolításának időtúllépése. Az alapértelmezett érték 15 perc. A minimális érték 5 perc. Ha 5 percnél rövidebb értéket ad meg, a Batch szolgáltatás hibát ad vissza; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Az időtartam ISO 8601 formátumban van megadva.
targetDedicatedNodes	integer (int32)	A készletben található dedikált számítási csomópontok kívánt száma.
targetLowPriorityNodes	integer (int32)	A készletben található kihasználatlan/alacsony prioritású számítási csomópontok kívánt száma.

Válaszok

Name	Típus	Description
202 Accepted		A kérelem feldolgozásra lett elfogadva, de a feldolgozás még nem fejeződött be. 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

202 Accepted

A kérelem feldolgozásra lett elfogadva, de a feldolgozás még nem fejeződött be.

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 resize

Mintakérelem

HTTP

POST {endpoint}/pools/resizePool/resize?api-version=2025-06-01



{
  "targetDedicatedNodes": 1,
  "targetLowPriorityNodes": 0
}

Mintaválasz

Állapotkód:: 202

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.
BatchNodeDeallocationOption	BatchNodeDeallocationOption enums
BatchPoolResizeOptions	Paraméterek az Azure Batch Pool méretének megváltoztatásához.

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.

BatchNodeDeallocationOption

Felsorolás

BatchNodeDeallocationOption enums

Érték	Description
requeue	Állítsa le a futó tevékenységfolyamatokat, és állítsa le újra a feladatokat. A feladatok akkor futnak újra, ha egy számítási csomópont elérhető. A feladatok leállása után távolítsa el a számítási csomópontokat.
terminate	Állítsa le a futó feladatokat. A feladatokat a hibaInfo hiba jelzi, amely azt jelzi, hogy leálltak, és nem futnak újra. A feladatok leállása után távolítsa el a számítási csomópontokat.
taskcompletion	Az aktuálisan futó feladatok végrehajtásának engedélyezése. Várakozás közben ne ütemezzen új feladatokat. Távolítsa el a számítási csomópontokat, ha az összes tevékenység befejeződött.
retaineddata	Elavult állapotban javasoljuk, hogy töltsd fel a feladatadatokat Azure Storage a feladatodban, és használd helyette a `TaskCompletion` jelet. Hagyja, hogy az aktuálisan futó tevékenységek befejeződjenek, majd várja meg, amíg az összes tevékenységadat-adatmegőrzési időszak lejár. Várakozás közben ne ütemezzen új feladatokat. Távolítsa el a számítási csomópontokat, ha az összes tevékenységmegőrzési időszak lejárt.

BatchPoolResizeOptions

Tárgy

Paraméterek az Azure Batch Pool méretének megváltoztatásához.

Name	Típus	Description
nodeDeallocationOption	BatchNodeDeallocationOption	Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó tevékenységeivel, ha a készlet mérete csökken. Az alapértelmezett érték az újrakérés.
resizeTimeout	string (duration)	A csomópontok készletbe foglalásának vagy a számítási csomópontok készletből való eltávolításának időtúllépése. Az alapértelmezett érték 15 perc. A minimális érték 5 perc. Ha 5 percnél rövidebb értéket ad meg, a Batch szolgáltatás hibát ad vissza; ha közvetlenül a REST API-t hívja meg, a HTTP-állapotkód 400 (hibás kérés). Az időtartam ISO 8601 formátumban van megadva.
targetDedicatedNodes	integer (int32)	A készletben található dedikált számítási csomópontok kívánt száma.
targetLowPriorityNodes	integer (int32)	A készletben található kihasználatlan/alacsony prioritású számítási csomópontok kívánt száma.