Show image details

イメージの詳細情報を表示します。

APIエンドポイント

リージョン APIエンドポイント
西日本リージョン3の場合 https://image.jp-west-3.cloud.global.fujitsu.com
東日本リージョン3の場合 https://image.jp-east-3.cloud.global.fujitsu.com

HTTPメソッドとURI

GET

/v2/images/{image_id}

HTTPステータスコード

正常時:200

エラー時:400, 401, 403, 404

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

名前 In Type

デフォルト値

/必須指定

Description
image_id path string 必須 イメージのUUID

レスポンスボディ(正常系)の説明

名前 Type Description
checksum string

イメージデータを検証するためのハッシュ値

「null」が表示される場合もあります。

container_format enum

イメージコンテナのフォーマット

指定可能な値はイメージを定義するスキーマのレスポンスに表示されます。

例: ami, ari, aki, bare, ovf, ovaまたはdocker

「null」が表示される場合もあります。

created_at string

リソースの作成日時

日時の入力形式は以下のISO 8601形式です。

CCYY-MM-DDThh:mm:ss±hh:mm

例:2015-08-27T09:49:58-05:00

「±hh:mm」の部分は、タイムゾーンにUTCからのオフセットがある場合にだけ表示されます。

disk_format enum

ディスクのフォーマット

指定可能な値はイメージを定義するスキーマのレスポンスに表示されます。

例: ami, ari, aki, vhd, vhdx, vmdk, raw, qcow2, vdi, ploopまたはiso

「null」が表示される場合もあります。

file string イメージファイルのURL
id string

以下の形式のイメージUUID

nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn

「n」は、16進数の0~Fです。

例) b2173dd3-7ad6-4362-baa6-a68bce3565cb

省略する場合は、UUIDが自動的に生成されます。

min_disk integer

イメージを起動するために必要なディスク領域(GB単位)

「null」が表示される場合もあります。

min_ram integer

イメージを起動するために必要なram領域(MB単位)

「null」が表示される場合もあります。

name string

イメージ名

「null」が表示される場合もあります。

owner string

イメージの所有者のプロジェクトID

「null」が表示される場合もあります。

protected boolean 「true」の場合はイメージは削除不可能
schema string イメージを定義するスキーマのURL
self string イメージのURL
size integer

イメージデータのサイズ(バイト単位)

「null」が表示される場合もあります。

status string イメージのステータス
tags array

イメージのタグのリスト

空配列の場合もあります。

updated_at string

リソースの最新更新日時

日時の入力形式は以下のISO 8601形式です。

CCYY-MM-DDThh:mm:ss±hh:mm

「±hh:mm」の部分は、UTCからのオフセットで表示されるタイムゾーンです。表示されない場合もあります。

例えば、以下の出力例に、UTCのタイムゾーンからの-05:00のオフセットが想定されます。

2015-08-27T09:49:58-05:00

設定されていない場合は、「null」となります。

virtual_size integer

イメージの仮想的なサイズ

「null」が表示される場合もあります。

visibility string イメージの公開状況
direct_url string イメージにアクセスするためのURL
locations array

イメージの場所が記載されているオブジェクトのリスト

各オブジェクトにイメージへのリンクURL(URL)とそのキーと値のペアのリスト(メタデータ)が含まれています。

レスポンス例

{
    "status": "active",
    "name": "cirros-0.3.2-x86_64-disk",
    "tags": [],
    "container_format": "bare",
    "created_at": "2014-05-05T17:15:10Z",
    "disk_format": "qcow2",
    "updated_at": "2014-05-05T17:15:11Z",
    "visibility": "public",
    "self": "/v2/images/1bea47ed-f6a9-463b-b423-14b9cca9ad27",
    "min_disk": 0,
    "protected": false,
    "id": "1bea47ed-f6a9-463b-b423-14b9cca9ad27",
    "file": "/v2/images/1bea47ed-f6a9-463b-b423-14b9cca9ad27/file",
    "checksum": "64d7c1cd2b6f60c92c14662941cb7913",
    "owner": "5ef70662f8b34079a6eddb8da9d75fe8",
    "size": 13167616,
    "min_ram": 0,
    "schema": "/v2/schemas/image",
    "virtual_size": null
}