Reclaiming zero pages of a DP 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 reclaims zero pages of a DP volume to release the pages. By releasing pages, you can increase the free capacity of a pool.

Execution permission

Storage Administrator (Provisioning)

Request line

POST base-URL/v1/objects/ldevs/object-ID/actions/discard-zero-page/invoke

Request message

Object ID
Specify the value of ldevId that was obtained by the processing to get information about volumes.

Attribute

Type

Description

ldevId

int

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

Query parameters
None.
Body
None.

Response message

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

Attribute

Description

affectedResources

URL of the volume for which zero pages were reclaimed

Action template

None.

Status codes

The following table explains the meanings of the status codes for this API. For details on other status codes, see the section explaining HTTP status codes.

Status code

Message

Description

412

Precondition Failed

The specified action cannot run because the volume meets one of the following conditions:

  • The volume is not a DP volume.
  • The volume is in the blocked status.
  • The volume is used as a pair volume of one of the following copy types:

    • ShadowImage
    • TrueCopy
    • Universal Replicator
    • Copy-on-Write Snapshot
  • The volume is used as a journal volume of Universal Replicator.
  • The volume is used as a Volume Migration volume.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X POST https://192.0.2.100/ConfigurationManager/v1/objects/ldevs/1/actions/discard-zero-page/invoke -d ""