创建BEC虚机镜像
更新时间：2025-08-05
接口描述
本接口基于BEC虚机实例创建自定义镜像，或者基于快照ID创建自定义镜像。
- 如果存在还未完成的镜像则不允许创建新镜像。
- 基于快照ID创建镜像：快照状态必须是created，一个快照只能创建一个自定义镜像。
请求结构
Plain Text
1 POST /v1/vm/image HTTP/1.1
2 Host: bec.baidubce.com
3 Content-Type: application/json; charset=utf-8
4 Authorization: authorization string
5
6 {
7 "vmId": "vm-fr8m8klg-0-m-hangzhou-xxxx",
8 "snapshotId": "",
9 "name": "imageName"
10 }
11 请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| vmId | String | / | RequestBody参数 | 基于虚机实例ID创建镜像 (与snapshotId二选一） |
| snapshotId | String | / | RequestBody参数 | 基于虚机系统盘快照ID创建镜像(与vmId二选一） |
| name | String | 是 | RequestBody参数 | 镜像名称，长度为1~65位的字符，包括英文、数字和符号。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功，true：成功；false：失败 |
| result | String | 自定义镜像ID |
错误码
请参照错误返回章节的内容。
请求示例
Plain Text
1 POST /v1/vm/image HTTP/1.1
2 Host: bec.baidubce.com
3 Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5 {
6 "vmId": "vm-fr8m8klg-0-m-hangzhou-xxxx",
7 "name": "imageName"
8 }响应示例
Plain Text
1 HTTP/1.1 200 OK
2 Content-Type: application/json;charset=UTF-8
3 Date: Wed, 08 Jul 2015 03:28:11 GMT
4 x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
5 Server: BWS
6
7 {
8 "result": "im-xxxxxxxx-1-m-hangzhou",
9 "success": true
10 }