文档中心

Web应用防火墙

访问管控

UpdateAreaBlockRule - 修改地理位置访问控制策略

修改地理位置访问控制策略对应的国家或地区信息。

使用说明

火山引擎 WAF 服务：使用 Country 传递国家/地区位置编码，使用 SubRegion 传递中国子地区位置编码。Country 字段取自 GetAreaBlockInfo 返回的 OverSeaAreaInfoList 中的 AreaCode，例如 ["ES"]。SubRegion 示例取自 CNAreaInfoList 中的 AreaCode，例如 ["Beijing"]。

BytePlus WAF 服务：使用 Location 传递国家/非中国大陆地区位置编码，Location 字段取自 GetAreaBlockInfo 返回的 OverSeaAreaInfoList 中的 AreaCode，例如 ["ES"]。

注意事项

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

单账号调用上限：50 QPS

请求说明

请求方式：POST

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

请求参数

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

Query

Action String 必选示例值：UpdateAreaBlockRule

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

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

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

Body

ProjectName String 可选示例值：default

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

Action String 必选示例值：observe

生效动作。支持的取值如下所示。

observe：观察；

block：拦截。

Country String[] 可选示例值：["ES"]

火山引擎 WAF 服务下使用的国家/地区编码列表，需要先调用GetAreaBlockInfo接口，在返回的OverSeaAreaInfoList中获取对应国家/地区的AreaCode后传入。

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

指定需要应用地理访问控制规则的域名。

Location String[] 可选示例值：["ES"]

BytePlus WAF 服务下使用的国家/非中国大陆地区位置编码，需要先调用GetAreaBlockInfo接口，在返回的OverSeaAreaInfoList中获取对应国家/非中国大陆地区的AreaCode后传入。

SubRegion String[] 可选示例值：["Beijing"]

火山引擎 WAF 服务下使用的国家/地区编码列表，需要先调用GetAreaBlockInfo接口，在返回的CNAreaInfoList中获取对应中国子地区位置的AreaCode后传入。

返回参数

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

错误码

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

输入示例 1

输入示例 2

输入示例

POST https://waf.volcengineapi.com/?Action=UpdateAreaBlockRule&Version=2023-12-25&ProjectName=default
X-Date: 20230711T035055Z
Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8***

{
  "Host": "example.volcwaf001.com",
  "Action": "observe",
  "Country": [
    "ES"
  ],
  "SubRegion": [
    "Beijing"
  ]
}

输出示例

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

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

这个页面对您有帮助吗？

有用

无用