Function

This API is used to obtain the address for remotely logging in to an ECS using VNC.

URI

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

Table 1 describes the parameters in the URI.

**Table 1** Parameter description
Parameter	Mandatory	Description
project_id	Yes	Specifies the project ID.
server_id	Yes	Specifies the ECS ID.

Constraints

When using this API, ensure that the microversion is 2.6 or later.
Add a microversion using the HTTP request header X-OpenStack-Nova-API-Version or OpenStack-API-Version.

For example, X-OpenStack-Nova-API-Version: 2.6 or OpenStack-API-Version: compute 2.6
An obtained login address is valid for 10 minutes. Obtain a new one after expiration.

Request

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
remote_console	Yes	Object	Obtains the address for remotely logging in to an ECS using VNC. For details, see Table 3.

**Table 3** **remote_console** parameters
Parameter	Mandatory	Type	Description
type	Yes	String	Specifies a remote login mode. Set it to novnc.
protocol	Yes	String	Specifies a remote login protocol. Set it to vnc.

Response

Table 4 describes the response parameters.

**Table 4** Response parameters
Parameter	Type	Description
remote_console	Object	Obtains the address for remotely logging in to an ECS. For details, see Table 5.

**Table 5** **remote_console** parameters
Parameter	Type	Description
type	String	Specifies a remote login mode.
protocol	String	Specifies a remote login protocol.
url	String	Specifies a remote login URL. The URL is valid for 10 minutes. Obtain a new one after expiration.

Example Request

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

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

Example Response

{
	"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"
	}
}

Returned Values

See Returned Values for General Requests.

Error Codes

See Error Codes.

Obtaining a VNC-based Remote Login Address (Microversion 2.6 or Later)