Show Image Registration Status#

イメージ登録状況を取得します。

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#

GET

/v1/imageimport/{import_id}/status

HTTPステータスコード#

正常時：200

エラー時：401, 403, 404, 500

リクエストパラメータの説明#

名前 In Type デフォルト値
/必須指定		 Description
X-Auth-Token header string 必須 Identityサービスを使用して取得したトークン
import_id path string 必須 イメージ登録のAPIで返却されたインポート処理のID

レスポンスボディ（正常系）の説明#

名前 Type Description
import_status string インポート処理状況
以下のどれかの値です。
キーワード 意味
succeeded インポート処理が正常終了したことを示す。
failed インポート処理が失敗したことを示す。
processing インポート処理中であることを示す。
queued インポート処理実行開始待ちであることを示す。
cancelling インポート処理が中止途中であることを示す。
canceled インポート処理が中止したことを示す。
processingとqueuedの状態を繰り返すことがあります。
progress integer インポート処理の進捗状況
0～100の範囲の値をとります。
name string イメージ名
disk_format string サービスに格納するディスク形式
container_format string サービスに格納するコンテナ形式
location string 移行元イメージファイルを配置したオブジェクトストレージのURL
id string サービスに登録したイメージの一意なID
min_ram integer イメージを使用するために必要な最小RAM（MB）
min_disk integer イメージを使用するために必要な最小ディスク容量（GB）
properties string 使用しない値のため""(空値)が表示されます。
ovf_location string 使用しない値のため""(空値)が表示されます。
conversion boolean イメージ変換の有無
os_type string 移行元イメージ内のOS種別
user_name string ユーザー名(*1)
password string パスワード(*1)(*2)
domain_name string ドメイン名(*1)
kms string KMSライセンス認証設定
server_info string KMSライセンスサーバのFQDNとポート番号
activate boolean KMSライセンス認証のアクティベーション指定
details object インポート方式の詳細
image_from string 移行元仮想環境
image_to string 移行先仮想環境
file_type string インポート対象イメージのファイル形式

*1：新バージョンでは本項目は使用しませんが、イメージ登録APIのリクエストボディに設定されていた場合だけ、旧バージョンどおり出力されます。

*2：イメージ登録APIにて入力値を*に変換し、Base64エンコード済みのパスワード文字列は保存しません。

リージョン間移行イメージ登録の場合のレスポンスボディ（正常系）の説明#

名前 Type Description
import_status string インポート処理状況以下のどれかの値です。
キーワード 意味
succeeded インポート処理が正常終了したことを示す。
failed インポート処理が失敗したことを示す。
processing インポート処理中であることを示す。
queued インポート処理実行開始待ちであることを示す。
cancelling インポート処理が中止途中であることを示す。
canceled インポート処理が中止したことを示す。
processingとqueuedの状態を繰り返すことがあります。
progress integer インポート処理の進捗状況0～100の範囲の値をとります。
name string イメージ名
disk_format string サービスに格納するディスク形式
container_format string サービスに格納するコンテナ形式
location string 移行元イメージファイルを配置したオブジェクトストレージのURL
id string サービスに登録したイメージの一意なID
min_ram integer イメージを使用するために必要な最小RAM（MB）
min_disk integer イメージを使用するために必要な最小ディスク容量（GB）
billing_info object 課金情報
base_image_id string 移行元イメージのベースイメージID
os_type string 移行元イメージ内のOS種別
details object インポート方式の詳細
image_from string 移行元仮想環境
image_to string 移行先仮想環境
file_type string インポート対象イメージのファイル形式

増設ストレージ移行対象のイメージ登録の場合のレスポンスボディ（正常系）の説明#

名前 Type Description
import_status string インポート処理状況以下のどれかの値です。
キーワード 意味
succeeded インポート処理が正常終了したことを示す。
failed インポート処理が失敗したことを示す。
processing インポート処理中であることを示す。
queued インポート処理実行開始待ちであることを示す。
cancelling インポート処理が中止途中であることを示す。
canceled インポート処理が中止したことを示す。
processingとqueuedの状態を繰り返すことがあります。
progress integer インポート処理の進捗状況0～100の範囲の値をとります。
name string イメージ名
location string 移行元イメージファイルを配置したオブジェクトストレージのURL
id string サービスに登録したイメージの一意なID
details object インポート方式の詳細
image_from string 移行元仮想環境
image_to string 移行先仮想環境
file_type string インポート対象イメージのファイル形式

レスポンス例#

{
  "import_status":"succeeded",
  "progress":100,"name":"sample_image",
  "disk_format":"raw",
  "container_format":"bare",
  "location":"/v2/AUTH_100f1c092038413a8dd6771a455b17f5/test_container/test_image.vmdk",
  "id":"14294f46-d9fe-45bb-ba5f-0b93a69c4416",
  "min_ram":0,
  "min_disk":0,
  "properties":{},
  "ovf_location":"",
  "conversion":true,
  "os_type":"rocky",
  "user_name":"testuser",
  "password":"*",
  "domain_name":"testdomain",
  "details":{"image_from":"vmware","image_to":"fj_cloud","file_type":".vmdk"}
}

リージョン間移行イメージ登録の場合のレスポンス例#

{
  "import_status":"succeeded",
  "progress":100,
  "name":"sample_image",
  "disk_format":"raw",
  "container_format":"bare",
  "location":"/v2/AUTH_100f1c092038413a8dd6771a455b17f5/test_container/test_image.qcow2.gz",
  "id":"14294f46-d9fe-45bb-ba5f-0b93a69c4416",
  "min_ram":0,
  "min_disk":0,
  "billing_info": {"os_type": "rocky", "base_image_id": "a37f91e029ca11edbccafa163e4552f6"},
  "details":{"image_from":"fj_cloud”,"image_to":"fj_cloud","file_type":".qcow2.gz"}
}

増設ストレージ移行対象のイメージ登録の場合のレスポンス例#

{
  "import_status":"succeeded",
  "progress":100,
  "name":"sample_image",
  "location":"/v2/AUTH_100f1c092038413a8dd6771a455b17f5/test_container/test_image.qcow2.gz",
  "id":"14294f46-d9fe-45bb-ba5f-0b93a69c4416",
  "details":{"image_from":"fj_cloud","image_to":"fj_cloud",”file_type":".qcow2.gz"}
}