7.2 ストレージシステムの容量情報を取得する
- メモ
-
このAPIは、ストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に使用できます。
- 重要
-
空き容量(freeSpace)と総容量(totalCapacity)には、バウンダリ制約(境界制約)によりボリュームを作成できない領域は含まれません。そのため、ボリュームの作成や削除などの操作後に総容量の値が変動することがあります。ボリュームの容量の詳細については、マニュアルオープンシステム構築ガイド、またはシステム構築ガイドを参照してください。
実行権限
ストレージ管理者(参照)
リクエストライン
GET <ベースURL>/v1/objects/storages/<ストレージデバイスID>/total-capacities/instance
リクエストメッセージ
- オブジェクトID
- instanceを指定します。instanceは、単一のインスタンスしか持たないオブジェクトの場合に、オブジェクトID として指定する固定の値です。
- クエリパラメータ
-
なし。
- ボディ
-
なし。
レスポンスメッセージ
- ボディ
{ "internal": { "freeSpace": 30405195264, "totalCapacity": 34921689272 }, "external": { "freeSpace": 0, "totalCapacity": 142606336 }, "total": { "freeSpace": 30405195264, "totalCapacity": 35064295608 } }
属性
型
説明
internal
object
内部ボリュームの容量に関する属性が出力されます。
-
freeSpace(long)
ユーザがボリュームを設定できる空き領域の容量(KB)
-
totalCapacity(long)
ユーザが作成したすべてのボリュームの容量と空き容量の合計(KB)
external
object
外部ボリュームの容量に関する属性が出力されます。
外部ボリュームと接続していない場合も、0の値で出力されます。
-
freeSpace(long)
ユーザがボリュームを設定できる空き領域の容量(KB)
-
totalCapacity(long)
ユーザが作成したすべてのボリュームの容量と空き容量の合計(KB)
total
object
内部ボリュームと外部ボリュームの合計の容量に関する属性が出力されます。
-
freeSpace(long)
ユーザがボリュームを設定できる空き領域の容量(KB)
-
totalCapacity(long)
ユーザが作成したすべてのボリュームの容量と空き容量の合計(KB)
-
ステータスコード
この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。
コード例
curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/886000123457/total-capacities/instance