调用GetNetworkTrafficTopN接口，获取网络流量指标排行。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：GetNetworkTrafficTopN

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

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

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

Region string 必选示例值：cn-beijing

资源所在地域。

SortBy string 必选示例值：ByteCount

排序的指标。取值如下：

ByteCount：流量字节数。

PacketCount：流量包数。

EndTime long 可选示例值：1764045943000

结束时间戳，单位 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

过滤条件值。

GroupBy string 必选示例值：Tuple1

流量统计排序的维度，取值如下：

公网流量分析：

Tuple1：一元组（云端IP）。

Tuple2：二元组（源和目的IP）。

Tuple5：五元组（源和目的IP、源和目的端口、协议）。

Protocol：协议。

Country：客户端所属国家。

City：客户端所属城市。

ISP：客户端所属运营商。

SourcePort：源端口（仅当Direction为out时支持）。

DestinationPort：目的端口（仅当Direction为in时支持）。

跨域流量分析：

Tuple1：一元组（源IP）。

Tuple2：二元组（源和目的IP）。

PeerRegion：对端地域。

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

混合云流量分析：

Tuple1：一元组（云端IP）。

Tuple2：二元组（源和目的IP）。

InstanceId：专线网关实例ID。

TopCount integer 可选示例值：10

排序后靠前数据的条数。

取值范围：1-100。

默认值：10。

BeginTime long 可选示例值：1764042943000

起始时间戳，单位 ms。

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

Direction string 必选示例值：out

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

in：入云方向。

out：出云方向。

ResourceType为CEN、TR时，填out。

SortOrder string 可选示例值：desc

排序方式，取值如下：

asc：按正序排序。

desc（默认）：按逆序排序。

ResourceType string 必选示例值：EIP

资源类型，取值如下：

EIP：弹性公网IP流量。

CEN：云企业网流量。

TR：中转路由器流量。

DCG：专线网关流量。

返回参数

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

Data object[] 示例值：--

指标排行数据。

Isp string 示例值：中国移动

客户端运营商。

City string 示例值：北京

客户端城市。

Country string 示例值：中国

客户端国家。

Protocol string 示例值：TCP

协议。

TCP

UDP

ICMP

ICMPv6

SourceIp string 示例值：101.XX.XX.110

源IP。

ByteCount long 示例值：100

流量字节数。

InstanceId string 示例值：cen-7qthudw0ll6jmc****

实例ID。

PeerRegion string 示例值：cn-beijing

对端地域。

SourcePort integer 示例值：80

源端口。

PacketCount long 示例值：1000

流量包数。

DestinationIp string 示例值：19.XX.XX.19

目的IP。

TrAttachmentId string 示例值：tr-attach-7qthudw0ll6jmc****

中转路由器跨地域连接实例ID。

DestinationPort integer 示例值：80

目的端口。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	DataUnmarshalFailed	Data unmarshal failed.	请求解析失败。
400	DuplicateFilters	Filters with same Name are not allowed.	过滤条件不能重复。
400	FiltersUnsupportedForGroupBy	The specified Filters are unsupported for the requested GroupBy	指定的过滤条件在当前的分组维度下不支持。
400	GroupByUnsupportedForDirection	The specified GroupBy is unsupported for the requested Direction.	指定的分组维度在请求的流量方向下不支持。
400	InvalidDirection	The specified Direction is invalid.	指定的流量方向无效。
400	InvalidGroupBy	The specified GroupBy is invalid.	指定的分组维度无效。
400	InvalidIPInFilters	There exists invalid IP address in Filters.	过滤条件包含无效的IP地址。
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	InvalidSortBy	The specified SortBy is invalid.	指定的排序指标无效。
400	InvalidSortOrder	The specified SortOrder 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
400	TopCountOutOfRange	The specified TopCount is out of range (1-100).	指定的数据条数超出范围（1-100）。
401	ServiceRoleUnauthorized	service role is unauthorized	角色未授权，请先访问控制台操作授权
500	InternalError	An internal error has occurred.	发生内部错误。

网络智能中心