调用GetNetworkTrafficMetrics接口，获取网络流量指标趋势。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：GetNetworkTrafficMetrics

要执行的操作，取值：GetNetworkTrafficMetrics。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

Region string 必选示例值：cn-beijing

资源所在地域。

EndTime long 可选示例值：1764042944000

结束时间戳，单位 ms。

Filters object[] 可选示例值：--

过滤条件。

Name string 必选示例值：SourceIp

过滤条件名字，取值：

公网流量分析：

InstanceId：弹性公网IP实例ID。

BandwidthPackageId：带宽包实例ID。

SourceIp：源IP。

DestinationIp：目的IP。

SourcePort：源端口。

DestinationPort：目的端口。

Protocol：协议（支持TCP、UDP、ICMP、ICMPv6）。

Country：客户端所属国家。

City：客户端所属城市。

ISP：客户端所属运营商。

跨域流量分析：

InstanceId：云企业网或中转路由器实例ID。

SourceIp：源IP。

DestinationIp：目的IP。

PeerRegion：对端地域。

混合云流量分析：

InstanceId：专线网关实例ID。

SourceIp：源IP。

DestinationIp：目的IP。

只有当GroupBy参数为Tuple5、Protocol、SourcePort、DestinationPort时，才能指定SourcePort、DestinationPort、Protocol过滤条件。

不支持出现重复的过滤条件。

Value string 必选示例值：101.XX.XX.223

过滤条件值。

BeginTime long 可选示例值：1764042943000

起始时间戳，单位 ms。

默认时间跨度5分钟，最大时间跨度24小时

Direction string 必选示例值：out

网络流量方向。取值如下：

in：入云方向。

out：出云方向。

ResourceType为CEN、TR时，填out。

MetricName string 必选示例值：bps

指标名。取值如下：

bps：每秒比特数。

pps：每秒包数。

ResourceType string 必选示例值：EIP

资源类型。取值如下：

EIP：弹性公网IP流量。

CEN：云企业网流量。

TR：中转路由器流量。

DCG：专线网关流量。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Data object 示例值：--

指标趋势数据。

Metrics object[] 示例值：--

指标趋势数据集合。

Time string 示例值：2025-12-23 18:27:00

数据时间。

Value float 示例值：130.6666717529297

指标值。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	DataUnmarshalFailed	Data unmarshal failed.	请求解析失败。
400	DuplicateFilters	Filters with same Name are not allowed.	过滤条件不能重复。
400	InvalidDirection	The specified Direction is invalid.	指定的流量方向无效。
400	InvalidIPInFilters	There exists invalid IP address in Filters.	过滤条件包含无效的IP地址。
400	InvalidMetricName	The specified MetricName is invalid.	指定的指标名无效。
400	InvalidPortInFilters	There exists invalid port in Filters.	过滤条件包含无效的端口。
400	InvalidQueryDuration	query duration invalid duration must less than 24H five tuple duration must less than 5Min.	查询时间区间不合法查询区间必须小于24小时五元组查询区间必须小于5分钟。
400	InvalidRegion	The specified Region is invalid.	指定的地域无效。
400	InvalidResourceType	The specified ResourceType is invalid.	指定的资源类型无效。
400	MissingParameter	The request is missing a required parameter. Ensure that you have supplied all the required parameters for the request, for example, the ''.	该请求缺少必要参数。请确保发起请求已提供全部必要参数，比如。
400	RegionNotOpen	Traffic analysis is not enabled in the current region. Please enable traffic analysis first.	当前地域未开启流量分析，请先开启流量分析。
400	RegionNotSupported	Current region is not support.	当前地域暂不支持，支持的地域：%s
401	ServiceRoleUnauthorized	service role is unauthorized	角色未授权，请先访问控制台操作授权
500	InternalError	An internal error has occurred.	发生内部错误。

网络智能中心