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 }