更新时间：2025-11-11 GMT+08:00
查询API接口的版本信息 - ShowVersion
功能介绍
查询接口的指定版本信息。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /{version}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
version |
是 |
String |
查询的目标版本号。 取值为：v1、v2、v3。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
versions |
Array of Versions objects |
版本信息。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
接口版本的ID。 |
|
links |
Array of Link objects |
接口版本信息的URI描述信息。 |
|
media-types |
Array of MediaTypes objects |
接口版本的请求消息类型信息。 |
|
min_version |
String |
接口版本的最小版本号。 |
|
status |
String |
接口版本的状态。 |
|
updated |
String |
接口版本更新时间。 |
|
version |
String |
接口版本的版本号信息。 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error |
Error object |
参数解释 出现错误时，返回的错误信息。 取值范围 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
code |
String |
参数解释 出现错误时，返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
|
message |
String |
参数解释 出现错误时，返回的错误消息。 取值范围 不涉及。 |
请求示例
GET https://{endpoint}/{version}
https://{endpoint}/{version}
响应示例
状态码：200
版本号详情列表。
{
"versions" : [ {
"min_version" : "",
"media-types" : [ {
"type" : "application/vnd.openstack.volume+json;version=1",
"base" : "application/json"
}, {
"type" : "application/vnd.openstack.volume+xml;version=1",
"base" : "application/xml"
} ],
"links" : [ {
"rel" : "describedby",
"href" : "http://docs.openstack.org/",
"type" : "text/html"
}, {
"rel" : "self",
"href" : "https://evs.localdomain.com/v2"
} ],
"id" : "v2.0",
"updated" : "2014-06-28T12:20:21Z",
"version" : "",
"status" : "SUPPORTED"
} ]
}
状态码：400
Bad Request
{
"error" : {
"code" : "string",
"message" : "string"
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
版本号详情列表。 |
|
400 |
Bad Request |
错误码
请参见错误码。
