有奖捉虫:云通信与企业服务文档专题,速来> HOT

1. 接口描述

接口请求域名: teo.tencentcloudapi.com 。

本接口(DescribeDDoSAttackTopData)用于查询DDoS攻击Top数据。

默认接口请求频率限制:100次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeDDoSAttackTopData。
Version String 公共参数,本接口取值:2022-09-01。
Region String 公共参数,此参数为可选参数。
StartTime Timestamp ISO8601 开始时间。
EndTime Timestamp ISO8601 结束时间。
MetricName String 查询的统计指标,取值有:
  • ddos_attackFlux_protocol:按各协议的攻击流量排行;
  • ddos_attackPackageNum_protocol:按各协议的攻击包量排行;
  • ddos_attackNum_attackType:按各攻击类型的攻击数量排行;
  • ddos_attackNum_sregion:按攻击源地区的攻击数量排行;
  • ddos_attackFlux_sip:按攻击源IP的攻击数量排行;
  • ddos_attackFlux_sregion:按攻击源地区的攻击数量排行。
  • ZoneIds.N Array of String 站点ID集合,此参数必填。
    PolicyIds.N Array of Integer DDoS策略组ID集合,不填默认选择全部策略ID。
    AttackType String 攻击类型,取值有:
  • flood:洪泛攻击;
  • icmpFlood:icmp洪泛攻击;
  • all:所有的攻击类型。
  • 不填默认为all,表示查询全部攻击类型。
    ProtocolType String 协议类型,取值有:
  • tcp:tcp协议;
  • udp:udp协议;
  • all:所有的协议类型。
  • 不填默认为all,表示查询所有协议。
    Port Integer 端口号。
    Limit Integer 查询前多少个数据,不填默认默认为10, 表示查询前top 10的数据。
    Area String 数据归属地区,取值有:
  • overseas:全球(除中国大陆地区)数据;
  • mainland:中国大陆地区数据。
  • 不填将根据用户所在地智能选择地区。

    3. 输出参数

    参数名称 类型 描述
    Data Array of TopEntry DDoS攻击Top数据列表。
    注意:此字段可能返回 null,表示取不到有效值。
    TotalCount Integer 查询结果的总条数。
    RequestId String 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

    4. 示例

    示例1 DDoS攻击Top数据

    输入示例

    POST / HTTP/1.1
    Host: teo.tencentcloudapi.com
    Content-Type: application/json
    X-TC-Action: DescribeDDoSAttackTopData
    <公共请求参数>
    
    {
        "AttackType": "UDPFLOOD",
        "MetricName": "ddos_attackFlux_protocol",
        "ProtocolType": "udp",
        "PolicyIds": [
            1705
        ],
        "ZoneIds": [
            "zone-21xfqlh4qjee"
        ],
        "Limit": 1,
        "StartTime": "2020-09-22T00:00:00+00:00",
        "EndTime": "2020-09-22T00:00:00+00:00",
        "Port": 22,
        "Area": "overseas"
    }

    输出示例

    {
        "Response": {
            "TotalCount": 10,
            "Data": [
                {
                    "Value": [
                        {
                            "Count": 123,
                            "Name": "udp"
                        }
                    ],
                    "Key": "zone-21xfqlh4qjee"
                }
            ],
            "RequestId": "3824cf60-c2aa-4f4a-95b7-a4d5e4dee188"
        }
    }

    5. 开发者资源

    腾讯云 API 平台

    腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

    API Inspector

    用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。

    SDK

    云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

    命令行工具

    6. 错误码

    以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

    错误码 描述
    FailedOperation 操作失败。
    InternalError.ProxyServer 后端服务器发生未知错误。
    LimitExceeded.QueryTimeLimitExceeded 查询时间范围超出限制。
    ResourceNotFound 资源不存在。
    UnauthorizedOperation.CamUnauthorized Cam 未授权。