Expanding the capacity of a volume

REST API Reference Guide for Virtual Storage Platform 5000, Virtual Storage Platform E Series, and Virtual Storage Platform G/F Series

Version
93-07-0x
90-09-0x
88-08-10
Audience
anonymous
Part Number
MK-98RD9014-17
The following request expands the capacity of a DP volume.

Execution permission

Storage Administrator (Provisioning)

Request line

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

Request message

Object ID
Specify the ldevId value obtained by getting information about volumes.

Attribute

Type

Description

ldevId

int

(Required) Specify the LDEV number with a decimal (base 10) number.

Query parameters
None.
Body
When specifying in bytes:
{
  "parameters": {
    "additionalByteFormatCapacity": "1G"
  }
}
When specifying in blocks:
{
  "parameters": {
    "additionalBlockCapacity": 2097152
  }
}

Attribute

Type

Description

additionalByteFormatCapacity

string

(Optional) The capacity to be added and its unit.

You must specify either additionalByteFormatCapacity or additionalBlockCapacity.

The specifiable units are as follows:

  • T or t
  • G or g
  • M or m
  • K or k

The following is an example of specifying a capacity of 1 GB:

"additionalByteFormatCapacity":"1G"

additionalBlockCapacity

long

(Optional) The capacity to be added in blocks (1 block = 512 bytes).

You must specify either additionalByteFormatCapacity or additionalBlockCapacity.

The following is an example of specifying a capacity of 1 GB:

"additionalBlockCapacity":2097152

enhancedExpansion

boolean

(Optional) Whether to expand the capacity of the volumes used by the copy pair.

  • true: Expand the volumes.
  • false: Do not expand the volumes used by the copy pair.

If you do not specify a value, false is assumed.

The capacity of volumes can be expanded if the status of the pair is PSUS or SSUS. For information on other prerequisite conditions and the workflow, see the manual of each software product.

Response message

Body

A job object is returned. For details on attributes other than affectedResources, see the section explaining job objects.

Attribute

Description

affectedResources

URL of the expanded volume

Action template

GET base-URL/v1/objects/ldevs/object-ID/actions/expand

Status codes

The following table describes the meanings of the status codes of the request for this operation. For details on other status codes, see the description on HTTP status codes.

Status code

Message

Description

412

Precondition Failed

The specified LDEV is not a DP volume.

Coding example

To get an action template:

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X GET https://192.0.2.100/ConfigurationManager/v1/objects/ldevs/1/actions/expand

To run the request after getting an action template:

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST --data-binary @./InputParameters.json https://192.0.2.100/ConfigurationManager/v1/objects/ldevs/1/actions/expand/invoke