ExportImage

説明

• この 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 のサンプルコードの動的な生成が可能です。

リクエストパラメーター

レスポンスパラメーター

コーディング例

リクエストの例

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"
}

エラーコード

エラーコードの一覧