批量更新自定义IPS规则的动作 - BatchUpdateCustomerIpsAction
功能介绍
批量更新自定义IPS规则的动作
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前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 |
错误码
请参见错误码。
