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"
}
]
}