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