Pools - Resize Pool

Služba:: Batch Service

Verze rozhraní API:: 2025-06-01

Změní počet výpočetních uzlů, které jsou přiřazené k fondu.
Velikost fondu můžete změnit pouze v době, kdy je stav přidělení stabilní. Pokud fond již provádí změnu velikosti, požadavek selže se stavovým kódem 409. Při změně velikosti fondu se stav přidělení fondu změní z stabilní velikosti na změnu velikosti. Nemůžete změnit velikost fondů, které jsou nakonfigurované pro automatické škálování. Pokud se to pokusíte provést, služba Batch vrátí chybu 409. Pokud změníte velikost fondu směrem dolů, služba Batch zvolí, které výpočetní uzly se mají odebrat. Pokud chcete odebrat konkrétní výpočetní uzly, použijte místo toho rozhraní API výpočetních uzlů k odebrání fondu.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
endpoint	path	True	string (uri)	Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	ID fondu, které chcete získat.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.
timeOut	query		integer (int32)	Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.".

Hlavička požadavku

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

Name	Typ	Description
client-request-id	string	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.
ocp-date	string (date-time-rfc7231)	Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.
If-Modified-Since	string (date-time-rfc7231)	Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.
If-Unmodified-Since	string (date-time-rfc7231)	Časové razítko označující čas poslední změny prostředku známého klientovi. Operace se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.
If-Match	string	Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.
If-None-Match	string	Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

Text požadavku

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

Name	Typ	Description
nodeDeallocationOption	BatchNodeDeallocationOption	Určuje, co dělat s výpočetním uzlem a jeho spuštěnými úlohami, pokud se velikost fondu snižuje. Výchozí hodnota je znovu vyměněná.
resizeTimeout	string (duration)	Časový limit pro přidělení uzlů do fondu nebo odebrání výpočetních uzlů z fondu. Výchozí hodnota je 15 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch vrátí chybu; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek).
targetDedicatedNodes	integer (int32)	Požadovaný počet vyhrazených výpočetních uzlů ve fondu.
targetLowPriorityNodes	integer (int32)	Požadovaný počet výpočetních uzlů s nízkou prioritou ve fondu

Odpovědi

Name	Typ	Description
202 Accepted		Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno. Hlavičky DataServiceId: string ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Neočekávaná chybová odpověď

Name

Typ

Description

202 Accepted

Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno.

Hlavičky

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

Other Status Codes

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

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

Příklady

Pool resize

Ukázkový požadavek

HTTP

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



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

Ukázková odpověď

Stavový kód:: 202

Definice

Name	Description
BatchError	Odpověď na chybu přijatá ze služby Azure Batch
BatchErrorDetail	Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
BatchErrorMessage	V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
BatchNodeDeallocationOption	BatchNodeDeallocationOption enumy
BatchPoolResizeOptions	Parametry pro změnu velikosti fondu Azure Batch

BatchError

Objekt

Odpověď na chybu přijatá ze služby Azure Batch

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	BatchErrorMessage	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	BatchErrorDetail[]	Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Objekt

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name	Typ	Description
key	string	Identifikátor určující význam vlastnosti Value.
value	string	Další informace zahrnuté v odpovědi na chybu.

BatchErrorMessage

Objekt

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name	Typ	Description
lang	string	Jazykový kód chybové zprávy.
value	string	Text zprávy.

BatchNodeDeallocationOption

Výčet

BatchNodeDeallocationOption enumy

Hodnota	Description
requeue	Ukončete spuštěné procesy úloh a znovu zadejte do fronty úkoly. Úkoly se spustí znovu, jakmile bude k dispozici výpočetní uzel. Jakmile budou úkoly ukončeny, odeberte výpočetní uzly.
terminate	Ukončete spuštěné úkoly. Úkoly budou dokončeny s informacemi o selhání, které indikují, že byly ukončeny, a nebudou znovu spuštěny. Jakmile budou úkoly ukončeny, odeberte výpočetní uzly.
taskcompletion	Povolit dokončení aktuálně spuštěných úkolů Při čekání neplánujte žádné nové úkoly. Po dokončení všech úkolů odeberte výpočetní uzly.
retaineddata	Zastaralé, doporučujeme vám nahrát data úkolů do služby Azure Storage ve své úloze a místo nich je použít `TaskCompletion` . Povolte dokončení aktuálně spuštěných úkolů a počkejte na vypršení platnosti všech období uchovávání dat úkolů. Při čekání neplánujte žádné nové úkoly. Pokud vypršela platnost všech období uchovávání úkolů, odeberte výpočetní uzly.

BatchPoolResizeOptions

Objekt

Parametry pro změnu velikosti fondu Azure Batch

Name	Typ	Description
nodeDeallocationOption	BatchNodeDeallocationOption	Určuje, co dělat s výpočetním uzlem a jeho spuštěnými úlohami, pokud se velikost fondu snižuje. Výchozí hodnota je znovu vyměněná.
resizeTimeout	string (duration)	Časový limit pro přidělení uzlů do fondu nebo odebrání výpočetních uzlů z fondu. Výchozí hodnota je 15 minut. Minimální hodnota je 5 minut. Pokud zadáte hodnotu kratší než 5 minut, služba Batch vrátí chybu; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek).
targetDedicatedNodes	integer (int32)	Požadovaný počet vyhrazených výpočetních uzlů ve fondu.
targetLowPriorityNodes	integer (int32)	Požadovaný počet výpočetních uzlů s nízkou prioritou ve fondu

Sdílet prostřednictvím

Pools - Resize Pool

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Zabezpečení

OAuth2Auth

Rozsahy

Příklady

Pool resize

Ukázkový požadavek

Ukázková odpověď

Definice

BatchError

BatchErrorDetail

BatchErrorMessage

BatchNodeDeallocationOption

BatchPoolResizeOptions