操作云桌面实例
更新时间：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}