DescribeDdosEventList - 查询DDoS攻击事件列表

查询单个公网IP资产上发生的DDoS攻击事件的详情列表。

接口说明

本接口用于分页查询单个公网 IP 资产上发生的 DDoS 攻击事件的详情列表,例如,事件的起止时间、当前状态等。

QPS 限制

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

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-ddos:DescribeDdosEventListget
  • 全部资源
    *

请求参数

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

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

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

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

  • ecs:表示云服务器 ECS 实例。
  • slb:表示负载均衡 SLB 实例。
  • eip:表示弹性公网 IP 实例。
  • ipv6:表示 IPv6 网关公网实例。
  • swas:表示轻量服务器公网实例。
  • waf:表示 Web 应用防火墙独享实例。
  • ga_basic:表示全球加速公网实例。
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
DdosEventListarray<object>

DDoS 攻击事件的详情列表。

DdosEventobject

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
      }
    ]
  }
}

错误码

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

变更历史

变更时间变更内容概要操作
暂无变更历史