查询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 |
错误码
请参见错误码。