云服务器 ECS：导入自定义镜像

步骤1：将镜像文件上传至OSS

上传本地镜像文件至OSS，并获取文件URL。具体操作，请参见控制台快速入门（无需执行步骤四：下载文件）。

步骤2：在ECS控制台导入自定义镜像

1. 登录ECS管理控制台。

2. 在左侧导航栏，选择实例与镜像 > 镜像。

3. 在顶部菜单栏左上角处，选择地域。

   重要

   所选地域需与镜像文件的OSS Bucket地域保持一致。

   金融云地域说明

   同一个金融云地域，在ECS和OSS地域名称不同，具体的对应关系如下：

   • ECS的华东2金融云cn-shanghai-finance-1地域对应OSS的oss-cn-shanghai-finance-1-pub地域。

   • ECS的华南1金融云cn-shenzhen-finance-1地域对应OSS的oss-cn-szfinance地域。

   • ECS的华北2金融云cn-beijing-finance-1地域对应使用OSS的oss-cn-beijing-finance-1地域。

4. 在镜像页面右上角，选择导入镜像 > 导入镜像。

   

5. 在导入前准备配置向导页面，确认导入镜像的准备工作是否完成，然后单击下一步。

6. （条件必选）授权ECS访问OSS的权限。

   如果您是首次导入镜像还没有授予ECS对OSS资源的访问权限，您可以直接在导入镜像对话框进行操作。

   1. 在将本地镜像文件上传至OSS区域，单击AliyunECSImageImportDefaultRole。

   2. 在云资源访问授权页面，查看到AliyunECSImageImportDefaultRole角色，单击同意授权。

      说明

      操作完成后，系统会自动创建AliyunECSImageImportDefaultRole角色并授予权限。

7. 返回至导入镜像对话框，重新单击下一步。

8. 单击继续导入。

9. 在导入镜像文件配置向导页面，完成以下配置。

   参数	是否必填	说明
   当前地域	是	由系统自动设置为当前地域。如需更换地域，请在顶部菜单栏选择新的地域，并重新打开导入镜像对话框。
   镜像文件URL	是	填写步骤1获取的镜像文件URL。
   镜像名称	是	填写镜像文件导入后显示的名称。长度为2~128个字符，以大小写字母或中文开头，可包含数字、英文句号（.）、下划线（_）、半角冒号（:）和短划线（-）。
   操作系统类型	是	选择待导入镜像文件的操作系统类型，与镜像文件的操作系统类型保持一致。 操作系统类型包括windows和linux。当导入镜像的操作系统不在阿里云支持的平台列表中时，应选择linux。
   操作系统版本	是	选择待导入镜像文件的操作系统版本，与镜像文件的操作系统版本保持一致。 如果您的操作系统不在阿里云支持的平台列表中，您可以： 选择Customized Linux：确保已手动添加解析脚本，确保镜像可用。更多信息，请参见定制Linux镜像。 选择Others Linux：ECS不会对所创建的实例做任何处理。创建实例后，需要您自行在实例中配置IP、路由和密码等。 如果您的操作系统是根据Linux内核定制开发的，请提交工单联系我们。
   系统架构	是	与本地镜像文件的系统架构保持一致。支持的系统架构有： 32位操作系统 64位操作系统 Arm64位操作系统
   镜像检测	否	镜像检测功能主要检测导入的自定义镜像是否为有效镜像、自定义镜像是否可以创建出功能齐全的ECS实例等。 默认选中创建后执行检测。镜像检测功能会在该镜像导入完成后立即执行，检测完成后，您可以在自定义镜像列表的检测结果列查看检测详情，如果有待修复项，可以通过一键修复功能或者根据镜像详情中的修复建议手动修复。 说明 目前仅部分操作系统支持镜像检测功能，不支持的操作系统列表请参见镜像检测操作系统限制。
   启动模式	否	选择镜像的启动模式，包括BIOS和UEFI。 启动模式是指创建ECS实例过程中启动系统盘的方式，建议与镜像文件启动模式保持一致，否则使用自定义镜像创建的ECS实例可能无法正常启动。
   镜像格式	否	支持自动检测（默认值）或选择RAW、QCOW2、VHD格式，建议与镜像文件格式保持一致。 如果您不清楚镜像格式，可选择自动检测，系统将自动设置镜像格式与您本地的镜像文件格式一致。 说明 ECS不支持直接导入ISO镜像文件，需要将镜像文件转换为ECS支持的镜像文件格式后再导入。更多信息，请参见ISO镜像文件如何转换为ECS支持的镜像格式？。
   许可证类型	否	镜像导入之后，激活源操作系统所需使用的许可证类型。取值范围： 自动检测（默认值）：由阿里云自动检测源操作系统是否有阿里云官方渠道许可证，并做如下处理： 如果有阿里云官方许可证，则将阿里云官方许可证分配给导入的镜像。 如果没有阿里云官方许可证，则切换成自带许可证方式。 阿里云官方许可证：采用对应操作系统的阿里云官方许可证。使用镜像创建的实例收取镜像License费用，且会自动激活。 自带许可证：采用源操作系统自带的许可证。使用镜像创建的实例不收费，且不会激活。
   云盘配置	否	设置系统盘云盘容量并添加数据盘镜像。 选中配置云盘属性。 系统盘参数已默认填充，只需填写系统盘的容量大小。系统盘大小范围为1 GiB~2,048 GiB，且不能小于镜像文件的大小。 说明 镜像文件大小即为OSS镜像文件大小，您可通过OSS控制台查看。 单击增加数据盘，然后填写参数。 镜像文件URL：填写步骤1获取的数据盘镜像文件URL，获取方法和系统盘一致。 挂载点：由系统默认分配，无需填写。 镜像格式：支持自动检测或选择RAW、QCOW2、VHD等格式，与镜像文件格式保持一致。 云盘容量GiB：大小范围为1 GiB~2,048 GiB，且不能小于镜像文件的大小。 说明 镜像文件大小即为OSS镜像文件大小，您可通过OSS控制台查看。
   镜像描述	否	填写镜像描述信息，便于后续管理。
   标签	否	您可以设置标签，将镜像归类，便于搜索与批量操作。
   资源组	否	您可以设置资源组，对镜像进行分级管理。 重要 阿里云账号为RAM用户添加权限策略时，如果授权范围是指定资源组权限，请确保该处选择相同的资源组。

