创建地理位置控制规则
功能介绍
创建地理位置控制规则
URI
POST /v1/{project_id}/waf/policy/{policy_id}/geoip
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID，对应控制台用户名->我的凭证->项目列表->项目ID |
policy_id | 是 | String | 防护策略id，您可以通过调用查询防护策略列表（ListPolicy）获取策略id |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
enterprise_project_id | 否 | String | 您可以通过调用企业项目管理服务（EPS）的查询企业项目列表接口（ListEnterpriseProject）查询企业项目id |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | 用户Token，通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Content-Type | 是 | String | 内容类型 缺省值：application/json;charset=utf8 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
name | 否 | String | 地理位置控制规则名称 |
geoip | 是 | String | 地理位置封禁区域： (CN： 中国,CA： 加拿大,US： 美国,AU： 澳大利亚,IN： 印度,JP： 日本,UK： 英国,FR： 法国,DE： 德国,BR： 巴西,Thailand： 泰国,Singapore： 新加坡,South Africa： 南非,Mexico： 墨西哥,Peru： 秘鲁,Indonesia： 印度尼西亚) |
white | 是 | Integer | 防护动作：
|
status | 否 | Integer | 规则状态，0：关闭，1：开启 |
description | 否 | String | 规则描述 |
响应参数
状态码： 200
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 规则id |
name | String | 地理位置控制规则名称 |
policyid | String | 策略id |
geoip | String | 地理位置封禁区域： (CN： 中国,CA： 加拿大,US： 美国,AU： 澳大利亚,IN： 印度,JP： 日本,UK： 英国,FR： 法国,DE： 德国,BR： 巴西,Thailand： 泰国,Singapore： 新加坡,South Africa： 南非,Mexico： 墨西哥,Peru： 秘鲁,Indonesia： 印度尼西亚zhao) |
white | Integer | 防护动作：
|
status | Integer | 规则状态，0：关闭，1：开启 |
timestamp | Long | 创建规则时间戳 |
状态码： 400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码： 401
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
状态码： 500
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 错误码 |
error_msg | String | 错误信息 |
请求示例
POST https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/geoip?enterprise_project_id=0
{
"white" : 0,
"description" : "demo",
"name" : "demo",
"geoip" : "SH|Afghanistan"
} 响应示例
状态码： 200
OK
{
"id" : "02dafa406c4941368a1037b020f15a53",
"policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
"name" : "demo",
"timestamp" : 1650534513775,
"description" : "demo",
"status" : 1,
"geoip" : "US",
"white" : 0,
"geoTagList" : [ "US" ]
} 状态码
状态码 | 描述 |
|---|---|
200 | OK |
400 | 请求失败 |
401 | token权限不足 |
500 | 服务器内部错误 |
错误码
请参见错误码。
