Register an Image for Migration between Regions#
リージョン間移行対象のイメージを登録します。
登録には、Export an Image for Migration between Regionsで出力されたファイルが、オブジェクトストレージに配置されている必要があります。
登録状況は、本APIのレスポンスに出力される「import_id」をキーに、「Show Image Registration Status」、「List Image Registration Statuses」を使用して確認します。
APIエンドポイント#
| リージョン | APIエンドポイント |
|---|---|
| 西日本リージョン3の場合 | https://import-export.jp-west-3.cloud.global.fujitsu.com |
| 東日本リージョン3の場合 | https://import-export.jp-east-3.cloud.global.fujitsu.com |
HTTPメソッドとURI#
POST
/v1/regionmigrationimport
HTTPステータスコード#
正常時：201
エラー時：400, 401, 403, 500, 503
リクエストパラメータの説明#
| 名前 | In | Type | デフォルト値 /必須指定 |
Description |
|---|---|---|---|---|
| X-Auth-Token | header | string | 必須 | Identityサービスを使用して取得したトークン |
| name | body | string | 任意 | イメージ名を指定します。 移行元リージョンのイメージ名と同名にする場合は、指定する必要はありません。 |
| location | body | string | 必須 | 移行元イメージファイルを配置した、オブジェクトストレージのURLのパス 以下の形式で指定します。 "/v2/AUTH_<プロジェクトID>/<コンテナ名>/<オブジェクト名>" オブジェクト名は以下のどちらかの値が指定できます。 - ”～.img.gz” - ”～.qcow2.gz” |
レスポンスボディ#
本APIが返却するパラメーターの一覧を正常時のレスポンスパラメーター一覧および失敗時のレスポンスパラメーター一覧に示します。レスポンスボディはJSON形式で出力されます。失敗時の詳細エラー情報一覧を詳細エラー情報一覧に示します。
表 1. 正常時のレスポンスパラメーター一覧
| 名前 | Type | Description |
|---|---|---|
| import_id | string | インポート処理のIDが出力されます。状況取得を行う場合に使用します。 |
表 2. 失敗時のレスポンスパラメーター一覧
| パラメーター名 | 値 | 説明 |
|---|---|---|
| error_code | string | 詳細エラーコード |
| error_message | string | 詳細エラーメッセージ |
表 3. 詳細エラー情報一覧
| ステータスコード | 詳細エラーコード | 詳細エラーメッセージ | 対処方法 |
|---|---|---|---|
| 400 | 40001 | Required parameter 'name' is not specified. | リクエスト内容を修正します。 |
| 400 | 40002 | Required parameter 'location' is not specified. | リクエスト内容を修正します。 |
| 400 | 40011 | Project_id does not exist. | 認証トークンよりプロジェクトが取得できませんでした。認証トークンを見直してください。 |
| 400 | 40013 | Request body does not exist. | リクエスト内容を修正します。 |
| 400 | 40014 | Request body is not a json format. | リクエスト内容を修正します。 |
| 400 | 40025 | Parameter 'location' has invalid value. | 指定したパスに、リージョン間移行エクスポートで出力されたオブジェクトが格納されているか確認します。 |
| 400 | 40027 | Parameter 'id' has invalid value. | リクエスト内容を修正します。 |
| 400 | 40028 | Parameter 'name' has invalid value. | リクエスト内容を修正します。 |
| 400 | 40031 | Parameter 'checksum' has invalid value. | リクエスト内容を修正します。 |
| 400 | 40032 | Parameter 'min_ram' has invalid value. | リクエスト内容を修正します。 |
| 400 | 40033 | Parameter 'min_disk' has invalid value. | リクエスト内容を修正します。 |
| 400 | 40037 | The size of the import image is too large. | インポート対象イメージをサイズが小さくなるよう作成しなおします。 |
| 400 | 40051 | Unsupported operating system or version in this region. | リクエスト内容を修正します。 |
| 400 | 40062 | Invalid parameter.(item='%s') | 指定されたパラメータの形式、値に誤りがあります(対象パラメータ名)。リクエスト内容を修正します。 |
| 403 | 40301 | You cannot execute this API. | アカウントの権限を管理者に確認します。 |
| 500 | 50001 | Internal server error. | サポートに連絡してください。 |
| 500 | 50002 | Internal server error. | サポートに連絡してください。 |
| 503 | 50301 | Too many requests. | 時間を置いてから本APIを再実行してください。 |
レスポンス例#
{"import_id":"6bf65660-70ee-4a75-b61a-36ac040c289c"}