查询API版本的详细信息getApiVersionDetail
.jpg)
.jpg)
.jpg)
.jpg)
接口说明
查询API版本的详细信息。api_version可以取值v1和v2
URL
GET https://sfs.cn-south-2.myhuaweicloud.com/{api_version}/
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
api_version
|
string | path | 是 |
API版本号。值为v1或v2。 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
version
|
version object | 是 |
200 version
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
id
|
string | 是 |
所使用版本的公用名称。 |
|
links
|
integer | 是 |
共享链接。参见links字段说明。 |
|
media-types
|
string | 是 |
API支持的媒介类型,参见media-types字段说明。 |
|
min_version
|
string | 是 |
如果当前版本的API支持microversions, 此处为支持的microversion的最小版本。如果不支持microversions, 这将会是空字符串 |
|
status
|
string | 是 |
API 版本的状态。其值为: CURRENT:当前API使用的首选版本。 SUPPORTED:表示该版本为老版本,但当前还在继续支持。 DEPRECATED:表示该版本为废弃版本,存在后续删除的可能。 |
|
updated
|
string | 是 |
接口最后修改的UTC时间,格式为YYYY-MM-DDTHH:MM:SSZ |
|
version
|
string | 是 |
如果当前版本的API支持microversions,此处为支持的microversion的最大版本。如果不支持microversions,这将会是空字符串 |
请求示例
示例 1
"GET https://{endpoint}/v2/"
返回示例
返回码：200
OK
示例 1
{
"versions": [
{
"id": "v2.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "https://sfs.region.www.t-systems.com/v2/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.share+json;version=1"
}
],
"min_version": "2.0",
"status": "CURRENT",
"updated": "2015-08-27T11:33:21Z",
"version": "2.28"
}
]
}
"versions": [
{
"id": "v2.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "https://sfs.region.www.t-systems.com/v2/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.share+json;version=1"
}
],
"min_version": "2.0",
"status": "CURRENT",
"updated": "2015-08-27T11:33:21Z",
"version": "2.28"
}
]
}
错误码
请参考 错误码说明。
