文档首页/ NAT网关 NAT/ API参考/ 历史API/ API v2.0/ API版本号管理/ 查询API所有版本号
更新时间：2025-12-25 GMT+08:00
查看PDF
分享

查询API所有版本号

功能介绍

查询NAT网关支持的API所有版本号。

接口格式

GET/

请求消息

无

响应消息

响应参数如表1所示。

表1 响应参数

参数

是否必选

参数类型

描述

versions

是

Array

描述version 相关对象的列表。

id

是

String

版本ID（版本号），如v1。

links

是

Array

API的URL地址。

href

是

String

当前API版本的引用地址。

rel

是

String

当前API版本和被引用地址的关系。

version

是

String

若该版本API支持微版本，则填支持的最大微版本号，如果不支持微版本，则填空。

status

是

String

版本状态。

取值为如下三种：

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

updated

是

String

版本发布时间。

要求用UTC时间表示。如v1发布的时间2014-06-28T12:20:21Z。

min_version

否

String

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

示例

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

状态码

请参考状态码。

父主题： API版本号管理