{"base_path":"/","components":null,"consumes":"","definitions":{"CreateGeoIpRuleRequestBody":{"properties":{"description":{"description":"规则描述","type":"string"},"geoip":{"description":"地理位置封禁区域,选择区域对应的字母代号,用中划线|分隔,可通过ShowPolicyGeoipMap接口查询支持的区域","type":"string"},"name":{"description":"地理位置控制规则名称","type":"string"},"status":{"description":"**参数解释:**\n规则状态标识,用于指定规则的启用或关闭状态\n**约束限制:**\n不涉及\n**取值范围:**\n - 0:关闭\n - 1:开启\n**默认取值:**\n不涉及","enum":[0,1],"type":"integer"},"white":{"description":"防护动作:\n - 0 拦截\n - 1 放行\n - 2 仅记录","type":"integer"}},"required":["geoip","white"]},"CreateGeoIpRuleResponseBody":{"properties":{"description":{"description":"规则描述","type":"string"},"geoip":{"description":"地理位置封禁区域","type":"string"},"id":{"description":"规则id","type":"string"},"ip_type":{"description":"ip范围。若您的网站使用独享模式,请确认独享引擎是否全部升级到最新版本,避免造成异常。202412之后的版本支持配置IP范围","type":"string"},"name":{"description":"地理位置控制规则名称","type":"string"},"policyid":{"description":"策略id","type":"string"},"status":{"description":"**参数解释:**\n规则状态标识,用于指定规则的启用或关闭状态\n**约束限制:**\n不涉及\n**取值范围:**\n - 0:关闭\n - 1:开启\n**默认取值:**\n不涉及","enum":[0,1],"type":"integer"},"timestamp":{"description":"创建规则时间戳","format":"int64","type":"integer"},"white":{"description":"防护动作:\n - 0 拦截\n - 1 放行\n - 2 仅记录","type":"integer"}},"type":"object"},"IAM5ErrorDetails":{"description":"调用下游服务的报错信息集合,IAM5鉴权错误时才会返回此信息0。","properties":{"error_code":{"description":"下游服务错误码","type":"string"},"error_msg":{"description":"下游服务报错信息","type":"string"}}},"RestErrorResponse":{"properties":{"details":{"description":"调用下游服务的报错信息集合,IAM5鉴权错误时才会返回此字段。","items":{"$ref":"#/definitions/IAM5ErrorDetails"},"type":"array"},"encoded_authorization_message":{"description":"编码 (加密) 后的详细拒绝原因,用户可以自行调用 STS 服务的decode-authorization-message接口进行解码,可参考STS5联调自验证。IAM5鉴权错误时才会返回此字段。","type":"string"},"error_code":{"description":"错误码","type":"string"},"error_msg":{"description":"错误信息","type":"string"}},"title":"RestErrorResponse","type":"object"}},"description":null,"group_id":"29975c0bd7ce463ca70ad5c074e3974b","host":"waf.cn-north-4.myhuaweicloud.com","id":"bb555efc3c7045aa90b0295934e19b40","info_version":"v1","method":"post","name":"CreateGeoipRule","parameters":{},"paths":{"/v1/{project_id}/waf/policy/{policy_id}/geoip":{"post":{"description":"创建地理位置控制规则","operationId":"CreateGeoipRule","parameters":[{"description":"**参数解释:**\n用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。\n**约束限制:**\n不涉及\n**取值范围:**\n不涉及\n**默认取值:**\n不涉及","in":"header","maxLength":4096,"minLength":32,"name":"X-Auth-Token","required":true,"type":"string"},{"default":"application/json;charset=utf8","description":"**参数解释:**\n内容类型\n**约束限制:**\n不涉及\n**取值范围:**\n不涉及\n**默认取值:**\napplication/json;charset=utf8","in":"header","name":"Content-Type","required":true,"type":"string"},{"description":"**参数解释:**\n项目ID,对应华为云控制台用户名->我的凭证->项目列表->项目ID\n**约束限制:**\n不涉及\n**取值范围:**\n不涉及\n**默认取值:**\n不涉及","in":"path","name":"project_id","required":true,"type":"string"},{"default":"0","description":"**参数解释:**\n您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目ID。若需要查询当前用户所有企业项目绑定的资源信息,请传参all_granted_eps。\n**约束限制:**\n不涉及\n**取值范围:**\n - 0:代表default企业项目\n - all_granted_eps:代表所有企业项目\n - 其它企业项目ID:长度为36个字符\n**默认取值:**\n0","in":"query","name":"enterprise_project_id","required":false,"type":"string"},{"description":"**参数解释:**\n防护策略id,您可以通过调用查询防护策略列表(ListPolicy)获取策略id\n**约束限制:**\n不涉及\n**取值范围:**\n不涉及\n**默认取值:**\n不涉及","in":"path","name":"policy_id","required":true,"type":"string"},{"description":"创建地理访问控制请求体","in":"body","name":"CreateGeoIpRuleRequestBody","required":true,"schema":{"$ref":"#/definitions/CreateGeoIpRuleRequestBody"}}],"produces":["application/json"],"responses":{"200":{"description":"OK","examples":{"application/json":{"geoip":"SH|Afghanistan","id":"02dafa406c4941368a1037b020f15a53","name":"demo","policyid":"38ff0cb9a10e4d5293c642bc0350fa6d","status":1,"timestamp":1650534513775,"white":0}},"schema":{"$ref":"#/definitions/CreateGeoIpRuleResponseBody"}},"400":{"description":"请求失败","schema":{"$ref":"#/definitions/RestErrorResponse"}},"401":{"description":"token权限不足","schema":{"$ref":"#/definitions/RestErrorResponse"}},"500":{"description":"服务器内部错误","schema":{"$ref":"#/definitions/RestErrorResponse"}}},"summary":"创建地理位置控制规则","tags":["策略规则管理"],"x-hybridcloud":true,"x-is-registered":"Y","x-request-examples-1":{"description":"demo","geoip":"SH|Afghanistan","name":"demo","white":0},"x-request-examples-description-1":"在项目id为project_id,防护策略id为policy_id的防护策略下创建地理位置控制规则,地理位置控制规则的防护动作为拦截,规则描述为”demo“,规则名称为”demo“,地理位置封禁区域为上海和和伊拉克。","x-request-examples-text-1":{"description":"demo","geoip":"SH|Afghanistan","name":"demo","white":0},"x-request-examples-url-1":"POST https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/geoip?enterprise_project_id=0","x-support-sdk":"Y"}}},"product_short":"WAF","region_id":"cn-north-4","schemes":["HTTPS"],"security_definitions":null,"summary":"创建地理位置控制规则","tags":"策略规则管理","uri":null,"version":"2.0"}