更新时间:2024-01-17 GMT+08:00
查询指定API版本信息
功能介绍
返回指定版本的信息。
为了支持功能不断扩展,Nova API支持版本号区分。Nova中有两种形式的版本号:
- "主版本号": 具有独立的url。
- "微版本号": 通过Http请求头X-OpenStack-Nova-API-Version来使用,从 2.27 版本开始支持新的微版本头:OpenStack-API-Version。
如果使用OpenStack-API-Version的请求头,version对应的value取值格式为 compute 微版本号。
例如:key为OpenStack-API-Version的时候value需要填compute 2.27。
请求消息
无
响应消息
响应参数如表2所示。
参数 |
参数类型 |
描述 |
---|---|---|
versions |
Object |
指定版本信息,详情请参见表3。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
string |
所讨论的版本的通用名称。仅仅是信息性的,它没有真正的语义。 |
links |
Object |
链接到资源的问题。有关更多信息,请参见OpenStack Documentation。 详情请参见表4。 |
media-types |
Object |
媒体类型。详情请参见表5。 |
min_version |
string |
|
status |
string |
API版本的状态:
|
updated |
string |
一个有特定值的字符串。API版本为2.0时,值为2011-01-21T11:33:21Z ,API版本是2.1时,值为2013-07-23T11:33:21Z。 |
version |
string |
|
请求示例
查询指定API的版本信息。
GET https://{endpoint}/v2.1
响应示例
{ "version":{ "min_version":"2.1", "media-types":[ { "type":"application/vnd.openstack.compute+json;version=2.1", "base":"application/json" } ], "links":[ { "rel":"self", "href":"https://{endpoint}/v2.1/" }, { "rel":"describedby", "href":"http://docs.openstack.org/", "type":"text/html" } ], "id":"v2.1", "updated":"2013-07-23T11:33:21Z", "version":"2.60", "status":"CURRENT" } }
返回值
请参考通用请求返回值。
父主题: 查询API版本信息