12.2.1　プールの情報を取得する : Hitachi Storage Advisor Embedded ガイド

実行権限

ストレージ管理者（参照）

リクエストライン

GET ＜ベースURL＞/simple/v1/objects/pools

リクエストメッセージ

オブジェクトID: なし。

クエリパラメータ

パラメータ	型	フィルタ条件
name	string	（任意）プール名指定した値の一部がプール名と一致する場合もプールの情報が取得されます。
status	string	（任意）取得するプールの状態として、次の値を指定します。 `Normal`：正常 `ExceededThreshold`：プールの使用率がしきい値を超えている `Error`：プールが満杯でエラー状態

パラメータ

型

フィルタ条件

name

string

（任意）プール名

指定した値の一部がプール名と一致する場合もプールの情報が取得されます。

status

string

（任意）取得するプールの状態として、次の値を指定します。

Normal：正常
ExceededThreshold：プールの使用率がしきい値を超えている
Error：プールが満杯でエラー状態

ボディ: なし。

レスポンスメッセージ

ボディ

{
  "data": [
    {
      "id": 63,
      "name": "NASOS",
      "status": "Normal",
      "totalCapacity": 2996994,
      "usedCapacity": 38,
      "freeCapacity": 2996956,
      "capacityManage": {
        "usedCapacityRate": 0,
        "thresholdWarning": 70,
        "thresholdDepletion": 80
      },
      "savingEffects": {
        "efficiencyDataReduction": 104,
        "efficiencyFmdSaving": 0,
        "preCapacityFmdSaving": 0,
        "postCapacityFmdSaving": 0
      },
      "numberOfVolumes": 2,
      "numberOfTiers": 2,
      "numberOfDriveTypes": 2,
      "tiers": [
        {
          "driveType": "Flash Drive",
          "driveRpm": "NUMBER_0",
          "totalCapacity": 1352148,
          "usedCapacity": 28
        },
        {
          "driveType": "SAS",
          "driveRpm": "NUMBER_10000",
          "totalCapacity": 1644846,
          "usedCapacity": 10
        }
      ]
    }
  ],
  "count": 1
}

属性	型	説明
id	int	プールID
name	string	プール名
status	string	プールの状態 `Normal`：正常 `ExceededThreshold`：プールの使用率がしきい値を超えている `Error`：プールが満杯でエラー状態
totalCapacity	long	プールの総容量（MiB）
usedCapacity	long	プールの使用容量（MiB）
freeCapacity	long	プールの空き容量（MiB）
capacityManage	object	プールの容量に関する設定情報が出力されます。 `usedCapacityRate`（int）プールの使用率（%） `thresholdWarning`（int）プールの警告しきい値（%） `thresholdDepletion`（int）プールの枯渇しきい値（%）
savingEffects	object	プールに関する削減効果の比率などの情報が出力されます。 `efficiencyDataReduction`（int）容量削減機能（圧縮および重複排除機能）によって削減されたプールの削減効果の比率削減後の値を`100`として計算した削減前の値が出力されます。（例）`104`（削減前）：`100`（削減後）の場合、「`"efficiencyDataReduction": 104`」と出力されます。削減後の容量には、ユーザデータのほかにストレージシステムが生成するメタデータやガベージデータを含んだ値で計算します。そのため、削減後の値の方が大きくなることがあります。 `-1`が出力された場合、その値は無効な情報です。 `efficiencyFmdSaving`（int）容量拡張機能によって削減されたプールの削減効果の比率削減後の値を`100`として計算した削減前の値が出力されます。（例）`104`（削減前）：`100`（削減後）の場合、「`"efficiencyFmdSaving": 104`」と出力されます。 `-1`が出力された場合、その値は無効な情報です。 `preCapacityFmdSaving`（long）容量拡張機能によって削減される前のプールの容量 `postCapacityFmdSaving`（long）容量拡張機能によって削減された後のプールの容量
numberOfVolumes	int	プールに関連づけられたボリュームの数
numberOfTiers	int	プールを構成する階層の数
numberOfDriveTypes	int	ドライブタイプの数
tiers	object[]	階層に関する次の属性が、階層ごとに出力されます。 `driveType`（string）次に示すドライブタイプが出力されます。 `Flash Drive` `SAS` `SATA` `External Storage` `Mixed` `Unknown` `driveRpm`（string）ドライブの毎分回転数 `totalCapacity`（long）階層の総容量（MiB） `usedCapacity`（long）階層の使用済み容量（MiB）

ステータスコード

この操作のリクエストに対するステータスコードについては、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/pools

12.2.1 プールの情報を取得する

12.2.1　プールの情報を取得する