文档中心

Web应用防火墙

日志管理

ModifyTLSConfig - 修改日志配置

修改日志参数配置，例如是否开启容量告警、告警阈值大小，告警时间间隔、日志存储时长以及采集域名和字段范围等。

注意事项

关于日志服务的其他操作，例如检索和下载日志等，可参考日志服务相关接口文档日志管理 API。

日志服务相关 API 暂不支持通过火山 SDK 调用。

请求说明

请求方式：POST

请求地址：https://waf.volcengineapi.com/?Action=ModifyTLSConfig&Version=2023-12-25

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action String 必选示例值：ModifyTLSConfig

接口名称。当前 API 的名称为 ModifyTLSConfig。

Version String 必选示例值：2023-12-25

接口版本。当前 API 的版本为 2023-12-25。

Body

AlarmThreshold Integer 可选示例值：80

日志容量告警阈值，为总日志容量的百分比。例如，当告警阈值设置为80时，表示当日志存储已使用量级到达日志容量的80%时，平台会推送告警通知。

CapacityAlert Boolean 可选示例值：true

是否启用容量告警。

true：启用。

false：不启用。

CapacityAlertInterval Integer 可选示例值：10

告警间隔时间，单位：天，范围为1～90天。

DomainList String[] 可选示例值：["example.volcwaf001.com"]

已选域名采集范围。

FieldList Object 可选示例值：-

可选采集字段。

Cookie Boolean 可选示例值：true

采集 Cookie 字段信息。

true：采集。

false：不采集。

RequestBody Boolean 可选示例值：true

采集请求体信息。

true：采集。

false：不采集。

RuleDescription Boolean 可选示例值：true

采集规则描述。

true：采集。

false：不采集。

RuleName Boolean 可选示例值：true

采集规则名称。

true：采集。

false：不采集。

FieldSelectAll Boolean 可选示例值：true

选中全部可选字段。

true：全部选中。

false：未全部选中。

TLSStorageTime Integer 可选示例值：180

日志存储时长，单位：天，范围为30～3650天。

WafActionList Object 可选示例值：-

可选处置动作。

AnswerOpt Boolean 可选示例值：true

采集触发“答案优化”动作的日志。

true：采集。

false：不采集。

Block Boolean 可选示例值：true

采集触发“拦截”动作的日志。

true：采集。

false：不采集。

Drop Boolean 可选示例值：true

采集触发“丢弃”动作的日志。

true：采集。

false：不采集。

HumanVerify Boolean 可选示例值：true

采集触发“人机验证”动作的日志。

true：采集。

false：不采集。

HumanVerifyBlock Boolean 可选示例值：true

采集触发“人机验证-拦截”动作的日志。

true：采集。

false：不采集。

JS Boolean 可选示例值：true

采集触发“JS 挑战”动作的日志。

true：采集。

false：不采集。

JSBlock Boolean 可选示例值：true

采集触发“JS 挑战-拦截”动作的日志。

true：采集。

false：不采集。

Observe Boolean 可选示例值：true

采集触发“观察”动作的日志。

true：采集。

false：不采集。

Pass Boolean 可选示例值：true

采集未触发防护规则的访问请求日志。

true：采集。

false：不采集。

Permit Boolean 可选示例值：true

采集触发“例外”动作的日志。

true：采集。

false：不采集。

Pow Boolean 可选示例值：true

采集触发“工作量证明”动作的日志。

true：采集。

false：不采集。

PowBlock Boolean 可选示例值：true

采集触发“工作量证明-拦截”动作的日志。

true：采集。

false：不采集。

WafActionSelectAll Boolean 可选示例值：true

选中全部处置动作。

ProjectName String 可选示例值：default

项目名称，即为当前资源关联对应项目，仅可关联当前身份下具有权限的项目。

项目名称获取方式参考ListProjectResources - 获取项目资源列表。

您也可以调用CreateProject - 创建项目创建新的项目。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

错误码

您可访问公共错误码，获取更多错误码信息。

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=ModifyTLSConfig&Version=2023-12-25

{
    "AlarmThreshold": 80,
    "CapacityAlert": true,
    "CapacityAlertInterval": 10,
    "DomainList": [
        "example.volcwaf001.com"
    ],
    "FieldList": {
        "Cookie": true,
        "RuleName": true,
        "RequestBody": true,
        "RuleDescription": true
    },
    "FieldSelectAll": true,
    "TLSStorageTime": 180,
    "WafActionList": {
        "JS": true,
        "Pow": true,
        "Drop": true,
        "Pass": true,
        "Block": true,
        "Permit": true,
        "JSBlock": true,
        "Observe": true,
        "PowBlock": true,
        "AnswerOpt": true,
        "HumanVerify": true,
        "HumanVerifyBlock": true
    },
    "WafActionSelectAll": true,
    "ProjectName": "default"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ModifyTLSConfig",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    }
}

最近更新时间：2026.01.20 15:17:10

这个页面对您有帮助吗？

有用

无用