调用ModifyWebPreciseAccessRule编辑网站业务精确访问控制规则。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyWebPreciseAccessRule |
要执行的操作。取值:ModifyWebPreciseAccessRule |
Domain | String | 是 | www.aliyun.com |
网站业务的域名。 说明 域名必须已配置网站业务转发规则。您可以调用DescribeDomains查询所有域名。
|
Rules | String | 是 | [{"action":"block","name":"testrule","condition":[{"field":"uri","match_method":"contain","content":"/test/123"}]}] |
精确访问控制规则的配置,使用JSON格式的字符串表述,具体结构如下。
|
RegionId | String | 否 | cn-hangzhou |
DDoS高防服务地域ID。取值:
|
ResourceGroupId | String | 否 | default |
DDoS高防实例在资源管理产品中所属的资源组ID。默认为空,即属于默认资源组。 |
Expires | Integer | 否 | 600 |
规则有效期。单位:秒。规则的匹配动作为阻断时(action为block)生效,在规则有效期内阻断访问请求。不传入该参数表示永久生效。 |
匹配字段(field) |
描述 |
适用的逻辑符(match_method) |
---|---|---|
ip |
访问请求的来源IP。 |
belong :属于 nbelong :不属于 |
uri |
访问请求的URI地址。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 regular :正则匹配 |
referer |
访问请求的来源网址,即该访问请求是从哪个页面跳转产生的。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 regular :正则匹配 |
user-agent |
发起访问请求的客户端的浏览器标识、渲染引擎标识和版本信息等浏览器相关信息。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 regular :正则匹配 |
params |
访问请求的URL地址中的参数部分,通常指URL中”?”后面的部分。例如, www.abc.com/index.html?action=login 中的 action=login 就是参数部分。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 |
cookie |
访问请求中的Cookie信息。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 |
content-type |
访问请求指定的响应HTTP内容类型,即MIME类型信息。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 |
x-forwarded-for |
访问请求的客户端真实IP。X-Forwarded-For(XFF)用来识别通过HTTP代理或负载均衡方式转发的访问请求的客户端最原始的IP地址的HTTP请求头字段,只有通过HTTP代理或者负载均衡服务器转发的访问请求才会包含该项。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 regular :正则匹配 |
content-length |
访问请求的所包含的字节数。 |
vless :值小于 vequal :值等于 vgreat :值大于 |
post-body |
访问请求的内容信息。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 regular :正则匹配 |
http-method |
访问请求的方法,如GET、POST等。 |
equal :等于 nequal :不等于 |
header |
访问请求的头部信息,用于自定义HTTP头部字段。 |
contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc |
本次请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyWebPreciseAccessRule
&Domain=www.aliyun.com
&Rules=[{"action":"block","name":"testrule","condition":[{"field":"uri","match_method":"contain","content":"/test/123"}]}]
&<公共请求参数>
正常返回示例
XML
格式
<ModifyWebPreciseAccessRuleResponse>
<RequestId>0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc</RequestId>
</ModifyWebPreciseAccessRuleResponse>
JSON
格式
{
"RequestId":"0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc"
}
错误码
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交