CreateImage_云服务器 ECS_API文档

注意事项

• 本接口为异步接口，创建自定义镜像请求发送成功后会返回镜像 ID，镜像的创建不是立即完成的，需要调用 DescribeImage 查看镜像信息，当返回信息中的状态为Available时代表镜像创建成功并可用。更多信息，请参见自定义镜像概述。

• 查询 ECS 实例信息时，如果返回数据中包含{"OperationLocks": {"LockReason" : "security"}}，则禁止创建自定义镜像。

• 建议在创建镜像时配置镜像检测参数DetectionStrategy，有助于系统帮助优化您的镜像。更多信息，请参见镜像检测概述。

以下描述了三种通过该接口创建自定义镜像的方法。请求参数的优先级为：InstanceId > DiskDeviceMapping > SnapshotId，若您的请求中同时含有两个及以上参数，默认以优先级更高的参数为准创建镜像。

• 根据实例创建自定义镜像：指定实例 ID（InstanceId）。

  • 实例的状态必须为运行中（Running）或者已停止（Stopped）。
  • 接口调用成功后，实例的每块云盘均会新增一份快照。
  注意 由于运行中的实例存在缓存数据未落盘的情况，可能导致创建的自定义镜像数据与实例数据不完全一致，因此建议您停止实例（ StopInstances ）后创建镜像。

• 根据快照创建自定义镜像（指定的快照不能是 2013 年 7 月 15 日（含）之前创建的快照。）

  • 使用系统盘快照创建自定义镜像：只需指定实例系统盘的快照 ID（SnapshotId）。
  • 使用系统盘快照和数据盘快照创建自定义镜像：这需要建立几块云盘的数据关联（DiskDeviceMapping）。
    • 系统盘快照只能被指定一个。
    • 数据盘快照可以指定多个，最多不能超过 16 块。不指定DiskDeviceMapping.N.SnapshotId时会创建一个默认容量的空数据盘。