# 查询版本信息列表 - ShowVersions
#### 功能介绍
- 功能介绍：查询API版本信息列表。
  
 
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dew/dew_02_0002.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dew/dew_02_0308.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项              | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | kms::getVersions | Read | -           | -   | -  | -      |
     
  
 
#### URI
GET /
#### 请求参数
无
#### 响应参数
**状态码：200**
表1响应Body参数 
| 参数       | 参数类型                                                                          | 描述                                                                                                                                        |
|:---|:---|:---|
| versions | Array of [ApiVersionDetail] objects | **参数解释：** 描述version 相关对象的列表 **取值范围：** 不涉及 |
   
 表2ApiVersionDetail 
| 参数          | 参数类型                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| id          | String                                                      | **参数解释：** 版本ID（版本号），如"v1.0" **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| links       | Array of [ApiLink] objects | **参数解释：** JSON对象，详情请参见links字段数据结构说明。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| version     | String                                                      | **参数解释：** 若该版本API支持微版本，则填支持的最大微版本号，如果不支持微版本，则返回空字符串。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| status      | String                                                      | **参数解释：** 版本状态 **取值范围：** - CURRENT：表示该版本为主推版本。   - SUPPORTED：表示为老版本，但是现在还继续支持。   - DEPRECATED：表示为废弃版本，存在后续删除的可能。    |
| updated     | String                                                      | **参数解释：** 版本发布时间，要求用UTC时间表示。如v1.发布的时间2014-06-28T12:20:21Z。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| min_version | String                                                      | **参数解释：** 若该版本API 支持微版本，则填支持的最小微版本号，如果不支持微版本，则返回空字符串。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表3ApiLink 
| 参数   | 参数类型   | 描述                                                                                                                                |
|:---|:---|:---|
| href | String | **参数解释：** API的URL地址 **取值范围：** 不涉及 |
| rel  | String | **参数解释：** 默认值self **取值范围：** 不涉及   |
   
#### 请求示例
```
无
```
#### 响应示例
**状态码：200**
```
{
  "versions" : [ {
    "min_version" : "",
    "links" : [ {
      "rel" : "self",
      "href" : "https://kms.region_id.domain.com/v1.0/"
    } ],
    "id" : "v1.0",
    "version" : "",
    "updated" : "2016-10-29T02:00:00Z",
    "status" : "CURRENT"
  } ]
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求已成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dew/ErrorCode.html)。