全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

ExportImage

更新时间:2017-09-13 12:56:42

描述

导出镜像是把用户自定义镜像导出到与该自定义镜像同一地域的 OSS bucket 里。

  • 需要申请加入白名单才能使用。
  • 不支持导出以下 2 种自定义镜像:
    • 自定义镜像中包括数据盘快照的信息。
    • 使用市场镜像的系统盘快照创建的自定义镜像。
  • 需要通过 RAM 授权云服务器 ECS 官方服务账号写入 OSS 的权限:
    1. 创建角色:AliyunECSImageExportDefaultRole(其他任何角色名称无效),为该角色设置以下角色策略:
      1. {
      2. "Statement": [
      3. {
      4. "Action": "sts:AssumeRole",
      5. "Effect": "Allow",
      6. "Principal": {
      7. "Service": [
      8. "ecs.aliyuncs.com"
      9. ]
      10. }
      11. }
      12. ],
      13. "Version": "1"
      14. }
    2. 在角色 AliyunECSImageExportDefaultRole 下加入默认的系统权限策略:AliyunECSImageExportRolePolicy,该策略是云服务器 ECS 提供导出镜像的默认策略。用户也可以创建自定义策略,权限需要包含:
      1. {
      2. "Version": "1",
      3. "Statement": [
      4. {
      5. "Action": [
      6. "oss:GetObject",
      7. "oss:PutObject",
      8. "oss:DeleteObject",
      9. "oss:GetBucketLocation",
      10. "oss:AbortMultipartUpload",
      11. "oss:ListMultipartUploads",
      12. "oss:ListParts"
      13. ],
      14. "Resource": "*",
      15. "Effect": "Allow"
      16. }
      17. ]
      18. }

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数。取值:ExportImage
RegionId String 自定义镜像的 RegionId。Region ID 的列表详见 地域列表
ImageId String 自定义镜像的 ID。
OssBucket String 镜像导出到的 OSS bucket。
OssPrefix String 用户的 OSS 的 Object 的前缀。可以由数字或者字母组成,字符长度为 [1, 30]。
ClientToken String 用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。
具体参见附录:如何保证幂等性

返回参数

名称 类型 描述
RegionId String 地域 ID
ExportTaskId String 导出镜像任务 ID

错误码

错误代码 描述 Http 状态码 语义
Forbidden User is not authorized to operate on the specified image. 400 用户没有权限导出镜像。
IncorrectImageStatus The image is not available. 400 指定的镜像暂不可用。
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 OssBucket that is mandatory for processing the request is not supplied. 400 缺少 OssBucket 值。
OssBucket.NotFound The specified OssBucket does not exist. 400 指定的 OSS bucket 在当前地域下不存在。
OssPrefix.Malformed The specified OssPrefix format is incorrect. 400 指定的 OSS 的 Object 的前缀格式不合法。
RegionId.NotFound The specified RegionId does not exist. 400 指定的镜像的 RegionId 不存在。
ExportImageFailed Failed to export image. 403 导出镜像失败。
ImageId.NotFound The image does not exist. 403 指定的镜像 ID 不存在。
ImageNotSupported The specified image is from the image market and does not support export. 403 指定的镜像来自镜像市场,不支持导出。
InvalidRegion.NotSupport The specified region does not support image import or export. 403 指定的地域暂时不支持导入或导出镜像。
OperationDenied.ImageExporting The specified image is being exported. 403 正在导出指定的镜像。

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=ExportImage
  2. &RegionId=cn-hangzhou
  3. &ImageId=m-231234567
  4. &OssBucket=testexportImage
  5. &<公共请求参数>

返回示例

XML 格式

  1. <ExportImageResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. <ExportTaskId>tsk-231234567</ExportTaskId>
  4. <RegionId>cn-hangzhou</RegionId>
  5. </ExportImageResponse>

JSON 格式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
  3. "RegionId": "cn-hangzhou",
  4. "ExportTaskId": "tsk-231234567"
  5. }
本文导读目录