1
0
forked from docs/doc-exports
doc-exports/docs/deh/api-ref/deh_05_0801.html
guoyanyan 91379d457f deh_api_1109
Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: guoyanyan <guoyanyan3@huawei.com>
Co-committed-by: guoyanyan <guoyanyan3@huawei.com>
2022-11-10 18:05:26 +00:00

10 KiB

Querying API Versions

Function

This API is used to query all API versions available to the DeH service.

URI

GET /

Request

  • Request parameters

    None

  • Example request
    GET /

Response

  • Response parameters
    Table 1 Response parameters

    Parameter

    Type

    Description

    versions

    Array of objects

    Specifies the API versions.

    Table 2 versions field description

    Parameter

    Type

    Description

    id

    String

    Specifies the ID of the API version.

    links

    Array of objects

    Specifies the URL of the API version.

    min_version

    String

    Specifies the microversion. If the APIs of this version support micro-versions, set this parameter to the supported minimum micro-version. If the microversion is not supported, leave this parameter blank.

    status

    String

    Specifies the API version status.

    • CURRENT: indicates a primary version.
    • SUPPORTED: indicates an earlier version which is still supported.
    • DEPRECATED: indicates a deprecated version which may be deleted later.

    updated

    String

    Specifies the API version update time, which must be UTC time.

    version

    String

    If the APIs of this version support micro-versions, set this parameter to the maximum micro-version supported. If not, leave this parameter blank.

    Table 3 links field description

    Parameter

    Type

    Description

    href

    String

    Specifies the URL of the API version.

    rel

    String

    Specifies the API URL dependency.

  • Example response
    {
        "versions": [
            {
                "id": "v1.0",
                "links": [
                    {
                        "href": "https//deh.xxx.com/v1.0/",
                        "rel": "self"
                    }
                ],
                "min_version": "",
                "status": "SUPPORTED",
                "updated": "2016-12-01T11:33:21Z",
                "version": ""
            }
        ]
    }

Status Code

See Status Codes.