ExportImage - 导出一份自定义镜像到OSS

导出一份自定义镜像到与自定义镜像同一地域的OSS Bucket里。

接口说明

导出镜像前:

  • 您需要先了解前提条件以及注意事项。更多信息,请参见导出镜像

  • 设置参数ImageFormat镜像导出格式功能仅在部分地域可用,支持的地域有日本(东京)、印度尼西亚(雅加达)、德国(法兰克福)、阿联酋(迪拜)、美国(弗吉尼亚)、英国(伦敦)、新加坡、马来西亚(吉隆坡)和美国(硅谷)。不支持设置镜像格式的地域,默认导出 RAW 格式的镜像。

  • 您必须通过 RAM 授权云服务器 ECS 写入 OSS 的权限。具体操作说明如下:

    • 创建角色:AliyunECSImageExportDefaultRole(其他任何角色名称无效),为该角色设置以下角色策略:
         {
           "Statement": [
             {
               "Action": "sts:AssumeRole",
               "Effect": "Allow",
               "Principal": {
                 "Service": [
                   "ecs.aliyuncs.com"
                 ]
               }
             }
           ],
           "Version": "1"
         }
      
    • 在角色AliyunECSImageExportDefaultRole下加入默认的系统权限策略:AliyunECSImageExportRolePolicy,该策略是云服务器 ECS 提供导出镜像的默认策略。更多详情,请参见云资源访问授权。您也可以创建自定义策略,权限需要包含:
           {
             "Version": "1",
             "Statement": [
               {
                 "Action": [
                   "oss:GetObject",
                   "oss:PutObject",
                   "oss:DeleteObject",
                   "oss:GetBucketLocation",
                   "oss:GetBucketInfo",
                   "oss:AbortMultipartUpload",
                   "oss:ListMultipartUploads",
                   "oss:ListParts"
                 ],
                 "Resource": "*",
                 "Effect": "Allow"
               }
             ]
           }
      

导出镜像后:

自定义镜像将保存在指定的 OSS bucket 中,您可以下载自定义镜像。具体操作,请参见下载自定义镜像文件

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:ExportImageupdate
*Image
acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

请求参数

名称类型必填描述示例值
RegionIdstring

自定义镜像的地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
ImageIdstring

自定义镜像 ID。

m-bp67acfmxazb4p****
OSSBucketstring

保存导出镜像的 OSS bucket。

testexportImage
OSSPrefixstring

您的 OSS Object 的前缀。可以由数字或者字母组成,字符长度为 1~30。

EcsExport
ImageFormatstring

镜像文件的导出格式。取值范围:

  • raw。
  • vhd。
  • qcow2。
  • vmdk。
  • vdi。

默认值:raw。

raw
RoleNamestring

导出镜像时使用的 RAM 角色名称。

AliyunECSImageExportDefaultRole

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

C8B26B44-0189-443E-9816-D951F596****
TaskIdstring

导出镜像任务 ID。

tsk-bp67acfmxazb4p****
RegionIdstring

地域 ID。

cn-hangzhou

示例

正常返回示例

JSON格式

{
  "RequestId": "C8B26B44-0189-443E-9816-D951F596****",
  "TaskId": "tsk-bp67acfmxazb4p****",
  "RegionId": "cn-hangzhou"
}

错误码

HTTP status code错误码错误信息描述
400MissingParameterAn input parameter "RegionId" that is mandatory for processing the request is not supplied.-
400MissingParameterAn input parameter "ImageId" that is mandatory for processing the request is not supplied.-
400MissingParameterAn input parameter "OSSBucket" that is mandatory for processing the request is not supplied.-
400InvalidImageName.MalformedThe specified Image name is wrongly formed.镜像名称格式错误。长度为2~128个字符。必须以大小字母或中文开头,不能以aliyun和acs:开头,不能包含http://或者https://。可以包含数字、半角句号(.)、半角冒号(:)、下划线(_)或者短划线(-)。
400InvalidOSSPrefix.MalformedThe specified OSSPrefix format is wrongly formed.参数 OssPrefix 格式错误。
400InvalidRegionId.NotFoundThe specified RegionId does not exist.指定的地域 ID 不存在。
400InvalidRegion.NotSupportThe specified region does not support image import or export.指定的地域暂时不支持此操作。
400IncorrectImageStatusThe specified Image is not available.指定的源镜像状态不正确。
400InvalidImageFormat.MalformedThe specified Image Format is wrongly formed.指定的镜像格式错误。
400InvalidOSSBucket.NotFoundThe specified OSS bucket does not exist in this region.指定的 bucket 不存在。
400OperationDeniedThe specified image contains the snapshot of the data disk,does not support this operation.包含了数据盘快照的镜像,不支持此操作。
400InvalidImage.DiskAmountOrSize%s无效的镜像,导出的镜像限制数据盘数不能超过 4 块,单块数据盘容量最大不能超过 500 GiB。
400ImageNotSupportedThe specified Image contains encrypted snapshots, do not support export.指定的镜像包含了加密快照,不支持导出。
400InvalidOSSObject.NeedRestoreThe specified OSS object is a archive object, need restore first.-
400InvalidOSSBucket.NotMatchedThe specified OSS bucket is incorrect, %s.指定的 OSS Bucket 有误,具体信息请参见错误信息的实际返回结果。
400InvalidImage.DiskAmountOrSizeThe diskSize of the image exceeds the maximum size.-
400InvalidImageFormat.RegionNotSupportedThe specified image format is not supported in current region.-
403ImageNotSupportedThe specified image from the image market, do not support export image.指定的镜像来自云市场镜像,此镜像不能导出。
403ImageIsExportingThe specified Image is exporting.指定的镜像正在导出。
403ExportImageFailedExporting image is failed, Please contact the administrator.导出镜像失败,请联系系统管理员。
403UserNotInTheWhiteListThe user is not in the white list of exporting image.该用户不在导出镜像白名单中。
403NoSetRoletoECSServiceAcountECS service account Have no right to access your OSS.please attach a role of access your oss to ECS service account.ECS 官网服务账号没有权限访问您指定的 OSS 的 bucket 和 Object。
403InvalidOSS.NotAuthorizedThe specified OSS bucket or object is not allowed to access.-
403ConcurrentQuotaExceed.ExportImage%s当前处理中的任务,已达到并发最大额度,请耐心等待一段时间再创建任务。
403WeeklyQuotaExceed.ExportImage%s本周提交任务已经超出配额,请耐心等候再次分配可用额度。
403InvalidImageLicense.NotSupported%s指定的镜像不支持导出。具体信息请参见错误信息%s占位符的实际返回值。
403InvalidImageCategory.NotSupportedThe specified image category is not supported.-
403InvalidOSSBucket.EncryptUnsupportedAccessing objects from encrypted OSS bucket is not supported.不支持从加密的OSS bucket读取对象。
404InvalidImageId.NotFoundThe specified ImageId does not exist.指定的镜像在该用户账号下不存在,请您检查镜像 ID 是否正确。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-12-17OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
2023-05-26OpenAPI 错误码发生变更查看变更详情