批量更新自定义IPS规则的动作
功能介绍
批量更新自定义IPS规则的动作
调用方法
请参见如何调用API。
URI
POST /v1/{project_id}/ips/custom-rule/action
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以从调API处获取,也可以从控制台获取。项目ID获取方式 约束限制: 不涉及 取值范围: 32位UUID 默认取值: 不涉及 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action_type |
否 |
Integer |
参数解释: 自定义IPS规则执行动作,仅更新自定义IPS规则场景下需要设置,其他场景无需设置 约束限制: 不涉及 取值范围: 0:只记录日志 1:重置/拦截 默认取值: 不涉及 |
ips_ids |
是 |
Array of strings |
参数解释: ips规则ID, 可通过调用获取ips规则列表获取,通过data.records.ips_id获取。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
fw_instance_id |
是 |
String |
参数解释: 防火墙ID,用户创建防火墙实例后产生的唯一ID,配置后可区分不同防火墙,可通过防火墙ID获取方式获取 约束限制: 不涉及 取值范围: 32位UUID 默认取值: 不涉及 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
data |
data object |
参数解释: 批量操作自定义IPS规则响应数据 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
参数解释: 错误码 取值范围: 不涉及 |
error_msg |
String |
参数解释: 错误描述 取值范围: 不涉及 |
请求示例
批量更新项目id为408972e72dcd4c1a9b033e955802a36b,防火墙id为d06dad70-b3be-4480-86bc-b3d139e9938b,ips id为797d82a4-9628-4e2b-aa77-55c17ed3aeb4和ceea5743-5e1a-4221-a543-e586c03eeeca的自定义IPS规则列表的action为拦截
https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/ips/custom-rule/action { "fw_instance_id" : "d06dad70-b3be-4480-86bc-b3d139e9938b", "action_type" : 1, "ips_ids" : [ "797d82a4-9628-4e2b-aa77-55c17ed3aeb4", "ceea5743-5e1a-4221-a543-e586c03eeeca" ] }
响应示例
状态码:200
OK
{ "data" : { "id" : "bc11e773-35cc-478c-a91c-772ed077e06e" } }
状态码:400
Bad Request
{ "error_code" : "CFW.00200003", "error_msg" : "参数错误" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
错误码
请参见错误码。