更新时间:2024-12-02 GMT+08:00

查询版本号列表

功能介绍

查询所有的云解析服务API版本号。

为了兼容第三方系统对接,DNS服务当前版本支持1024位和2048位的DH密钥交换算法,建议您使用2048位的DH密钥交换算法。

URI

GET /

请求

  • 请求参数

  • 请求样例

    查询所有云解析服务API的版本。

    GET https://{DNS_Endpoint}/

响应

  • 要素说明
    表1 响应样例的要素说明

    名称

    参数类型

    说明

    versions

    Object

    版本对象,详细信息请参见表2

    表2 versions字段说明

    名称

    参数类型

    说明

    values

    Array of object

    所有版本列表,详细信息请参见表3

    表3 values字段说明

    名称

    参数类型

    说明

    status

    String

    版本状态,包含:

    • CURRENT:表示该版本为主推版本。
    • SUPPORTED:表示为老版本,但是现在还在继续支持。
    • DEPRECATED:表示为废弃版本,存在后续删除的可能。

    id

    String

    版本号。

    links

    Array of object

    指向当前版本的url。详细信息请参见表4

    表4 links对象参数说明

    名称

    参数类型

    说明

    href

    String

    对应链接。

    rel

    String

    链接标记名称。

  • 响应样例
    {
        "versions": {
            "values": [
                {
                    "status": "CURRENT",
                    "id": "v2",
                    "links": [
                        {
                            "href": "https://Endpoint/v2",
                            "rel": "self"
                        }
                    ]
                }
            ]
        }
    }

返回值

接口正常的返回值为2xx,例如200、202或者204。

返回值含义以及更多返回值请参考状态码