文档首页/ 裸金属服务器 BMS/ API参考/ 历史API/ 查询API版本信息（OpenStack Nova API）/ 查询指定API版本信息
更新时间：2024-10-22 GMT+08:00
查看PDF
分享

查询指定API版本信息

功能介绍

返回指定API版本的信息。

URI

GET /{api_version}

参数说明请参见表1。

表1 参数说明

参数

是否必选

描述

api_version

是

API版本号。例如：v2

请求参数

无

请求示例

查询v2版本的API版本信息。 
1
 
GET https://{ECS Endpoint}/v2

响应参数

参数

参数类型

描述

version

Object

描述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
16
17
18
19
20
21
22
23
24
25
26
 
{
    "version": {
        "min_version": "",
        "media-types": [
            {
                "type": "application/vnd.openstack.compute+json;version=2",
                "base": "application/json"
            }
        ],
        "links": [
            {
                "rel": "self",
                "href": "https://ecs.service.domain.com:443/v2/"
            },
            {
                "rel": "describedby",
                "href": "http://docs.openstack.org/",
                "type": "text/html"
            }
        ],
        "id": "v2.0",
        "updated": "1999-02-20T11:33:21Z",
        "version": "",
        "status": "SUPPORTED"
    }
}

返回值

正常返回值：

返回值

说明

200

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

其他返回值请参考状态码。

错误码

请参考错误码。