DescribeOnDemandDdosEvent_图表日志_2018-07-20版本_API参考（原生防护）

说明 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
}

错误码

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