调用DescribeOnDemandDdosEvent查询DDoS防护代播IP上的DDoS事件记录。

说明 DDoS原生防护的API接口目前仅对DDoS原生防护企业版用户开放。

调试

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

请求参数

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

要执行的操作。取值:DescribeOnDemandDdosEvent

EndTime Integer 1557909844

查询结束时间,秒级时间戳。

InstanceId String ddosbgp-cn-x1

要查询的代播实例ID。

PageNo Integer 1

列表的页码,默认值为1

PageSize Integer 10

分页查询时每页的行数,最大值为50,默认值为10

StartTime Integer 1557305044

查询开始时间,秒级时间戳。

Ip String 1.1.1.1

要查询的代播IP。

ResourceGroupId String default

DDoS防护代播实例在资源管理产品中所属的资源组ID。默认为空,即属于默认资源组。

RegionId String cn-hangzhou

要查询的代播实例的地域ID。

返回数据

名称 类型 示例值 描述
Events Array

DDoS攻击事件信息。

EndTime Integer 1557891306

攻击结束时间,秒级时间戳。

Ip String 1.1.1.1

被攻击的IP。

Mbps Integer 110000

攻击流量大小,单位:Mbps。

Pps Integer 0

攻击报文数量,单位:pps。

StartTime Integer 1557889506

攻击开始时间,秒级时间戳。

Status String defense_end

事件状态,取值:

  • hole_begin:黑洞中
  • hole_end:黑洞结束
  • defense_begin:清洗中
  • defense_end:清洗结束
RequestId String 6A507DC8-F657-4C13-84E2-D1D1B9400753

本次请求的ID。

Total Long 8

DDoS攻击事件总数。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeOnDemandDdosEvent
&EndTime=1557909844
&InstanceId=ddosbgp-cn-x1
&PageNo=1
&PageSize=10
&StartTime=1557305044
&<公共请求参数>

正常返回示例

XML 格式

<DescribeOnDemandDdosEventResponse>
       <RequestId>6A507DC8-F657-4C13-84E2-D1D1B9400753</RequestId>
       <Events>
               <Event>
                       <Pps>0</Pps>
                       <Status>defense_end</Status>
                       <Ip>1.1.1.1</Ip>
                       <Mbps>110000</Mbps>
                       <EndTime>1557891306</EndTime>
                       <StartTime>1557889506</StartTime>
               </Event>
       </Events>
       <Total>1</Total>
</DescribeOnDemandDdosEventResponse>

JSON 格式

{
	"RequestId":"6A507DC8-F657-4C13-84E2-D1D1B9400753",
	"Events":[
		{
			"Pps":0,
			"Ip":"1.1.1.1",
			"Status":"defense_end",
			"Mbps":110000,
			"EndTime":1557891306,
			"StartTime":1557889506
		}
	],
	"Total":8
}

错误码

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