响应参数
5.2.2 查询指定 API 版本信息
功能介绍
查询存储容灾指定API版本信息。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
GET /{version}
表5-62 路径参数
参数 是否必选 参数类型 描述
version 是 String API版本号。例如：v1。
请求参数
version ShowApiVers ionParams object
API版本信息。
表5-64 ShowApiVersionParams
参数 参数类型 描述
id String 版本ID（版本号），如v1。
links Array of ShowApiVers ionLinksPara ms objects
版本号查询链接
version String 若该版本API支持微版本，则返回支持的最大微版 本号，如果不支持微版本，则返回空。
status String 版本状态，为如下3种： CURRENT：表示该版本 为主推版本 SUPPORTED：表示为老版本，但是 现在还继续支持 DEPRECATED：表示为废弃版 本，存在后续删除的可能
枚举值：
● CURRENT
● SUPPORTED
● DEPRECATED
updated String 版本发布时间，采用UTC时间表示。如v1发布的 时间2018-05-30T15:00:00Z。
min_version String 若该版本API 支持微版本，则返回支持的最小微 版本号，如果不支持微版本，则返回空。
表5-65 ShowApiVersionLinksParams
参数 参数类型 描述
rel String 链接的描述
href String 版本号查询链接
状态码： 400
表5-66 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-67 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 401
表5-68 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-69 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 403
表5-70 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-71 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 404
表5-72 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-73 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 405
表5-74 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-75 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 406
表5-76 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-77 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 407
表5-78 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-79 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 408
表5-80 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-81 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 409
表5-82 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-83 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 500
表5-84 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-85 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 501
表5-86 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-87 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 502
表5-88 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-89 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 503
表5-90 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-91 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
状态码： 504
表5-92 响应 Body 参数
参数 参数类型 描述
error ErrorInfo
object 失败返回结构
表5-93 ErrorInfo
参数 参数类型 描述
message String 错误信息
code String 错误码
请求示例
GET https://{endpoint}/v1
响应示例
状态码： 200 OK
{ "version" : { "id" : "v1", "links" : [ {
"href" : "https://sdrs.localdomain.com/v1", "rel" : "self"
} ],
"status" : "CURRENT",
"updated" : "2018-05-30T00:00:00Z",
"version" : "", "min_version" : ""
}}
状态码
状态码 描述
200 OK
400 Bad Request 401 Unauthorized 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
错误码
请参见错误码。