调用DescribeTopTraffic查询指定时间段内经代播实例转发流量最大的前N个IP信息。

使用说明

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

QPS限制

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeTopTraffic

要执行的操作。取值:DescribeTopTraffic

InstanceId String ddosbgp-cn-z2q1qzxb****

要查询的代播实例的ID。

说明 您可以调用DescribeOnDemandInstance查询所有代播实例的ID。
Ipnet String 47.XX.XX.0/24

要查询的代播网段。

StartTime String 1560853054

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

EndTime String 1563445054

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

Rn Integer 1

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

PageNo Integer 1

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

PageSize Integer 10

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

ResourceGroupId String rg-acfm2pz25js****

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

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

RegionId String cn-zhangjiakou

代播实例的地域ID。

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

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

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

返回数据

名称 类型 示例值 描述
Total Long 1

查询到的IP的总数量。

RequestId String CF33B4C3-196E-4015-AADD-5CAD00057B80

本次请求的ID。

TrafficList Array of Traffic

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

Ip String 47.XX.XX.0

防护的IP地址。

AttackPps Integer 0

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

Bps Integer 2919212

总流量大小。单位:Kbps。

Pps Integer 100000

总数据包数。单位:pps。

AttackBps Integer 0

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

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeTopTraffic
&InstanceId=ddosbgp-cn-z2q1qzxb****
&StartTime=1560853054
&EndTime=1563445054
&Rn=1
&PageNo=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeTopTrafficResponse>
    <Total>1</Total>
    <RequestId>CF33B4C3-196E-4015-AADD-5CAD00057B80</RequestId>
    <TrafficList>
        <Ip>47.XX.XX.0</Ip>
        <AttackPps>0</AttackPps>
        <Bps>2919212</Bps>
        <Pps>100000</Pps>
        <AttackBps>0</AttackBps>
    </TrafficList>
</DescribeTopTrafficResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

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