Obtaining RAID Group Information

GET /raidgroup/{raidgroup_id}

Introduction

Obtains RAID Group information.

Request Examples

  • This is an example of how to obtain the RAID Group ID and Name for a RAID Group with RAID Group ID 2.

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

Response Examples

{
  "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 to display.

Only the information of the specified Parameter name (Response Body Parameter) is extracted and retrieved.

For details about the specification methods, see Property Filter.
is_response_volume_id_list

boolean

Whether to return the information on the volumes that belong to the RAID Group using the Volume ID List format.

If this parameter is specified as true, the information on the volumes that belong to the RAID Group is not returned using the Volume Href List format, but returned using the Volume ID List format.

If this parameter is specified as false or is omitted, the Volume Href List format is used to return the information.

If a single RAID Group contains 16384 or more volumes, the information on all the volumes cannot be returned using the Volume Href List format.

To obtain the information on all the volumes belonging to a RAID Group that contains a large number of volumes, set this parameter as true.

Responses

If successful, the HTTP status code is 200 (OK) and the response body is returned.

RESPONSE BODY

raidgroup_id

integer

RAID Group ID.
raidgroup_href

string

Resource link of the RAID Group.
number

integer

RAID Group Number.
name

string

RAID Group name.
level

string

RAID Level.
Items Description
RAID0 Striping
RAID1 Mirroring
RAID5 High Capacity
RAID6 High Reliability
RAID10 High Performance
RAID50 Reliability
RAID6FR RAID6 (Fast Recovery)
raid6fr_drive_configuration

string

RAID Group Drive Configuration for RAID 6FR.

Respond only if level is RAID 6 FR.

Indicates D: Data, P: Parity, and HS: Hot Spare.
Items Description
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

Assigned CM of the RAID Group.

For CE#0-CM#0, "00" is displayed and for CE#a-CM#1, "a1" is displayed.
status

string

Status.
Items Description
Normal Normal state.
Maintenance Maintenance state.
Warning Preventive maintenance is required.
Error An error has occurred and maintenance is required.
detail_status

string

Detailed status of the RAID Group.
Items Description
Available Normal state.
Spare_In_Use The RAID group maintains redundancy by using a Hot Spare Drive.
Readying Unformatted state.
Rebuild Rebuild is in progress from the failed Drive to the Hot Spare Drive or the replaced Drive.
Copyback The information saved in the Hot Spare Drive is being written back to the replaced Drive.
Redundant_Copy Redundant Copy state to Hot Spare Drive.
Partially_Exposed_Rebuild Rebuild is in progress from the failed Drive to the Hot Spare Drive or the replaced Drive (Only for RAID 6 or RAID 6 FR).
Exposed_Rebuild Two drives have failed and a rebuild is in progress from the first failed Drive to the Hot Spare Drive or the replaced Drive (Only for RAID 6 or RAID 6 FR).
Exposed Redundancy has been lost due to a Drive failure.
Partially_Exposed One drive has failed (Only for RAID 6 or RAID 6 FR).
No_Drive_Path RAID is blocked state.
SED_Locked The SED authentication key could not be obtained and the RAID is blocked.
Broken Failed state.
is_volume_raidgroup

boolean

Indicates whether a Volume can be created in the RAID Group.

If false, it is used for the following purposes:.

  • It is a RAID Group that belongs to TPP.

  • It is a RAID Group that belongs to FTRP.

  • RAID Group registered as REC Disk Buffer.

  • The RAID Group being used as the Extreme Cache Pool.
allocated_resource_href

string

Link of the Resource to which the RAID Group belongs.

Respond if RAID Group belongs to TPP, FTRP.

Example) /api/v1/tpp/0
capacity

integer

RAID Group Capacity

The unit is MB.
free_capacity

integer

Free Space in RAID Group

The unit is MB.

Respond only if is_volume_raidgroup is true.
maximum_free_area_size

integer

Size of the largest continuous free space

The unit is MB.

Respond only if is_volume_raidgroup is true.
stripe_depth

integer

Stripe Depth.

The unit is MB.

Does not respond if RAID Level is 1.
drive_type

string

Type of the drive that configures the RAID Group.
Items Description
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

Configuration drives of the RAID Group.
dedicated_hotspare_href_list

Array of strings

Link to the Hotspare Drive assigned to the relevant RAID Group.

If there are no Dedicated Hotspare disks, this property is not returned.
volume_href_list

Array of strings

Link of the Volume which belongs to the RAID Group.

This item is returned if is_response_volume_id_list is not true and is_volume_raidgroup is true.

Replies with up to 16384 Volume information.
volume_id_list

Array of integer

Link of the Volume which belongs to the RAID Group.

This item is returned if is_response_volume_id_list is true and is_volume_raidgroup is true.