Pool - Remove Nodes

  • Referencia
Service:
Batch Service
API Version:
2023-11-01.18.0

Eltávolítja a számítási csomópontokat a megadott készletből.
Ez a művelet csak akkor futhat, 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 {batchUrl}/pools/{poolId}/removenodes?api-version=2023-11-01.18.0
With optional parameters: 
POST {batchUrl}/pools/{poolId}/removenodes?timeout={timeout}&api-version=2023-11-01.18.0

URI-paraméterek

Name In Kötelező Típus Description
batchUrl
 path True

string

Az összes Azure Batch szolgáltatáskérés alap URL-címe.
poolId
 path True

string

Annak a készletnek az azonosítója, amelyből el szeretné távolítani a számítási csomópontokat.
api-version
 query True

string

Ügyfél API-verziója.
timeout
 query

integer

int32

A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

Kérelem fejléce

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

Name Kötelező Típus Description
client-request-id

string

uuid

A hívó által generált kérési identitás, olyan GUID formátumban, amely nem rendelkezik díszítéssel, például kapcsos zárójelekkel, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Azt határozza meg, hogy a kiszolgálónak vissza kell-e küldenie a válaszban szereplő client-request-id azonosítót.
ocp-date

string

date-time-rfc1123

A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróraidőre állítják be; állítsa be explicit módon, ha a REST API-t közvetlenül hívja meg.
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.
If-Modified-Since

string

date-time-rfc1123

Az ügyfél által ismert erőforrás utolsó módosításának időpontjá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-rfc1123

Az ügyfél által ismert erőforrás utolsó módosításának időpontját jelző időbélyeg. A művelet csak akkor lesz végrehajtva, ha a szolgáltatásban lévő erőforrás nem módosult a megadott időpont óta.

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

ComputeNodeDeallocationOption

Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó tevékenységeivel, miután kiválasztotta a felszabadításhoz.
Az alapértelmezett érték a requeue.
resizeTimeout

string

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).

Válaszok

Name Típus Description
202 Accepted

A Batch szolgáltatásnak küldött kérés sikeres volt.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamata

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Authorization

Type: apiKey
In: header

Példák

Pool remove nodes

Sample Request

POST account.region.batch.azure.com/pools/poolId/removenodes?api-version=2023-11-01.18.0



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

Sample Response

Status code:
202

Definíciók

Name Description
BatchError

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

Egy Azure Batch hibaválaszban szereplő további információk egy eleme.
ComputeNodeDeallocationOption

Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó tevékenységeivel, miután kiválasztotta a felszabadításhoz.
ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.
NodeRemoveParameter

A számítási csomópontok készletből való eltávolításának lehetőségei.

BatchError

Hibaválasz érkezett a 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

ErrorMessage

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, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

Egy Azure Batch hibaválaszban szereplő további információk egy eleme.

Name Típus Description
key

string

Egy azonosító, amely az Érték tulajdonság jelentését adja meg.
value

string

A hibaválaszban szereplő további információk.

ComputeNodeDeallocationOption

Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó tevékenységeivel, miután kiválasztotta a felszabadításhoz.

Name Típus Description
requeue

string

Állítsa le a futó tevékenységfolyamatokat, és állítsa le újra a Feladatokat. A Feladatok újra futni fog, ha egy számítási csomópont elérhető. A feladatok leállása után azonnal távolítsa el a számítási csomópontokat.
retaineddata

string

Engedélyezze az aktuálisan futó feladatok befejezését, majd várja meg, amíg az összes tevékenységadat-megő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.
taskcompletion

string

Az aktuálisan futó feladatok befejezésének engedélyezése. Várakozás közben ne ütemezzen új feladatokat. Ha minden tevékenység befejeződött, távolítsa el a számítási csomópontokat.
terminate

string

Állítsa le a futó feladatokat. A feladatok a failureInfo hibával fejeződnek be, jelezve, hogy leálltak, és nem futnak újra. A feladatok leállása után azonnal távolítsa el a számítási csomópontokat.

ErrorMessage

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.

NodeRemoveParameter

A számítási csomópontok készletből való eltávolításának lehetőségei.

Name Típus Description
nodeDeallocationOption

ComputeNodeDeallocationOption

Meghatározza, hogy mi a teendő egy számítási csomóponttal és annak futó tevékenységeivel, miután kiválasztotta a felszabadításhoz.
Az alapértelmezett érték a requeue.
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

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).