Creating a pool

Storage Advisor Embedded User Guide

Part Number

The following request creates a pool by using the specified pool name and drive information.

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.


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
Query parameters

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"






(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.



(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.



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







URL used to obtain the results of the create pool request


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