文档

DescribeDdosEventList - 查询DDoS攻击事件列表

更新时间:

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

接口说明

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

QPS 限制

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

调试

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

授权信息

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

请求参数

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

要查询的公网 IP 资产所在地域 ID。

说明 您可以调用 DescribeRegions 查询所有地域 ID。
cn-hangzhou
InstanceTypestring

要查询的公网 IP 资产的实例类型。取值:

  • ecs:表示查询云服务器 ECS 实例。
  • slb:表示查询负载均衡 SLB 实例。
  • eip:表示查询弹性公网 IP 实例。
ecs
InstanceIdstring

要查询的公网 IP 资产的实例 ID。

说明 您可以调用 DescribeInstance 查询当前阿里云账号拥有的 ECS、SLB、EIP 实例的 ID。
i-bp10bclrt56fblts****
CurrentPageinteger

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

1
PageSizeinteger

分页查询时,设置每页包含攻击事件的数量。默认值为 10

10
InternetIpstring

要查询的公网 IP 资产的 IP 地址。

121.199.XX.XX

返回参数

名称类型描述示例值
object
Totalinteger

查询到的 DDoS 攻击事件的总数量。

1
RequestIdstring

本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。

BC0907F8-A9F3-5E11-977B-D59CD98C64ED
DdosEventListobject []

DDoS 攻击事件的详情列表。

DdosTypestring

DDoS 攻击事件的类型。取值:

  • defense:表示流量清洗事件。
  • blackhole:表示黑洞事件。
blackhole
EndTimelong

事件的结束时间。使用时间戳表示,单位:毫秒。

1637817679000
StartTimelong

事件的开始时间。使用时间戳表示,单位:毫秒。

1637812279000
DelayTimelong

最后一次遭受攻击的时间。使用时间戳表示,单位:毫秒。

说明 只有在一次攻击事件中,公网 IP 资产遭到多次攻击时,才会返回该参数。
1637817679000
DdosStatusstring

事件的状态。取值:

  • mitigating:表示清洗中,即正在进行流量清洗。
  • blackholed:表示黑洞中,即公网 IP 资产处于黑洞状态。
  • normal:表示正常,即事件已结束。
normal
UnBlackholeTimelong

黑洞解除时间。使用时间戳表示,单位:毫秒。

说明 只有当 DdosTypeblackhole(表示黑洞事件)时,才会返回该参数。
1637814079000

示例

正常返回示例

JSON格式

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

错误码

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

  • 本页导读 (1)