Expanding the Volume Capacity

POST /volume/{volume_id}/expand

Introduction

Expands the capacity of the specified Volume.

Caution

  • A Volume cannot be expanded if it meets the following conditions:

    • Volume Type is not TPV.

    • An Advanced Copy session with "Totally" as the copy range is set.

    • Balancing is in progress.

    • RAID migration is in progress.

    • Storage Migration is running.

    • The Volume is in use by the Storage Cluster function.

    • For Data Container Volume extensions, the Volume Status is abnormal.

    • If Data Reduction is enabled, the Status of the Data Container Volume in the Thin Provisioning Pool to which the Volume belongs is abnormal.

  • For tenant users, only Volumes that belong to the tenant of the current user can be expanded.

Request Examples

  • This is an example of expanding the capacity of Volume ID 234100025 to 2 TB. 
    $ curl -i -H "Content-Type:application/json" -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X POST "https://192.168.1.1:5665/api/v1/volume/234100025/expand"
-d
'{"new_capacity":2097152}'

Response Examples

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

Parameters

PATH PARAMETERS

volume_id

(required)

integer

Volume ID.

REQUEST BODY

new_capacity

(required)

integer

Volume capacity after expansion.

The unit is MB.

Input criteria:

  • The allowed values are 25 to 51539607552.

  • You cannot specify a value less than or equal to the Capacity of the volume before expansion.

  • A volume whose Usage is "ODX" has a maximum capacity of 1 TB.

  • The maximum capacity of a Data Container Volume is 48PB.

  • Other TPVs have a maximum capacity of 128 TB.

  • The total TPV (except when Data Reduction is enabled) and FTV capacity of a device cannot exceed the Maximum Pool Capacity of the device.

  • The total capacity of Volumes with Data Reduction enabled that can be created in a Thin Provisioning Pool with Deduplication and/or Compression enabled cannot exceed 10 times the capacity of the Data Container Volume.

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.