接口說明

調(diào)用該接口時(shí)，您需要注意：

• 您必須提前上傳鏡像文件到對(duì)象存儲(chǔ) OSS。具體操作，請(qǐng)參見上傳文件。

• 為避免部分服務(wù)器、虛擬機(jī)或者云主機(jī)的操作系統(tǒng)在導(dǎo)入自定義鏡像后，創(chuàng)建的 ECS 實(shí)例無法啟動(dòng)，您需要在導(dǎo)入鏡像前檢查是否需要在源服務(wù)器中安裝 virtio 驅(qū)動(dòng)。具體操作，請(qǐng)參見安裝 virtio 驅(qū)動(dòng)。

• 首次導(dǎo)入鏡像時(shí)，您必須提前通過訪問控制 RAM 授權(quán) ECS 訪問您的 OSS Bucket，否則會(huì)報(bào)錯(cuò)NoSetRoletoECSServiceAccount或InvalidOperation.CloudBoxImageImportRoleRequired。分為以下兩種場(chǎng)景情況：

  • 不通過云盒導(dǎo)入鏡像文件：您可以通過 RAM 管理控制臺(tái)一鍵完成授權(quán)操作，具體的授權(quán)頁面，請(qǐng)參見云資源訪問授權(quán)。您也可以手動(dòng)完成授權(quán)操作，部分操作中策略與權(quán)限如下所示。具體操作，請(qǐng)參見賬號(hào)訪問控制。

    1. 創(chuàng)建角色AliyunECSImageImportDefaultRole（必須是這個(gè)名稱，否則導(dǎo)入鏡像會(huì)失敗），角色的策略為：

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

    2. 在該角色下，添加系統(tǒng)策略AliyunECSImageImportRolePolicy。您也可以創(chuàng)建自定義策略，權(quán)限必須包含：

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

  • 通過云盒導(dǎo)入鏡像文件：您可以通過 RAM 管理控制臺(tái)一鍵完成授權(quán)操作，具體的授權(quán)頁面，請(qǐng)參見云資源訪問授權(quán)。您也可以手動(dòng)完成授權(quán)操作，部分操作中策略與權(quán)限如下所示。具體操作，請(qǐng)參見賬號(hào)訪問控制。

    1. 創(chuàng)建角色AliyunECSCloudBoxImageImportDefaultRole（必須是這個(gè)名稱，否則導(dǎo)入鏡像會(huì)失敗），角色的策略為：

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

    2. 在該角色下，添加系統(tǒng)策略AliyunECSCloudBoxImageImportRolePolicy。您也可以創(chuàng)建自定義策略，權(quán)限必須包含：

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

• 不能刪除正在導(dǎo)入的鏡像，只能調(diào)用 CancelTask 取消導(dǎo)入鏡像任務(wù)。

• 導(dǎo)入鏡像的地域必須跟鏡像文件上傳的 OSS Bucket 的地域相同。

• 參數(shù)DiskDeviceMapping.N中 N 的取值范圍為 1~17。N 為 1 時(shí)表示系統(tǒng)盤，N 為 2~17 時(shí)表示數(shù)據(jù)盤，當(dāng) N 大于 17 時(shí)系統(tǒng)會(huì)自動(dòng)忽略。

• 當(dāng)參數(shù)Architecture取值為arm64，或者參數(shù)Platform取值為CentOS Stream、Anolis、AlmaLinux、UOS、Kylin或Rocky Linux時(shí)，您需要注意：

  • 為了使導(dǎo)入后的鏡像支持配置密碼或者支持修改密鑰對(duì)，鏡像必須滿足以下條件：

    • 操作系統(tǒng)的內(nèi)核需要支持CONFIG_FW_CFG_SYSFS特性。Linux 社區(qū)內(nèi)核 4.6 版本之后默認(rèn)支持該特性，CentOS 的內(nèi)核在 3.10.0-826.el7 版本之后默認(rèn)支持該特性。您可以在該鏡像對(duì)應(yīng)的服務(wù)器內(nèi)運(yùn)行grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)命令，如果回顯結(jié)果中包含CONFIG_FW_CFG_SYSFS=y信息，則說明該鏡像中的內(nèi)核已支持CONFIG_FW_CFG_SYSFS特性。

    • 操作系統(tǒng)中已安裝阿里云最新版本 cloud-init。其中，19.1 版本 cloud-init 必須在 19.1.3 版本及以上，部分低版本操作系統(tǒng)中的 0.7.6a 版本 cloud-init 必須在 0.7.6a15 版本及以上。具體操作，請(qǐng)參見安裝 cloud-init。

    • 操作系統(tǒng)需要支持 SHA-512 加密算法。

  • 為了使導(dǎo)入后的鏡像支持?jǐn)U容云盤與擴(kuò)容文件系統(tǒng)，鏡像必須滿足以下條件：

    • 操作系統(tǒng)的內(nèi)核版本需要高于 3.6 版本。

    • 支持 growpart 命令。支持該命令需要安裝cloud-utils-growpart包，不同操作系統(tǒng)安裝方式有所不同。具體操作，請(qǐng)參見擴(kuò)展分區(qū)和文件系統(tǒng)（Linux）。

    • 支持 resize2fs 命令。支持該命令需要安裝e2fsprogs包，該包在操作系統(tǒng)中默認(rèn)已安裝，如果沒有安裝您需要自行安裝。

    • 操作系統(tǒng)中已安裝阿里云最新版本 cloud-init。其中，19.1 版本 cloud-init 必須在 19.1.3 版本及以上，部分低版本操作系統(tǒng)中的 0.7.6a 版本 cloud-init 必須在 0.7.6a15 版本及以上。具體操作，請(qǐng)參見安裝 cloud-init。

• 如果您待導(dǎo)入的自定義鏡像對(duì)應(yīng)的系統(tǒng)架構(gòu)為 arm64 時(shí)，您需要設(shè)置其 RTC 時(shí)鐘使用 UTC 時(shí)間標(biāo)準(zhǔn)。具體操作，請(qǐng)參見 Linux 時(shí)間和時(shí)區(qū)說明。

• 強(qiáng)烈建議在導(dǎo)入鏡像時(shí)配置鏡像檢測(cè)參數(shù)，有助于系統(tǒng)幫助優(yōu)化您的鏡像。更多信息，請(qǐng)參見鏡像檢測(cè)概述。