Alibaba Cloud ECS にオンプレミスのイメージをインポートします。インスタンスを作成 (RunInstances) するため、またはインスタンスのシステムディスクを交換 (ReplaceSystemDisk) するために、インポートしたイメージを使用できます。

説明

このインターフェイスを呼び出すときは、次の点を考慮してください。

  • イメージファイルを OSS にあらかじめアップロードする必要があります。

  • 同じリージョンの OSS からのみ、イメージファイルをインポートできます。イメージと OSS は、1 つのアカウントに属している必要があります。

  • DiskDeviceMapping.n の n は、ディスクタイプを示します。n が 1 に設定されている場合は、システムディスクを表します。n が [2, 17] に設定されている場合は、データディスクを表します。

  • インポート中のイメージを削除することはできません。ただし、イメージのインポートタスク (CancelTask) はキャンセルできます。

  • お使いの Alibaba Cloud アカウントの OSS に、ECS をアクセスさせるために RAM の概要を使用するには、次の手順を実行します。

    1. AliyunECSImageImportDefaultRole (違う名前が使用されると、イメージのインポートは失敗します。) という名前のロールを作成し、ロールポリシーに設定するために、次のコードスニペットをご覧ください。

      1. {“Statement”: [{“Action”: sts:AssumeRole”,“Effect”: Allow”,“Principal”: { Service”: [ ecs.aliyuncs.com ]}}],“Version”: 1”}
    2. デフォルトの許可ポリシー AliyunECSImageImportRolePolicy を AliyunECSImageImportDefaultRole にアタッチします。また、次の許可を持つカスタムポリシーを作成できます。

      1. {“Version”: 1”,“Statement”: [{“Action”: [ oss:GetObject”, oss:GetBucketLocation”],“Resource”: “*”,“Effect”: Allow”}]}

リクエストパラメーター

名前 必須かどうか 説明
Action String はい インターフェイスの名前。値:ImportImage
RegionId String はい リージョン ID。最新のリージョンリストを取得するために、DescribeRegions を呼び出すことができます。
ImageName String いいえ イメージ名。
  • 長さは [2, 128] 文字です。大文字または小文字の英文字、または漢字、平仮名、片仮名で開始する必要があります。数字、コロン (:)、アンダースコア(_)、ハイフンを (-) を含めることができます。
  • イメージ名は、ECS コンソールに表示されます。
  • http:// または https:// で始めることはできません。
Description String いいえ イメージの説明。
  • null にできます。イメージの説明はオプションですが、256 文字を超えてはいけません。
  • http:// または https:// で始めることはできません。
Architecture String いいえ システムアーキテクチャ。オプションの値:
  • i386
  • x86_64
デフォルト値: x86_64.
OSType String いいえ オペレーティングシステムプラットフォームのタイプ。オプションの値:
  • Windows
  • Linux
デフォルト値: Linux
Platform String いいえ オペレーティングシステムのリリース版。オプションの値:
  • CentOS
  • Ubuntu
  • SUSE
  • OpenSUSE
  • Debian
  • CoreOS
  • Aliyun
  • Windows Server 2003
  • Windows Server 2008
  • Windows Server 2012
  • Others Linux
  • Customized Linux
デフォルト値:Others Linux.
DiskDeviceMapping.n.Format String いいえ イメージフォーマット。オプションの値:
  • RAW
  • VHD
イメージをインポートすると、イメージフォーマットが自動的にチェックされ、スキャンされます。このプロセスで得られた結果が、このパラメーターのデフォルト値として使用されます。
DiskDeviceMapping.n.OSSBucket String はい イメージファイルが保存されている OSS バケット。
DiskDeviceMapping.n.OSSObject String はい イメージファイルを持つ OSS オブジェクトの名前 (キー)
DiskDeviceMapping.n.DiskImageSize String いいえ カスタムイメージのサイズ。ディスクの容量は、ディスクの実際に使用される容量以上でなければなりません。値の範囲:
  • n が 1 に設定されている場合:[5, 500] GiB
  • n が [2, 16] に設定されている場合:[5, 1000] GiB
