Querying API Versions

Function

This API is used to query the currently supported RDS API versions.

URI

  • URI format

    GET https://{Endpoint}/rds/

  • Parameter description

    None

Request

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.

    CURRENT: indicates that the version is recommended.

    DEPRECATED: indicates a deprecated version which may be deleted later.

    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 Coordinated Universal Time (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

    The values are as follows, depending on the version:

    • V3

    • V1

    • V1.0

  • Example normal response

    {
        "versions": [{
            "id": "v1",
            "links": [],
            "status": "CURRENT",
            "updated": "2017-02-07T17:34:02Z"
        }, {
            "id": "v1.0",
            "links": [{
                "href": "",
                "rel": "v1.0"
            }],
            "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

Error Code

For details, see Error Codes.