UpdateAtkAlarmThreshold-更新实例的攻击告警阈值--DDoS防护-火山引擎

文档中心

立即注册

导航

UpdateAtkAlarmThreshold-更新实例的攻击告警阈值

最近更新时间：2024.11.27 21:51:41首次发布时间：2024.07.19 19:17:48

如果告警阈值过低，可能导致告警事件过于频繁，造成干扰；而告警阈值过高，可能导致漏掉攻击事件信息，影响正常业务。因此，建议根据业务实际场景调整告警阈值。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com/?Action=UpdateAtkAlarmThreshold&Version=2021-06-15

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`UpdateAtkAlarmThreshold`	接口名称。当前 API 的名称为 `UpdateAtkAlarmThreshold`。
Version	String	是	`2021-06-15`	接口版本。当前 API 的版本为 `2021-06-15`。
InstanceIp	String	是	`1.1.1.1`	高防实例 IP 地址。

Body

参数类型是否必选示例值描述

参数	类型	是否必选	示例值	描述
BandWidth	Integer	否	`1000`	自定义告警攻击带宽阈值，单位：Mbps。当 ThresType=1，即`配置类型`为`攻击带宽阈值`时生效。取值范围：0~1,000,000，默认为 100。
Pps	Integer	否	`0`	自定义告警包速率阈值，单位：pps。当 ThresType=2，即`配置类型`为`攻击包速率阈值`时生效。取值范围：0~450,000,000，默认为 50,000。
ThresType	Integer	否	`1`	配置类型。 0：恢复默认值，即攻击带宽 100 Mbps 或攻击包速率 50,000 pps 时触发告警。 1：自定义攻击带宽阈值。 2：自定义攻击包速率阈值。

BandWidth

Integer

否

1000

自定义告警攻击带宽阈值，单位：Mbps。
当 ThresType=1，即配置类型为攻击带宽阈值时生效。
取值范围：0~1,000,000，默认为 100。

Pps

Integer

否

0

自定义告警包速率阈值，单位：pps。
当 ThresType=2，即配置类型为攻击包速率阈值时生效。
取值范围：0~450,000,000，默认为 50,000。

ThresType

Integer

否

1

配置类型。

0：恢复默认值，即攻击带宽 100 Mbps 或攻击包速率 50,000 pps 时触发告警。
1：自定义攻击带宽阈值。
2：自定义攻击包速率阈值。

返回参数

无。

请求示例

POST https://open.volcengineapi.com/?Action=UpdateAtkAlarmThreshold&Version=2021-06-15&InstanceIp=1.1.1.1
Host: https://open.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20240610T082509Z
X-content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240610/cn-beijing/AdvDefence/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f
{
  "ThresType": 1,
  "BandWidth": 1000
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240715114310****37FC5D66C8A17FFD",
        "Action": "UpdateAtkAlarmThreshold",
        "Version": "2021-06-15",
        "Service": "AdvDefence",
        "Region": "cn-beijing"
    }
}