文档中心

Web应用防火墙

Bot 管理

GetDynamicTokenConfig - 获取动态令牌配置

获取指定域名下的动态令牌配置。

注意事项

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

单账号调用上限：50 QPS

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：GetDynamicTokenConfig

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

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

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

Body

ProjectName String 可选示例值：default

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

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

返回参数

Action String 示例值：observe

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

observe：观察；

block：拦截；

js：js挑战；

captcha：人机验证。

DetectionPath String[] 示例值：["/test.html"]

检测路径。

Enable Integer 示例值：1

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

1：启用；

0：禁用。

RuleTag String 示例值：T000000055659

规则标识。

ValidityPeriod Integer 示例值：30

动态令牌配置的有效期。

VerificationExemptionTime Integer 示例值：0

人机验证、JS 挑战、工作量证明验证成功后的豁免时间。

错误码

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

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=GetDynamicTokenConfig&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***
{
  "Host": "1203.volcwaf001.com",
  "Region": "cn-shanghai"
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20260526183004749D94210582B9B9179E",
        "Action": "GetDynamicTokenConfig",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-shanghai"
    },
    "Result": {
        "Enable": 1,
        "ValidityPeriod": 30,
        "DetectionPath": [
            "/test.html"
        ],
        "Action": "observe",
        "RuleTag": "T000000055659",
        "VerificationExemptionTime": 0
    }
}

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

这个页面对您有帮助吗？

有用

无用