Sdílet prostřednictvím

Nodes - Reboot Node

Služba:
Batch Service
Verze rozhraní API:
2025-06-01

Restartuje zadaný výpočetní uzel.
Výpočetní uzel můžete restartovat jenom v případě, že je v nečinném nebo spuštěném stavu.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2025-06-01
S volitelnými parametry: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2025-06-01&timeOut={timeOut}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string (uri)

Koncový bod účtu Batch (například: https://batchaccount.eastus2.batch.azure.com).
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

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.
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

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

Č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
nodeRebootOption

BatchNodeRebootKind

Kdy restartovat 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

Žádost byla přijata ke zpracování, ale zpracování ještě nebylo dokončeno.

Hlavičky

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

BatchError

Neočekávaná chybová odpověď

Zabezpečení

OAuth2Auth

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

Rozsahy

Name Description
https://batch.core.windows.net//.default

Příklady

Node reboot

Ukázkový požadavek

POST {endpoint}/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z/reboot?api-version=2025-06-01

Ukázková odpověď

Stavový kód:
202

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
BatchErrorMessage

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

Enumy BatchNodeRebootKind
BatchNodeRebootOptions

Parametry pro restartování výpočetního uzlu Služby Azure Batch

BatchError

Objekt

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

BatchErrorMessage

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

Objekt

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.

BatchErrorMessage

Objekt

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

Name Typ Description
lang

string

Jazykový kód chybové zprávy.
value

string

Text zprávy.

BatchNodeRebootKind

Výčet

Enumy BatchNodeRebootKind

Hodnota Description
requeue

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. Jakmile budou úkoly ukončeny, restartujte výpočetní uzel.
terminate

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. Jakmile budou úkoly ukončeny, restartujte výpočetní uzel.
taskcompletion

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ů restartujte výpočetní uzel.
retaineddata

Zastaralé, doporučujeme vám nahrát data úkolů do služby Azure Storage ve své úloze a místo nich je použít TaskCompletion . 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. Restartujte výpočetní uzel, pokud vypršela platnost všech období uchovávání úloh.

BatchNodeRebootOptions

Objekt

Parametry pro restartování výpočetního uzlu Služby Azure Batch

Name Typ Description
nodeRebootOption

BatchNodeRebootKind

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