Hitachi

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


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

プール種別

  • HDPHDPプール
  • HDTHDTプール
  • RTactive 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、G900VSP F350、F370、F700、F900の場合に表示されます。

availableVolumeCapacity

long

ボリュームデータに使用できる容量(MB)

論理容量の空き容量(MB)を示します。

availablePhysicalVolumeCapacity

long

物理容量の空き容量(MB)

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900の場合に表示されます。

totalPoolCapacity

long

プールの総容量(MB)

論理容量の合計(MB)を示します。

totalPhysicalCapacity

long

物理容量の合計(MB)

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP 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、G900VSP 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)

    階層再配置の進捗率

    次に示す階層再配置の稼働状態の進捗率が099の値で表示されます。

    • 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

プール種別を表示します。

HTIThin 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、G900VSP F350、F370、F700、F900の場合に表示されます。

snapshotCount

int

プールにあるボリューム数

availableVolumeCapacity

long

ボリュームデータに使用できる容量(MB)

論理容量の空き容量(MB)を示します。

availablePhysicalVolumeCapacity

long

物理容量の空き容量(MB)

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP F350、F370、F700、F900の場合に表示されます。

totalPoolCapacity

long

プールの総容量(MB)

論理容量の合計(MB)を示します。

totalPhysicalCapacity

long

物理容量の合計(MB)

VSP 5000 シリーズVSP E シリーズVSP G150、G350、G370、G700、G900VSP 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