Show volume information (1)
Method | URI | Description |
---|---|---|
GET | /v2/{tenant_id}/volumes/{volume_id} | 指定したボリュームに関する情報を表示します。 |
Normal response codes: 200
Request
下表は、ボリューム情報表示リクエストのURIパラメーターの一覧です。
Name | Type | Description |
---|---|---|
{tenant_id} | String | プロジェクトID |
{volume_id} | UUID | 既存のボリュームのボリュームID |
本操作ではリクエストボディ部の指定は不要です。
Response
下表は、レスポンスパラメーターの一覧です。
Name | Type | Description |
---|---|---|
volume | object | volumeオブジェクト |
attachments | list | アタッチされているインスタンスの情報
このボリュームが仮想サーバにアタッチされている場合、アタッチメントリストにはアタッチされているサーバのUUIDと、存在する場合はアタッチされているホストの名前、ボリュームのUUID、デバイス、デバイスのUUIDが記載される。 それ以外の場合、この一覧は空です。 |
links | list | ボリュームのリンク |
availability_zone | string | アベイラビリティゾーン名 |
os-vol-host-attr:host | string | ボリュームの現在のバックエンド |
encrypted | boolean | "true"の場合、このボリュームは暗号化されています。 |
snapshot_id | UUID | ボリューム作成元スナップショットのID |
id | UUID | ボリュームID |
size | int | ボリュームの容量 (単位: GiB) |
user_id | UUID | ユーザーID |
os-vol-tenant-attr:tenant_id | UUID | ボリュームが属しているプロジェクトID |
os-vol-mig-status-attr:migstat | string | このボリュームの移行のステータス(Noneは移行が現在進行中ではないことを意味します) |
metadata | object | ボリュームに関連付けられる一つ以上のメタデータのキーと値のペア |
status | string | ボリュームの状態 |
description | string | ボリュームの説明 |
source_volid | UUID | 作成元ボリュームのボリュームID |
os-vol-mig-status-attr:name_id | UUID | バックエンドにあるボリューム名のベースとなっているボリュームID |
name | string | ボリューム名 |
bootable | boolean | bootable属性を有効化または無効化します。起動可能なボリュームからインスタンスを起動できます。 |
created_at | dateTime | リソースの作成日時
日付と時刻の形式はISO 8601に準拠しています。 CCYY-MM-DDThh:mm:ss±hh:mm 例: 2015-08-27T09:49:58-05:00 "±hh:mm"の値が含まれる場合、この値はタイムゾーンのUTCへのオフセット時間です。 |
volume_type | string | ボリュームタイプ
複数のストレージバックエンドのある環境において、スケジューラーは、ボリュームのタイプに基づいてボリュームの送信先を判断します。 複数のストレージバックエンドの作成にボリュームのタイプを使用する方法については、複数ストレージバックエンドの構成を参照してください。 |
volume_image_metadata | object | ボリュームのイメージに関連付けられる一つ以上のメタデータのキーと値のペア |
Example. Show volume information: JSON response
{
"volume": {
"status": "available",
"attachments": [],
"links": [
{
"href": "http://localhost:8776/v2/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "self"
},
{
"href": "http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"bootable": "false",
"os-vol-host-attr:host": "ip-10-168-107-25",
"source_volid": null,
"snapshot_id": null,
"id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"description": "Super volume.",
"name": "vol-002",
"created_at": "2013-02-25T02:40:21.000000",
"volume_type": "None",
"os-vol-tenant-attr:tenant_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
"size": 1,
"metadata": {
"contents": "not junk"
}
}
}