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/ Obtención de la dirección para iniciar sesión remotamente en un BMS
Actualización más reciente 2025-02-18 GMT+08:00

Obtención de la dirección para iniciar sesión remotamente en un BMS

Función

Esta interfaz se utiliza para obtener la dirección para iniciar sesión remotamente en un BMS.

Restricciones

Los BMS de Windows no admiten el inicio de sesión remoto.

URI

POST /v1/{project_id}/baremetalservers/{server_id}/remote_console

Tabla 1 enumera los parámetros URI.

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Descripción

project_id

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.

server_id

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

Parámetros de solicitud

Parámetro

Obligatorio

Tipo

Descripción

remote_console

Object

Especifica la acción para obtener la dirección para iniciar sesión de forma remota en un BMS. Para obtener más información, véase Tabla 2.

Tabla 2 Descripción de la estructura de datos de campo remote_console

Parámetro

Obligatorio

Tipo

Descripción

protocol

String

Especifica el protocolo de inicio de sesión remoto. Póngalo a serial.

type

String

Especifica el modo de inicio de sesión remoto. Póngalo a serial.

Ejemplo de solicitud

Obtención de la dirección para iniciar sesión remotamente en un BMS (ID: cf2a8b97-b5c6-47ef-9714-eb27adf26e5b) con el tipo de inicio de sesión y el protocolo establecidos en serial
1
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/remote_console
{
    "remote_console": {
        "protocol": "serial",
        "type": "serial"
    }
}

Parámetros de respuesta

Parámetro

Tipo

Descripción

remote_console

Object

Especifica la acción para obtener la dirección para iniciar sesión de forma remota en un BMS. Para obtener más información, consulte Tabla 3.

Tabla 3 Descripción de la estructura de datos de campo remote_console

Parámetro

Tipo

Descripción

type

String

Especifica el modo de inicio de sesión remoto.

protocol

String

Especifica el protocolo de inicio de sesión remoto.

url

String

Especifica la dirección URL de inicio de sesión remota.

Ejemplo de respuesta

{
   "remote_console": {
        "type": "serial",
        "protocol": "serial",
        "url": "https://console.domainname.com:443/serial/pod05ironic.region-01/?token=2a794f06-15ec-4f3d-a55b-06aca8e3dcbc"
    }
}

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.