8.3　特定のプールの情報を取得する

プール番号を指定して、特定のプールの情報を取得します。

実行権限

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

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/pools/＜オブジェクトID＞

リクエストメッセージ

オブジェクトID

プールの情報取得で取得したpoolIdの値を指定します。

属性	型	説明
poolId	int	（必須）プール番号

クエリパラメータ: なし。

ボディ: なし。

レスポンスメッセージ

ボディ

HDPプールの情報を取得した場合の出力例を次に示します。

{
  "poolId" : 2,
  "poolStatus" : "POLN",
  "usedCapacityRate" : 8,
  "snapshotCount" : 0,
  "poolName" : "testDP_Pool",
  "availableVolumeCapacity" : 24066,
  "totalPoolCapacity" : 26418,
  "numOfLdevs" : 3,
  "firstLdevId" : 257,
  "warningThreshold" : 70,
  "depletionThreshold" : 80,
  "virtualVolumeCapacityRate" : -1,
  "isMainframe" : false,
  "isShrinking" : false,
  "locatedVolumeCount" : 3,
  "totalLocatedCapacity" : 41956068,
  "blockingMode" : "FB",
  "totalReservedCapacity" : 0,
  "reservedVolumeCount" : 0,
  "poolType" : "HDP",
  "duplicationLdevIds" : [ 61158 ],
  "duplicationNumber" : 1,
  "dataReductionAccelerateCompCapacity" : 3260591,
  "dataReductionCapacity" : 3260591,
  "dataReductionBeforeCapacity" : 5901315,
  "dataReductionAccelerateCompRate" : 52,
  "duplicationRate" : 6,
  "compressionRate" : 46,
  "dataReductionRate" : 55,
  "dataReductionAccelerateCompIncludingSystemData" : {
    "isReductionCapacityAvailable" : true,
    "reductionCapacity" : 1376256,
    "isReductionRateAvailable" : true,
    "reductionRate" : 22
  },
  "dataReductionIncludingSystemData" : {
    "isReductionCapacityAvailable" : true,
    "reductionCapacity" : 1376256,
    "isReductionRateAvailable" : true,
    "reductionRate" : 22
  },
  "snapshotUsedCapacity" : 0,
  "suspendSnapshot" : true
}

DPプールの場合

