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¶

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