：DescribeInstanceVncUrl

描述

調用該介面時，您需要注意：

• 管理終端地址的有效期間為 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 位元字或大小寫字母組成。使用該參數時，在串連管理終端處您不需要再輸入密碼。

    樣本：

    https://g.alicdn.com/aliyun/ecs-console-vnc/0.0.7/index.html?vncUrl=ws%3A%2F%xxx&instanceId=i-wz9hhwq5a6tmxxxxxxx&isWindows=true

    或

    https://g.alicdn.com/aliyun/ecs-console-vnc/0.0.7/index.html?vncUrl=ws%3A%2F%xxx&instanceId=i-wz9hhwq5a6tmxxxxxxx&isWindows=true&Password=111111

請求參數

返回參數

樣本

https://ecs.aliyuncs.com/?Action=DescribeInstanceVncUrl
&RegionId=cn-qingdao
&InstanceId=AY121018033933eaxxxxxxx
&<公共請求參數>

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

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

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。