功能介紹
查詢 存儲容災(zāi) 當(dāng)前所有可用的版本信息列表。
接口約束
無
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
GET /
請求參數(shù)
無
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
versions |
API版本信息列表。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
id |
String |
版本ID（版本號），如v1。 |
|
links |
版本號查詢鏈接 |
|
|
version |
String |
若該版本API支持微版本，則返回支持的最大微版本號，如果不支持微版本，則返回空。 |
|
status |
String |
版本狀態(tài)，為如下3種： CURRENT：表示該版本為主推版本 SUPPORTED：表示為老版本，但是現(xiàn)在還繼續(xù)支持 DEPRECATED：表示為廢棄版本，存在后續(xù)刪除的可能 枚舉值：
|
|
updated |
String |
版本發(fā)布時間，采用UTC時間表示。如v1發(fā)布的時間2018-05-30T15:00:00Z。 |
|
min_version |
String |
若該版本API 支持微版本，則返回支持的最小微版本號，如果不支持微版本，則返回空。 |
狀態(tài)碼： 400
狀態(tài)碼： 403
狀態(tài)碼： 404
狀態(tài)碼： 405
狀態(tài)碼： 406
狀態(tài)碼： 407
狀態(tài)碼： 408
狀態(tài)碼： 409
狀態(tài)碼： 500
狀態(tài)碼： 501
狀態(tài)碼： 502
狀態(tài)碼： 503
狀態(tài)碼： 504
請求示例
GET https://{endpoint}/
響應(yīng)示例
狀態(tài)碼： 200
OK
{
"versions" : [ {
"id" : "v1",
"links" : [ {
"href" : "https://sdrs.localdomain.com/v1",
"rel" : "self"
} ],
"status" : "CURRENT",
"updated" : "2018-05-30T15:00:00Z",
"version" : "",
"min_version" : ""
} ]
}
狀態(tài)碼
|
狀態(tài)碼 |
描述 |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
403 |
Forbidden |
|
404 |
Not Found |
|
405 |
Method Not Allowed |
|
406 |
Not Acceptable |
|
407 |
Proxy Authentication Required |
|
408 |
Request Timeout |
|
409 |
Conflict |
|
500 |
Internal Server Error |
|
501 |
Not Implemented |
|
502 |
Bad Gateway |
|
503 |
Service Unavailable |
|
504 |
Gateway Timeout |
錯誤碼
請參見錯誤碼。
