更新时间:2024-10-22 GMT+08:00
分享

查询API版本信息列表

功能介绍

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

URI

GET /

请求参数

请求示例

查询当前可用版本。
1
GET https://{ECS Endpoint}/

响应参数

参数

参数类型

描述

versions

Array of objects

描述version对象的列表。

id

String

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

links

Array of objects

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支持微版本,则为支持的最小微版本号;如果不支持微版本,则为空。

响应示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
{
    "versions": [
        {
            "links": [
                {
                    "rel": "self",
                    "href": "https://192.168.82.231:443/v2/"
                }
            ],
            "id": "v2.0",
            "updated": "2018-09-21T12:33:21Z",
            "status": "SUPPORTED"
        }
    ]
}

返回值

正常返回值:

返回值

说明

200

服务器已成功处理了请求。

其他返回值请参考状态码

错误码

请参考错误码

相关文档