List Virtual Storage

Overview

Lists all virtual storages in a tenant

Classification

  • List

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{api_endpoint}/v1.0/{tenant_id}/virtual_storages

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

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.

id

String

Virtual Storage ID (UUID)

name

String

Name of the virtual storage

Sample API Request and Response

Sample API Request

curl -s -i -X GET https://storage-jp1.ecl.api.ntt.com/v1.0/7dea34ac34a14d04b0accbfe793c74af/virtual_storages -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: 5990f1de419e46649728bd3f505e9a17'

Sample API Response

HTTP/1.1 200 OK
Date: Thu, 21 Apr 2016 06:22:25 GMT
Content-Type: application/json
Content-Length: 1231
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce12183b8805eea30bc53088e31153bad782973f4ca8f45246f9f9cd690ab904100; Path=/

{
  "api_error_message": "",
  "virtual_storages":  [
    {
      "id": "aebd693e-457b-4344-9d0c-7a3428831189",
      "name": "vs-storage-nw01-subnet01"
    },
    {
      "id": "98ac7596-0d01-4636-93e3-a1013f42a9c3",
      "name": "nttc-virtual_storage1459160036-79"
    }
  ]
}