创建攻击惩罚规则
功能介绍
创建攻击惩罚规则
URI
POST /v1/{project_id}/waf/policy/{policy_id}/punishment
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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 | 内容类型 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| category | 是 | String | 攻击惩罚类别 |
| block_time | 是 | Integer | 拦截时间，如果选择前缀为long的攻击惩罚类别，则block_time时长范围设置为301-1800;选择前缀为short的攻击惩罚类别，则block_time时长范围为0-300之间 |
| description | 否 | String | 规则描述 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 规则id |
| policyid | String | 所属策略id |
| block_time | Integer | 拦截时间 |
| category | String | 攻击惩罚类别 |
| description | String | 规则描述 |
| timestamp | Long | 创建规则时间戳 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
请求示例
在项目id为project_id，防护策略id为policy_id的防护策略下创建攻击惩罚规则，攻击惩罚规则的攻击惩罚规则为“long_ip_block”，拦截时间为1233秒，规则描述为“demo"。
POST https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/punishment?
{
"category" : "long_ip_block",
"block_time" : "1233",
"description" : "demo"
} 响应示例
状态码：200
请求成功
{
"block_time" : 1233,
"category" : "long_ip_block",
"description" : "demo",
"id" : "2c3afdcc982b429da4f72ee483aece3e",
"policyid" : "2fcbcb23ef0d48d99d24d7dcff00307d",
"timestamp" : 1668148186106
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求失败 |
| 401 | token权限不足 |
| 500 | 服务器内部错误 |
错误码
请参见错误码。
