14.5.2 特定のボリュームの情報を取得する
ボリュームIDを指定して、特定のボリュームの情報を取得します。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/simple/v1/objects/volumes/<オブジェクトID>
リクエストメッセージ
- オブジェクトID
-
ボリュームの情報取得で取得したidの値を指定します。
属性
型
説明
id
int
(必須)ボリュームID
- クエリパラメータ
- なし。
- ボディ
- なし。
レスポンスメッセージ
- ボディ
-
ボリュームIDが100のボリュームの情報を取得した例を次に示します。
{ "id": 100, "nickname": "JH-26216_DP", "poolId": 63, "poolName": "pool-1", "totalCapacity": 1024, "usedCapacity": 42, "freeCapacity": 982, "reservedCapacity": 0, "savingSetting": "COMPRESSION", "isDataReductionShareEnabled": true, "compressionAcceleration": true, "compressionAccelerationStatus": "ENABLED", "capacitySavingStatus": "Enabled", "numberOfConnectingServers": 2, "numberOfSnapshots": 0, "luns": [ { "lun": 1, "serverId": 10, "portId": "CL1-A" }, { "lun": 1, "serverId": 11, "portId": "CL2-A" } ], "volumeTypes": [] }
取得する属性については、ボリュームの情報を取得する場合の属性に加えて、次に示す属性が取得されます。
属性
型
説明
freeCapacity
long
ボリュームの空き容量(MiB)
ボリュームを作成中または削除中の場合、ボリュームの総容量が出力されます。
reservedCapacity
long
ボリュームのページ予約容量(MiB)
compressionAccelerationStatus
string
ボリュームに格納されているデータの圧縮アクセラレータ適用の状態
- DISABLED:圧縮アクセラレータが適用されていない
- ENABLED:圧縮アクセラレータが適用されている
- HYBRID:圧縮アクセラレータが有効なデータと無効なデータが、ボリューム内に混在している
ストレージシステムがVSP E シリーズの場合で、容量削減機能が有効なボリュームまたは重複排除用システムデータボリューム(データストア)のときに出力されます。
capacitySavingProgress
int
容量削減機能(圧縮および重複排除機能)の状態の進捗率(%)
luns
object[]
LUNの設定情報
- lun(int)
LU番号
- serverId(int)
サーバID
- portId(string)
割り当て先のポートID
volumeTypesがNamespaceの場合、この属性は出力されません。
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X GET https://192.0.2.100/ConfigurationManager/simple/v1/objects/volumes/100