创建自定义镜像

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
kaopuyun all right reserved,powered by GitbookUpdated Time: 2024-10-09 06:22:14

results matching ""

    No results matching ""