Compartir a través de

Compute Node - Reboot

  • Referencia
Servicio:
Batch Service
Versión de la API:
2023-11-01.18.0

Reinicia el nodo de ejecución especificado.
Solo puede reiniciar un nodo de ejecución si está en estado inactivo o en ejecución.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?api-version=2023-11-01.18.0
Con parámetros opcionales: 
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/reboot?timeout={timeout}&api-version=2023-11-01.18.0

Parámetros de identificador URI

Nombre En Requerido Tipo Description
batchUrl
 path True

string

Dirección URL base de todas las solicitudes de servicio de Azure Batch.
nodeId
 path True

string

Identificador del nodo de ejecución que desea reiniciar.
poolId
 path True

string

Identificador del grupo que contiene el nodo de proceso.
api-version
 query True

string

Versión de la API de cliente.
timeout
 query

integer

int32

Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos.

Encabezado de la solicitud

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

Nombre Requerido Tipo Description
client-request-id

string

uuid

La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Si el servidor debe devolver el client-request-id en la respuesta.
ocp-date

string

date-time-rfc1123

Hora a la que se emitió la solicitud. Normalmente, las bibliotecas cliente establecen esto en la hora actual del reloj del sistema; establézcalo explícitamente si llama directamente a la API REST.

Cuerpo de la solicitud

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

Nombre Tipo Description
nodeRebootOption

ComputeNodeRebootOption

Cuándo reiniciar el nodo de ejecución y qué hacer con las tareas que se están ejecutando actualmente.
El valor predeterminado es requeue.

Respuestas

Nombre Tipo Description
202 Accepted

La solicitud al servicio Batch se realizó correctamente.

Encabezados

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

BatchError

Error del servicio Batch.

Seguridad

azure_auth

flujo de código de autenticación de OAuth 2.0 Microsoft Entra

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation Suplantación de su cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Node reboot

Solicitud de ejemplo

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



{
  "nodeRebootOption": "terminate"
}

Respuesta de muestra

status code:
202

Definiciones

Nombre Description
BatchError

Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error Azure Batch.
ComputeNodeRebootOption

Cuándo reiniciar el nodo de ejecución y qué hacer con las tareas que se están ejecutando actualmente.
ErrorMessage

Mensaje de error recibido en una respuesta de error Azure Batch.
NodeRebootParameter

Opciones para reiniciar un nodo de proceso.

BatchError

Respuesta de error recibida del servicio Azure Batch.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message

ErrorMessage

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
values

BatchErrorDetail[]

Colección de pares clave-valor que contiene detalles adicionales sobre el error.

BatchErrorDetail

Elemento de información adicional incluida en una respuesta de error Azure Batch.

Nombre Tipo Description
key

string

Identificador que especifica el significado de la propiedad Value.
value

string

La información adicional incluida con la respuesta de error.

ComputeNodeRebootOption

Cuándo reiniciar el nodo de ejecución y qué hacer con las tareas que se están ejecutando actualmente.

Nombre Tipo Description
requeue

string

Finalice los procesos de tarea en ejecución y vuelva a poner en cola las tareas. Las tareas se volverán a ejecutar cuando haya disponible un nodo de proceso. Reinicie el nodo de ejecución en cuanto finalicen las tareas.
retaineddata

string

Permita que las tareas en ejecución se completen y espere a que expiren todos los períodos de retención de datos de tareas. Programe ninguna nueva tarea mientras espera. Reinicie el nodo de proceso cuando hayan expirado todos los períodos de retención de tareas.
taskcompletion

string

Permitir que las tareas en ejecución se completen actualmente. Programe ninguna nueva tarea mientras espera. Reinicie el nodo de ejecución cuando se hayan completado todas las tareas.
terminate

string

Finalizar las tareas en ejecución. Las tareas se completarán con failureInfo que indica que finalizaron y no se volverán a ejecutar. Reinicie el nodo de ejecución en cuanto finalicen las tareas.

ErrorMessage

Mensaje de error recibido en una respuesta de error Azure Batch.

Nombre Tipo Description
lang

string

Código de idioma del mensaje de error
value

string

Texto del mensaje.

NodeRebootParameter

Opciones para reiniciar un nodo de proceso.

Nombre Tipo Description
nodeRebootOption

ComputeNodeRebootOption

Cuándo reiniciar el nodo de ejecución y qué hacer con las tareas que se están ejecutando actualmente.
El valor predeterminado es requeue.