Sdílet prostřednictvím


Compute Node - Reimage

Přeinstaluje operační systém na zadaný výpočetní uzel.
Operační systém můžete přeinstalovat na výpočetním uzlu jenom v případě, že je v nečinném nebo spuštěném stavu.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?api-version=2024-07-01.20.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reimage?timeout={timeout}&api-version=2024-07-01.20.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 služby Azure Batch.

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, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota.

Hlavička požadavku

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

Name Vyžadováno Typ Description
client-request-id

string

uuid

Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Určuje, jestli má server v odpovědi vrátit ID požadavku klienta.

ocp-date

string

date-time-rfc1123

Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API.

Text požadavku

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

Name Typ Description
nodeReimageOption

ComputeNodeReimageOption

Kdy znovu vytvořit výpočetní uzel a co dělat s aktuálně spuštěnými úkoly.
Výchozí hodnota je znovu vyměněná.

Odpovědi

Name Typ Description
202 Accepted

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

Hlavičky

  • 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

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

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Authorization

Typ: apiKey
V: header

Příklady

Node reimage

Ukázkový požadavek

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reimage?api-version=2024-07-01.20.0



{
  "nodeReimageOption": "terminate"
}

Ukázková odpověď

Definice

Name Description
BatchError

Odpověď na chybu přijatá ze služby Azure Batch

BatchErrorDetail

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

ComputeNodeReimageOption

Kdy znovu vytvořit výpočetní uzel a co dělat s aktuálně spuštěnými úkoly.

ErrorMessage

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

NodeReimageParameter

Možnosti pro opětovné vytvoření výpočetního uzlu

BatchError

Odpověď na chybu přijatá ze služby Azure Batch

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.

message

ErrorMessage

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

values

BatchErrorDetail[]

Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch

Name Typ Description
key

string

Identifikátor určující význam vlastnosti Value.

value

string

Další informace zahrnuté v odpovědi na chybu.

ComputeNodeReimageOption

Kdy znovu vytvořit výpočetní uzel a co dělat s aktuálně spuštěnými úkoly.

Name Typ Description
requeue

string

Ukončete spuštěné procesy úloh a znovu zadejte do fronty úkoly. Úkoly se spustí znovu, jakmile bude k dispozici výpočetní uzel. Znovu naimaktivní výpočetní uzel ihned po ukončení úkolů.

retaineddata

string

Povolte dokončení aktuálně spuštěných úkolů a počkejte na vypršení platnosti všech období uchovávání dat úkolů. Při čekání neplánujte žádné nové úkoly. Znovu naimažte výpočetní uzel, pokud vypršela platnost všech období uchovávání úkolů.

taskcompletion

string

Povolit dokončení aktuálně spuštěných úkolů Při čekání neplánujte žádné nové úkoly. Po dokončení všech úkolů znovu naimate výpočetní uzel.

terminate

string

Ukončete spuštěné úkoly. Úkoly budou dokončeny s informacemi o selhání, které indikují, že byly ukončeny, a nebudou znovu spuštěny. Znovu naimaktivní výpočetní uzel ihned po ukončení úkolů.

ErrorMessage

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

Name Typ Description
lang

string

Kód jazyka chybové zprávy

value

string

Text zprávy.

NodeReimageParameter

Možnosti pro opětovné vytvoření výpočetního uzlu

Name Typ Description
nodeReimageOption

ComputeNodeReimageOption

Kdy znovu vytvořit výpočetní uzel a co dělat s aktuálně spuštěnými úkoly.
Výchozí hodnota je znovu vyměněná.