Deleting 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 deletes an LDEV (basic volume) or a virtual volume (a DP volume or a virtual volume for Thin Image).

Execution permission

Storage Administrator (Provisioning)

Request line

DELETE base-URL/v1/objects/ldevs/object-ID

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
None.

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 deleted volume

Status codes

For details on the status codes of the request for this operation, see the description on HTTP status codes.

Coding example

curl -v -H "Accept:application/json" -H "Content-Type:application/json" -H "Authorization:Session d7b673af189048468c5af9bcf3bbbb6f" -X DELETE https://192.0.2.100/ConfigurationManager/v1/objects/ldevs/105

When forcibly deleting the DP volume for which the capacity saving function (dedupe and compression) is enabled

Important: Deleting data on a DP volume for which the capacity saving function (compression or deduplication) is enabled takes time. Be sure to take this into account when planning when to delete such data. In addition, use the status of the target resource rather than the status of the job to check whether the volume has been deleted.

When deleting the DP volume for which the capacity saving function (compression or deduplication) is enabled, in the request body, specify true for the isDataReductionDeleteForceExecute attribute.

The following coding example forcibly deletes the DP volume for which the capacity saving function (compression or deduplication) is enabled:

{
  "isDataReductionDeleteForceExecute": true
}

Attribute

Type

Description

isDataReductionDeleteForceExecute

boolean

(Optional) Specify whether to forcibly delete the DP volume for which the capacity saving function (compression or deduplication) is enabled.

  • true: Forcibly deletes
  • false: Does not forcibly delete

When the attribute is omitted, false is assumed.