6.2　パリティグループの情報を取得する

メモ

SCMドライブの場合は使用上の注意事項があります。詳細は、ストレージシステムのマニュアルを参照してください。

実行権限

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

リクエストライン

GET ＜ベースURL＞/v1/objects/storages/＜ストレージデバイスID＞/parity-groups

リクエストメッセージ

オブジェクトID

なし。

クエリパラメータ

指定した条件で実行結果をフィルタリングしたり、パリティグループの詳細な情報を追加で取得したりできます。

• 実行結果をフィルタリングする場合

  パラメータ	型	フィルタ条件
  clprId	int	（任意）CLPR番号
  driveTypeName	string	（任意）ドライブタイプ VSP 5000 シリーズの場合： SAS SSD(MLC) SSD(FMC) SSD SCM VSP E シリーズの場合： SAS SSD(MLC) SSD VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合： SAS SSD(MLC) SSD(FMC) SSD(RI) VSP G100、G200、G400、G600、G800、VSP G1000、VSP G1500、VSP F400、F600、F800、VSP F1500の場合： SAS SATA SSD(SLC) SSD(MLC) SSD(FMD) SSD(FMC) Virtual Storage Platform、HUS VMの場合： SAS SATA SSD
  driveSpeed	int	（任意）ドライブの回転数（rpm）

• 詳細情報を追加して取得する場合

  パラメータ	型	説明
  detailInfoType	string	（任意）取得する詳細情報のタイプ 複数指定する場合は、コンマで区切ります。 実行結果をフィルタリングするパラメータと組み合わせて使うこともできます。 FMC ドライブタイプがSSD(FMC)のパリティグループについて、容量拡張の詳細な情報を追加します。 class ストレージシステムのキャッシュからの付加情報を追加します。 ストレージシステムがVSP 5000 シリーズ、VSP E シリーズ、VSP Gx00 モデル、VSP G1000、VSP G1500、VSP Fx00 モデル、VSP F1500、Virtual Storage Platform、HUS VMの場合に指定できます。VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、SVP と連携する構成のときに指定できます。 最新の情報を取得する場合、事前にストレージシステムの構成情報のキャッシュを更新するAPI を実行する必要があります。詳細については、「ストレージシステムの構成情報のキャッシュを更新する」の説明を参照してください。 physicalCapacity 物理容量を追加します。 ストレージシステムがVSP G100、G200、G400、G600、G800、VSP G1000、VSP G1500、VSP F400、F600、F800、VSP F1500の場合に指定できます。

ボディ

なし。

レスポンスメッセージ

ボディ

{
  "data" : [
    {
      "parityGroupId" : "1-1",
      "numOfLdevs" : 267,
      "usedCapacityRate" : 96,
      "availableVolumeCapacity" : 24,
      "raidLevel" : "RAID5",
      "raidType" : "3D+1P",
      "clprId" : 0,
      "driveType" : "DKR5C-K300SS",
      "driveTypeName" : "SAS",
      "driveSpeed" : 15000,
      "totalCapacity" : 805,
      "physicalCapacity" : 805,
      "availablePhysicalCapacity" : 24,
      "isAcceleratedCompressionEnabled" : false,
      "availableVolumeCapacityInKB" : 26103552
    }, {
      "parityGroupId" : "1-2",
      "numOfLdevs" : 8,
      "usedCapacityRate" : 3,
      "availableVolumeCapacity" : 499,
      "raidLevel" : "RAID1",
      "raidType" : "2D+2D",
      "clprId" : 0,
      "driveType" : "DKR5C-K300SS",
      "driveTypeName" : "SAS",
      "driveSpeed" : 15000,
      "totalCapacity" : 518,
      "physicalCapacity" : 518,
      "availablePhysicalCapacity" : 499,
      "isAcceleratedCompressionEnabled" : false,
      "availableVolumeCapacityInKB" : 523737912
    }, {
      "parityGroupId" : "2-1",
      "numOfLdevs" : 90,
      "usedCapacityRate" : 88,
      "availableVolumeCapacity" : 191,
      "raidLevel" : "RAID6",
      "raidType" : "6D+2P",
      "clprId" : 0,
      "driveType" : "DKR5C-K300SS",
      "driveTypeName" : "SAS",
      "driveSpeed" : 15000,
      "totalCapacity" : 1610,
      "physicalCapacity" : 1610,
      "availablePhysicalCapacity" : 191,
      "isAcceleratedCompressionEnabled" : false,
      "availableVolumeCapacityInKB" : 201149952
    }
  ]
}

