> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/zec/elastic-ip/describeeipnewconnsmonitordata.md).
# DescribeEipNewConnsMonitorData
## 1. 接口描述
本接口(DescribeEipNewConnsMonitorData)用于查询一段时间的弹性公网IP每秒新建连接数（CPS，All/In/Out）监控数据；也可传实例ID，查询其名下所有EIP的聚合数据。
## 2. 请求参数
以下请求参数列表仅列出了接口中需要的请求参数
| 参数名称 | 必选 | 类型 | 描述 |
| ---------- | -- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| metricType | 是 | [EipNewConnsMeta](/api-reference/cn/zec/datastructure.md#eipnewconnsmeta) | 新建连接数监控指标类型。 |
| startTime | 是 | String | 查询开始时间。
时间格式：yyyy-MM-ddTHH🇲🇲ssZ。
|
| endTime | 是 | String | 查询结束时间。
时间格式：yyyy-MM-ddTHH🇲🇲ssZ。
|
| eipId | 否 | String | EIP唯一标识ID。
网络类型为PathBasedBandwidthIP的EIP不支持查询此指标，返回错误。
与 instanceId 二选一。
|
| instanceId | 否 | String | 实例ID。
查询该实例绑定的所有IPv4 EIP的聚合数据（不含IPv6，且排除PathBasedBandwidthIP类型）。
与 eipId 二选一。
|
| step | 否 | Integer | 查询数据点间隔。
单位为分钟。
支持参数：1,5,15,60,360,1440,10080。
取值为1时，查询时间跨度不能超过6小时。
默认值：5
|
## 3. 响应结果
| 参数名称 | 类型 | 描述 |
| ----------- | ------------------------------------------------------------------------------ | -------------------------------------------------------- |
| requestId | String | 唯一请求 ID。
每次请求都会返回。定位问题时需要提供该次请求的 requestId。
|
| allMaxValue | Float | All（入+出之和）数据点的最大值。 |
| allMinValue | Float | All（入+出之和）数据点的最小值。 |
| allAvgValue | Float | All（入+出之和）数据点的平均值。 |
| inMaxValue | Float | In（入方向）数据点的最大值。 |
| inMinValue | Float | In（入方向）数据点的最小值。 |
| inAvgValue | Float | In（入方向）数据点的平均值。 |
| outMaxValue | Float | Out（出方向）数据点的最大值。 |
| outMinValue | Float | Out（出方向）数据点的最小值。 |
| outAvgValue | Float | Out（出方向）数据点的平均值。 |
| dataList | Array of [NewConnsValue](/api-reference/cn/zec/datastructure.md#newconnsvalue) | 监控数据集合。 |
## 4. 代码示例
{% tabs %}
{% tab title="示例" %}
**1. 查询单个EIP的每秒新建连接数（CPS）监控指标。**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeEipNewConnsMonitorData
Request：
{
"eipId": "< EipId >",
"metricType": "NEW_CONNECTIONS",
"startTime": "2026-09-16T01:55:00Z",
"endTime": "2026-09-16T07:55:00Z"
}
Response：
{
"requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
"response": {
"requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
"allMaxValue": 1.2,
"allMinValue": 1.2,
"allAvgValue": 1.2,
"inMaxValue": 1.2,
"inMinValue": 1.2,
"inAvgValue": 1.2,
"outMaxValue": 1.2,
"outMinValue": 1.2,
"outAvgValue": 1.2,
"dataList": [
{
"time": "2026-09-16T01:55:00Z",
"allValue": 1.2,
"inValue": 1.2,
"outValue": 1.2
}
]
}
}
```
**2. 查询实例下所有IPv4 EIP的新建连接数聚合数据（不含IPv6）**
```json
POST /api/v2/zec HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeEipNewConnsMonitorData
Request：
{
"instanceId": "< InstanceId >",
"metricType": "NEW_CONNECTIONS",
"startTime": "2026-09-16T01:55:00Z",
"endTime": "2026-09-16T07:55:00Z",
"step": 60
}
Response：
{
"requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
"response": {
"requestId": "T05992D0C-7E8B-4047-B0C0-780F2CD549D3",
"allMaxValue": 1.2,
"allMinValue": 1.2,
"allAvgValue": 1.2,
"inMaxValue": 1.2,
"inMinValue": 1.2,
"inAvgValue": 1.2,
"outMaxValue": 1.2,
"outMinValue": 1.2,
"outAvgValue": 1.2,
"dataList": [
{
"time": "2026-09-16T01:55:00Z",
"allValue": 1.2,
"inValue": 1.2,
"outValue": 1.2
}
]
}
}
```
{% endtab %}
{% endtabs %}
## 5. 开发者工具
Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](/api-reference/cn/api-introduction/toolkit.md)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。
## 6. 错误码
下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](/api-reference/cn/api-introduction/instruction/commonerrorcode.md)
| HTTP状态码 | 错误码 | 说明 |
| ------- | ------------------------------------------------------------ | -------------------- |
| 400 | INVALID\_TIME\_RANGE | 查询时间范围不合法。 |
| 400 | INVALID\_MONITOR\_TIME\_RANGE\_EXCEED\_STEP\_LIMIT | 当前间隔下所选时间范围超出上限。 |
| 404 | INVALID\_EIP\_NOT\_FOUND | EIP不存在。 |
| 404 | INVALID\_INSTANCE\_NOT\_FOUND | 服务器实例不存在。 |
| 400 | OPERATION\_DENIED\_EIP\_NETWORK\_TYPE\_NOT\_SUPPORT\_MONITOR | 该EIP的网络类型不支持查询此监控指标。 |