CreateCustomImage

使用说明

自定义镜像是您通过轻量应用服务器的快照创建的镜像。您可以通过已配置好的自定义镜像创建更多包含相同配置的轻量应用服务器，也可以将自定义镜像共享至云服务器ECS，进而通过共享镜像创建ECS实例或更换操作系统。

关于自定义镜像的更多消息，请参见自定义镜像概述。

创建自定义镜像之前，您需要先创建轻量应用服务器的系统盘快照。具体操作，请参见CreateSnapshot。

创建自定义镜像时，您需要先阅读以下注意事项：

• 创建的自定义镜像所属地域与对应的轻量应用服务器所属地域相同。
• 创建的自定义镜像数量上限为已创建的服务器数量的3倍，但最多不超过15个。
• 只有服务器的系统盘快照可以直接创建自定义镜像。如果您需要自定义镜像中包含服务器的数据盘数据，在创建自定义镜像的过程中，需要手动选择对应的数据盘快照。
• 如果轻量应用服务器到期或者退款后释放，该服务器对应的自定义镜像也会随之释放。
• 重置系统或更换镜像会清除服务器上的磁盘数据，请您根据需要做好数据备份。

QPS限制

本接口的单用户QPS限制为10次/分钟。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

请求参数

返回数据

示例

请求示例

http(s)://swas.cn-hangzhou.aliyuncs.com/?Action=CreateCustomImage
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&InstanceId=ace0706b2ac4454d984295a94213****
&ImageName=customImage-test
&SystemSnapshotId=s-acscasca****
&Description=test
&DataSnapshotId=s-acscasca****
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateCustomImageResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <ImageId>m-csaascsaccscs****</ImageId>
</CreateCustomImageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ImageId" : "m-csaascsaccscs****"
}

错误码

访问错误中心查看更多错误码。