ImportImage

Description

You can use the imported image to create instances (RunInstances) 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 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).
• To use RAM to allow ECS to access OSS for your Alibaba Cloud account, follow these steps:
  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

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

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

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

Error codes

Error codes specific to this interface are as follows. For more information, see API Error Center.