Creating RAID Group

POST /raidgroup

Introduction

Creates a RAID Group.

Caution

  • You can find the Href of the created RAID Group in resource_href_list of "GET /job/{job_id}".

  • Tenant users cannot execute this command.

Request Examples

  • This is an example of creating a RAID Group for a RAID Level 1 RAID Group named RAIDG with drives in Slot#0 and Slot #1 of DE#00.

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/raidgroup"
-d
'{"name": "RAIDG","drive_id_list": ["0000","0001"],"level": "RAID1"}'

  • This is an example of creating a RAID Group for a RAID Level 6FR named RAIDG.

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/raidgroup"
-d
'{"name": "RAIDG","drive_id_list": ["0000","0001","0100","0101","0200","0201","0300","0301","0400","0401","0500"],"level": "RAID6FR","raid6fr_drive_configuration": "3Dx2_2Px2_1HS"}'

Response Examples

{
  "job_id": 8192001,
  "job_href": "/api/v1/job/8192001"
}

Parameters

REQUEST BODY

name

(required)

string

RAID Group name.

Input criteria:

  • The available number of characters allowed is 1 to 16.

  • Acceptable characters are single byte alphanumeric characters. However, "," and "?" are excluded.

  • You cannot use a RAID Group name that already exists.
drive_id_list

(required)

Array of strings

Drives that configure the RAID Group.

Specify drive_id for all the drives that configure the RAID Group.

Format is as follows:

  • Drive in CE w0yy

    • w - Hexadecimal CE ID (0 to b)

    • yy - Hexadecimal Slot ID (00 to 17)

  • Drive in DE xxyy

    • xx - Hexadecimal DE ID (00 to ff)

    • yy - Hexadecimal Slot ID (00 to 17)

Input criteria:

  • You cannot specify a Drive that is in use.

  • When RAID Level is RAID 10, RAID 5, or RAID 50, you cannot specify a Drive larger than 6 TB.

    However, even if the Drive is 6TB or more, it can be specified if the Drive type is SAS SSD, SAS SSD SED, NVMe SSD, and NVMe SSD SED.

  • You cannot use SAS HDDs, SAS SSDs, NVMe SSDs, SAS HDD SEDs, SAS SSD SEDs, and NVMe SSD SEDs in the same RAID Group.

  • For the ETERNUS DX8900 S6, some restrictions are applied for Drives that configure a RAID Group depending on the RAID Level.

    RAID Level Restriction
    RAID1

    You cannot specify more than half of the drives in a RAID Group within the same DE.
    RAID10

    You cannot specify more than half of the drives in a RAID Group within the same DE.
    RAID5 You cannot specify two or more Drives in the same DE.
    RAID50 You cannot specify three or more Drives in the same DE.
    RAID6, RAID6FR You cannot specify three or more Drives in the same DE.
level

(required)

string

RAID Level.
Item 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.

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

Input criteria:

  • Required if level is a RAID 6FR.

  • Not available if level is not a RAID 6FR.
assigned_cm

string

Default: "Automatically selected."

Assigned CM of the RAID Group.

Specifies the CM assigned to the RAID Group.

It is usually determined automatically to distribute the load per CM, so no specification is required.

Specify this value if you want a specific CM to be the assigned CM.

To use CE#0-CM#0, specify "00"; or to use CE#a-CM#1, specify "a1".

If there is only one CE, it is assumed to be CE#0.

Responses

If the job registration is successful, the HTTP status code will be 202 (Accepted) and the response body will respond.

RESPONSE BODY

job_id

integer

Job ID.
job_href

string

Resource link of the job.