Elastic Compute Service:ExportImage

Usage notes

Before you export images, take note of the following items:

• You must make sure that you are familiar with the prerequisites and precautions. For more information, see Export images.

• You must use Resource Access Management (RAM) to create a RAM role for Elastic Compute Service (ECS) and authorize ECS to write data to OSS. To complete the authorization, perform the following operations:

  1. Create a role named AliyunECSImageExportDefaultRole and 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 that grants ECS the permissions to export images. For more information, go to the Cloud Resource Access Authorization page. You can also 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, take note of the following items:

The custom image is stored 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

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

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

Error codes

For a list of error codes, see Service error codes.