操作云桌面实例
更新时间:2025-08-05
操作云桌面实例
接口描述
本接口用于操作云桌面实例,包括开机、关机、重启、备份、恢复
请求结构
JSON
1POST /v1/bvd/desktops/operate
2Host: bec.baidubce.com
3Authorization: authorization string
4X-Bce-Accesskey: accesskey
5
6{
7 "action": "",
8 "desktopIds": []
9}
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
action | 操作云桌面: start,stop,reboot,backup,restore | body | true | string | |
desktopIds | 桌面ID | body | true | array | string |
响应头域
除公共头域外,无其它特殊头域。
响应状态
状态码 | 说明 |
---|---|
200 | OK |
201 | Created |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
响应参数
参数名称 | 参数说明 | 类型 | schema |
---|---|---|---|
failedList | 失败的桌面ID列表 | array |
错误码
请参照错误返回章节的内容。
请求示例
JSON
1POST /v1/bvd/desktops/operate HTTP/1.1
2Host: bec.baidubce.com
3Authorization: bce-auth-v1/xxxxx
4
5{
6 "action": "stop",
7 "desktopIds": ["vd-afdxf-cn-baoding-ix-arjgj"]
8}
响应示例
JSON
1{
2 "failedList": []
3}