Creating a pool

Execution permission

If you are using a VSP E series storage system, you can create a pool for which encryption is enabled. For details on the Encryption License Key functionality such as the encryption specifications and system requirements, see the Encryption License Key User Guide.

For storage systems with a Dynamic Tiering license, if you specify drives that have different drive types, drive interfaces, or drive speeds at the same time, tiered pools, where the tiers are arranged by performance, are created. In a tiered pool, data is automatically stored in optimum tiers.

If the storage system does not have a valid Dynamic Tiering license, you cannot simultaneously specify drives that have different drive types, drive interfaces, or drive speeds.

Note:

If the differential data of a snapshot is stored in a pool and the usage rate of the pool exceeds the depletion threshold value, the created snapshot might become unusable. To change the depletion threshold value, change the pool settings after you create the pool.

Storage Administrator (Provisioning)

Request line

POST base-URL/simple/v1/objects/pools

Request message

Object ID: None.

Query parameters: None.

Body

The following is an example of creating an encrypted pool, with the pool name and drive information specified as follows:

Pool name: NASOS
Encryption setting for the pool: true
Drive type code: SNR5A-R960NC
Number of data drives: 4
RAID level: RAID5

{
  "name": "NASOS",
  "isEncryptionEnabled": true,
  "drives": [
    {
      "driveTypeCode": "SNR5A-R960NC",
      "dataDriveCount": 4,
      "raidLevel": "RAID5"
    }
  ]
}

Attribute	Type	Description
name	string	(Required) Specify a pool name consisting of up to 32 characters. You can use alphanumeric characters (`0` through `9`, `A` through `Z`, `a` through `z`), space characters, and the following symbols: Comma (`,`), hyphen (`-`), period (`.`), forward slash (`/`), colon (`:`), at sign (`@`), back slash (`\`), underscore (`_`) This attribute is case-sensitive. You can use a space character between characters, but cannot use it at the beginning or end of the pool name. You cannot use a hyphen (`-`) at the beginning of the pool name.
isEncryptionEnabled	boolean	(Optional) Specify whether to enable or disable pool encryption. `true`: Enable encryption `false`: Disable encryption You can specify this attribute for VSP E series storage systems only. If this attribute is omitted, `false` is assumed.
drives	object[]	Specify the drive information to use for the pool: (Required) `driveTypeCode` (string) Specify a drive type code consisting of 12 characters.^* Example: `DKR5D-J900SS` (Required) `dataDriveCount` (int) Specify the number of data drives as an integer from `1` through `1440`. If `RAID1` or `RAID5` is specified as the RAID level, specify `4` or a greater value for the number of data drives. If `RAID6` is specified as the RAID level, specify `8` or a greater value for the number of data drives. (Required) `raidLevel` (string) RAID level Specify one of the following RAID levels: `RAID1` `RAID5` `RAID6`
* The storage system can contain drives that have the same drive conditions (drive type, drive interface, drive rotation speed, and drive capacity), but different drive type codes. In this case, regardless of the drive type code you specified, drives that match the drive conditions are used to create a pool. You can check information about the drives belonging to the newly created pool by specifying the corresponding pool ID as a query parameter for the API request to getting drive information and then executing the request.

Response message

Body

Attribute	Type	Description
statusResource	string	URL used to obtain the results of the create pool request

Note:

Run the API function for obtaining information about the status of the API function that performs asynchronous processing. For details, see Getting status information about an API function that performs asynchronous processing.

Status codes

See HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session b74777a3f9f04ea8bd8f09847fac48d3" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/simple/v1/objects/pools