Compute Node - Reimage

Service:

Batch Service

API Version:

2023-11-01.18.0

Újratelepíti az operációs rendszert a megadott számítási csomóponton.
Az operációs rendszert csak akkor telepítheti újra egy számítási csomóponton, ha tétlen vagy futó állapotban van. Ez az API csak a felhőszolgáltatás konfigurációs tulajdonságával létrehozott készleteken hívható meg.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2023-11-01.18.0

With optional parameters:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?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.
nodeId	path	True	string	Az újraindítani kívánt számítási csomópont azonosítója.
poolId	path	True	string	A számítási csomópontot tartalmazó készlet azonosítója.
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.

Kérelem törzse

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

Name	Típus	Description
nodeReimageOption	ComputeNodeReimageOption	Mikor kell újraimázni a számítási csomópontot, és mi a teendő az aktuálisan futó tevékenységekkel. Az alapértelmezett érték a requeue.

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

Node reimage

Sample Request

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2023-11-01.18.0



{
  "nodeReimageOption": "terminate"
}

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.
ComputeNodeReimageOption	Mikor kell újraimázni a számítási csomópontot, és mi a teendő az aktuálisan futó tevékenységekkel.
ErrorMessage	Hibaüzenet érkezett egy Azure Batch hibaválaszban.
NodeReimageParameter	A számítási csomópontok újraimálá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.

ComputeNodeReimageOption

Mikor kell újraimázni a számítási csomópontot, és mi a teendő az aktuálisan futó tevékenységekkel.

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 újraimázhatja a számítási csomópontot.
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. A számítási csomópont újraimulása, 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. A számítási csomópont újraimálása, ha az összes tevékenység befejeződött.
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 újraimázhatja a számítási csomópontot.

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.

NodeReimageParameter

A számítási csomópontok újraimálásának lehetőségei.

Name	Típus	Description
nodeReimageOption	ComputeNodeReimageOption	Mikor kell újraimázni a számítási csomópontot, és mi a teendő az aktuálisan futó tevékenységekkel. Az alapértelmezett érték a requeue.