describeinstancevncurl
查询一台 ecs 实例的 web 管理终端 地址。
描述
调用该接口时,您需要注意:
管理终端地址的有效期为 15 秒,调用接口成功后如果 15 秒内不使用该链接,url 地址自动失效,您需要重新查询。
单个管理终端链接的 持久链接(keepalive)时间为 60 秒,60 秒内您管理终端窗口没有任何交互操作时,连接自动断开。
如果连接中断,每分钟内重新连接的次数不能超过 30 次。
您需要在链接 https://g.alicdn.com/aliyun/ecs-console-vnc/0.0.7/index.html? 末尾加上 vncurl=xxxx、instanceid=xxx 和 iswindows=true、iswindows=false 和 password=xxxxxx,参数之间使用 & 连接。其中:
参数 vncurl:调用接口成功后会返回的 vncurl 的值。
参数 instanceid:您的实例 id。
参数 iswindows:该实例的操作系统是否是 windows 系统。取值为 true 表示是 windows 系统,取值为 false 表示不是 windows 系统。
(可选)参数 password:该实例的远程连接密码,由 6 位数字或大小写字母组成。使用该参数时,在连接管理终端处您不需要再输入密码。
示例:
index.html?vncurl=ws%3a%2f%xxx&instanceid=i-wz9hhwq5a6tmxxxxxxx&iswindows=true
或
index.html?vncurl=ws%3a%2f%xxx&instanceid=i-wz9hhwq5a6tmxxxxxxx&iswindows=true&password=111111
请求参数
返回参数
示例
请求示例
https://ecs.aliyuncs.com/?action=describeinstancevncurl®ionid=cn-qingdao&instanceid=ay121018033933eaxxxxxxx&<公共请求参数>
返回示例
xml 格式
<describeinstancevncurlresponse> <requestid>1450f2d7-5435-4420-bbc9-49c5xxxxxxxx</requestid> <vncurl>ws%3a%2f%2fhz01-vncproxy.aliyun.com%2fwebsockify%2f%3fs%3ddvh%252fia%252byc73gwo48c bx2gbxudvzaanskr74pq30mzquygeumcb%252fbknixdxdea996</vncurl></describeinstancevncurlresponse>
json 格式
{ "requestid": "1450f2d7-5435-4420-bbc9-49c514b0157e", "vncurl": "ws%3a%2f%2fhz01-vncproxy.aliyun.com%2fwebsockify%2f%3fs%3ddvh%252 fia%252byc73gwo48cbx2gbxudvzaanskr74pq30mzquygeumcb%252fbknixdxdea996"}
错误码
以下为本接口特有的错误码。更多错误码,请访问 api 错误中心。
以上就是如何查询一台 ecs 实例的 web 管理终端 地址的详细内容。
