List API versions

Overview

Lists available versions of Block/File Storage APIs.

Classification

  • List

API Operation Object

  • Version

Synchronous / Asynchronous

  • Synchronous

Request

HTTP Request Method

  • GET

HTTP Request Path

{api_endpoint}

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 if there is only a version listed
300 Multiple Choices No Returned if there are multiple versions listed
400 Bad Request Yes  
401 Unauthorized Yes  
500 Internal Server Error Yes  

HTTP Response Body

Response Parameter

Response Parameters
Key Value
api_error_message Error Message
versions List of version objects
status CURRENT or SUPPORTED
updated Timestamp of update for the API version
id Version ID (e.g. v1.0)

Sample API Request and Response

Sample API Request

curl -s -i -X GET https://storage-jp1.ecl.api.ntt.com -H 'Content-type: application/json' -H 'Accept: application/json' -H 'X-Auth-Token: bd0343af86a74e5cb9867a69729675ba'

Sample API Response

HTTP/1.1 200 OK
Date: Thu, 21 Apr 2016 04:59:13 GMT
Content-Type: application/json
Content-Length: 104
Connection: keep-alive
Set-Cookie: TS0183560f=01cce65ce128601861395335dd182427413def44343cffdb05cf2bc235112eece0b3dbb0a0; Path=/

{
 "api_error_message": "",
 "versions" : [
{
  "status": "CURRENT",
  "updated": "2016-01-16T10:42:23+0000",
  "id": "v1.0"
}
]
}
2.1. API Versions
Show API version