リージョン間移行イメージ登録

リージョン間移行対象のイメージを登録します。

登録には、リージョン間移行イメージエクスポートで出力されたファイルが、オブジェクトストレージに配置されている必要があります。

登録状況は、本APIのレスポンスに出力される「import_id」をキーに、「イメージ登録状況取得」、「イメージ登録状況一覧取得」を使用して確認します。

URL

/v1/regionmigrationimport

Method

POST

リクエストヘッダー

本APIが受け取るリクエストヘッダーの一覧をリクエストヘッダー一覧に示す。

表 1. リクエストヘッダー一覧
リクエストヘッダー名 説明
X-Auth-Token String Identityサービスを使用して取得したトークン

リクエストボディ

本APIが受け取るリクエストパラメーターの一覧をリクエストパラメーター一覧に示す。各パラメーターはリクエストボディにJSON形式で指定する。

表 2. リクエストパラメーター一覧
パラメーター名 説明
location String

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

以下の形式で指定する。

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

レスポンスボディ

本APIが返却するパラメーターの一覧を正常時のレスポンスパラメーター一覧および異常時のレスポンスパラメーター一覧に示す。レスポンスボディはJSON形式で出力される。失敗時の詳細エラー情報一覧を詳細エラー情報一覧に示す。

表 3. 正常時のレスポンスパラメーター一覧
パラメーター名 説明
import_id String

インポート処理のID

変換状況取得を行う場合に用いる。

表 4. 異常時のレスポンスパラメーター一覧
パラメーター名 説明
error_code String 詳細エラーコード
message String 詳細エラーメッセージ

表 5. 詳細エラー情報一覧
ステータスコード 詳細エラーコード 詳細エラーメッセージ 対処方法
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. インポート対象イメージをサイズが小さくなるよう作成しなおす。
403 40301 You cannot execute this API. アカウントの権限を管理者に確認する。
400 40051 Unsupported operating system or version in this region. リクエスト内容を修正する。
500 50001 Internal server error. サポートに連絡する。
500 50002 Internal server error. サポートに連絡する。

ステータスコード

本APIが返却するステータスコードの一覧をステータスコード一覧に示す。

表 6. ステータスコード一覧
ステータスコード 説明
201 仮想サーバインポート処理を正常に開始したことを示す。
400 リクエストが不正であることを示す。
401 トークンが不正であることを示す。
403 仮想サーバインポートの実行権限が存在しないことを示す。
500 内部エラーにより仮想サーバインポート処理が失敗したことを示す。
503 仮想サーバインポート処理の同時実行上限を超える要求であったため失敗したことを示す。

レスポンスボディ例

レスポンスボディの例を以下に示す。


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