Alibaba Cloud ECS にオンプレミスのイメージをインポートします。インスタンスを作成 (RunInstances) するため、またはインスタンスのシステムディスクを交換 (ReplaceSystemDisk) するために、インポートしたイメージを使用できます。
説明
このインターフェイスを呼び出すときは、次の点を考慮してください。
-
イメージファイルを OSS にあらかじめアップロードする必要があります。
-
同じリージョンの OSS からのみ、イメージファイルをインポートできます。イメージと OSS は、1 つのアカウントに属している必要があります。
-
DiskDeviceMapping.n
の n は、ディスクタイプを示します。n が 1 に設定されている場合は、システムディスクを表します。n が [2, 17] に設定されている場合は、データディスクを表します。 -
インポート中のイメージを削除することはできません。ただし、イメージのインポートタスク (CancelTask) はキャンセルできます。
-
お使いの Alibaba Cloud アカウントの OSS に、ECS をアクセスさせるために RAM の概要を使用するには、次の手順を実行します。
-
AliyunECSImageImportDefaultRole
(違う名前が使用されると、イメージのインポートは失敗します。) という名前のロールを作成し、ロールポリシーに設定するために、次のコードスニペットをご覧ください。{“Statement”: [{“Action”: “sts:AssumeRole”,“Effect”: “Allow”,“Principal”: { “Service”: [ “ecs.aliyuncs.com” ]}}],“Version”: “1”}
-
デフォルトの許可ポリシー
AliyunECSImageImportRolePolicy
を AliyunECSImageImportDefaultRole にアタッチします。また、次の許可を持つカスタムポリシーを作成できます。{“Version”: “1”,“Statement”: [{“Action”: [ “oss:GetObject”, “oss:GetBucketLocation”],“Resource”: “*”,“Effect”: “Allow”}]}
-
リクエストパラメーター
名前 | 型 | 必須かどうか | 説明 |
---|---|---|---|
Action | String | はい | インターフェイスの名前。値:ImportImage |
RegionId | String | はい | リージョン ID。最新のリージョンリストを取得するために、DescribeRegions を呼び出すことができます。 |
ImageName | String | いいえ | イメージ名。
|
Description | String | いいえ | イメージの説明。
|
Architecture | String | いいえ | システムアーキテクチャ。オプションの値:
|
OSType | String | いいえ | オペレーティングシステムプラットフォームのタイプ。オプションの値:
|
Platform | String | いいえ | オペレーティングシステムのリリース版。オプションの値:
|
DiskDeviceMapping.n.Format | String | いいえ | イメージフォーマット。オプションの値:
|
DiskDeviceMapping.n.OSSBucket | String | はい | イメージファイルが保存されている OSS バケット。 |
DiskDeviceMapping.n.OSSObject | String | はい | イメージファイルを持つ OSS オブジェクトの名前 (キー) |
DiskDeviceMapping.n.DiskImageSize | String | いいえ | カスタムイメージのサイズ。ディスクの容量は、ディスクの実際に使用される容量以上でなければなりません。値の範囲:
|
レスポンスパラメーター
名前 | 型 | 説明 |
---|---|---|
RegionId | String | リージョン ID。 |
ImageId | String | イメージ ID。 |
ImportTaskId | String | イメージインポートタスクの ID。 |
例
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 形式
JSON 形式
<ImportImageResponse> <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId> <ImageId>Img-231234567</ImageId> <ImportTaskId>123-345-2332-22323</ImportTaskId></ImportImageResponse>
{ “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 | スナップショットのインポート制限を超えています。これ以上のイメージはインポートできません。 |