Updated on 2022-12-12 GMT+08:00

Querying the API Version List

API Description

This API is used to query the currently supported API version list.

URI

  • URI format

    GET https://{Endpoint}/

  • URI example

    https://dds.ap-southeast-1.myhuaweicloud.com/

Requests

None

Responses

  • Parameter description
    Table 1 Parameter description

    Name

    Type

    Mandatory

    Description

    versions

    Array of objects

    No

    Indicates the list of detailed API version information. For more information, see Table 2.

    Table 2 versions field data structure description

    Name

    Type

    Mandatory

    Description

    id

    String

    Yes

    Indicates the API version.

    links

    Array of objects

    Yes

    Indicates the API link information. For more information, see Table 3.

    NOTE:

    If the version is v3, the value is [].

    status

    String

    Yes

    Version status

    The value CURRENT indicates that the version has been released.

    version

    String

    Yes

    Indicates the subversion of the API version.

    min_version

    String

    Yes

    Indicates the minimum API version.

    updated

    String

    Yes

    Indicates the version update time.

    The format is yyyy-mm-ddThh: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

    Name

    Type

    Mandatory

    Description

    href

    String

    No

    Indicates the API URL and the value is "".

    rel

    String

    No

    Its value is self, indicating that URL is a local link.

  • Response example
    {
        "versions": [
            {
                "id": "v3",
                "links": [],
                "status": "CURRENT",
                "version": "",
                "min_version": "",
                "updated": "2017-02-07T17:34:02Z"
            }
        ]
    }

Status Code

For more information, see Status Code.

Error Code

For more information, see Error Code.