文档

DescribeTopTraffic - 查询代播实例上牵引流量最大IP

更新时间:

查询指定时间段内,代播实例上牵引流量最大的前N个IP信息。

接口说明

本接口用于分页查询指定时间段内经代播实例转发流量最大的前N个IP信息。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制,API调用将会被限流,这可能影响您的业务,请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
InstanceIdstring

要查询的代播实例的ID。

说明您可以调用DescribeOnDemandInstance查询所有代播实例的ID。
ddosbgp-cn-z2q1qzxb****
Ipnetstring

要查询的代播网段。

47.XX.XX.0/24
StartTimestring

流量转发开始时间。使用时间戳表示,单位:秒。

1560853054
EndTimestring

流量转发结束时间。使用时间戳表示,单位:秒。

1563445054
Rninteger

查询转发流量最大的前几个IP。默认为1,表示查询转发流量最大的IP。

1
PageNointeger

分页查询时,设置当前页面的页面。默认值为1

1
PageSizeinteger

分页查询时,设置每页包含IP的数量。默认值为10,最大值为50

10
ResourceGroupIdstring

代播实例在资源管理服务中所属的资源组ID。

不设置该参数表示默认资源组。

rg-acfm2pz25js****
RegionIdstring

代播实例的地域ID。

说明您可以调用DescribeRegions查询DDoS原生防护支持的所有地域信息。
cn-zhangjiakou

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回参数

名称类型描述示例值
object
Totallong

查询到的IP的总数量。

1
RequestIdstring

本次请求的ID。

CF33B4C3-196E-4015-AADD-5CAD00057B80
TrafficListobject []

经过代播实例转发的流量信息。

Ipstring

防护的IP地址。

47.XX.XX.0
AttackPpsinteger

攻击数据包数。单位:pps。

0
Bpsinteger

总流量大小。单位:Kbps。

2919212
Ppsinteger

总数据包数。单位:pps。

100000
AttackBpsinteger

攻击流量大小。单位:Kbps。

0

示例

正常返回示例

JSON格式

{
  "Total": 1,
  "RequestId": "CF33B4C3-196E-4015-AADD-5CAD00057B80",
  "TrafficList": [
    {
      "Ip": "47.XX.XX.0",
      "AttackPps": 0,
      "Bps": 2919212,
      "Pps": 100000,
      "AttackBps": 0
    }
  ]
}

错误码

访问错误中心查看更多错误码。