功能介绍
返回指定版本的信息。
为了支持功能不断扩展,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。
调试
您可以在API Explorer中调试该接口。
请求消息
无
响应消息
响应参数如表2所示。
参数 |
参数类型 |
描述 |
---|---|---|
id |
string |
所讨论的版本的通用名称。仅仅是信息性的,它没有真正的语义。 |
links |
Object |
链接到资源的问题。有关更多信息,请参见OpenStack Documentation。 |
media-types |
Object |
|
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
响应示例
{
"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"
}
}
返回值
请参考通用请求返回值。