接口说明

导出镜像前：

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

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

  1. 创建角色： AliyunECSImageExportDefaultRole（其他任何角色名称无效），为该角色设置以下角色策略：

  {
             "Statement": [
               {
                 "Action": "sts:AssumeRole",
                 "Effect": "Allow",
                 "Principal": {
                   "Service": [
                     "ecs.aliyuncs.com"
                   ]
                 }
               }
             ],
             "Version": "1"
           }

  2. 在角色 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中，您可以下载自定义镜像。具体操作，请参见下载自定义镜像文件。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=ExportImage
&ImageId=m-bp67acfmxazb4p****
&OSSBucket=testexportImage
&RegionId=cn-hangzhou
&OSSPrefix=EcsExport
&ImageFormat=raw
&<公共请求参数>

正常返回示例

XML格式

<ExportImageResponse>
      <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
      <ExportTaskId>tsk-bp67acfmxazb4p****</ExportTaskId>
      <RegionId>cn-hangzhou</RegionId>
</ExportImageResponse>

JSON格式

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

错误码

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