云服务器 ECS：ImportImage

接口说明

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

• 您必须提前上传镜像文件到对象存储OSS。具体操作，请参见上传文件。
• 为避免部分服务器、虚拟机或者云主机的操作系统在导入自定义镜像后，创建的ECS实例无法启动，您需要在导入镜像前检查是否需要在源服务器中安装virtio驱动。具体操作，请参见安装virtio驱动。

• 首次导入镜像时，您必须提前通过访问控制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时表示数据盘，当N大于17时系统会自动忽略。
• 当参数Architecture取值为arm64，或者参数Platform取值为CentOS Stream、Anolis、AlmaLinux、UOS、Kylin或Rocky Linux时，您需要注意：
  • 为了使导入后的镜像支持配置密码或者支持修改密钥对，镜像必须满足以下条件：
    • 操作系统的内核需要支持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。
• 如果您待导入的自定义镜像对应的系统架构为arm64时，您需要设置其RTC时钟使用UTC时间标准。具体操作，请参见Linux时间和时区说明。
• 强烈建议在导入镜像时配置镜像检测参数，有助于系统帮助优化您的镜像。更多信息，请参见镜像检测概述。

请求参数

返回数据

示例

请求示例

http(s)://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
&DetectionStrategy=Standard
&公共请求参数

正常返回示例

XML格式

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

<ImportImageResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
    <ImageId>m-bp67acfmxazb4p****</ImageId>
    <TaskId>t-bp67acfmxazb4p****</TaskId>
    <RegionId>cn-hangzhou</RegionId>
</ImportImageResponse>

JSON格式

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "ImageId" : "m-bp67acfmxazb4p****",
  "TaskId" : "t-bp67acfmxazb4p****",
  "RegionId" : "cn-hangzhou"
}

错误码

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