创建自定义镜像

最近更新时间:2023-08-09 11:39:39

说明:

当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。云服务器 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 云服务器 API 3.0

1. 接口描述

本接口(CreateImage)用于将实例的系统盘制作为新镜像,创建后的镜像可以用于创建实例。

接口请求域名:image.api.qcloud.com

  • 为了您的数据安全,请关闭实例后创建镜像。
  • 单个账号在每个地域最多支持创建10个自定义镜像。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数可参考公共请求参数

参数名称 类型 是否必选 描述
Version String 表示API版本号,主要用于标识请求的不同API版本。 本接口第一版本可传:2017-03-12。
InstanceId String 用于制作镜像的实例ID 。实例ID可以通过以下方式获取:
  • 通过DescribeInstances接口返回的InstanceId获取。
  • 通过实例控制台获取。
  • ImageName String 镜像名称;需要满足下列要求:
  • 不得超过20个字符。
  • 镜像名称不得重复。
  • ImageDescription String 镜像描述;需要满足下列要求:
  • 不得超过60个字符。
    不指定该参数时镜像描述为空。
  • Sysprep Boolean 创建镜像时是否启用 SysPrep( Windows only) 。其默认值为 False

    3. 输出参数

    参数名称 类型 描述
    RequestId String 唯一请求ID。每次请求都会返回一个唯一的 RequestId,当客户调用接口失败需要后台研发人员处理时需提供该 RequestId。

    4. 错误码

    以下错误码表仅列出了该接口的业务逻辑错误码,更多错误码详见公共错误码

    错误码 描述
    InvalidParameter.ValueTooLarge 参数长度超过限制。
    InvalidImageName.Duplicate 镜像名称与原有镜像重复。
    MutexOperation.TaskRunning 同样的任务正在运行。
    InvalidInstanceId.NotFound 没有找到相应实例。
    ImageQuotaLimitExceeded 镜像配额超过了限制。
    InvalidInstance.NotSupported 不被支持的实例。

    5. 示例

    请求参数

    https://image.api.qcloud.com/v2/index.php?Action=CreateImage
    &Version=2017-03-12
    &InstanceId=ins-6pb6lrmy
    &<公共请求参数>
    

    返回参数

    {
        "Response": {
            "RequestID": "354f4ac3-8546-4516-8c8a-69e3ab73aa8a"
        }
    }