この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.

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 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 任意

カスタムイメージをエクスポートする形式。 設定可能な値は以下のとおりです。

  • vhd
  • qcow2
  • vmdk
  • vdi

デフォルト値: 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 形式

{
    &quot;RequestId&quot;: &quot;C8B26B44-0189-443E-9816-D951F59623A9&quot;、
    "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 エラーセンター」をご参照ください。