Compute Node - Reimage

Reference

Service:: Batch Service

API Version:: 2023-11-01.18.0

Přeinstaluje operační systém na zadaném výpočetním uzlu.
Operační systém můžete na výpočetním uzlu přeinstalovat jenom v případě, že je v nečinném nebo spuštěném stavu. Toto rozhraní API je možné vyvolat pouze u fondů vytvořených pomocí vlastnosti konfigurace cloudové služby.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
batchUrl	path	True	string	Základní adresa URL pro všechny požadavky Azure Batch služby.
nodeId	path	True	string	ID výpočetního uzlu, který chcete restartovat.
poolId	path	True	string	ID fondu, který obsahuje výpočetní uzel.
api-version	query	True	string	Verze rozhraní API klienta.
timeout	query		integer int32	Maximální doba, kterou může server strávit zpracováním požadavku( v sekundách). Výchozí hodnota je 30 sekund.

Hlavička požadavku

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

Name	Typ	Description
client-request-id	string uuid	Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Určuje, jestli má server v odpovědi vrátit client-request-id.
ocp-date	string date-time-rfc1123	Čas, kdy byla žádost vydána. Klientské knihovny obvykle nastavit na aktuální systémový čas hodin; pokud voláte rozhraní REST API přímo, explicitně ho nastavte.

Text požadavku

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

Name	Typ	Description
nodeReimageOption	ComputeNodeReimageOption	Kdy znovu vytvořit z image výpočetního uzlu a co dělat s aktuálně spuštěnými úkoly. Výchozí hodnota je opětovné zařazení do fronty.

Odpovědi

Name	Typ	Description
202 Accepted		Požadavek na službu Batch byl úspěšný. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Chyba ze služby Batch.

Name

Typ

Description

202 Accepted

Požadavek na službu Batch byl úspěšný.

Headers

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

Other Status Codes

BatchError

Chyba ze služby Batch.

Zabezpečení

azure_auth

Microsoft Entra tok ověřovacího kódu OAuth 2.0

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

Scopes

Name	Description
user_impersonation	Zosobnění uživatelského účtu

Authorization

Type: apiKey
In: header

Příklady

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

Definice

Name	Description
BatchError	Služba Azure Batch obdržela chybovou odpověď.
BatchErrorDetail	Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi.
ComputeNodeReimageOption	Kdy znovu vytvořit z image výpočetního uzlu a co dělat s aktuálně spuštěnými úkoly.
ErrorMessage	Chybová zpráva přijatá v Azure Batch chybovou odpověď.
NodeReimageParameter	Možnosti pro opětovné nastavení výpočetního uzlu

BatchError

Služba Azure Batch obdržela chybovou odpověď.

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

BatchErrorDetail

Položka s dalšími informacemi, které jsou součástí Azure Batch chybové odpovědi.

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