10. 信息确认无误后，单击确定导入。

    系统会创建一个导入自定义镜像的任务。

（可选）步骤3：查看或者取消导入任务

• 查看导入任务

  您可以在目标地域的自定义镜像列表中或者任务管理界面查看导入任务的进度。

  说明

  导入自定义镜像所需时间取决于镜像文件的大小和当前导入任务的并发数，请您耐心等待。

  • 导入自定义镜像时，系统会自动生成一份快照，您可以在快照列表里看到快照信息。导入镜像任务未完成前，快照的状态会显示为失败。任务完成后，快照的状态自动更新为成功，镜像的状态自动更新为可用。快照的容量为导入的自定义镜像文件大小，与导入自定义镜像时设置的系统盘大小无关。目前快照容量已经收费，更多信息，请参见快照计费。

  • 如果启用了镜像检测功能，镜像检测完成后，您可以在自定义镜像列表的检测结果列查看检测详情，如果有待修复项，可以通过一键修复功能或者根据镜像详情中的修复建议手动修复。检测项范围及修复建议，请参见镜像检测概述。

  • 在导入镜像时可能会遇到任务失败的问题，这是因为导入镜像时校验文件发生了非预期错误，这些错误可能会影响您后续创建实例等操作，您可以按照下列方式确认问题并进行修复。

    1. 通过任务管理界面或调用API接口DescribeTaskAttribute查看错误码。

    2. 根据错误码确认问题详情并进行修复。

       错误码详情

       错误码	错误原因	原因定位	修复建议
       UNKNOWN_IMAGE_FORMAT	镜像文件格式未在支持的范围内。	使用qemu-img check命令检查镜像文件的格式。	建议转换镜像格式，推荐RAW或VHD格式。 说明 建议使用qemu-img工具转换镜像文件格式，并且转换时使用默认参数。具体操作，请参见转换镜像格式。
       IMAGE_SIZE_EXCEEDS_LIMIT	镜像文件的大小过大。	使用qemu-img info命令确认镜像文件的大小信息。	缩小镜像文件。 建议转换镜像格式，推荐RAW或VHD格式。 说明 建议使用qemu-img工具转换镜像文件格式，并且转换时使用默认参数。具体操作，请参见转换镜像格式。
       INVALID_IMAGE_SIZE	无法正确获取镜像大小。	使用OSS API接口GetObject确认能否返回Object相关信息。	尝试重新上传镜像文件到新的OSS Object。
       IMAGE_FILE_NOT_FOUND	无法找到镜像文件来源。	使用OSS API接口GetObject确认能否返回Object相关信息。	导入任务未完成前，请不要删除OSS Object。 OSS文件名称不建议使用特殊字符。更多信息， 请参见对象命名。 尝试重新上传镜像文件到新的OSS Object。
       INVALID_IMAGE_FORMAT	无效的镜像格式。	暂不支持文件头中声明的格式。	检查镜像文件格式，对于非RAW或VHD格式的文件，建议将镜像格式转换为RAW或VHD。 说明 建议使用qemu-img工具转换镜像文件格式，并且转换时使用默认参数。具体操作，请参见转换镜像格式。

• 取消导入任务

  在导入自定义镜像任务完成前，您可以通过以下两种方式取消镜像导入任务。

  • 方式一：在镜像列表直接单击取消导入。

  • 方式二：在任务管理界面取消镜像导入任务。

    1. 在左侧导航栏，选择运维与监控 > 任务管理。

    2. 找到导入自定义镜像的任务，在操作列单击取消任务。