查询API版本号详情
功能介绍
查询指定的企业项目API版本号详情
调用方法
请参见如何调用API。
URI
GET /{api_version}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
api_version | 是 | String | 版本ID(版本号),如v1.0。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token。说明:由于EPS是全局服务,因此调用IAM服务获取用户Token接口时需要注意作用域即scope字段应该设置为domain。响应消息头中X-Subject-Token的值即为用户Token。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
version | VersionDetail object | 版本详情 |
参数 | 参数类型 | 描述 |
|---|---|---|
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 支持微版本,则返回支持的最小微版本号, 如果不支持微版本,则返回空。 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
状态码:401
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:403
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:404
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:405
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:406
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:408
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:409
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:410
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:412
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:429
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:500
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:501
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码:503
参数 | 参数类型 | 描述 |
|---|---|---|
error | RespErrorMessage object | 错误请求信息 |
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
请求示例
无
响应示例
状态码:200
OK
{
"version" : {
"id" : "v1.0",
"links" : [ {
"rel" : "self",
"href" : "https://API的URL地址/v1.0"
} ],
"version" : "",
"status" : "CURRENT",
"updated" : "2016-12-09T00:00:00Z",
"min_version" : ""
}
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | Bad Request |
401 | Unauthorized |
403 | Forbidden |
404 | Not Found |
405 | Method Not Allowed |
406 | Not Acceptable |
408 | Request Timeout |
409 | Conflict |
410 | Gone |
412 | Precondition Failed |
429 | Too Many Requests |
500 | Internal Server Error |
501 | Not Implemented |
503 | Service Unavailable |
错误码
请参见错误码。

