：CreateImage

建立方法

以下描述了三種通過該介面建立自訂鏡像的方法。

方法一. 如果您需要針對某一台執行個體的系統硬碟建立自訂鏡像，只需要指定執行個體系統硬碟的一份曆史快照 ID （SnapshotId）。其中，指定的快照不能是 2013 年 7 月 15 日（含）之前建立的快照。

方法二. 如果您需要使用一台 ECS 執行個體做執行個體模板，只需要指定執行個體 ID （InstanceId）。該台執行個體的狀態必須為 運行中（Running）或者 已停止（Stopped）。介面調用成功後，該台執行個體的每塊磁碟均會新增一份快照。

方法三. 如果您需要將多個快照組合成一個鏡像模板，只需要建立幾個磁碟資料關聯（DiskDeviceMapping）。通過這種方法建立自訂鏡像時，您需要注意：

• 只能指定一個系統硬碟快照，系統硬碟的裝置名稱必須為 /dev/xvda。

• 可以指定多個資料盤快照，資料盤裝置名稱預設由系統有序分配，從 /dev/xvdb 依次排序到 /dev/xvdz，不能重複。

• 可以不指定 SnapshotId，不指定時會建立一個指定大小的沒有任何資料的空資料盤。

• 指定的快照不能是 2013 年 7 月 15 日（含）之前建立的快照。

請求樣本

https://ecs.aliyuncs.com/?Action=CreateImage
&RegionId=cn-hangzhou
&SnapshotId=s-snapshot1
&ImageName=demo_image
&<公用請求參數>

返回樣本

XML 格式

<CreateImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>m-63DFD5FB2</ImageId>
</CreateImageResponse>

JSON 格式

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "ImageId": "m-63DFD5FB2"
}