Hitachi

Hitachi Command Suite Configuration Manager REST API リファレンスガイド


7.2 ストレージシステムの容量情報を取得する

操作対象のストレージシステムについて、すべてのパリティグループの空き容量と総容量の情報を取得します。
メモ

このAPIは、ストレージシステムがVSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP 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