文档中心

Web应用防火墙

Bot 管理

UpdateDynamicTokenConfig - 更新动态令牌配置

更新指定域名下的动态令牌配置。

注意事项

服务接口调用总上限：1000 QPS

单账号调用上限：50 QPS

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：UpdateDynamicTokenConfig

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

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

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

Body

ProjectName String 可选示例值：default

项目名称，用于关联当前资源对应的项目，仅可关联当前身份下具有权限的项目。项目名称可通过调用ListProjectResources接口获取，也可调用CreateProject接口创建新的项目。默认值为default。

Action String 可选示例值：observe

指定动态令牌检测后的动作策略。支持的取值如下所示：

observe：观察；

block：拦截；

js：js挑战；

captcha：人机验证。

DetectionPath String[] 可选示例值：-

指定需要进行动态令牌检测的路径列表，支持通配符 *，通配符在一个路径中仅可使用一次。

Enable Integer 可选示例值：1

动态令牌配置的启用状态。支持的取值如下所示：

0：禁用动态令牌配置；

1：启用动态令牌配置。

Host String 必选示例值：1203.volcwaf001.com

指定需要更新动态令牌配置的目标域名。

Region String 必选示例值：cn-beijing

云 WAF 实例所在区域。

华北 2（北京）：cn-beijing

华东 2（上海）：cn-shanghai

华南 1（广州）：cn-guangzhou

中国香港：cn-hongkong

亚太东南（柔佛）：ap-southeast-1

Asia Pacific (Johor)：ap-southeast-1

Asia Pacific (Jakarta)：ap-southeast-3

China (Hong Kong)：cn-hongkong

Edge：byteplus-global

ValidityPeriod Integer 可选示例值：30

动态令牌的有效时长，单位为：秒，支持范围为 15～60。

返回参数

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

错误码

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

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=UpdateDynamicTokenConfig&Version=2023-12-25&ProjectName=default
X-Date: 20230711T035055Z
Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-shanghai/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8***
{
  "ProjectName": "default",
  "ValidityPeriod": 30,
  "DetectionPath": [
    "/test.html"
  ],
  "Action": "observe",
  "Enable": 1,
  "Host": "1203.volcwaf001.com",
  "Region": "cn-shanghai"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20231009200242CE25C146B591DDCE****",
        "Action": "UpdateDynamicTokenConfig",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": null
}

最近更新时间：2026.06.03 17:05:18

这个页面对您有帮助吗？

有用

无用