：ImportImage

描述

匯入自訂鏡像後，您可以使用建立的自訂鏡像建立ECS執行個體（RunInstances）或者更換執行個體的系統盤（ReplaceSystemDisk）。調用該介面時，您需要注意：

• 您必須提前 上傳鏡像檔案到Object Storage Service。
• 匯入鏡像的地域必須跟鏡像檔案上傳的OSS Bucket的地域相同。
• 參數DiskDeviceMapping.n中n的取值範圍為[1, 17]。n為1時表示系統盤，n為[2, 17]時表示資料盤。
• 不能刪除正在匯入的鏡像，只能取消匯入鏡像任務（CancelTask）。
• 您需要預先通過 存取控制RAM 服務為您授權ECS訪問OSS。參閱以下步驟：
  1. 建立角色 AliyunECSImageImportDefaultRole。必須是這個名稱，否則匯入鏡像會失敗。角色的策略為：

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

  2. 在該角色下，添加權限原則AliyunECSImageImportRolePolicy。這個策略是ECS匯入鏡像功能的預設策略，或者您也可以建立自訂策略，許可權需要包含：

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

請求參數

返回參數

樣本

https://ecs.aliyuncs.com/?Action=ImportImage
&RegionId=cn-hangzhou
&DiskDeviceMapping.1.OSSBucket=ecsimageos
&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw
&<公共請求參數>

<ImportImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ImageId>Img-231234567</ImageId>
    <ImportTaskId>123-345-2332-22323</ImportTaskId>
</ImportImageResponse>

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "ImageId": "Img-231234567"，
    "ImportTaskId":"123-345-2332-22323"
}

錯誤碼