跨Region复制镜像CopyImageCrossRegion
功能介绍
该接口为扩展接口，用户在一个区域制作的私有 镜像 ，可以通过跨Region复制镜像将镜像复制到其他区域，在其他区域发放相同类型的 云服务器 ，帮助用户实现区域间的业务 迁移 。
该接口为异步接口，返回job_id说明任务下发成功，查询异步任务状态，如果是success说明任务执行成功，如果是failed说明任务执行失败。
约束与限制
调试
您可以在API Explorer中调试该接口。
请求消息
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
镜像名称。name参数说明请参考镜像属性。 |
|
description |
否 |
String |
镜像描述信息。_description参数说明请参考镜像属性。支持字母、数字、中文等，不支持回车、<、>，长度不能超过1024个字符。默认为空。 |
|
region |
是 |
String |
目的区域的Region ID。 如何获取Region ID列表，请参见“查询区域列表”。 |
|
project_name |
是 |
String |
目的区域的项目名称。 |
|
agency_name |
是 |
String |
委托名称。 怎样创建 IAM 委托，请参见“如何创建IAM委托？”。 |
|
vault_id |
否 |
String |
存储库ID。 如果是整机镜像，则在跨Region复制镜像时，为必选参数，需传入该值。 |
请求示例
- 跨Region复制镜像，其中，目的区域的Region ID为“region-1”、目的区域的项目名称为“project-1”。
POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/cross_region_copy { "name":"test-copy-1001-4", "description":"test", "region":"region-1", "project_name":"project-1", "agency_name":"ims_copy_image" }
- 跨Region复制整机镜像，其中，目的区域的Region ID为“region-1”、目的区域的项目名称为“project-1”、存储库ID为“6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61”。
POST https://{Endpoint}/v1/cloudimages/465076de-dc36-4aec-80f5-ef9d8009428f/cross_region_copy { "name":"test-copy-1001-4", "description":"test", "region":"region-1", "project_name":"project-1", "agency_name":"ims_copy_image", "vault_id":"6yhtb5df-1bc3-4c3f-893e-3e4716yhgt61" }
响应消息
- 响应参数
参数
参数类型
描述
job_id
String
异步任务ID。
- 响应样例
STATUS CODE 200
{ "job_id": "edc89b490d7d4392898e19b2deb34797" }
返回值
- 正常
- 异常
返回值
说明
400 Bad Request
请求错误，具体返回错误码请参错误码。
401 Unauthorized
鉴权失败。
403 Forbidden
没有操作权限。
404 Not Found
找不到资源。
500 Internal Server Error
服务内部错误。
503 Service Unavailable
服务不可用。
