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