このAPIを呼び出して、同じリージョンのObject Storage Service (OSS) バケットにカスタムイメージをエクスポートできます。
説明
Before you export images:
- まず前提条件と注意事項を理解する必要があります。 詳細については、「イメージのエクスポート」をご参照ください。
-
RAM (Resource Access Management) を使用してECSのRAMロールを作成し、ECSがOSSにデータを書き込むことを許可する必要があります。 次の操作を実行します。
1。AliyunECSImageExportDefaultRole
という名前のロールを作成します。 他のすべてのロール名は無効です。 ロールに対して次の信頼ポリシーを設定します。{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "Service": [ "ecs.aliyuncs.com" ] } } ], "Version": "1" }
2。AliyunECSImageExportRolePolicy
システムポリシーをAliyunECSImageExportDefaultRole
ロールにアタッチします。 このポリシーは、ECSがイメージをエクスポートするために使用されるデフォルトのポリシーです。 詳細については、Cloud Resource Access Authorizationページにアクセスしてください。 または、次のコンテンツを含むカスタムポリシーを作成し、そのポリシーをロールにアタッチすることもできます。{ "Version": "1", "Statement": [ { "Action": [ "oss:GetObject", "oss:PutObject", "oss:DeleteObject", "oss:GetBucketLocation", "oss:GetBucketInfo", "oss:AbortMultipartUpload", "oss:ListMultipartUploads", "oss:ListParts" ], "Resource": "*", "Effect":"Allow" } ] }
イメージをエクスポートした後:
カスタムイメージは、指定されたOSSバケットに保存されます。 カスタムイメージをダウンロードできます。 For more information, see Download objects.
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | ExportImage |
実行する操作です。 (CopyImage) を設定します。 |
ImageId | String | 必須 | m-bp67acfmxazb4p**** |
カスタムイメージのID を設定します。 |
OSSBucket | String | 必須 | testexportImage |
The OSS bucket to which to export the custom image. |
RegionId | String | 必須 | cn-hangzhou |
カスタムイメージのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。 |
OSSPrefix | String | 任意 | EcsExport |
OSSバケットにカスタムイメージを格納するオブジェクトのプレフィックス。 長さは 8 文字から 64 文字で、英字と数字のみ使用できます。 |
ImageFormat | String | 任意 | 生 |
カスタムイメージをエクスポートする形式。 設定可能な値は以下のとおりです。
デフォルト値: raw。 |
RoleName | String | 任意 | AliyunECSImageExportDefaultRole |
カスタムイメージのエクスポートに使用されるRAMロールの名前。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RegionId | String | cn-hangzhou |
タスクのリージョンID。 |
RequestId | String | C8B26B44-0189-443E-9816-D951F59623A9 |
リクエストの ID です。 |
TaskId | String | tsk-bp67acfmxazb4p **** |
イメージエクスポートタスクの ID を示します。 |
例
リクエストの例
https://ecs.aliyuncs.com/?Action=ExportImage
&ImageId=m-bp67acfmxazb4p ****
&OSSBucket=testexportImage
&RegionId=cn-hangzhou
&OSSPrefix=EcsExport
&ImageFormat=raw
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<ExportImageResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<ExportTaskId>tsk-bp67acfmxazb4p ****</ExportTaskId>
<RegionId>cn-hangzhou</RegionId>
</ExportImageResponse>
JSON
形式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"、
"ExportTaskId": "tsk-bp67acfmxazb4p ****" 、
"RegionId": "cn-hangzhou"
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | MissingParameter | An input parameter "RegionId" that is mandatory for processing the request is not supplied. | RegionIdパラメーターが指定されていない場合に返されるエラーメッセージ。 |
400 | MissingParameter | このリクエスト処理に必須の入力パラメータ "ImageId" が指定されていません。 | ImageIdパラメーターが指定されていない場合に返されるエラーメッセージ。 |
400 | MissingParameter | このリクエスト処理に必須の入力パラメータ "OSSBucket" が指定されていません。 | OSSBucketパラメーターが指定されていない場合に返されるエラーメッセージ。 |
400 | InvalidImageName.Malformed | 指定されたイメージ名の形式が誤っています。 | 指定されたDestinationImageNameパラメーターが無効な場合に返されるエラーメッセージ。 名前は 2~128 文字で、英数字、ピリオド (.)、アンダースコア (_)、およびハイフン (-) を使用できます。 名前は英字で始まる必要があります。注:http:// または https:// で始めることはできません。 |
400 | InvalidOSSPrefix.Malformed | 指定されたOSSPrefix形式が誤っています。 | 指定されたOSSPrefixパラメーターが無効な場合に返されるエラーメッセージ。 |
400 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定された DiskId パラメーターが存在しない場合に返されるエラーメッセージ。 |
400 | InvalidRegion.NotSupport | The specified region does not support image import or export. | 指定されたリージョンが操作をサポートしていない場合に返されるエラーメッセージ。 |
404 | InvalidImageId.NotFound | The specified ImageId does not exist. | このアカウントに指定されたイメージが存在しない場合に返されるエラーメッセージ。 イメージ ID が正しいかどうかを確認してください。 |
400 | IncorrectImageStatus | The specified Image is not available. | 指定されたイメージのステータスが無効な場合に返されるエラーメッセージ。 |
403 | ImageNotSupported | The specified image from the image market, do not support export image. | The error message returned because the specified image is an Alibaba Cloud Marketplace image and cannot be exported. |
400 | InvalidImageFormat.Malformed | The specified Image Format is wrongly formed. | 指定されたImageFormatパラメーターが無効な場合に返されるエラーメッセージ。 |
403 | ImageIsExporting | 指定されたイメージはエクスポート中です。 | 指定されたイメージがエクスポート中の場合に返されるエラーメッセージ。 |
403 | ExportImageFailed | Exporting image is failed, Please contact the administrator. | イメージのエクスポートに失敗した場合に返されるエラーメッセージ。 システム管理者にお問い合わせください。 |
403 | UserNotInTheWhiteList | ユーザーはイメージをエクスポートするホワイトリストにありません。 | イメージをエクスポートする権限がない場合に返されるエラーメッセージ。 |
403 | NoSetRoletoECSServiceAcount | ECSサービスアカウントOSSにアクセスする権利がありません。アクセスのロールをECSサービスアカウントにアタッチしてください。 | ECSが指定されたOSSバケットおよびオブジェクトへのアクセスを許可されていない場合に返されるエラーメッセージ。 |
400 | InvalidOSSBucket.NotFound | 指定されたOSSバケットはこのリージョンに存在しません。 | 指定されたOSSBucketパラメーターが存在しない場合に返されるエラーメッセージ。 |
400 | OperationDenied | 指定されたイメージにはデータディスクのスナップショットが含まれています。この操作はサポートしていません。 | イメージにデータディスクのスナップショットが含まれている場合、操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | InvalidImage.DiskAmountOrSize | %s | イメージに4つ以上のデータディスクスナップショットが含まれているか、1つのデータディスクスナップショットのサイズが500 GiBを超えている場合に返されるエラーメッセージ。 |
400 | ImageNotSupported | The specified Image contains encrypted snapshots, do not support export. | The error message returned because the specified image contains encrypted snapshots and cannot be exported. |
400 | ImageNotSupported | Image from image market does not support exporting. | 指定されたイメージがAlibaba Cloud Marketplaceイメージであり、エクスポートできない場合に返されるエラーメッセージ。 |
400 | InvalidOSSBucket.NotMatched | 指定されたOSSバケットが正しくありません (% s) 。 | The error message returned because the OSSBucket parameter is invalid. 詳細については、エラーメッセージの % sプレースホルダーの返された結果をご参照ください。 |
403 | ConcurrentQuotaExceed.ExportImage | %s | 同時進行中のタスクの最大数に達した場合に返されるエラーメッセージ。 しばらくしてから再試行します。 |
403 | WeeklyQuotaExceed.ExportImage | %s | The error message returned because the weekly quota for exported images of this week has been used up. クォータが再び利用可能になったら再試行します。 |
403 | InvalidImageLicense.NotSupported | %s | 指定されたイメージをエクスポートできない場合に返されるエラーメッセージ。 詳細については、エラーメッセージの % sプレースホルダーの返された結果をご参照ください。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。