ImportImage

Description

Imports on-premises image files to the Alibaba Cloud ECS. You can use the imported image to create an instance (CreateInstance) or replace the system disk of an instance (ReplaceSystemDisk). When you call this interface, consider the following:

• You must upload the image file to OSS beforehand.

• You can only import an image file to a region from OSS in the same region. The image and the OSS must belong to one account.

• The n in DiskDeviceMapping.n indicates the disk type.

  • When n is set to 1, it represents a system disk.

  • When n is set to [2, 17], it represents a data disk.

• You cannot delete an image that is being imported. However, you can cancel the image import task (CancelTask).

• Follow these steps to use RAM allowing ECS to access OSS for your Alibaba Cloud account.

  1. Create a role with a name AliyunECSImageImportDefaultRole (image import fails if a different name is used), and see the following code snippet to set its role policy.

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

  2. Attach the default permission policy AliyunECSImageImportRolePolicy to AliyunECSImageImportDefaultRole. You can also create a custom policy with the following permissions:

     {
     "Version": "1",
     "Statement": [
      {
        "Action": [
          "oss:GetObject",
          "oss:GetBucketLocation"
        ],
        "Resource": "*",
        "Effect": "Allow"
      }
     ]
     }

Request parameters

Response parameters

Examples

Request example

https://ecs.aliyuncs.com/?Action=ImportImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.OSSBucket=ecsimageos
&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw
&<Common Request Parameters>

Response example

XML format

<ImportImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>Img-231234567</ImageId>
    <ImportTaskId>123-345-2332-22323</ImportTaskId>
</ImportImageResponse>

JSON format

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "ImageId": "Img-231234567",
    "ImportTaskId":"123-345-2332-22323"
}

Error codes