接口功能介绍
- 适用于不属于池化桌面池的云电脑。- 每次切换，云电脑的系统类型、规格类型必须相同。- 新旧镜像适用的系统类型与规格类型必须相同。
接口约束
无
URI
POST /v3/desktop/batch/changeImage
路径参数
无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionId | 是 | String | 资源池ID。 |
请求参数
请求头header参数
无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| desktopOidList | 是 | Array of Strings | 云电脑ID列表，可设置一个或多个，最多10个 | D0023092101180485 | |
| imageOid | 是 | String | 镜像ID | mi-yr404205jf6br4f1dyb03 | |
| includeDataDisk | 否 | Boolean | 切换整机镜像时，是否包括数据盘，默认为否。 | includeDataDisk |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 状态码。可能值： - 800：请求成功。 - 900：请求失败。 |
800 | |
| error | String | 错误码。 | ||
| message | String | 提示信息。 | OK. | |
| returnObj | Object | 返回数据结构体。 | { } | returnObj |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{"desktopOidList":["D0023092101180485"],"imageOid":"mi-yr404205jf6br4f1dyb03","includeDataDisk":null}
响应示例
{"statusCode":800,"message":"OK.","returnObj":{ }}
状态码
请参考 状态码
错误码
请参考 错误码
