文档中心 API中心查询API版本信息

查询API版本信息列表

功能介绍

返回当前所有可用的版本。

为了支持功能不断扩展， API支持版本号区分。

URI

GET /

请求消息

无

响应消息

响应参数

参数	参数类型	描述
versions	Object	API版本信息列表，详情请参见表1。

表1 versions字段数据结构说明

参数	参数类型	描述
id	string	所讨论的版本的通用名称，仅仅是信息性的，它没有真正的语义。
links	Object	版本相关标记快捷链接信息，详情请参见表2。
min_version	string	如果API的这个版本支持微版本，则支持最小的微版本。如果不支持微版本，这将是空字符串。
status	string	API版本的状态。CURRENT，这是使用的API的首选版本SUPPORTED，这是一个较老的，但仍然支持的API版本。DEPRECATED，一个被废弃的API版本，该版本将被删除。
version	string	如果API的这个版本支持微版本，则支持最大的微版本。如果不支持微版本，这将是空字符串。
updated	string	一个有特定值的字符串。API版本为2.0时，值为2011-01-21T11:33:21Z，API版本是2.1时，值为 2013-07-23T11:33:21Z。

表2 links字段数据结构说明

参数	参数类型	描述
href	string	相应资源的链接。
rel	string	self：自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。alternate：备用链接可以包含资源的替换表示形式。例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。

请求示例

1	GET https://{endpoint}/

响应示例

{
    "versions": [
        {
            "id": "v2.0",
            "links": [
                {
                    "href": "https://home.jcloud.sjtu.edu.cn:8774/v2/",
                    "rel": "self"
                }
            ],
            "min_version": "",
            "status": "SUPPORTED",
            "updated": "2011-01-21T11:33:21Z",
            "version": ""
        },
        {
            "id": "v2.1",
            "links": [
                {
                    "href": "https://home.jcloud.sjtu.edu.cn:8774/v2.1/",
                    "rel": "self"
                }
            ],
            "min_version": "2.1",
            "status": "CURRENT",
            "updated": "2013-07-23T11:33:21Z",
            "version": "2.53"
        }
    ]
}