Deleting Volumes

DELETE /volume/{volume_id}

Introduction

Deletes a Volume.

If Snapshot or Clone is specified, the associated Copy Session is also deleted.

Caution

  • The following volume types can be deleted: Standard, WSV, TPV, SDV, and Temporary.

  • The following volumes cannot be deleted:

    • The volume being mapped.

    • Volume during RAID Migration.

    • Volume during TPV/FTRP balancing.

    • Volume during Storage Migration.

    • Volume in use by the Storage Cluster function.

    • A Data Reduction Enabled Volume that belongs to a Thin Provisioning Pool where the Data Container Volume is in an abnormal state.

    • Data Container Volume.

    • FTV.

    • SDPV.

    • ODX Buffer Volume.

  • Snapshots or Clones cannot be deleted through this API if:

    • Volume Type is other than TPV.

    • The Snapshot or the Clone is the copy source of the copy session.

    • The copy range of the Copy Session is "Extent".

    • The Snapshot or the Clone is used for middle generation Snapshots.

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

Request Examples

  • This is an example of deleting a Volume with Volume ID 1023400004.

    $ curl -i -H "Authorization: Bearer g17e4umvwYoHuhkG7yCSee.." -X DELETE "https://192.168.1.1:5665/api/v1/volume/1023400004"

Response Examples

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

Parameters

PATH PARAMETERS

volume_id

(required)

integer

Volume ID.

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.