RAID Group情報の取得

GET /raidgroup/{raidgroup_id}

概要説明

RAID Group情報の取得。

リクエスト例

  • RAID Group ID 2のRAID Groupについて、RAID Group IDとNameを取得する場合の例です。

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X GET "https://192.168.1.1:5665/api/v1/raidgroup/2?fields=name"

レスポンス例

{
  "raidgroup_id": 101,
  "raidgroup_href": "/api/v1/raidgroup/101",
  "number": 101,
  "name": "RAIDGROUP#101",
  "level": "RAID10",
  "raid6fr_drive_configuration": "3Dx2_2Px2_1HS",
  "assigned_cm": "00",
  "status": "Normal",
  "detail_status": "Available",
  "is_volume_raidgroup": true,
  "allocated_resource_href": "string",
  "capacity": 131072,
  "free_capacity": 131072,
  "maximum_free_area_size": 131072,
  "stripe_depth": 64,
  "drive_type": "Online",
  "drive_href_list": [
    "/api/v1/drive/0000",
    "/api/v1/drive/0001",
    "/api/v1/drive/0100",
    "/api/v1/drive/0101"
  ],
  "dedicated_hotspare_href_list": [
    "/api/v1/drive/000b",
    "/api/v1/drive/010b"
  ],
  "volume_href_list": [
    "/api/v1/volume/1300001",
    "/api/v1/volume/2100002"
  ]
  "volume_id_list": [
    100000,
    200000,
    300000
  ]
}

Parameters

PATH PARAMETERS

raidgroup_id

(required)

integer

RAID Group ID。

QUERY PARAMETERS

fields

Array of strings

表示したいParameter。

指定したParameter名(Response Body Parameter)の情報のみを抜き出して取得します。

指定方法の詳細は、表示する項目の絞り込みを参照してください。
is_response_volume_id_list

boolean

RAID Groupに属するVolume情報をVolume ID List型式で応答するかどうか。

trueを指定した場合、RAID Groupに属するVolume情報を、Volume Href ListではなくVolume ID List型式で応答します。

falseを指定した場合または指定を省略した場合、Volume Href List型式で応答します。

1つのRAID GroupにVolumeが16384以上存在する場合、Volume Href List型式ではすべてのVolume情報を応答することができません。

大量にVolumeが存在するRAID Groupに属するVolume情報をすべて取得したい場合は、本Parameterでtrueを指定してください。

Responses

正常に取得できた場合、HTTPステータスコードが200 (OK)となりレスポンスボディを応答します。

RESPONSE BODY

raidgroup_id

integer

RAID Group ID。
raidgroup_href

string

RAID GroupのResourceへのLink。
number

integer

RAID Group Number。
name

string

RAID Group名。
level

string

RAID Level。
項目 説明
RAID0 Striping
RAID1 Mirroring
RAID5 High Capacity
RAID6 High Reliability
RAID10 High Performance
RAID50 Reliability
RAID6FR RAID6 (Fast Recovery)
raid6fr_drive_configuration

string

RAID6FRのRAID GroupのDrive構成。

levelがRAID6FRの場合に限り応答します。

D：Data、P：Parity、HS：Hot Spare を示します。
項目 説明
3Dx2_2Px2_1HS (3D + 2P)x2 + 1HS
4Dx2_2Px2_1HS (4D + 2P)x2 + 1HS
6Dx2_2Px2_1HS (6D + 2P)x2 + 1HS
9Dx2_2Px2_1HS (9D + 2P)x2 + 1HS
12Dx2_2Px2_1HS (12D + 2P)x2 + 1HS
5Dx4_2Px4_1HS (5D + 2P)x4 + 1HS
13Dx2_2Px2_1HS (13D + 2P)x2 + 1HS
8Dx3_2Px3_1HS (8D + 2P)x3 + 1HS
4Dx5_2Px5_1HS (4D + 2P)x5 + 1HS
3Dx6_2Px6_1HS (3D + 2P)x6 + 1HS
assigned_cm

string

RAID Groupの担当CM。

CE#0-CM#0の場合は'00'、CE#a-CM#1の場合は'a1'となります。
status

string

ステータス。
項目 説明
Normal 正常状態です。
Maintenance 保守状態です。
Warning 予防保守が必要な状態です。
Error 異常が発生し、保守が必要な状態です。
detail_status

string

RAID Groupの詳細ステータス。
項目 説明
Available 正常状態です。
Spare_In_Use Hot Spare Driveを使用して冗長性を確保している状態です。
Readying 未Format状態です。
Rebuild 故障したDriveから、Hot Spare Driveまたは交換したDriveへのRebuild処理中の状態です。
Copyback Hot Spare Driveに退避した情報を交換したDriveへ書き戻し中の状態です。
Redundant_Copy Hot Spare DriveへRedundant Copy中の状態です。
Partially_Exposed_Rebuild 1台目の故障したDriveからHot Spare Driveまたは交換したDriveへのRebuild処理中の状態です (Only for RAID6 or RAID6FR)。
Exposed_Rebuild 2台のDriveに故障が発生中で、1台目の故障したDriveからHost Spare Driveまたは交換したDriveへのRebuild処理中の状態です (Only for RAID6 or RAID6FR)。
Exposed Drive故障により冗長性を失った状態です。
Partially_Exposed Driveが1台故障中の状態です (Only for RAID6 or RAID6FR)。
No_Drive_Path RAID閉塞状態です。
SED_Locked SED認証鍵が取得できず、RAID閉塞状態です。
Broken 故障状態です。
is_volume_raidgroup

boolean

Volumeが作成可能なRAID Groupかどうか。

falseの場合、以下の用途で使用されています。

  • TPPに属しているRAID Groupです。

  • FTRP に属しているRAID Groupです。

  • REC Disk Bufferとして登録されているRAID Groupです。

  • Extreme Cache Poolとして使用しているRAID Groupです。
allocated_resource_href

string

RAID Groupが属するResourceのLink。

RAID GroupがTPP、FTRPの構成要素になっている場合に応答します。

例） /api/v1/tpp/0
capacity

integer

RAID Groupの容量。

単位はMBです。
free_capacity

integer

RAID Group空き容量。

単位はMBです。

is_volume_raidgroupがtrueの場合に限り応答します。
maximum_free_area_size

integer

最大連続空き領域のサイズ。

単位はMBです。

is_volume_raidgroupがtrueの場合に限り応答します。
stripe_depth

integer

Stripe Depth。

単位はKBです。

RAID Levelが1の場合は応答しません。
drive_type

string

RAID Groupを構成するDriveの種別。
項目 説明
Online Online HDD
Nearline Nearline HDD
SSD SAS SSD
NVMe_SSD NVMe SSD
Online_SED Online HDD SED
Nearline_SED Nearline HDD SED
SSD_SED SAS SSD SED
NVMe_SSD_SED NVMe SSD SED
drive_href_list

Array of strings

RAID Groupの構成Drive。
dedicated_hotspare_href_list

Array of strings

該当RAID Groupに紐づいたHotspare DriveのLink。

Dedicated Hotspareが存在しない場合は、このプロパティは応答されません。
volume_href_list

Array of strings

RAID Groupに属するVolumeのLink。

is_response_volume_id_listがtrue以外、かつis_volume_raidgroupがtrueの場合に限り応答します。

16384までのVolume情報を応答します。
volume_id_list

Array of integer

RAID Groupに属するVolumeのLink。

is_response_volume_id_listがtrue、かつis_volume_raidgroupがtrueの場合に限り応答します。