ExportImage

Description

Before you export images:

• You must first understand the prerequisites and precautions. For more information, see Export images.

• You must use Resource Access Management (RAM) to create a RAM role for ECS and authorize ECS to write data to OSS. Perform the following operations:

  1. Create a role named AliyunECSImageExportDefaultRole. All other role names are invalid. Configure the following trust policy for the role:

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

  2. Attach the AliyunECSImageExportRolePolicy system policy to the AliyunECSImageExportDefaultRole role. This policy is the default policy used for ECS to export images. For more information, go to the Cloud Resource Access Authorization page. Alternatively, you can create a custom policy that contains the following content and attach the policy to the role:

  
           {
             "Version": "1",
             "Statement": [
               {
                 "Action": [
                   "oss:GetObject",
                   "oss:PutObject",
                   "oss:DeleteObject",
                   "oss:GetBucketLocation",
                   "oss:GetBucketInfo",
                   "oss:AbortMultipartUpload",
                   "oss:ListMultipartUploads",
                   "oss:ListParts"
                 ],
                 "Resource": "*",
                 "Effect": "Allow"
               }
             ]
           }
          

After you export the images:

The custom image is saved in the specified OSS bucket. You can download the custom image. For more information, see Download objects.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ExportImage
&ImageId=m-bp67acfmxazb4p****
&OSSBucket=testexportImage
&RegionId=cn-hangzhou
&OSSPrefix=EcsExport
&ImageFormat=raw
&<Common request parameters>

Sample success responses

XML format

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

JSON format

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

Error codes

For a list of error codes, visit the API Error Center.