查询实例管理终端地址
描述
查询 ECS 的 Web 管理终端地址
管理终端地址的有效期为 15 秒。如果查询地址后 15 秒内不连接,URL 地址会失效,需要重新查询
单个管理终端连接的 keepalive 时间为 60 秒,60 秒内用户在管理终端窗口没有交互操作,会自动断开连接
如果连接中断,每分钟内重新连接的次数不能超过 30 次
请求参数
名称 | 类型 | 是否必须 | 描述 |
---|---|---|---|
Action | String | 是 | 系统规定参数,取值:DescribeInstanceVncUrl |
RegionId | String | 是 | 查询的 ECS 实例所在的 Region |
InstanceId | String | 是 | 查询的 ECS 实例 |
返回参数
名称 | 类型 | 描述 |
---|---|---|
VncUrl | String | 管理终端 Url |
错误码
错误代码 | 描述 | Http 状态码 |
---|---|---|
InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 |
MissingParameter | The input parameter "InstanceId" that is mandatory for processing this request is not supplied. | 400 |
IncorrectInstanceStatus | The current status of the resource does not support this operation. | 403 |
InternalError | The request processing has failed due to some unknown error. | 500 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=DescribeInstanceVncUrl
&DescribeInstanceVncUrl
&InstanceId=AY121018033933eae8689
&<公共请求参数>
返回示例
XML格式
1450F2D7-5435-4420-BBC9-49C514B0157E
ws%3A%2F%2Fhz01-vncproxy.aliyun.com%2Fwebsockify%2F%3Fs%3DDvh%252FIA%252BYc73gWO48cBx2gBxUDVzaAnSKr74pq30mzqUYgeUMcB%252FbkNixDxdEA996
JSON格式
{
"RequestId": "1450F2D7-5435-4420-BBC9-49C514B0157E",
"VncUrl": "ws%3A%2F%2Fhz01-vncproxy.aliyun.com%2Fwebsockify%2F%3Fs%3DDvh%252FIA%252BYc73gWO48cBx2gBxUDVzaAnSKr74pq30mzqUYgeUMcB%252FbkNixDxdEA996"
}