Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Bare Metal Server/ Referencia de la API/ API de BMS/ Gestión de estado del BMS/ Reinicio de BMS
Actualización más reciente 2025-02-18 GMT+08:00
Ver PDF
Compartir

Reinicio de BMS

Función

Esta API se utiliza para reiniciar los BMS de los ID especificados. Puede reiniciar un máximo de 1000 BMS a la vez.

Esta es una API asíncrona. Invocar a la API correctamente indica que la tarea se ha entregado correctamente. Para comprobar si la tarea es correcta, usa la API de Consulta de estados de tareas.

URI

POST /v1/{project_id}/baremetalservers/action

Tabla 1 enumera los parámetros.
Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

Sí

Especifica el ID del proyecto.

Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

En la solicitud, el comando para reiniciar BMS debe enviarse con el parámetro reboot. Para obtener más información, consulte la solicitud de ejemplo.

Parámetro

Obligatorio

Tipo

Descripción

reboot

Sí

Object

Especifica la operación para reiniciar los BMS. Para obtener más información, consulte Tabla 2.
Tabla 2 Descripción de la estructura de datos del campo reboot

Parámetro

Obligatorio

Tipo

Descripción

type

Sí

String

Especifica el tipo de reinicio de BMS.

  • SOFT: reinicio suave (inválido)
  • HARD: reinicio duro (predeterminado)

servers

Sí

Array of objects

Especifica los ID de BMS. Para obtener más información, consulte Tabla 3.
Tabla 3 Descripción de la estructura de datos de campo servers

Parámetro

Obligatorio

Tipo

Descripción

id

Sí

String

Especifica el ID de BMS.

Puede obtener el ID de BMS desde la consola de BMSBMS o invocando al Consulta de los BMS (API nativa de OpenStack).

Ejemplo de solicitud

Reinicio de dos BMS (IDs: son 616fb98f-46ca-475e-917e-2563e5a8cd19 y 726fb98f-46ca-475e-917e-2563e5a8cd20) 
1
 
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/action

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
 
{
    "reboot": {
        "type": "HARD",
        "servers": [
            {
                "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
            },
            {
                "id": "726fb98f-46ca-475e-917e-2563e5a8cd20"
            }
        ]
    }
}

Parámetros de respuesta

  • Respuesta normal
Tabla 4 Respuesta normal

Parámetro

Tipo

Descripción

job_id

String

Especifica el ID de tarea devuelto después de ejecutar un comando de tarea. El ID de tarea se puede utilizar para consultar el estado de ejecución de la tarea.

Para obtener más información acerca de cómo consultar el estado de ejecución de la tarea basado en job_id, consulte Consulta de estados de tareas.
  • Respuesta anormal
Tabla 5 Respuesta anormal

Parámetro

Tipo

Descripción

error

Dictionary data structure

Especifica el error devuelto cuando un envío de tareas encuentra una excepción. Para obtener más información, consulte Tabla 6.
Tabla 6 Estructura de datos de error

Parámetro

Tipo

Descripción

message

String

Especifica el mensaje de error.

code

String

Especifica el código de error.

Ejemplo de respuesta

  • Respuesta normal 
    1
2
3
    		 
    { 
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

Valores devueltos

Valores normales

Valores devueltos

Descripción

200

La solicitud se ha procesado correctamente.

Para obtener más información sobre otros valores devueltos, consulte Códigos de estado.

Códigos de error

Véase Códigos de error.

Tema principal: Gestión de estado del BMS