匯出您的自訂鏡像到與該自訂鏡像同一地域的 OSS Bucket 裡。

描述

  • 不支援匯出使用市場鏡像的系統盤快照建立的自訂鏡像。
  • 支援匯出鏡像中包括資料盤快照的資訊的自訂鏡像,其中資料盤數不能超過 4 塊,單塊資料盤容量最大不能超過 500 GB。
  • 您需要 提交工單 聯繫阿里雲,為您開啟匯出鏡像功能。

  • 需要通過 RAM 授權Elastic Compute Service 官方服務帳號寫入 OSS 的許可權:
    1. 建立角色:AliyunECSImageExportDefaultRole(其他任何角色名稱稱無效),為該角色設定以下角色策略:
       {
         "Statement": [
           {
             "Action": "sts:AssumeRole",
             "Effect": "Allow",
             "Principal": {
               "Service": [
                 "ecs.aliyuncs.com"
               ]
             }
           }
         ],
         "Version": "1"
       }
    2. 在角色 AliyunECSImageExportDefaultRole 下加入預設的系統權限原則:AliyunECSImageExportRolePolicy,該策略是雲伺服器 ECS 提供匯出鏡像的預設策略。使用者也可以建立自訂策略,許可權需要包含:
       {
         "Version": "1",
         "Statement": [
           {
             "Action": [
               "oss:GetObject",
               "oss:PutObject",
               "oss:DeleteObject",
               "oss:GetBucketLocation",
               "oss:AbortMultipartUpload",
               "oss:ListMultipartUploads",
               "oss:ListParts"
             ],
             "Resource": "*",
             "Effect": "Allow"
           }
         ]
       }

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ExportImage
RegionId String 自訂鏡像的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
ImageId String 自訂鏡像 ID。
OssBucket String 保存匯出鏡像的 OSS bucket。
OssPrefix String 使用者的 OSS 的 Object 的首碼。可以由數字或者字母組成,字元長度為 [1, 30]。
ClientToken String 用於保證請求的等冪性。由用戶端生成該參數值,要保證在不同請求間唯一。只支援 ASCII 字元,且不能超過 64 個字元。更多詳情,請參閱 如何保證等冪性

返回參數

名稱 類型 描述
RegionId String 地域 ID
ExportTaskId String 匯出鏡像任務 ID

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ExportImage
&RegionId=cn-hangzhou
&ImageId=m-231234567
&OssBucket=testexportImage
&<公共請求參數>
返回樣本

XML 格式

<ExportImageResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
    <ExportTaskId>tsk-231234567</ExportTaskId>
    <RegionId>cn-hangzhou</RegionId>
</ExportImageResponse>
JSON 格式
{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9",
    "RegionId": "cn-hangzhou",
    "ExportTaskId": "tsk-231234567"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
Forbidden User is not authorized to operate on the specified image. 400 使用者沒有許可權匯出鏡像。
IncorrectImageStatus The image is not available. 400 指定的鏡像暫不可用。
MissingParameter An input parameter RegionId that is mandatory for processing the request is not supplied. 400 缺少 RegionId 值。
MissingParameter An input parameter ImageId that is mandatory for processing the request is not supplied. 400 缺少 ImageId 值。
MissingParameter An input parameter OssBucket that is mandatory for processing the request is not supplied. 400 缺少 OssBucket 值。
OssBucket.NotFound The specified OssBucket does not exist. 400 指定的 OSS bucket 在當前地域下不存在。
OssPrefix.Malformed The specified OssPrefix format is incorrect. 400 指定的 OSS 的 Object 的首碼格式不合法。
RegionId.NotFound The specified RegionId does not exist. 400 指定的鏡像的 RegionId 不存在。
ExportImageFailed Failed to export image. 403 匯出鏡像失敗。
ImageId.NotFound The image does not exist. 403 指定的鏡像 ID 不存在。
ImageNotSupported The specified image is from the image market and does not support export. 403 指定的鏡像來自鏡像市場,不支援匯出。
InvalidRegion.NotSupport The specified region does not support image import or export. 403 指定的地域暫時不支援匯入或匯出鏡像。
OperationDenied.ImageExporting The specified image is being exported. 403 正在匯出指定的鏡像。