复制镜像
描述
复制镜像可以把用户的某个地域的自定义镜像复制到其他地域进行跨地域一致性部署,在其他地域可以使用复制后的镜像进行创建实例和更换系统盘等操作。
只有自定义镜像为可用状态才可以进行复制。
复制的镜像只能在本账号下进行,不能跨账号进行复制
该镜像没有复制完成,是不能进行删除操作,可以进行取消复制操作。
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数,取值:CopyImage
RegionId
String
是
源自定义镜像的 regionId
ImageId
String
是
源自定义镜像的 ID
DestinationRegionId
String
是
复制到目标 regionId
DestinationImageName
String
否
目标镜像名称,[2, 128] 英文或中文字符,必须以大小字母或中文开头,可包含数字,”_”或”-”。不能以 // 和 https:// 开头。
DestinationDescription
String
否
目标镜像的描述信息,长度限制在 0 ~ 256 个字符,不填则为空,默认为空。不能以 // 和 https:// 开头。
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性。
返回参数
名称 |
类型 |
描述 |
ImageId
String
目标镜像的 ID
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
MissingParameter
An input parameter "RegionId" that is mandatory for processing the request is not supplied.
400
缺少 RegionId 值
MissingParameter
An input parameter "ImageId" that is mandatory for processing the request is not supplied.
400
缺少 ImageId 的值
MissingParameter
An input parameter "DestinationRegionId" that is mandatory for processing the request is not supplied.
400
缺少 DestinationRegionId 值
InvalidImageId.NotFound
The image does not exist.
403
指定的源镜像 Id 不存在
InvalidImageName.Malformed
The specified destination Image name is wrongly formed.
400
指定的目标镜像名称不合法
InvalidDescription.Malformed
The specified destination image description is wrongly formed.
400
指定的目标镜像描述不合法
SourceRegion.NotFound
The source region not found.
400
指定的源镜像的 regionId 不存在
DestinationRegion.NotFound
The destination region not found
400
指定的源镜像的 regionId 不存在
IncorrectImageStatus
The image is not available.
400
指定的源镜像状态不正确
InvalidImageName.Duplicated
The destination image is exist.
400
目标镜像名称已经重复
QuotaExceed.Image
The Image Quota exceeds.
403
已经超过自定义镜像配额限制,不能再进行镜像复制
QuotaExceed.Snapshot
The Snapshot Quota exceeds.
403
已经超过快照的配额限制,不能再进行镜像复制。
Forbbiden
User not authorized to operate on the specified resource
400
没有权限进行复制镜像
OperationDenied.ImageCopying
The Image is coping.
403
指定的源镜像正在进行复制,不能进行再进行复制。
RegionNotSupportCopy
The region not support copy.
403
指定的目标镜像 region 或者源镜像 region 暂时不支持镜像复制
IncorrectDestinationRegion
The destination region is not equal the target region.
403
复制镜像的源 region 不能等于目标 region
示例
请求示例
https://ecs.aliyuncs.com/?Action=CopyImage
&DestinationRegionId=cn-hangzhou
&ImageId=m-281234567
&RegionId=cn-qingdao
&<公共请求参数>
返回示例
【点击图片进入下一页或下一篇】
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
"ImageId": "Img-231234567"
}
所属专题: