Delete Virtual Storage

Overview

Deletes a virtual storage

Pre/Post Conditions

  • virtual_storage status must be 'available' or 'error_creating'
  • Must delete all volumes on the virtual storage before deleting

Classification

  • Delete

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • DELETE

HTTP Request Path

{api_endpoint}/v1.0/{tenant_id}/virtual_storages/{virtual_storage_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.  

Sample API Request and Response

Sample API Request

curl -s -i -X DELETE https://storage-jp1.ecl.api.ntt.com/v1.0/5846e9724f84439c9b44d7d754a70b96/virtual_storages/bbbf534a-c487-44d8-a9b0-4e949405bb8d -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 8e9990c0191c4015aa7c099fa4049777'

Sample API Response

HTTP/1.1 200 OK
Date: Fri, 27 Jan 2017 05:21:33 GMT
Server: Apache
Transfer-Encoding: chunked
Content-Type: application/json

{
  "api_error_message": ""
}