カスタムイメージと同じリージョンの OSS バケットにカスタムイメージをエクスポートします。
説明
- この API は、Marketplace に用意されているイメージのシステムディスクスナップショットから作成されたカスタムイメージをエクスポートできません。
- カスタムディスクに 4 つを超えるデータディスクスナップショットが含まれている場合、またはいずれかのデータディスクのサイズが 500 GBを超える場合はエクスポートできません。
-
ECS から OSS にデータを書き込むための RAM ロールを承認するには、RAM を使用する必要があります。 RAM ロールの作成および承認方法について、以下のセクションで説明します。
1.AliyunECSImageExportDefaultRole
という名称のロールを作成します 。 他のロール名は使用できません。 以下のコードで、ロールのポリシーを設定します。{ "Statement": [ { "Action": "sts:AssumeRole", "Effect": "Allow", "Principal": { "Service": [ "ecs.aliyuncs.com" ] } } ], "Version": "1" }
2. ロールAliyunECSImageExportDefaultRole
に、デフォルトのシステム権限ポリシーAliyunECSImageExportRolePolicy
を追加します. このポリシーは、ECS がイメージをエクスポートする際のデフォルトのポリシーです。 詳細については、https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7Dをご参照ください。 また、以下の権限が付与されたカスタムポリシーも作成できます。{ "Version": "1", "Statement": [ { "Action": [ "oss:GetObject", "oss:PutObject", "oss:DeleteObject", "oss:GetBucketLocation", "oss:GetBucketInfo", "oss:AbortMultipartUpload", "oss:ListMultipartUploads", "oss:ListParts" ], "Resource": "*", "Effect": "Allow" } ] }
デバッグ
API Explorer でデバッグを実行できます。 API Explorer を使用すると、API を簡単に利用するための各種の操作を実行できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成が可能です。
リクエストパラメーター
名称 | データ型 | 必須 / 任意 | 例 | 説明 |
---|---|---|---|---|
ImageId | String | 必須 | m-imageid1 |
カスタムイメージのID を設定します。 |
OSSBucket | String | 必須 | testexportImage |
イメージのエクスポート先の OSS バケットを設定します。 |
RegionId | String | 必須 | cn-hangzhou |
ソースカスタムイメージが属するリージョンの ID を設定します。 DescribeRegions を呼び出すと、Alibaba Cloud の最新リージョンが表示されます。 |
Action | String | 必須 | ExportImage |
実行する API (CopyImage) を設定します。 |
OSSPrefix | String | 必須 | EcsExport |
OSS オブジェクトのプレフィックスを設定します。 長さは 8 文字から 64 文字で、英字と数字のみ使用できます。 |
レスポンスパラメーター
名称 | データ型 | 例 | 説明 |
---|---|---|---|
RegionId | String | cn-hangzhou |
リージョンの ID を示します。 |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエストの ID を示します。 |
TaskId | String | tsk-231234567 |
イメージエクスポートタスクの ID を示します。 |
コーディング例
リクエストの例
https://ecs.aliyuncs.com/?Action=ExportImage
&ImageId=m-imageid1
&OSSBucket=testexportImage
&RegionId=cn-hangzhou
&OSSPrefix=EcsExport
&<Common request parameters>
通常のレスポンスの例
XML
形式
<ExportImageResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
<ExportTaskId>tsk-231234567</ExportTaskId>
<RegionId>cn-hangzhou</RegionId>
</ExportImageResponse>
JSON
形式
{
"RegionId":"cn-hangzhou",
"RequestId":"C8B26B44-0189-443E-9816-D951F59623A9",
"ExportTaskId":"tsk-231234567"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | MissingParameter | An input parameter "RegionId" that is mandatory for processing the request is not supplied. | RegionId パラメーターが指定されていない場合に返されるエラーメッセージです。 |
400 | MissingParameter | An input parameter ImageId that is mandatory for processing the request is not supplied. | ImageId パラメーターが指定されていない場合に返されるエラーメッセージです。 |
400 | InvalidRegionId.NotFound | The specified RegionId does not exist. | 指定された リージョン ID が存在しない場合に返されるエラーメッセージです。 該当のリージョンでサービスが利用可能かどうかを確認してください。 |
400 | InvalidRegion.NotSupport | The specified region does not support image import or export. | 指定されたリージョンでこの API がサポートされていない場合に返されるエラーメッセージです。 |
404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定されたイメージが該当のアカウントに存在しない場合に返されるエラーメッセージです。 イメージ ID が正しいかどうかを確認してください。 |
400 | IncorrectImageStatus | The specified Image is not available. | 指定したソースイメージがこの API をサポートしていないステータスである場合に返されるエラーメッセージです。 |
403 | ImageNotSupported | The specified image from the image market, do not support export image. | Marketplace からイメージををエクスポートしようとした場合に返されるエラーメッセージです。 |
400 | InvalidImageFormat.Malformed | The specified Image Format is wrongly formed. | AssociateInstanceType パラメーターが正しくない場合に返されるエラーメッセージです。 |
403 | ExportImageFailed | Exporting image is failed, Please contact the administrator. | 指定されたイメージのエクスポートに失敗した場合に表示されるエラーメッセージです。 システム管理者にお問い合わせください。 |
400 | InvalidImage.DiskAmountOrSize | The diskSize or diskAmount of the image exceeds the limitation. | ディスクサイズまたはディスク数がイメージをエクスポートする際の上限に達した場合に返されるエラーメッセージです。 |
400 | ImageNotSupported | The specified Image contains encrypted snapshots, do not support export. | 指定されたイメージに暗号化されたスナップショットが含まれているためエクスポートできない場合に返されるエラーメッセージです。 |
400 | ImageNotSupported | Image from image market does not support exporting. | Marketplaceから画像をエクスポートしようとした場合に返されるエラーメッセージです。 |