Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API da Nova do OpenStack/ Gerenciamento do console do ECS/ Obtenção de um endereço de login remoto baseado em VNC (Microversão 2.6 ou posterior)

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

Obtenção de um endereço de login remoto baseado em VNC (Microversão 2.6 ou posterior)

Função

Essa API é usada para obter o endereço para fazer login remotamente em um ECS usando o VNC.

URI

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

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.
server_id	Sim	Especifica a ID de ECS.

Restrições

Ao usar essa API, certifique-se de que a microversão seja 2.6 ou posterior.
Adicione uma microversão usando o cabeçalho de solicitação HTTP X-OpenStack-Nova-API-Version ou OpenStack-API-Version.

Por exemplo, X-OpenStack-Nova-API-Version: 2.6 ou OpenStack-API-Version: computação 2.6
Um endereço de login obtido é válido por 10 minutos. Obter um novo após a expiração.

Solicitação

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
remote_console	Sim	Object	Obtém o endereço para efetuar login remotamente em um ECS usando o VNC. Para mais detalhes, consulte Tabela 3.

**Tabela 3** parâmetros **remote_console**
Parâmetro	Obrigatório	Tipo	Descrição
type	Sim	String	Especifica um modo de login remoto. Ajuste-o para novnc.
protocol	Sim	String	Especifica um protocolo de login remoto. Defina-o para vnc.

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 4** Parâmetros de resposta
Parâmetro	Tipo	Descrição
remote_console	Object	Obtém o endereço para efetuar login remotamente em um ECS. Para mais detalhes, consulte Tabela 5.

**Tabela 5** parâmetros **remote_console**
Parâmetro	Tipo	Descrição
type	String	Especifica um modo de login remoto.
protocol	String	Especifica um protocolo de login remoto.
url	String	Especifica um URL de login remoto. A URL é válida por 10 minutos. Obter um novo após a expiração.

Exemplo de solicitação

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

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

Exemplo de resposta

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