# 获取EMS版本列表 - ListReleases
#### 功能介绍
获取EMS版本列表。
#### URI
GET /v1/releases
表1Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| limit  | 否    | Integer | **参数解释** 返回结果个数限制。 **约束限制** 不涉及。 **取值范围** 值为大于0的整数。 **默认取值** 100                                                                           |
| offset | 否    | Integer | **参数解释** 分页偏移量。分页查询时使用，与limit配合使用。假如共有50条记录，设置offset为11，limit为10，即为从第12条记录开始查询，一次最多可读取10条记录。 **约束限制** 不涉及。 **取值范围** 值为大于等于0的整数。 **默认取值** 0 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数       | 参数类型                                                                       | 描述                                                                                                                                           |
|:---|:---|:---|
| total    | Integer                                                                    | **参数解释** 总记录数。 **取值范围** 0\~2147483647           |
| releases | Array of [ReleaseProperty] objects | **参数解释** EMS版本列表。 **取值范围** EMS版本对象数组，最多1000个元素。 |
   
 表3ReleaseProperty 
| 参数          | 参数类型   | 描述                                                                                                                                                       |
|:---|:---|:---|
| version     | String | **参数解释** EMS版本号。 **取值范围** 由字母、数字、点号(.)组成，且长度为0-64个字符。       |
| tag         | String | **参数解释** EMS版本标签，例如优选版本。 **取值范围** 由字母、下划线(_)组成，且长度为0-64个字符。 |
| description | String | **参数解释** 版本描述信息。 **取值范围** 由Unicode字符组成，且长度为0-2048个字符。       |
   
**状态码：400**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                    |
|:---|:---|:---|
| error_code | String | **参数解释** 错误码，用于标识具体的错误类型。 **取值范围** 不涉及。  |
| error_msg  | String | **参数解释** 错误描述，用于说明具体的错误信息。 **取值范围** 不涉及。 |
   
#### 请求示例
查询EMS版本列表，每页返回10个记录，从第2条记录（offset=1）开始返回结果。
```
GET https://{endpoint}/v1/releases?limit=10&offset=1
```
#### 响应示例
**状态码：200**
**参数解释**
获取EMS版本列表成功返回响应体。
**取值范围**
不涉及。
```
{
  "total" : 1,
  "releases" : [ {
    "version" : "v3.0",
    "tag" : null,
    "description" : "26.3.0版本，优选版本"
  } ]
}
```
**状态码：400**
**参数解释**
错误响应体。
**取值范围**
不涉及。
```
{
  "error_code" : "EMS.00004000",
  "error_msg" : "invalid parameter"
}
```
#### 状态码
| 状态码 | 描述                                                                                                                                    |
|:---|:---|
| 200 | **参数解释** 获取EMS版本列表成功返回响应体。 **取值范围** 不涉及。 |
| 400 | **参数解释** 错误响应体。 **取值范围** 不涉及。            |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-ems/ems_04_0031.html)。