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/ Elastic Cloud Server/ Referencia de la API/ API de OpenStack Nova/ Gestión de consola de ECS/ Obtención de una dirección de inicio de sesión remoto basada en VNC (Microversión 2.6 o posterior)

Actualización más reciente 2025-08-25 GMT+08:00

Ver PDF

Obtención de una dirección de inicio de sesión remoto basada en VNC (Microversión 2.6 o posterior)

Función

Esta API se utiliza para obtener la dirección para iniciar sesión remotamente en un ECS con VNC.

URI

POST /v2.1/{project_id}/servers/{server_id}/remote-consoles

Tabla 1 describe los parámetros en el URI.

**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, consulte Obtención de un ID de proyecto.
server_id	Sí	Especifica el ID del ECS.

Restricciones

Al usar esta API, asegúrese de que la microversión sea 2.6 o posterior.
Agregue una microversión usando el encabezado de solicitud HTTP X-OpenStack-Nova-API-Version o OpenStack-API-Version.

Por ejemplo, X-OpenStack-Nova-API-Version: 2.6 o OpenStack-API-Version: compute 2.6
Una dirección de inicio de sesión obtenida es válida durante 10 minutos. Obtener otra nueva después de la expiración.

Solicitud

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
remote_console	Sí	Object	Obtiene la dirección para iniciar sesión remotamente en un ECS con VNC. Para más detalles, consulte Tabla 3.

**Tabla 3** Parámetros **remote_console**
Parámetro	Obligatorio	Tipo	Descripción
type	Sí	String	Especifica un modo de inicio de sesión remoto. Póngalo en novnc.
protocol	Sí	String	Especifica un protocolo de inicio de sesión remoto. Póngalo a vnc.

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 4** Parámetros de respuesta
Parámetro	Tipo	Descripción
remote_console	Object	Obtiene la dirección para iniciar sesión de forma remota en un ECS. Para más detalles, consulte Tabla 5.

**Tabla 5** Parámetros **remote_console**
Parámetro	Tipo	Descripción
type	String	Especifica un modo de inicio de sesión remoto.
protocol	String	Especifica un protocolo de inicio de sesión remoto.
url	String	Especifica un URL de acceso remoto. El URL es válido durante 10 minutos. Obtener otro nuevo después de la caducidad.

Ejemplo de la solicitud

POST https://{endpoint}/v2.1/13c67a214ced4afb88d911ae4bd5721a/servers/47bc79ae-df61-4ade-9197-283a74e5d70e/remote-consoles

{
   "remote_console" : {
        "type" : "novnc",
        "protocol": "vnc"
    }
}

Ejemplo de la respuesta

{
	"remote_console": {
		"url": "https://nova-novncproxy.az21.dc1.domainname.com:8002/vnc.auto.html?token=80fa7c8d-37fe-451e-8b08-bfbd9fb6a4df&lang=EN",
		"type": "novnc",
		"protocol": "vnc"
	}
}