420      windows

創建自定義鏡像__鏡像相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

創建的自定義鏡像，隻有等待狀態變為可用才能使用，可以使用鏡像進行創建新的ECS實例或者對已有實例進行更換係統盤。創建自定義鏡像，可以通過三種方式來創建，來滿足您不同業務場景。

1.如果您隻需要對實例的係統盤創建自定義鏡像，那麼隻需要指定一個快照Id進行創建自定義鏡像。

• 隻有係統盤的快照可以用於創建自定義鏡像。
• 隻有達到完成狀態（進度為100%）的快照可以用於創建自定義鏡像。
• 被安全控製在實例的OperationLocks中標記了”LockReason”: “security”的鎖定狀態時，不能創建自定義鏡像。
• 2013年7月15日（含）之前創建的快照，不能創建自定義鏡像。當Request因此原因被拒絕時，Response中的code為InvalidSnapshot.TooOld。

2.如果您需要對整個ECS實例做個模板，那麼可以指定實例Id進行創建自定義鏡像。

• 指定的實例的狀態隻能使運行中或者已停止
• 會給該實例的每塊磁盤新增一個快照
• 需要等待快照創建完成後，鏡像的狀態才能變成可用狀態，需要您等待一段時間。

3.如果您需要對多個快照進行組合成一個鏡像模板，那麼可以指定DiskDeviceMappings進行創建自定義鏡像。

• 隻能指定一個係統盤快照，指定係統盤快照的device必須為：/dev/xvda
• 可以不指定快照的Id，那麼會創建一個指定大小的沒有任何數據的空盤。
• 隻有達到完成狀態（進度為100%）的快照可以用於創建自定義鏡像。
• 被安全控製在實例的OperationLocks中標記了”LockReason”: “security”的鎖定狀態時，不能創建自定義鏡像。
• 2013年7月15日（含）之前創建的快照，不能創建自定義鏡像。當Request因此原因被拒絕時，Response中的code為InvalidSnapshot.TooOld。

請求參數

返回參數

錯誤碼

示例

請求示例

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"
}

最後更新：2016-11-23 16:03:50

  上一篇： 查詢可用鏡像__鏡像相關接口_API 參考_雲服務器 ECS-阿裏雲

  下一篇： 修改鏡像屬性__鏡像相關接口_API 參考_雲服務器 ECS-阿裏雲