/ / / / / 查询api指定版本号
更新时间:2024-05-21 gmt 08:00

查询api指定版本号-九游平台

功能介绍

查询云审计服务指定api版本号。

uri

get /{version}

表1 路径参数

参数

是否必选

参数类型

描述

version

string

版本号

请求参数

响应参数

状态码: 200

表2 响应body参数

参数

参数类型

描述

version

object

描述version相关对象的列表。

表3 version

参数

参数类型

描述

id

string

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

links

array of linksbody objects

api的url地址。

version

string

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

status

string

版本状态,为如下3种: current:表示该版本为主推版本。 supported:表示为老版本,但是现在还继续支持。 deprecated:表示为废弃版本,存在后续删除的可能。

枚举值:

  • current
  • supported
  • deprecated

updated

string

版本发布时间,要求用utc时间表示。如v1发布的时间2014-06-28t12:20:21z。

min_version

string

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

表4 linksbody

参数

参数类型

描述

href

string

当前api版本的引用地址。

rel

string

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

请求示例

响应示例

状态码: 200

请求正常。

{
    "version": {
        "min_version": "",
        "links": [{
                "rel": "self",
                "href": "https://x.x.x.x/v3/"
            }
        ],
        "id": "v3",
        "updated": "2020-06-30t00:00:00z",
        "version": "",
        "status": "current"
    }
}

状态码

状态码

描述

200

请求正常。

404

服务器无法找到被请求的资源。

500

请求未完成,服务异常。

错误码

请参见错误码

相关文档

网站地图