Pools - Remove Nodes

Szolgáltatás:: Batch Service

API-verzió:: 2025-06-01

Eltávolítja a számítási csomópontokat a megadott készletből.
Ez a művelet csak akkor futtatható, ha a készlet foglalási állapota állandó. A művelet futtatásakor a foglalási állapot állandóról átméretezésre változik. Minden kérés legfeljebb 100 csomópontot távolíthat el.

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

Opcionális paraméterekkel:

POST {endpoint}/pools/{poolId}/removenodes?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	Kötelező	Típus	Description
nodeList	True	string[]	A megadott készletből eltávolítandó számítási csomópontok azonosítóit tartalmazó lista. Kérésenként legfeljebb 100 csomópont távolítható el.
nodeDeallocationOption		BatchNodeDeallocationOption	Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó feladatával, miután ki lett választva a felszabadításhoz. Az alapértelmezett érték az újrakérés.
resizeTimeout		string (duration)	A számítási csomópontok készletbe 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.

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 remove nodes

Mintakérelem

HTTP

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



{
  "nodeList": [
    "tvm-1695681911_1-20161122t224741z",
    "tvm-1695681911_2-20161122t224741z"
  ]
}

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
BatchNodeRemoveOptions	Paraméterek a csomópontok eltávolításához egy Azure Batch Poolból.

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.

BatchNodeRemoveOptions

Tárgy

Paraméterek a csomópontok eltávolításához egy Azure Batch Poolból.

Name	Típus	Description
nodeDeallocationOption	BatchNodeDeallocationOption	Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó feladatával, miután ki lett választva a felszabadításhoz. Az alapértelmezett érték az újrakérés.
nodeList	string[]	A megadott készletből eltávolítandó számítási csomópontok azonosítóit tartalmazó lista. Kérésenként legfeljebb 100 csomópont távolítható el.
resizeTimeout	string (duration)	A számítási csomópontok készletbe 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.