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