UpdateGeoLimitPolicy-更新区域封禁规则--DDoS防护-火山引擎

文档中心

立即注册

导航

UpdateGeoLimitPolicy-更新区域封禁规则

最近更新时间：2025.05.28 18:54:51首次发布时间：2025.05.08 11:28:25

调用 UpdateGeoLimitPolicy 可以编辑需要封禁的地区。通过识别 IP 地址所属的地区，DDoS 原生防护可以帮助您拦截或者限制来自特定区域的访问速度，防止影响正常业务访问。

区域列表说明

修改地域时，需传入对应区域的 code，请确保您使用的 code 在以下列表范围内。

海外地区代码可参考ISO 3166-1 二位代码标准。例如：
- US：美国
- GB：英国
- VN：越南
国内地区代码需填写省级行政区域拼音全称，详情如下：
- Anhui: 安徽
- Beijing: 北京
- Chongqing: 重庆
- Fujian: 福建
- Gansu: 甘肃
- Guangdong: 广东
- Guangxi: 广西
- Guizhou: 贵州
- Hainan: 海南
- Hebei: 河北
- Heilongjiang: 黑龙江
- Henan: 河南
- Hubei: 湖北
- Hunan: 湖南
- InnerMongolia: 内蒙古
- Jiangsu: 江苏
- Jiangxi: 江西
- Jilin: 吉林
- Liaoning: 辽宁
- Ningxia: 宁夏
- Qinghai: 青海
- Shaanxi: 陕西
- Shandong: 山东
- Shanghai: 上海
- Shanxi: 山西
- Sichuan: 四川
- Tianjin: 天津
- Tibet: 西藏
- Xinjiang: 新疆
- Yunnan: 云南
- Zhejiang: 浙江
- Taiwan: 台湾
- HongKong: 香港
- Macau: 澳门

注意事项

调用时请将{region}替换成实际地域 ID，地域详情参见地域信息。

请求说明

请求方式：POST
请求地址：https://origin_defence.{region}.volcengineapi.com/?Action=UpdateGeoLimitPolicy&Version=2022-01-01

请求参数

Query

参数	类型	是否必选	示例值	描述
Action	String	是	`UpdateGeoLimitPolicy`	接口名称。当前 API 的名称为 `UpdateGeoLimitPolicy`。
Version	String	是	`2022-01-01`	接口版本。当前 API 的版本为 `2022-01-01`。

Body

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

参数	类型	是否必选	示例值	描述
GeoLimit	Integer	是	`10`	区域封禁限速，单位：pps。支持输入的范围：0~10000000。 0：对封禁地域的请求执行拦截动作。 1~10000000：对封禁地域的请求执行限速动作，阈值为传入的数值。
GroupName	String	是	`自定义规则组1`	规则组名称，可调用DescPolicyGroup-查询规则组详情查询。
Locations	Array of String	是	`Yunnan,US`	需要封禁的地域列表，需要传入地域对应的 code。国内地区：填写省级行政区域拼音全称。详情可参考本文使用说明中的列表，例如： Beijing：北京 Fujian：福建 Gansu：甘肃海外地区：参考ISO 3166-1 二位代码标准。例如： US：美国 GB：英国 VN：越南

GeoLimit

Integer

是

10

区域封禁限速，单位：pps。支持输入的范围：0~10000000。

0：对封禁地域的请求执行拦截动作。
1~10000000：对封禁地域的请求执行限速动作，阈值为传入的数值。

GroupName String 是 自定义规则组1 规则组名称，可调用DescPolicyGroup-查询规则组详情查询。

Locations

Array of String

是

Yunnan,US

需要封禁的地域列表，需要传入地域对应的 code。

国内地区：填写省级行政区域拼音全称。详情可参考本文使用说明中的列表，例如：
- Beijing：北京
- Fujian：福建
- Gansu：甘肃
海外地区：参考ISO 3166-1 二位代码标准。例如：
- US：美国
- GB：英国
- VN：越南

返回参数

参数	类型	示例值	描述
GroupName	String	`自定义规则组1`	规则组名称。

请求示例

POST https://origin_defence.{region}.volcengineapi.com/?Action=UpdateGeoLimitPolicy&Version=2022-01-01
{
    "GeoLimit": 10,
    "GroupName": "自定义规则组1",
    "Locations": [
        ""
    ]
}

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "UpdateGeoLimitPolicy",
        "Version": "2022-01-01",
        "Service": "origin_defence",
        "Region": "cn-beijing"
    },
    "Result": {
        "GroupName": "自定义规则组1"
    }
}