创建或编辑网站业务频率控制防护(CC防护)的自定义规则。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| Domain |
string |
是 |
网站业务的域名。 说明
域名必须已配置网站业务转发规则。您可以调用 DescribeDomains 查询所有域名。 |
www.example.com |
| RuleList |
string |
是 |
频率控制规则的配置,使用 JSON 格式的字符串表述,具体结构如下。
|
[{"action":"block","name":"trdsss","statistics":{"mode":"count","field":"header","header_name":"hahah"},"ratelimit":{"interval":60,"ttl":300,"threshold":70,"target":"ip"},"status_code":{"enabled":true,"code":404,"use_ratio":true,"ratio_threshold":80,"count_threshold":2},"condition":[{"field":"ip","match_method":"belong","content":"1.1.1.1"}]}] |
| Expires |
integer |
否 |
规则有效期。单位:秒。 默认 0 表示永久生效。 |
0 |
field 和 match_method 的取值及对应关系
| 匹配字段(field) | 描述 | 适用的逻辑符(match_method) |
| ip | 访问请求的来源 IP。 | belong :属于 nbelong :不属于 ipinlist :在列表中 ipninlist :不在列表中 |
| uri | 访问请求的 URI 地址。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 prefix :前缀匹配 inlist :等于多值之一 ninlist :不等于多值之一 |
| referer | 访问请求的来源网址,即该访问请求是从哪个页面跳转产生的。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 inlist :等于多值之一 ninlist :不等于多值之一 |
| user-agent | 发起访问请求的客户端的浏览器标识、渲染引擎标识和版本信息等浏览器相关信息。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 inlist :等于多值之一 ninlist :不等于多值之一 |
| params | 访问请求的 URL 地址中的参数部分,通常指 URL 中”?”后面的部分。例如,demo.aliyundoc.com/index.html?action=login中的action=login就是参数部分。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 inlist :等于多值之一 ninlist :不等于多值之一 |
| cookie | 访问请求中的 Cookie 信息。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 inlist :等于多值之一 ninlist :不等于多值之一 |
| content-type | 访问请求指定的响应 HTTP 内容类型,即 MIME 类型信息。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 inlist :等于多值之一 ninlist :不等于多值之一 |
| x-forwarded-for | 访问请求的客户端真实 IP。X-Forwarded-For(XFF)用来识别通过 HTTP 代理或负载均衡方式转发的访问请求的客户端最原始的 IP 地址的 HTTP 请求头字段,只有通过 HTTP 代理或者负载均衡服务器转发的访问请求才会包含该项。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 inlist :等于多值之一 ninlist :不等于多值之一 |
| content-length | 访问请求的所包含的字节数。 | vless :值小于 vequal :值等于 vgreat :值大于 |
| post-body | 访问请求的内容信息。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 inlist :等于多值之一 ninlist :不等于多值之一 |
| http-method | 访问请求的方法,如 GET、POST 等。 | equal :等于 nequal :不等于 inlist :等于多值之一 ninlist :不等于多值之一 |
| header | 访问请求的头部信息,用于自定义 HTTP 头部字段。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 nexist :不存在 inlist :等于多值之一 ninlist :不等于多值之一 |
| scheme | 访问请求协议,如 HTTP、HTTPS 等。 | equal :等于 nequal :不等于 |
| protocol | 访问请求的 HTTP 版本,如 HTTP/1.0、HTTP/1.1、HTTP/2.0。 | equal :等于 nequal :不等于 inlist :等于多值之一 ninlist :不等于多值之一 |
| http2-fingerprint | 访问请求 HTTP2.0 指纹。 | equal :等于 nequal :不等于 inlist :等于多值之一 ninlist :不等于多值之一 |
| ja3-fingerprint | 访问请求 JA3 指纹 。 | equal :等于 nequal :不等于 inlist :等于多值之一 ninlist :不等于多值之一 |
| ja4-fingerprint | 访问请求 JA4 指纹 。 | equal :等于 nequal :不等于 inlist :等于多值之一 ninlist :不等于多值之一 |
| area | 请求大洲/国家 。 | areainlist :区域封禁选择 |
| uri-path | 请求 URI-Path。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 prefix :前缀匹配 inlist :等于多值之一 ninlist :不等于多值之一 |
| cookie-name | 自定义 Cookie。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 prefix :前缀匹配 inlist :等于多值之一 ninlist :不等于多值之一 |
| query-parameter | 自定义请求参数。 | contain :包含 ncontain :不包含 equal :等于 nequal :不等于 lless :长度小于 lequal :长度等于 lgreat :长度大于 prefix :前缀匹配 inlist :等于多值之一 ninlist :不等于多值之一 |
| server-port | 请求 Server-Port。 | vless :值小于 vequal :值等于 vgreat :值大于 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
本次调用请求的 ID,是由阿里云为该请求生成的唯一标识符,可用于排查和定位问题。 |
0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc |
示例
正常返回示例
JSON格式
{
"RequestId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。