跨地域复制自定义镜像
所有文档
menu

云服务器 BCC

跨地域复制自定义镜像

产品详情自助选购

该接口用于用户跨地域复制自定义镜像,仅限自定义镜像,公共镜像和服务集成镜像不能复制。

  • imageId 所指定的镜像不存在,提示404错误。
  • 镜像复制成功后,用户可在目的地域使用此镜像创建、重置实例。

请求结构

POST /v{version}/image/{imageId}?{action} HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string

{
    "name" : "destImageName",
    "destRegion" : ["bj","gz"]
}

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String URL参数 API版本号
imageId String URL参数 待复制的镜像ID
action String Query参数 对镜像执行的动作,当前取值:remoteCopy
name String Request Body参数 复制镜像名
destRegion List Request Body参数 目的regionId,可以传多个

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
result List 远程复制结果

错误码

错误码 错误描述 HTTP状态码 中文解释
Image.RegionNotSupportCopy Region not support copy. 409 目的region不支持复制
Image.ImageStorageFormatInvalid Image storage format is invalid. 409 镜像存储格式不支持复制
Image.ImageNotSupportCopy Image not support copy. 409 非自定义镜像不能复制
Image.ImageStatusForbidden Image status is not Available. 409 镜像状态为不可用

请求示例

POST /v2/image/m-nky7qeom?remoteCopy HTTP/1.1
Host: bcc.bj.baidubce.com
ContentType: application/json
Date: Wed, 01 Mar 2006 12:00:00 GMT
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de

{
  "name": "test-copy-image",
  "destRegion": ["bj","gz"]
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
Date: Wed, 03 Dec 2014 06:42:19 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS

{
    "result": [
        {
            "region": "gz",
            "imageId": "m-3ev9sySj",
            "errMsg": "success",
            "code": "success"
        },
        {
            "region": "bj",
            "imageId": "m-3ev9sySj",
            "errMsg": "success",
            "code": "success"
        }
    ]
}
上一篇
取消跨地域复制自定义镜像
下一篇
修改自定义镜像名称