Querying an API Version List (Compatible with OpenStack)¶
Function¶
This API is used to query the currently supported RDS API version list.
Before calling an API, you need to understand the API in Authentication.
Before calling this API, obtain the required region and endpoint.
URI¶
URI format
PATH: /
Method: GET
Parameter description
None
Request¶
None
Response¶
Normal response
Table 1 Parameter description¶ Name
Type
Description
versions
Array of objects
Indicates the list of detailed API version information.
For details, see Table 2.
Table 2 versions field data structure description¶ Name
Type
Description
id
String
Indicates the API version.
v1: indicates the API v1 version.
v1.0: indicates the OpenStack trove API v1.0.
v3: indicates the API v3 version.
links
Array of objects
Indicates the API link information. The value is empty when the version is v1 or v3.
For details, see Table 3.
status
String
Indicates the version status.
The value CURRENT indicates that the version has been released.
updated
String
Indicates the version update time.
The format is yyyy-mm-dd Thh:mm:ssZ.
T is the separator between the calendar and the hourly notation of time. Z indicates the UTC.
Table 3 links field data structure description (dedicated for OpenStack v1.0)¶ Name
Type
Description
href
String
Indicates the API URL and the value is "".
rel
String
Its value is self, indicating that href is a local link.
Example normal response
{ "versions": [ { "id": "v1", "links": [], "status": "CURRENT", "updated": "2017-02-07T17:34:02Z" }, { "id": "v1.0", "links": [ { "href": "", "rel": "self" } ], "status": "CURRENT", "updated": "2017-03-23T17:34:02Z" } , { "id": "v3", "links": [], "status": "CURRENT", "updated": "2019-01-15T12:00:00Z" } ] }Abnormal Response
For details, see Abnormal Request Results.
Status Code¶
Normal
200
Abnormal
For details, see Status Codes.
Error Code¶
For details, see Error Codes.