Condividi tramite

Nodes - Reboot Node

Servizio:
Batch Service
Versione API:
2025-06-01

Riavvia il nodo di calcolo specificato.
È possibile riavviare un nodo di calcolo solo se si trova in uno stato di inattività o in esecuzione.

POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2025-06-01
Con parametri facoltativi: 
POST {endpoint}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2025-06-01&timeOut={timeOut}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
endpoint
 path True

string (uri)

Endpoint dell'account Batch (ad esempio: https://batchaccount.eastus2.batch.azure.com).
nodeId
 path True

string

ID del nodo di calcolo da riavviare.
poolId
 path True

string

ID del pool che contiene il nodo di calcolo.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.
timeOut
 query

integer (int32)

Tempo massimo di elaborazione della richiesta da parte del server, espresso in secondi. Il valore predefinito è 30 secondi. Se il valore è superiore a 30, verrà utilizzato il valore predefinito.".

Intestazione della richiesta

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

Nome Necessario Tipo Descrizione
client-request-id

string

Identità della richiesta generata dal chiamante, sotto forma di GUID senza decorazioni come parentesi graffe, ad esempio 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Indica se il server deve restituire l'ID richiesta client nella risposta.
ocp-date

string (date-time-rfc7231)

Ora di emissione della richiesta. Le librerie client in genere impostano questo valore sull'ora corrente dell'orologio di sistema; impostarla in modo esplicito se si chiama direttamente l'API REST.

Corpo della richiesta

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

Nome Tipo Descrizione
nodeRebootOption

BatchNodeRebootKind

Quando riavviare il nodo di calcolo e le operazioni da eseguire con attività attualmente in esecuzione. Il valore predefinito è requeue.

Risposte

Nome Tipo Descrizione
202 Accepted

La richiesta è stata accettata per l'elaborazione, ma l'elaborazione non è ancora stata completata.

Intestazioni

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

BatchError

Risposta di errore imprevista.

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Ambiti

Nome Descrizione
https://batch.core.windows.net//.default

Esempio

Node reboot

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
202

Definizioni

Nome Descrizione
BatchError

Risposta di errore ricevuta dal servizio Azure Batch.
BatchErrorDetail

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.
BatchErrorMessage

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.
BatchNodeRebootKind

Enum BatchNodeRebootKind
BatchNodeRebootOptions

Parametri per il riavvio di un nodo di calcolo di Azure Batch.

BatchError

Oggetto

Risposta di errore ricevuta dal servizio Azure Batch.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
message

BatchErrorMessage

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
values

BatchErrorDetail[]

Raccolta di coppie chiave-valore contenenti dettagli aggiuntivi sull'errore.

BatchErrorDetail

Oggetto

Elemento di informazioni aggiuntive incluse in una risposta di errore di Azure Batch.

Nome Tipo Descrizione
key

string

Identificatore che specifica il significato della proprietà Value.
value

string

Informazioni aggiuntive incluse nella risposta di errore.

BatchErrorMessage

Oggetto

Messaggio di errore ricevuto in una risposta di errore di Azure Batch.

Nome Tipo Descrizione
lang

string

Il codice linguistico del messaggio di errore.
value

string

Testo del messaggio.

BatchNodeRebootKind

Enumerazione

Enum BatchNodeRebootKind

Valore Descrizione
requeue

Terminare l'esecuzione dei processi attività e rieseguere la coda delle attività. Le attività verranno eseguite di nuovo quando è disponibile un nodo di calcolo. Riavviare il nodo di calcolo non appena le attività sono state terminate.
terminate

Terminare l'esecuzione di attività. Le attività verranno completate con failureInfo che indica che sono state terminate e non verranno eseguite di nuovo. Riavviare il nodo di calcolo non appena le attività sono state terminate.
taskcompletion

Consenti il completamento delle attività attualmente in esecuzione. Non pianificare nuove attività durante l'attesa. Riavviare il nodo di calcolo al termine di tutte le attività.
retaineddata

Deprecato, è consigliabile caricare i dati dell'attività in Archiviazione di Azure nell'attività e usarli TaskCompletion al suo posto. Consenti il completamento delle attività attualmente in esecuzione, quindi attendi la scadenza di tutti i periodi di conservazione dei dati attività. Non pianificare nuove attività durante l'attesa. Riavviare il nodo di calcolo quando tutti i periodi di conservazione delle attività sono scaduti.

BatchNodeRebootOptions

Oggetto

Parametri per il riavvio di un nodo di calcolo di Azure Batch.

Nome Tipo Descrizione
nodeRebootOption

BatchNodeRebootKind

Quando riavviare il nodo di calcolo e le operazioni da eseguire con attività attualmente in esecuzione. Il valore predefinito è requeue.