イメージをインポートすると、イメージのサイズが自動的にスキャンされてチェックされ、チェック結果がこのパラメーターのデフォルト値として使用されます。

レスポンスパラメーター

名前 説明
RegionId String リージョン ID。
ImageId String イメージ ID。
ImportTaskId String イメージインポートタスクの ID。

リクエストの例
  1. https://ecs.aliyuncs.com/?Action=ImportImage&RegionId=cn-hangzhou&DiskDeviceMapping.1.OSSBucket=ecsimageos&DiskDeviceMapping.1.OSSObject=CentOS_5.4_32.raw&<Common Request Parameters>
レスポンスの例

XML 形式

  1. <ImportImageResponse> <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId> <ImageId>Img-231234567</ImageId> <ImportTaskId>123-345-2332-22323</ImportTaskId></ImportImageResponse>
JSON 形式
  1. { RequestId”: C8B26B44-0189-443E-9816-D951F59623A9”, ImageId”: Img-231234567”, ImportTaskId”:”123-345-2332-22323”}

エラーコード

このインタフェースに固有のエラーコードは次の通りです。詳細については、 API のエラーセンターをご覧ください 。

エラーコード エラーメッセージ HTTP ステータスコード 意味
Forbbiden User not authorized to operate on the specified resource 400 今はイメージをインポートできません。

チケットを作成し 、イメージのインポート機能を有効にしてください。

IncorrectImageStatus The specified image is not available. 400 指定されたイメージのステータスが正しくありません。
InvalidArchitecture.Malformed The specified Architecture is wrongly formed. 400 指定された Architecture は無効です。
InvalidDescription.Malformed The specified destination image description is wrongly formed. 400 指定されたターゲットイメージ Description は無効です。
InvalidFormat.Malformed The specified Image format is wrongly formed. 400 指定されたイメージファイル形式が無効です。
InvalidImageName.Duplicated The destination image is exist. 400 指定された ImageName の値はすでに存在しています。
InvalidImageName.Malformed The specified destination Image name is wrongly formed. 400 指定された ImageName は無効です。
InvalidImageSize The specified “DiskDeviceMapping.n.DiskImageSize” should be not less than system device size. 400 指定された値 DiskDeviceMapping.n.DiskImageSize は、ディスクの実際の使用容量以上でなければなりません。
InvalidOSType.Malformed The specified OSType is wrongly formed. 400 指定された OSType は無効です。
InvalidPlatform.Malformed The specified Platform is wrongly formed. 400 指定された Platform は無効です。
MissingParameter An input parameter “RegionId” that is mandatory for processing the request is not supplied. 400 RegionId パラメーターを指定する必要があります。
MissingParameter An input parameter “DiskDeviceMapping.n.OSSBucket” that is mandatory for processing the request is not supplied. 400 OSSBucket パラメーターを指定する必要があります 。
MissingParameter An input parameter “DiskDeviceMapping.n.OSSObject” that is mandatory for processing the request is not supplied. 400 OSSObject パラメーターを指定する必要があります。
RegionId.NotFound The specified region is not found. 400 指定されたイメージの RegionId は存在しません。
ImageIsImporting The specified Image is importing. 403 指定されたイメージがコピーされています。しばらくしてからもう一度お試しください。
InvalidRegion.NotSupport The specified region does not support image import or export. 403 指定されたリージョンは、現在のイメージのインポートをサポートしていません。
QuotaExceed.Image The Image Quota exceeds. 403 カスタムイメージのインポート制限を超えています。これ以上のイメージはインポートできません。
QuotaExceed.Snapshot The maximum number of snapshots is exceeded. 403 スナップショットのインポート制限を超えています。これ以上のイメージはインポートできません。