云服务器同步镜像-云服务器 API 2017-API 中心-腾讯云

说明：

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

1. 接口描述

本接口（SyncImages）用于将自定义镜像同步到其它地区。
接口请求域名：image.api.qcloud.com

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

参数名称	类型	是否必选	描述
Version	String	是	表示API版本号，主要用于标识请求的不同 API 版本。本接口第一版本可传：2017-03-12。
ImageIds.N	array of Strings	是	镜像 ID 列表，镜像 ID 可以通过如下方式获取：通过 DescribeImages 接口返回的`ImageId`获取。通过镜像控制台获取。镜像 ID 必须满足限制：镜像 ID 对应的镜像状态必须为`NORMAL`。镜像大小小于50GB。
DestinationRegions.N	array of String	是	目的同步地域列表；必须满足限制：不能为源地域。必须是一个合法的Region。暂不支持部分地域同步。

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

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

错误码	描述
InvalidImageId.IncorrectState	镜像状态不合法。
InvalidImageId.NotFound	未找到该镜像。
InvalidImageId.Malformed	镜像 ID 格式错误。
InvalidImageId.TooLarge	镜像大小超过限制。
InvalidRegion.NotFound	未找到该区域。
InvalidRegion.Unavailable	该区域目前不支持同步镜像。

请求参数

https://image.api.qcloud.com/v2/index.php?Action=SyncImages
&Version=2017-03-12
&ImageIds.0=img-o3ycss2p
&DestinationRegions.0=ap-guangzhou
&<公共请求参数>

返回参数

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