Expanding a Thin Provisioning Pool

POST /tpp/{tpp_id}/expand

Introduction

Expands the Thin Provisioning Pool.

Expand the physical capacity of the Thin Provisioning Pool by adding RAID Groups that configure the Thin Provisioning Pool.

The RAID Level, number of drives, and drive type of the RAID Group you are adding must be the same as the existing RAID Group in the Thin Provisioning Pool you are expanding.

Caution

  • You cannot expand the Thin Provisioning Pool in any of the following conditions.

    • The sum of the physical capacities of Thin Provisioning Pools and Flexible Tier Pools exceeds the Maximum Pool Capacity.

    • The device does not have enough resources (RAID Groups, Volumes, etc.) to create a Thin Provisioning Pool.

    • Thin Provisioning Pool has more than 48 PB of physical capacity.

  • Tenant users cannot execute this command.

Request Examples

  • The following shows an example when expanding a Thin Provisioning Pool of Thin Provisioning Pool ID 5.

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/tpp/5/expand"
-d
'{"add_raidgroup_list": [{"drive_id_list": ["0005","0106","0207","0308","0409"]},{"drive_id_list": ["0000","0101","0202","0303","0404"]}]}'

  • This is an example of extending the Thin Provisioning Pool using the Drive Auto-Selection feature.

    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/tpp/5/expand"
-d
'{"is_auto_drive_selection": true,"minimum_capacity_after_expansion" : 614400}'

Response Examples

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

Parameters

PATH PARAMETERS

tpp_id

(required)

integer

Thin Provisioning Pool ID.

REQUEST BODY

is_auto_drive_selection

boolean

Default: false

Whether the system automatically determines which drives comprise the Thin Provisioning Pool.

If true, automatically selects the drives to be added to the Thin Provisioning Pool.

Input criteria:

  • If true, the minimum_capacity_after_expansion must be specified.

    The add_raidgroup_list cannot be specified.

  • If false, add_raidgroup_list must be specified.

    You cannot specify the minimum_capacity_after_expansion.

Caution

For automatic drive selection, a TPP is created without distinguishing between AF compatible and non-AF compatible drives. If both drives are used, select Drives manually.
add_raidgroup_list

Array of objects

Input criteria:

  • You can specify up to 5 values.

drive_id_list

Array of strings

ID of the drive that configures the RAID Group.

Input criteria:

  • The format of the Drive ID 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)

  • You cannot specify a Drive that does not exist.

  • The number of drives and drive type must be the same as the existing RAID Groups that configure the Thin Provisioning Pool being expanded.

    However, Drive types can only be a mix of Online and Nearline.

  • For the ETERNUS DX 8900 S6, the following conditions must be met for Drive location.

    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 more than one Drive in the same DE.
    RAID6, RAID6FR You cannot specify two or more Drives in the same DE.
    RAID6FR You cannot specify two or more Drives in the same DE.

  • If the RAID Level is RAID10 or RAID5, you cannot select a Drive that has a capacity of 6 TB or larger.
assigned_cm

string

Default: "Automatically selected."

ID of the CM assigned to 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.

Input criteria:

  • You cannot specify a CM that does not exist.

  • A CM in an abnormal state cannot be specified.
minimum_capacity_after_expansion

integer

Minimum capacity of Thin Provisioning Pool after expansion.

The unit is MB.

When selecting Drive automatically, determine the Drive configuration that meets the minimum amount of space set in this item.

Required if is_auto_drive_selection is true.

Input criteria:

  • The allowed values are 24 to 50331648.

  • Cannot be set unless is_auto_drive_selection is true.

  • You cannot specify a value less than or equal to the capacity of the Thin Provisioning Pool before expansion.

  • The expansion operation will fail if there are not enough unused drives on the device.

Responses

If successful, the HTTP status code is 202 (Accepted) and the response body is returned.

RESPONSE BODY

job_id

integer

Job ID.
job_href

string

Resource link of the job.