属性	型	説明
parityGroupId	string	パリティグループ番号
numOfLdevs	int	パリティグループ内のLDEV数
usedCapacityRate	int	パリティグループの使用率
availableVolumeCapacity	long	使用できる容量（GB） 空き領域の容量が表示されます。 1GB未満の場合は、0が表示されます。
availableVolumeCapacityInKB	long	使用できる容量（KB） 空き領域の容量が表示されます。 情報が取得できない場合、無効な値を示す-1が表示されます。
raidLevel	string	RAIDレベル
raidType	string	RAID種別
clprId	int	CLPR番号
driveType	string	パリティグループを構成するドライブのドライブタイプコード
driveTypeName	string	パリティグループを構成するドライブのドライブタイプ
driveSpeed	int	パリティグループを構成するドライブの回転数（rpm）
totalCapacity	long	パリティグループの論理容量の合計（GB） 容量拡張の設定が有効な場合、拡張容量が表示されます。
physicalCapacity	long	パリティグループの物理容量の合計（GB） この属性の値は、1GB=10243バイトです。 1GB未満の場合は、0が表示されます。 VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
availablePhysicalCapacity	long	パリティグループの物理空き容量の合計（GB） この属性の値は、1GB=10243バイトです。 1GB未満の場合は、0が表示されます。 VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合に表示されます。
isAcceleratedCompressionEnabled	boolean	パリティグループの容量拡張の設定 true：容量拡張が有効 false：容量拡張が無効

容量拡張の詳細情報を取得した場合

パリティグループのドライブタイプがSSD(FMC)のとき、クエリパラメータでdetailInfoTypeにFMCを指定して実行すると、次の情報も取得されます。

属性	型	説明
totalPhysicalCapacity	long	パリティグループを構成するデータドライブの合計容量（GB） この属性の値は、1GB=10003バイトです。 1GB未満の場合は、0が表示されます。 VSP 5000 シリーズ、VSP E シリーズ、VSP G150、G350、G370、G700、G900、VSP F350、F370、F700、F900の場合、無効な値が表示されます。
isExpandedSpaceUsed	boolean	パリティグループ内のLDEVが拡張領域を使用しているかどうか true：LDEVが拡張領域を使用している false：LDEVが物理領域を使用している、またはLDEVが未実装

クエリパラメータでdetailInfoTypeにclassを指定して実行すると、ストレージシステムのキャッシュからの付加情報も取得されます。

属性	型	説明
diskAdapterPairId	int	VSP G1000、VSP G1500、VSP F1500またはVirtual Storage Platformの場合、パリティグループのDKA ペアの番号が出力されます。 VSP 5000 シリーズの場合、パリティグループのDKB ペアの番号が出力されます。
largestAvailableCapacity	long	パリティグループ内の、ボリュームではない領域の最大容量（KB） 連続した空き領域の最大容量が出力されます。
emulationType	string	エミュレーションタイプ
totalOpenVolumeCapacity	long	パリティグループ内のオープンボリュームの合計容量（KB）
unallocatedOpenVolumeCapacity	long	パリティグループ内のオープンボリュームのうち、パスが割り当てられていないボリュームの合計容量（KB）
allocatedOpenVolumeCapacity	long	パリティグループ内のオープンボリュームのうち、パスが割り当てられたボリュームの合計容量（KB）
allocatableOpenVolumeCapacity	long	パリティグループ内のオープンボリュームのうち、パスの割り当てが可能なボリュームの合計容量（KB） 次のすべてに当てはまるボリュームの合計容量が出力されます。 パスが割り当てられていない プールボリュームでない システムディスクでない
reservedOpenVolumeCapacity	long	パリティグループ内のオープンボリュームのうち、予約されたボリュームの合計容量（KB） 次のすべてに当てはまるボリュームの合計容量が出力されます。 パスが割り当てられていない プールボリュームまたはシステムディスクである
totalUsablePhysicalCapacity	long	パリティグループへの書き込みまたは読み取りできる領域の容量（KB） 容量拡張機能をサポートしているパリティグループの場合に出力されます。

クエリパラメータでdetailInfoTypeにphysicalCapacityを指定して実行すると、物理容量も取得されます。

属性	型	説明
physicalCapacity	long	パリティグループの物理容量の合計（GB） この属性の値は、1GB=10243バイトです。 1GB未満の場合は、0が表示されます。
availablePhysicalCapacity	long	パリティグループの物理空き容量の合計（GB） この属性の値は、1GB=10243バイトです。 1GB未満の場合は、0が表示されます。

ステータスコード

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