全部产品
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件
云服务器 ECS

DescribeInstanceVncUrl

更新时间:2018-02-09 13:19:24

描述

查询 ECS 实例的 Web 管理终端 地址。

  • 管理终端地址的有效期为 15 秒,调用接口成功后如果 15 秒内不使用该链接,URL 地址自动失效,您需要重新查询。

  • 单个管理终端链接的 持久链接(KeepAlive)时间为 60 秒,60 秒内您管理终端窗口没有任何交互操作时,连接自动断开。

  • 如果连接中断,每分钟内重新连接的次数不能超过 30 次。

  • 您需要在链接 https://g.alicdn.com/aliyun/ecs-console-vnc/0.0.2/index.html? 末尾加上 vncUrl=xxxxinstanceId=xxxisWindows=True 或者 isWindows=False,参数之间使用 & 连接。其中:

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:DescribeInstanceVncUrl
RegionId String 实例所属的 Region ID。Region ID 的列表详见 地域列表
InstanceId String ECS 实例 ID

返回参数

名称 类型 描述
VncUrl String 管理终端 Url

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=DescribeInstanceVncUrl
  2. &InstanceId=AY121018033933eaxxxxxxx
  3. &<公共请求参数>

返回示例

XML格式

  1. <DescribeInstanceVncUrlResponse>
  2. <RequestId>1450F2D7-5435-4420-BBC9-49C5xxxxxxxx</RequestId>
  3. <VncUrl>ws%3A%2F%2Fhz01-vncproxy.aliyun.com%2Fwebsockify%2F%3Fs%3DDvh%252FIA%252BYc73gWO48cBx2gBxUDVzaAnSKr74pq30mzqUYgeUMcB%252FbkNixDxdEA996</VncUrl>
  4. </DescribeInstanceVncUrlResponse>

JSON格式

  1. {
  2. "RequestId": "1450F2D7-5435-4420-BBC9-49C514B0157E",
  3. "VncUrl": "ws%3A%2F%2Fhz01-vncproxy.aliyun.com%2Fwebsockify%2F%3Fs%3DDvh%252FIA%252BYc73gWO48cBx2gBxUDVzaAnSKr74pq30mzqUYgeUMcB%252FbkNixDxdEA996"
  4. }

错误码

错误代码 错误信息 HTTP 状态码 说明
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 指定实例的状态需要处于 运行中Running)。
InstanceNotReady The specified instance is not ready for use 403 指定的实例正在创建中,请稍后再试。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 ECS 实例不存在。
InvalidRegionId.NotFound The specified RegionId does not exist. 404 指定的 RegionId 不存在。RegionId 的列表详见 地域列表
本文导读目录