Expanding the capacity of a pool

For storage systems with a Dynamic Tiering license, if you include drives that have different drive information (drive type, drive interface, drive rotation speed), the expanded pool will be a tiered pool where the tiers are arranged by performance. 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 specify drives that have different drive information (drive types, drive interfaces, or drive rotation speed).

Execution permission

Storage Administrator (Provisioning)

Request line

POST base-URL/simple/v1/objects/pools/object-ID/actions/expand/invoke

Request message

Object ID

Specify the id value obtained by getting information about the pool.

Attribute	Type	Description
id	int	(Required) Pool ID

Query parameters

None.

Body

The following is an example of adding four data drives that have the drive type code SLB5F-M480SS to a pool with ID 63:

{
  "additionalDrives": [
    {
      "driveTypeCode": "SLB5F-M480SS",
      "dataDriveCount": 4,
      "raidLevel": "RAID5"
    }
  ]
}

Attribute	Type	Description
additionalDrives	object[]	Information of drives to add to 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) 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 added to expand the pool. You can check information about the drives added to a pool by specifying the corresponding pool ID as a query parameter for the API request of getting drive information and then executing the request. If a snapshot is created in an expanded pool, drives that have different drive conditions cannot be specified.

Response message

Body

Attribute	Type	Description
statusResource	string	URL used to obtain the results of the expand the pool capacity 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/63/actions/expand/invoke