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