ImportImage

介面說明

調用該介面時，您需要注意：

• 您必須提前上傳鏡像檔案到物件儲存 OSS。具體操作，請參見上傳檔案。

• 為避免部分伺服器、虛擬機器或者雲主機的作業系統在匯入自訂鏡像後，建立的 ECS 實例無法啟動，您需要在匯入鏡像前檢查是否需要在來源伺服器中安裝 virtio 驅動程式。具體操作，請參見安裝 virtio 驅動程式。

• 首次匯入鏡像時，您必須提前透過存取控制 RAM 授權 ECS 存取您的 OSS Bucket，否則會報錯NoSetRoletoECSServiceAccount或InvalidOperation.CloudBoxImageImportRoleRequired。分為以下兩種場景情況：

  • 不透過雲盒匯入鏡像檔案：您可以透過 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"
       			}
       	]
       }
       
       

  • 透過雲盒匯入鏡像檔案：您可以透過 RAM 管理主控台一鍵完成授權操作，具體的授權頁面，請參見雲資源存取授權。您也可以手動完成授權操作，部分操作中策略與權限如下所示。具體操作，請參見帳號存取控制。

    1. 建立角色AliyunECSCloudBoxImageImportDefaultRole（必須是這個名稱，否則匯入鏡像會失敗），角色的策略為：

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

    2. 在該角色下，新增系統策略AliyunECSCloudBoxImageImportRolePolicy。您也可以建立自訂策略，權限必須包含：

       {
       	"Version": "1",
       	"Statement": [
       	{
       		"Action": [
       				"oss-cloudbox:GetObject",
       				"oss-cloudbox:GetBucketLocation",
       				"oss-cloudbox: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 時間和時區說明。

• 強烈建議在匯入鏡像時配置鏡像檢測參數，有助於系統幫助最佳化您的鏡像。更多資訊，請參見鏡像檢測概述。