接口說明
查詢SFS當前所有可用版本。 為了支持功能不斷擴展,SFS API支持版本號區(qū)分。 彈性文件 服務有兩種形式的版本號: 主版本號:具有獨立的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/
返回參數(shù)
返回碼: 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 版本的狀態(tài)。其值為: CURRENT:當前API使用的首選版本。 SUPPORTED:表示該版本為老版本,但當前還在繼續(xù)支持。 DEPRECATED:表示該版本為廢棄版本,存在后續(xù)刪除的可能。 |
|
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"
}
]
}
錯誤碼
請參考 錯誤碼說明。
猜你喜歡
