Pools - Delete Pool

Szolgáltatás:

Batch Service

API-verzió:

2025-06-01

Egy készlet törlése a megadott fiókból.
Amikor egy készlet törlését kéri, a következő műveletek történnek: a készlet állapota törlésre van beállítva; a készleten folyamatban lévő átméretezési műveletek leállnak; a Batch szolgáltatás elkezdi átméretezni a készletet nulla számítási csomópontra; a meglévő számítási csomópontokon futó tevékenységek leállnak és újra lekérdezhetők (mintha egy átméretezési készlet műveletet kértek volna az alapértelmezett ismételt lekérési beállítással); végül a rendszer eltávolítja a készletet a rendszerből. Mivel a futó feladatok újra le vannak kérdezve, a felhasználó újrafuttathatja ezeket a feladatokat úgy, hogy a feladatukat egy másik készletre frissíti. A feladatok ezután futtathatók az új készleten. Ha felül szeretné bírálni az újralekérdezési viselkedést, akkor a készlet törlése előtt kifejezetten az átméretezési készletet kell meghívnia, hogy a készletet nullára zsugorítsa. Ha törlési állapotban meghív egy Frissítés, Javítás vagy Törlés API-t egy készleten, az a 409-es HTTP-állapotkóddal és a PoolBeingDeleted hibakóddal meghiúsul.

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

Opcionális paraméterekkel:

DELETE {endpoint}/pools/{poolId}?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

Name	Kötelező	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.

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 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 delete

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:

202

Definíciók

Name	Description
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.

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.