查询版本号

功能介绍

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

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

URI

GET /{version}

请求

• 请求参数

  无

• 请求样例

  查询版本号为“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。

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