# 查询API版本信息 - ShowApiVersion
#### 功能介绍
查询API指定版本信息。
- 调用接口前，您需要了解API[认证鉴权](https://support.huaweicloud.com/api-rds/rds_03_0001.html)。
- 调用接口前，您需要了解[请求Header参数说明](https://support.huaweicloud.com/api-rds/rds_03_0005.html#rds_03_0005__section479119143310)。
 
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/RDS/doc?api=ShowApiVersion)中调试该接口。
#### 授权信息
不涉及。
#### URI
- URI格式 GET /rds/{*version*}
  
- 参数说明
  表1参数说明 
  | 名称      | 是否必选 | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
  |:---|:---|:---|
  | version | 是    | **参数解释**： API版本号。 **约束限制**： 不涉及。 **取值范围**： 区分大小写。 详情请参考[查询API版本列表 - ListApiVersionNew](https://support.huaweicloud.com/api-rds/rds_04_0007.html)响应消息[表2](https://support.huaweicloud.com/api-rds/rds_04_0007.html#rds_04_0007__table37479565104653)中的"id"。 **默认取值**： 不涉及。 |
     
  
 
#### 请求消息
- 请求参数 无。
  

- URI样例 GET https://{endpoint}/rds/v1
  
 
#### 响应消息
- 正常响应要素说明
  表2要素说明 
  | 名称       | 参数类型   | 说明                                                                                                                                 |
  |:---|:---|:---|
  | versions | Object | **参数解释**： API版本详细信息列表。 详情请参见[表3]。 |
  | version  | Object | **参数解释**： API版本详细信息列表。 详情请参见[表3]。   |
     
   表3versions字段数据结构说明 
  | 名称      | 参数类型   | 说明                                                                                                                                                                                                                                                                                                                                   |
  |:---|:---|:---|
  | id      | String | **参数解释**： API版本号。 **取值范围**： 不涉及。                                                                                                                                                                                                            |
  | links   | Array  | **参数解释**： 对应该API版本的链接信息，该字段为空。 详情请参见[表4]。                                                                                                                                                                                                 |
  | status  | String | **参数解释**： 版本状态。 **取值范围**： - CURRENT：表示该版本为主推版本。  - DEPRECATED：表示为废弃版本，存在后续删除的可能。   |
  | updated | String | **参数解释**： 版本更新时间。 **取值范围**： 格式为"yyyy-mm-dd Thh:mm:ssZ"。 其中，T指某个时间的开始；Z指UTC时间。                                                                                                                             |
     
   表4links字段数据结构说明 
  | 名称   | 参数类型   | 说明                                                                                                                                            |
  |:---|:---|:---|
  | href | String | **参数解释**： 对应该API的URL。 **取值范围**： 该字段为""。                  |
  | rel  | String | **参数解释**： URL类型。 **取值范围**： 取值为"self"，表示href为本地链接。 |
     
  

- 正常响应样例
  ```
  {
    "version": {
      "id": "v1",
      "links": [],
      "status": "DEPRECATED",
      "updated": "2017-02-07T17:34:02Z"
    },
    "versions": {
      "id": "v1",
      "links": [],
      "status": "DEPRECATED",
      "updated": "2017-02-07T17:34:02Z"
    }
  }
  ```
  
- 异常响应 请参见[异常响应结果](https://support.huaweicloud.com/api-rds/rds_01_0010.html)。
  
 
#### 状态码
- 正常 200
  
- 异常 请参见[状态码](https://support.huaweicloud.com/api-rds/rds_10_0200.html)。
  
 
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-rds/rds_10_0201.html)。