5.1 查询版本操作
5.1.1 查询 API 版本列表
功能介绍
查询标签管理服务的API版本列表。
调试
您可以在API Explorer中调试该接口。
URI
GET /
请求参数
无
响应参数
状态码： 200
表5-1 响应 Body 参数
参数 参数类型 描述
versions Array of VersionDetail objects
版本列表
表5-2 VersionDetail
参数 参数类型 描述
id String 版本ID（版本号），如v1.0。
links Array of Link
objects API的URL地址。
version String 若该版本API支持微版本，则返回支持的最新微版 本号，如果不支持微版本，则返回空。
status String 版本状态，为如下3种： CURRENT：表示该版本 为主推版本。 SUPPORTED：表示为老版本，但 是现在还继续支持。 DEPRECATED：表示为废弃 版本，存在后续删除的可能。
updated String 版本发布时间，采用UTC时间表示。如v1.0发布 的时间2016-12-09T00:00:00Z。
min_version String 若该版本API 支持微版本，则返回支持的最早微 版本号， 如果不支持微版本，则返回空。
表5-3 Link
参数 参数类型 描述
href String API的URL地址。
rel String self
状态码： 400
表5-4 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-5 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 404
表5-6 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-7 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 405
表5-8 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-9 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 406
表5-10 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-11 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 409
表5-12 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-13 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 410
表5-14 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-15 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 412
表5-16 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-17 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 429
表5-18 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-19 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 500
表5-20 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-21 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 501
表5-22 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-23 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
状态码： 503
表5-24 响应 Body 参数
参数 参数类型 描述
error RespErrorMe
ssage object 响应错误信息
表5-25 RespErrorMessage
参数 参数类型 描述
error_code String 请求错误码 error_msg String 错误信息
请求示例
查询标签管理接口版本号列表
GET https://{Endpoint}/
响应示例
"href" : "https://{Endpoint}/v1.0"
} ],
"version" : "", "status" : "CURRENT",
"updated" : "2016-12-09T00:00:00Z", "min_version" : ""
400 Bad Request 404 Not Found
405 Method Not Allowed 406 Not Acceptable 409 Conflict
410 Gone
412 Precondition Failed 429 Too Many Requests 500 Internal Server Error 501 Not Implemented 503 Service Unavailable
错误码
请参见错误码。