Delete Volume

Overview

Deletes a volume

Pre/Post Conditions

  • volume must be ‘available’ or ‘error_creating’
  • Must delete all snapshots on the volume before deleting

Classification

  • Delete

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • DELETE

HTTP Request Path

{api_endpoint}/v1.0/{tenant_id}/volumes/{volume_id}

HTTP Request Header

Format

X-Auth-Token: <token>

HTTP Request Body

  • none

Response

HTTP Response Header

Response Code

Response Codes
Code Description Error? Note
200 OK No Returned in case of success
400 Bad Request Yes  
401 Unauthorized Yes  
409 Tenant is busy Yes Returned if one of creation/update/deletion/restore request is already on-going
500 Internal Server Error Yes  

HTTP Response Body

Response Parameter

Response Parameters
Parameter Type Description Note
api_error_message String Error message in API error case.This property may not appear if there is no error.  

Sample API Request and Response

Sample API Request

curl -s -i -X DELETE https://storage-jp1.ecl.api.ntt.com/v1.0/5846e9724f84439c9b44d7d754a70b96/volumes/f08c88b2-a79c-4a1f-9bd7-2bdaf75c4bed -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 80e8ad9d867241ac87ea68cc370bd763'

Sample API Response

HTTP/1.1 200 OK
Date: Fri, 27 Jan 2017 06:54:35 GMT
Server: Apache
Transfer-Encoding: chunked
Content-Type: application/json