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"
		}
	}
}