功能介绍
查询 存储容灾 当前所有可用的版本信息列表。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
GET /
请求参数
无
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
版本ID(版本号),如v1。 |
links |
版本号查询链接 |
|
version |
String |
若该版本API支持微版本,则返回支持的最大微版本号,如果不支持微版本,则返回空。 |
status |
String |
版本状态,为如下3种: CURRENT:表示该版本为主推版本 SUPPORTED:表示为老版本,但是现在还继续支持 DEPRECATED:表示为废弃版本,存在后续删除的可能 枚举值:
|
updated |
String |
版本发布时间,采用UTC时间表示。如v1发布的时间2018-05-30T15:00:00Z。 |
min_version |
String |
若该版本API 支持微版本,则返回支持的最小微版本号,如果不支持微版本,则返回空。 |
状态码: 400
状态码: 403
状态码: 404
状态码: 405
状态码: 406
状态码: 407
状态码: 408
状态码: 409
状态码: 500
状态码: 501
状态码: 502
状态码: 503
状态码: 504
请求示例
GET https://{endpoint}/
响应示例
状态码: 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" : "" } ] }
状态码
状态码 |
描述 |
---|---|
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 |
错误码
请参见错误码。