最近更新时间:2023.07.25 18:39:31
首次发布时间:2021.12.29 11:18:50
调用 DescribeInstanceVncUrl 查询一台云服务器的VNC管理终端地址。
调用该接口时,您需要注意:
无法使用ECS Terminal连接Linux实例时,您可以通过控制台的 VNC远程连接 登录实例,查看云服务器操作界面的实时状态。
您可以按以下操作生成VNC登录链接(JS格式):
在https://console.volcengine.com/ecs/connect/vnc/?
末尾增加Region=****
、host=****
和name=****
,参数之间使用&连接。
名称 | 描述 | 示例值 |
---|---|---|
Region | 实例所在地域。 | cn-beijing |
host | 调用 DescribeInstanceVncUrl 接口返回的VncUrl 的值。 | cn-beijing-a01-vncproxy-ecs.volcengine.com:443/websockify/destInfoToken/01495659-06ab-49ca-9aa7-d1b226******* |
name | 实例名称。 | instance-host-name |
示例如下(JS格式):
https://console.volcengine.com/ecs/connect/vnc/?Region=cn-beijing&host=cn-beijing-a01-vncproxy-ecs.volcengine.com:443/websockify/destInfoToken/01495659-06ab-49ca-9aa7-d1b226*******&name=instance-host-name
VNC登录成功后,您的管理终端窗口在180秒内没有任何交互操作时,连接自动断开。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeInstanceVncUrl | 要执行的操作,取值:DescribeInstanceVncUrl。 |
Version | String | 是 | 2020-04-01 | API的版本,取值:2020-04-01。 |
InstanceId | String | 是 | i-l8u10sauiu9qj0h***** | 实例ID。 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
VncUrl | String | wss://cn-beijing-a01-vncproxy-ecs.volcengine.com:443/websockify/destInfoToken/01495659-06ab-49ca-9aa7-d1b226******* | 管理终端Url。 |
GET /?Action=DescribeInstanceVncUrl&Version=2020-04-01&InstanceId=i-l8u10sauiu9qj0h***** HTTP/1.1 Host: open.volcengineapi.com Region: cn-beijing Service: ecs
{ "ResponseMetadata": { "RequestId": "20211104180426010194099035220C****", "Action": "DescribeInstanceVncUrl", "Version": "2020-04-01", "Service": "ecs", "Region": "cn-beijing" }, "Result": { "VncUrl": "wss://cn-beijing-a01-vncproxy-ecs.volcengine.com:443/websockify/destInfoToken/01495659-06ab-49ca-9aa7-d1b226*******" } }
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter.InstanceId | The required parameter InstanceId is not supplied. | 实例ID不能为空。 |
400 | InvalidInstanceStatus | The status of the specified instance does not support this request. | 当前实例的状态不支持此操作。 |
404 | InvalidInstance.NotFound | The specified instance does not exist. | 指定的实例不存在。 |
500 | InternalError | An internal error has occurred. | 内部错误,请重试。如果多次尝试失败,请提交工单。 |