创建自定义镜像
1. 接口描述
调用 CreateImage 接口创建一份自定义镜像。您可以使用创建的自定义镜像创建实例（CreateInstance）或者重装操作系统（ReInstallInstance）。
2. 请求参数
| 名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| Action | String | 是 | 固定取值：CreateImage |
| RegionCode | String | 是 | 镜像所属的地域编码，您可以调用 DescribeRegionConfig 查看最新的地域列表 |
| ZoneCode | String | 是 | 镜像所属的可用区编码，您可以调用 DescribeZoneConfig 查看可用区列表 |
| SnapshotUUID | String | 是 | 快照ID |
| ImageName | String | 是 | 镜像名称，长度为2~128个英文或中文字符 |
| Description | String | 否 | 描述，长度为2~256个英文或中文字符 |
3. 返回数据
| 名称 | 类型 | 说明 |
|---|---|---|
| ImageUUID | String | 镜像ID |
| RequestId | String | 请求ID |
4. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=CreateImage
&Format=JSON
&RegionCode=cn-fuzhou-5
&ZoneCode=cn-fuzhou-5-a
&SnapshotUUID=snp-22425533aa
&ImageName=Test
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%3D
正常返回示例
{
"ImageUUID":"img-z500000czmnb",
"RequestId":"742fbe80-0ea9-11eb-9b36-0208cb7f7896"
}
5. 错误码
| 错误码 | 错误信息 |
|---|---|
| MissingParameter | RegionCode 参数不能为空 |
| MissingParameter | ZoneCode 参数不能为空 |
| MissingParameter | SnapshotUUID 参数不能为空 |
| MissingParameter | ImageName 参数不能为空 |
| AvailableRegionNotFound | 可用的地域未找到 |
| AvailableZoneNotFound | 可用的区域未找到 |
| AvailableDiskNotFound | 可用磁盘未找到 |
| AvailableSnapshotNotFound | 可用快照未找到 |
| IncorrectImageStatus.ExceedMaxQuantity | 镜像数量超过最大值 |
| IncorrectDiskStatus.CreateSnapshot | 当前磁盘正在创建快照 |
| IncorrectDiskStatus.CountOutLimit | 磁盘快照数量超出限制 |
| IncorrectDiskStatus.NotYetOneHour | 系统盘创建还未超过1个小时 |
| InvalidImageStatus.Locked | 非法镜像状态—已锁定 |
| DiskNotAttached | 磁盘未挂载 |
| InvalidDiskType | 磁盘类型错误 |
| AvailableInstanceNotFound | 可用云服务器未找到 |
| InvalidInstanceStatus.NotStarted | 非法云服务器状态—不是开机状态 |
| CreateImageFail | 创建镜像失败:xxx |