查询所有API版本getApiVersion
接口说明
查询SFS当前所有可用版本。 为了支持功能不断扩展,SFS API支持版本号区分。 弹性文件 服务有两种形式的版本号: 主版本号:具有独立的url,例如v1和v2 微版本号:通过Http请求头“X-Openstack-Manila-Api-Version:微版本号”来使用,例如:X-Openstack-Manila-Api-Version:2.4 该接口无需鉴权。
约束说明
接口也支持V1版本。
URL
GET https://sfs.cn-south-2.myhuaweicloud.com/
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
versions
|
Array of version objects | 是 |
所有可用的API版本列表对象,包含v1和v2。 |
200 versions
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
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}/"
返回示例
返回码：200
OK
示例 1
{
"versions": [
{
"id": "v1.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "https://sfs.region.www.t-systems.com/v1/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.share+json;version=1"
}
],
"min_version": "",
"status": "SUPPORTED",
"updated": "2015-08-27T11:33:21Z",
"version": ""
},
{
"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.42"
}
]
}
"versions": [
{
"id": "v1.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "https://sfs.region.www.t-systems.com/v1/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.share+json;version=1"
}
],
"min_version": "",
"status": "SUPPORTED",
"updated": "2015-08-27T11:33:21Z",
"version": ""
},
{
"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.42"
}
]
}
错误码
请参考 错误码说明。
