更新时间:2025-12-25 GMT+08:00

查询API指定版本号

功能介绍

查询NAT网关API指定版本号。

URI

GET/{api_version}

表1 参数说明

参数

是否必选

描述

api_version

是

API版本号。

请求消息

无

响应消息

响应参数如表2所示。

表2 响应参数

参数

是否必选

参数类型

描述

version

是

String

描述version 相关对象。

id

是

String

版本ID(版本号),如v1。

links

是

Array

API的URL地址。

href

是

String

当前API版本的引用地址。

rel

是

String

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

version

是

String

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

status

是

String

版本状态,为如下3种:

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

updated

是

String

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

min_version

否

String

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

示例

  • 响应样例
{ 
  "version": { 
      "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": "" 
    } 
}

状态码

请参考状态码。