步驟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. 找到導入自定義鏡像的任務，在操作列單擊取消任務。