更新时间:2022-08-15 GMT+08:00

查询版本号

功能介绍

查询指定的云解析服务API版本号。

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

URI

GET /{version}

参数说明请参见表1
表1 URI格式的参数说明

名称

是否必选

参数类型

说明

version

String

待查询版本号。以v开头,如v2。

请求

  • 请求参数

  • 请求样例

    查询版本号为“v2”的版本。

    GET https://{DNS_Endpoint}/v2

响应

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

    名称

    参数类型

    说明

    version

    Object

    描述version对象,详细信息请参见表3

    表3 version字段说明

    名称

    参数类型

    说明

    status

    String

    版本状态,包含:

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

    id

    String

    版本号,如v2。

    updated

    String

    版本发布时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    version

    String

    支持的最大微版本号。若该版本API不支持微版本,则为空。

    min_version

    String

    支持的最小微版本号。若该版本API不支持微版本,则为空。

    links

    Array of object

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

    表4 links对象参数说明

    名称

    参数类型

    说明

    href

    String

    对应链接。

    rel

    String

    链接标记名称。

  • 响应样例
    {
            "version": 
                {
                    "status": "CURRENT",
                    "id": "v2",
                    "links": [
                        {
                            "href": "https://Endpoint/v2/",
                            "rel": "self"
                        }
                    ],
                "min_version": "",
                "updated": "2018-09-18T00:00:00Z",
                "version": ""
                }
    }

返回值

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

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