DescribeDdosEventList - 查询DDoS攻击事件列表

查询单个公网IP资产（云服务器ECS实例、负载均衡SLB实例、弹性公网IP实例）上发生的DDoS攻击事件的详情列表。

接口说明

本接口用于分页查询单个公网IP资产（云服务器ECS实例、负载均衡SLB实例、弹性公网IP实例）上发生的DDoS攻击事件的详情列表，例如，事件的起止时间、当前状态等。

QPS限制

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

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
DdosRegionId	string	是	要查询的公网IP资产所在地域ID。说明您可以调用DescribeRegions查询所有地域ID。	cn-hangzhou
InstanceType	string	是	要查询的公网IP资产的实例类型。取值： ecs：表示查询云服务器ECS实例。 slb：表示查询负载均衡SLB实例。 eip：表示查询弹性公网IP实例。	ecs
InstanceId	string	是	要查询的公网IP资产的实例ID。说明您可以调用DescribeInstance查询当前阿里云账号拥有的ECS、SLB、EIP实例的ID。	i-bp10bclrt56fblts****
CurrentPage	integer	否	分页查询时，设置当前页面的页码。默认值为1。	1
PageSize	integer	否	分页查询时，设置每页包含攻击事件的数量。默认值为10。	10
InternetIp	string	否	要查询的公网IP资产的IP地址。	121.199.XX.XX

返回参数

名称	类型	描述	示例值
	object
Total	integer	查询到的DDoS攻击事件的总数量。	1
RequestId	string	本次调用请求的ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	BC0907F8-A9F3-5E11-977B-D59CD98C64ED
DdosEventList	array	DDoS攻击事件的详情列表。
	object
DdosType	string	DDoS攻击事件的类型。取值： defense：表示流量清洗事件。 blackhole：表示黑洞事件。	blackhole
EndTime	long	事件的结束时间。使用时间戳表示，单位：毫秒。	1637817679000
StartTime	long	事件的开始时间。使用时间戳表示，单位：毫秒。	1637812279000
DelayTime	long	最后一次遭受攻击的时间。使用时间戳表示，单位：毫秒。说明只有在一次攻击事件中，公网IP资产遭到多次攻击时，才会返回该参数。	1637817679000
DdosStatus	string	事件的状态。取值： mitigating：表示清洗中，即正在进行流量清洗。 blackholed：表示黑洞中，即公网IP资产处于黑洞状态。 normal：表示正常，即事件已结束。	normal
UnBlackholeTime	long	黑洞解除时间。使用时间戳表示，单位：毫秒。说明只有当DdosType为blackhole（表示黑洞事件）时，才会返回该参数。	1637814079000

示例

正常返回示例

JSON格式

{
  "Total": 1,
  "RequestId": "BC0907F8-A9F3-5E11-977B-D59CD98C64ED",
  "DdosEventList": {
    "DdosEvent": [
      {
        "DdosType": "blackhole",
        "EndTime": 1637817679000,
        "StartTime": 1637812279000,
        "DelayTime": 1637817679000,
        "DdosStatus": "normal",
        "UnBlackholeTime": 1637814079000
      }
    ]
  }
}

错误码

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