匯出您的自訂鏡像到與該自訂鏡像同一地域的 OSS Bucket 裡。
描述
- 不支援匯出使用市場鏡像的系統盤快照建立的自訂鏡像。
- 支援匯出鏡像中包括資料盤快照的資訊的自訂鏡像,其中資料盤數不能超過 4 塊,單塊資料盤容量最大不能超過 500 GB。
-
您需要 提交工單 聯繫阿里雲,為您開啟匯出鏡像功能。
- 需要通過 RAM 授權Elastic Compute Service 官方服務帳號寫入 OSS 的許可權:
- 建立角色:
AliyunECSImageExportDefaultRole
(其他任何角色名稱稱無效),為該角色設定以下角色策略:{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "Service": [ "ecs.aliyuncs.com" ] } } ], "Version": "1" }
- 在角色
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 | 正在匯出指定的鏡像。 |