属性	型	説明
poolId	int	プール番号
poolName	string	プール名
poolType	string	プール種別 `HDP`：HDPプール `HDT`：HDTプール `RT`：active flash用のプール `DM`：データダイレクトマップ属性のHDPプール
poolStatus	string	プールの次の状態を表示します。 `POLN`：正常（Pool Normal） `POLF`：しきい値を超えたオーバーフロー状態（Pool Full） `POLS`：しきい値を超えたオーバーフロー状態で閉塞している（Pool Suspend） `POLE`：障害状態で閉塞している（Pool failure）プールの状態が`POLE`の場合、プールの情報を取得できません。
usedCapacityRate	int	プールの使用率（%）論理容量の使用率（%）を示します。
usedPhysicalCapacityRate	int	物理容量の使用率（%） VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
availableVolumeCapacity	long	ボリュームデータに使用できる容量（MB）論理容量の空き容量（MB）を示します。
availablePhysicalVolumeCapacity	long	物理容量の空き容量（MB） VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
totalPoolCapacity	long	プールの総容量（MB）論理容量の合計（MB）を示します。
totalPhysicalCapacity	long	物理容量の合計（MB） VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
numOfLdevs	int	プールを構成するLDEV数
firstLdevId	int	プールを構成するLDEVの第1の番号
warningThreshold	int	プールに設定されている警告しきい値
depletionThreshold	int	プールに設定されている枯渇しきい値
suspendSnapshot^※	boolean	枯渇しきい値を超過した場合に、Thin Imageペアを中断するかどうか `true`：枯渇しきい値超過時にThin Imageペアを中断する `false`：枯渇しきい値超過時にThin Imageペアを中断しない
virtualVolumeCapacityRate	int	プール容量に対する仮想ボリュームの最大予約率無制限が設定されている場合、`-1`が出力されます。 VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、無効な値を示す`-1`が出力されます。
isShrinking	boolean	プールが縮小中（シュリンク中）であるかどうかが表示されます。 `true`：プールが縮小中である `false`：プールが縮小中でない
locatedVolumeCount	int	プールにマッピングされたDPボリュームの合計数
totalLocatedCapacity	long	プールにマッピングされたすべてのDPボリュームの合計容量（MB）この属性値は、制御領域を含みません。
snapshotCount^※	int	プールにマッピングされたスナップショットデータの合計数
snapshotUsedCapacity^※	long	プールにマッピングされたすべてのスナップショットデータの使用量（MB）
blockingMode	string	仮想ボリューム保護機能の設定 DPプールが満杯か、またはDPプールボリュームが閉塞している場合に、対象のDPプールを使用しているDPボリュームを読み書きできるかどうかが表示されます。 `PF`：Pool Full DPプールが満杯の場合、読み書きできない DPプールボリュームが閉塞している場合、読み書きできる `PB`：Pool vol Blockade DPプールボリュームが閉塞している場合、読み書きできない DPプールが満杯の場合、読み書きできる `FB`：Full or Blockade DPプールが満杯またはDPプールボリュームが閉塞している場合、読み書きできない `NB`：No Blocking DPプールが満杯またはDPプールボリュームが閉塞している場合でも、対象のDPボリュームを読み書きできる
totalReservedCapacity	long	DPプールに関連づけられたDPボリュームのページ予約容量の合計（MB）ページ予約機能をサポートしていない構成の場合は表示されません。
reservedVolumeCount	int	DPプールに関連づけられた、ページ予約の設定が有効なボリューム数ページ予約機能をサポートしていない構成の場合は表示されません。
poolActionMode	string	プールの実行モード `DEF`：REST APIサーバからモニタの開始、終了を指示し、DKC自動計算で階層の範囲設定を行うモード `AUT`：時刻指定でモニタを開始、終了し、DKC自動計算で階層の範囲設定を行うモード（Storage Navigatorで指定します）
monitoringMode	string	性能モニタリングの実行モード（モニタモード） `PM`：周期モード（Period Mode） `CM`：継続モード（Continuous Mode）
tierOperationStatus	string	性能モニタリングおよび階層再配置の稼働状態を表示 `STP`：性能モニタリングおよび階層再配置が停止状態 `RLC`：性能モニタリングが停止状態、階層再配置は稼働状態 `MON`：性能モニタリングが稼働状態、階層再配置は停止状態 `RLM`：性能モニタリングおよび階層再配置が稼働状態
dat	string	モニタ情報の状態 `VAL`：有効 `INV`：無効 `PND`：計算中
tiers	object[]	HDTプールの階層に関する次の属性が階層ごとに表示されます。 tierNumber（int）階層の番号 tierLevelRange（string）階層の下限値 1時間当たりのI/O数（IOPH）で表示されます。 tierDeltaRange（string）階層のデルタ値 1時間当たりのI/O数（IOPH）で表示されます。 tierUsedCapacity（long）階層の使用量（MB） tierTotalCapacity（long）階層の合計容量（MB） tablespaceRate（int）新規割り当て用の空き領域率 performanceRate（int）性能稼働率 progressOfReplacing（int）階層再配置の進捗率次に示す階層再配置の稼働状態の進捗率が`0`～`99`の値で表示されます。 `tierOperationStatus`属性の値が`RLC`または`RLM`の場合：再配置（実行中）の進捗率 `tierOperationStatus`属性の値が`STP`または`MON`の場合：再配置（中断中）の進捗率階層再配置が実行されていない状態、または階層再配置が終了した状態の場合、`100`が表示されます。 bufferRate（int）再配置用バッファ領域率
duplicationLdevIds^※	int[]	重複排除用システムデータボリュームのLDEV番号
duplicationNumber^※	int	重複排除用システムデータボリューム数
dataReductionAccelerateCompCapacity^※	long	容量削減機能（dedupe and compression）または容量拡張機能によって削減された容量（ブロック単位）削減後の容量には、ストレージシステムが生成するメタデータやガベージデータは含まれません。
dataReductionCapacity^※	long	容量削減機能（圧縮および重複排除）によって削減された容量（ブロック単位）削減後の容量には、ストレージシステムが生成するメタデータやガベージデータは含まれません。
dataReductionBeforeCapacity^※	long	容量削減機能（圧縮および重複排除）によって削減される前の容量（ブロック単位）
dataReductionAccelerateCompRate ^※	int	容量削減機能（圧縮および重複排除）または容量拡張機能によって削減された容量の割合（%）削減後の容量には、ストレージシステムが生成するメタデータやガベージデータは含まれません。
dataReductionRate^※	int	容量削減機能（圧縮および重複排除）によって削減された容量の割合（%）削減後の容量には、ストレージシステムが生成するメタデータやガベージデータは含まれません。
dataReductionAccelerateCompIncludingSystemData^※	object	容量削減機能（圧縮および重複排除）または容量拡張機能によって削減された容量に関する属性が表示されます。これらの属性は、削減後の容量にユーザデータのほかにストレージシステムが生成するメタデータおよびガベージデータを含んだ値で算出されます。 isReductionCapacityAvailable（boolean）容量の削減効果があるかどうか `true`：ある `true`の場合、`reductionCapacity`属性に削減された容量が表示されます。 `false`：ない（削減後に容量が増加している場合など） reductionCapacity（long）削減された容量（ブロック単位） `isReductionCapacityAvailable`属性が`true`の場合に表示されます。 isReductionRateAvailable（boolean）容量の削減効果があるかどうか `true`：ある `true`の場合、`reductionRate`属性に削減された容量の割合が表示されます。 `false`：ない（削減後に容量が増加している場合など） reductionRate（int）削減された容量の割合（%） `isReductionRateAvailable`属性が`true`の場合に表示されます。
dataReductionIncludingSystemData^※	object	容量削減機能（圧縮および重複排除）によって削減された容量に関する属性が表示されます。これらの属性は、削減後の容量にユーザデータのほかにストレージシステムが生成するメタデータおよびガベージデータを含んだ値で算出されます。 isReductionCapacityAvailable（boolean）容量の削減効果があるかどうか `true`：ある `true`の場合、`reductionCapacity`属性に削減された容量が表示されます。 `false`：ない（削減後に容量が増加している場合など） reductionCapacity（long）削減された容量（ブロック単位） `isReductionCapacityAvailable`属性が`true`の場合に表示されます。 isReductionRateAvailable（boolean）容量の削減効果があるかどうか `true`：ある `true`の場合、`reductionRate`属性に削減された容量の割合が表示されます。 `false`：ない（削減後に容量が増加している場合など） reductionRate（int）削減された容量の割合（%） `isReductionRateAvailable`属性が`true`の場合に表示されます。
compressionRate^※	int	圧縮機能または容量拡張機能によって削減された容量の割合（%）
duplicationRate^※	int	重複排除機能によって削減された容量の割合（%）
isMainframe	boolean	プールがメインフレーム用かオープンシステム用かが表示されます。 `true`：メインフレームボリューム用のプール `false`：オープンボリューム用のプール

