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

使用说明

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

QPS限制

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

调试

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

请求参数

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

要执行的操作。取值:DescribeDdosEventList

DdosRegionId String cn-hangzhou

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

说明 您可以调用DescribeRegions查询所有地域ID。
InstanceType String ecs

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

  • ecs:表示查询云服务器ECS实例。
  • slb:表示查询负载均衡SLB实例。
  • eip:表示查询弹性公网IP实例。
InstanceId String i-bp10bclrt56fblts****

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

说明 您可以调用DescribeInstance查询当前阿里云账号拥有的ECS、SLB、EIP实例的ID。
CurrentPage Integer 1

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

PageSize Integer 10

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

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
Total Integer 2

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

RequestId String 5740363B-BCB8-5E9E-8209-6B657341B457

本次请求的ID。

DdosEventList Array of DdosEvent

DDoS攻击事件的详情列表。

DdosEvent
DdosType String blackhole

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

  • defense:表示流量清洗事件。
  • blackhole:表示黑洞事件。
EndTime Long 1637817679000

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

StartTime Long 1637812279000

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

DelayTime Long 1637817679000

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

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

事件的状态。取值:

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

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

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

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeDdosEventList
&DdosRegionId=cn-hangzhou
&InstanceType=ecs
&InstanceId=i-bp10bclrt56fblts****
&CurrentPage=1
&PageSize=10
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDdosEventListResponse>
    <DdosEventList>
        <DdosEvent>
            <EndTime>1637817679000</EndTime>
            <StartTime>1637812279000</StartTime>
            <DdosStatus>normal</DdosStatus>
            <UnBlackholeTime>1637814079000</UnBlackholeTime>
            <DdosType>blackhole</DdosType>
        </DdosEvent>
        <DdosEvent>
            <EndTime>1637812580000</EndTime>
            <StartTime>1637812173000</StartTime>
            <DdosStatus>normal</DdosStatus>
            <DdosType>defense</DdosType>
        </DdosEvent>
    </DdosEventList>
    <RequestId>5740363B-BCB8-5E9E-8209-6B657341B457</RequestId>
    <Total>2</Total>
</DescribeDdosEventListResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DdosEventList" : {
    "DdosEvent" : [ {
      "EndTime" : 1637817679000,
      "StartTime" : 1637812279000,
      "DdosStatus" : "normal",
      "UnBlackholeTime" : 1637814079000,
      "DdosType" : "blackhole"
    }, {
      "EndTime" : 1637812580000,
      "StartTime" : 1637812173000,
      "DdosStatus" : "normal",
      "DdosType" : "defense"
    } ]
  },
  "RequestId" : "5740363B-BCB8-5E9E-8209-6B657341B457",
  "Total" : 2
}

错误码

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