全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
云服务器 ECS

CopyImage

更新时间:2017-09-27 21:55:43

描述

复制镜像可以把用户某个地域的自定义镜像复制到其他地域进行跨地域一致性部署,在其他地域可以使用复制后的镜像创建实例和更换系统盘等操作。

  • 只有自定义镜像为可用(Available)状态才可以复制。
  • 只能在本账号下复制的镜像,不能跨账号复制。
  • 如果镜像没有复制完成,不能删除操作,可以取消复制。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值:CopyImage
RegionId String 源自定义镜像的 RegionId。RegionId 的列表详见 地域列表
ImageId String 源自定义镜像的 ID。
DestinationRegionId String 复制到目标 RegionId。RegionId 的列表详见 地域列表
DestinationImageName String 目标镜像名称。
  • 长度为 [2, 128] 个字符英文或中文字符,必须以大小字母或中文开头,可包含数字,下划线(_)或连字符(-)。
  • 不能以 http:// 和 https:// 开头。
不填则为空,默认值:空。
DestinationDescription String 目标镜像的描述信息。
  • 长度为 [0, 256] 个字符。
  • 不能以 http:// 和 https:// 开头。
不填则为空,默认值:空。

返回参数

名称 类型 描述
ImageId String 目标镜像的 ID

错误码

错误代码 描述 HTTP 状态码 语义
DestinationRegion.NotFound The destination region not found 400 指定的目标镜像的 RegionId 不存在。
IncorrectImageStatus The image not available. 400 指定的镜像状态不对。
InvalidDescription.Malformed The specified destination description is wrongly formed. 400 指定的 Description 不合法。
InvalidDescription.Malformed The specified description is wrongly formed. 400 指定的 Description 不合法。
InvalidImageId.NotFound The specified ImageId does not exist. 400 指定的源镜像 ID 不存在。
InvalidImageName.Duplicated The destination image is exist. 400 目标镜像名称已经重复。
InvalidImageName.Malformed The specified destination Image name is wrongly formed. 400 指定的目标镜像名称不合法。
InvalidImageName.Malformed The specified Image name is wrongly formed. 400 无效的ImageName取值(字符不支持或者超出长度)。
InvalidSnapshotId.NotFound The specified SnapshotId does not exist. 400 指定镜像的快照不存在。
SourceRegion.NotFound The source region not found 400 指定的源镜像的 RegionId 不存在。
Forbidden User not authorized to operate on the specified resource. 403 用户没有权限复制镜像。
IncorrectDestinationRegion The destination region is not equal the target region. 403 复制镜像的源 region 不能等于目标 region。
InvalidSnapshot.TooOld This operation is denied because the specified snapshot is created before 2013-07-15. 403 指定快照创建于 2013 年 7 月 15 日(含)之前。
OperationDeined.EncryptedSnapshot The image contains encrypted snapshots, which do not support copying. 403 该镜像含有加密快照,不支持复制。
OperationDenied The specified snapshot is not allowed to create image. 403 特定磁盘的快照不能创建镜像。
OperationDenied.ImageCopying The specified image is being copied. 403 镜像正在复制中。
QuotaExceed.Image The Image Quota exceeds. 403 已经超过自定义镜像配额限制,不能再镜像复制。
QuotaExceed.Snapshot The maximum number of snapshots is exceeded. 403 已经超过快照的配额限制,不能再镜像复制。
RegionNotSupportCopy The region not support copy. 403 指定的目标镜像 region 或者源镜像 region 暂时不支持镜像复制。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=CopyImage
  2. &DestinationRegionId=cn-hangzhou
  3. &ImageId=m-281234567
  4. &RegionId=cn-qingdao
  5. &<公共请求参数>

返回示例

XML 格式

  1. <CopyImageResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. <ImageId>Img-231234567</ImageId>
  4. </CopyImageResponse>

JSON 格式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  3. "ImageId": "Img-231234567"
  4. }
本文导读目录