接口说明

调用该接口时，您需要注意：

• 您必须提前上传镜像文件到对象存储OSS。具体操作，请参见上传文件。

• 首次导入镜像时，您必须提前通过访问控制RAM授权ECS访问您的OSS Bucket，否则会报错NoSetRoletoECSServiceAcount。您可以通过RAM管理控制台一键完成授权操作，具体的授权页面，请参见云资源访问授权。您也可以手动完成授权操作，部分操作中策略与权限如下所示。具体操作，请参见账号访问控制。

  1. 创建角色 AliyunECSImageImportDefaultRole（必须是这个名称，否则导入镜像会失败），角色的策略为：

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

  2. 在该角色下，添加系统策略 AliyunECSImageImportRolePolicy。您也可以创建自定义策略，权限必须包含：

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

• 不能删除正在导入的镜像，只能调用CancelTask取消导入镜像任务。
• 导入镜像的地域必须跟镜像文件上传的OSS Bucket的地域相同。
• 参数DiskDeviceMapping.N中N的取值范围为1~17。N为1时表示系统盘，N为2~17时表示数据盘。
• 当您设置的参数为Architecture=arm64或者Platform=Anolis时，您需要注意：
  • 为了使导入后的镜像支持配置密码或者支持修改密钥对，镜像必须满足以下条件：
    • 操作系统的内核需要支持CONFIG_FW_CFG_SYSFS特性。Linux社区内核4.6版本之后默认支持该特性，CentOS的内核在3.10.0-826.el7版本之后默认支持该特性。您可以在该镜像对应的服务器内运行grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)命令，如果回显结果中包含CONFIG_FW_CFG_SYSFS=y信息，则说明该镜像中的内核已支持CONFIG_FW_CFG_SYSFS特性。
    • 操作系统中已安装阿里云最新版本cloud-init。其中，19.1版本cloud-init必须在19.1.3版本及以上，部分低版本操作系统中的0.7.6a版本cloud-init必须在0.7.6a15版本及以上。具体操作，请参见安装cloud-init。
    • 操作系统需要支持SHA-512加密算法。
  • 为了使导入后的镜像支持扩容云盘与扩容文件系统，镜像必须满足以下条件：
    • 操作系统的内核版本需要高于3.6版本。
    • 支持growpart命令。支持该命令需要安装cloud-utils-growpart包，不同操作系统安装方式有所不同。具体操作，请参见扩展分区和文件系统_Linux系统盘。
    • 支持resize2fs命令。支持该命令需要安装e2fsprogs包，该包在操作系统中默认已安装，如果没有安装您需要自行安装。
    • 操作系统中已安装阿里云最新版本cloud-init。其中，19.1版本cloud-init必须在19.1.3版本及以上，部分低版本操作系统中的0.7.6a版本cloud-init必须在0.7.6a15版本及以上。具体操作，请参见安装cloud-init。

请求参数

返回数据

示例

请求示例

https://ecs.aliyuncs.com/?Action=ImportImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.Format=QCOW2
&DiskDeviceMapping.1.OSSBucket=ecsimageos
&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw
&DiskDeviceMapping.1.DiskImageSize=80
&ImageName=Test
&Description=Test
&Architecture=x86_64
&OSType=linux
&Platform=Aliyun
&LicenseType=Aliyun
&<公共请求参数>

正常返回示例

XML格式

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

<ImportImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>m-bp67acfmxazb4p****</ImageId>
    <RegionId>cn-hangzhou</RegionId>
    <ImportTaskId>t-bp67acfmxazb4p****</ImportTaskId>
</ImportImageResponse>

JSON格式

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

{
  "RequestId" : "C8B26B44-0189-443E-9816-D951F59623A9",
  "ImageId" : "m-bp67acfmxazb4p****",
  "RegionId" : "cn-hangzhou",
  "ImportTaskId" : "t-bp67acfmxazb4p****"
}

错误码

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