接口說明
查詢API版本的詳細信息。api_version可以取值v1和v2
URL
GET https://sfs.cn-south-2.myhuaweicloud.com/{api_version}/
請求參數(shù)
| 名稱 | 類型 | IN | 必選 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用戶Token。 通過調(diào)用 IAM 服務獲取用戶Token接口獲取(響應消息頭中X-Subject-Token的值)。 |
|
api_version
|
string | path | 是 |
API版本號。值為v1或v2。 |
返回參數(shù)
返回碼: 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 版本的狀態(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}/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"
}
]
}
錯誤碼
請參考 錯誤碼說明。
猜你喜歡
