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サービスを使用して取得したトークン
location body string 必須

移行元イメージファイルを配置した、オブジェクトストレージのURLのパス

以下の形式で指定します。

"/v2/AUTH_<プロジェクトID>/<コンテナ名>/<オブジェクト名>"

レスポンスボディ

本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. リクエスト内容を修正します。
403 40301 You cannot execute this API. アカウントの権限を管理者に確認します。
500 50001 Internal server error. サポートに連絡してください。
500 50002 Internal server error. サポートに連絡してください。

レスポンス例

{"import_id":"6bf65660-70ee-4a75-b61a-36ac040c289c"}