注※　※が付いている属性およびオブジェクト配下の属性は、プール種別がHDPプールの場合に表示されます。

Thin Imageプールの情報を取得した場合の出力例を次に示します。

{
  "poolId": 6,
  "poolStatus": "POLN",
  "usedCapacityRate": 1,
  "snapshotCount": 1,
  "poolName": "pool_for_snapshot_data",
  "availableVolumeCapacity": 5922,
  "totalPoolCapacity": 6006,
  "numOfLdevs": 1,
  "firstLdevId": 35,
  "warningThreshold": 80,
  "virtualVolumeCapacityRate": -1,
  "isMainframe": false,
  "isShrinking": false,
  "poolType": "HTI"
}

Thin ImageプールまたはCopy-on-Write Snapshotのプールの場合

属性	型	説明
poolId	int	プール番号
poolName	string	プール名
poolType	string	プール種別を表示します。 `HTI`：Thin Imageプール `CW`：Copy-on-Write Snapshotのプール
poolStatus	string	プールの次の状態を表示します。 `POLN`：正常（Pool Normal） `POLF`：しきい値を超えたオーバーフロー状態（Pool Full） `POLS`：しきい値を超えたオーバーフロー状態で閉塞している（Pool Suspend） `POLE`：障害状態で閉塞している（Pool failure）プールの状態が`POLE`の場合、プールの情報を取得できません。
usedCapacityRate	int	プールの使用率（%）論理容量の使用率（%）を示します。
usedPhysicalCapacityRate	int	物理容量の使用率（%） VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
snapshotCount	int	プールにあるボリューム数
availableVolumeCapacity	long	ボリュームデータに使用できる容量（MB）論理容量の空き容量（MB）を示します。
availablePhysicalVolumeCapacity	long	物理容量の空き容量（MB） VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
totalPoolCapacity	long	プールの総容量（MB）論理容量の合計（MB）を示します。
totalPhysicalCapacity	long	物理容量の合計（MB） VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
numOfLdevs	int	プールを構成するLDEV数
firstLdevId	int	プールを構成するLDEVの第1の番号（昇順の先頭番号ではない）
warningThreshold	int	プールに設定されている警告しきい値
virtualVolumeCapacityRate	int	無効な値を示す`-1`が出力されます。
isShrinking	boolean	プールが縮小中（シュリンク中）であるかどうかが表示されます。 `true`：プールが縮小中である `false`：プールが縮小中でない
isMainframe	boolean	プールがメインフレーム用かオープンシステム用かが表示されます。 `true`：メインフレームボリューム用のプール `false`：オープンボリューム用のプール

ステータスコード

この操作のリクエストに対するステータスコードについては、HTTPステータスコードの説明を参照してください。

コード例

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3-f9f0-4ea8-bd8f-09847fac48d3" -X GET https://192.0.2.100:23451/ConfigurationManager/v1/objects/storages/800000012345/pools/18

8.3 特定のプールの情報を取得する

8.3　特定のプールの情報を取得する