修改自定义规则 - UpdateCustomRuleConfig

功能介绍

修改自定义规则

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

URI

PUT /v5/{project_id}/custom/rule/config

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID。约束限制: 不涉及取值范围: 字符长度1-256位默认取值: 不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释: 用户Token，包含了用户的身份、权限等信息，在调用API接口时，可通过Token进行身份认证。获取方式请参见获取用户Token。约束限制: 不涉及取值范围: 字符长度1-32768位默认取值: 不涉及

表3 请求Body参数
参数	是否必选	参数类型	描述
rule_name	是	String	参数解释：规则名称约束限制：不涉及取值范围：字符长度1-64位默认取值：不涉及
is_all_host	否	Boolean	参数解释: 是否选择所有主机约束限制: 不涉及取值范围: true：是 false：否默认取值: false
custom_rule_value_info	是	CustomRuleValueInfo object
agent_ids	否	Array of strings	参数解释: agent列表约束限制: 不涉及取值范围: 1-1000个agentID 默认取值: 不涉及
rule_id	是	String	参数解释：规则ID 约束限制：必填取值范围：字符长度1-36位默认取值：不涉及

表4 CustomRuleValueInfo
参数	是否必选	参数类型	描述
rule_type	是	String	参数解释：规则类型约束限制：必填取值范围： black_hash：黑hash 默认取值：不涉及
hash_type	是	String	参数解释： hash类型约束限制：必填取值范围： SHA-256：sha256sum MD5：md5sum SHA-1：sha1sum 默认取值：不涉及
auto_block	是	Integer	参数解释：是否自动阻断告警约束限制：必填取值范围： 0：不自动阻断告警 1：自动阻断告警默认取值：不涉及
rule_values	是	Array of strings	参数解释：规则集列表约束限制: 必填取值范围: 1-1000个规则值默认取值: 不涉及

响应参数

状态码：200

请求已成功

无

请求示例

修改自定义规则

PUT https://{endpoint}/v5/{project_id}/custom/rule/config

{
  "rule_name" : "rule_name1",
  "rule_id" : "47421976-688d-41be-b70a-6ed126231611",
  "custom_rule_value_info" : {
    "rule_values" : [ "08a7baa28dd268f8a12bc1f6fd95869321fe51144c5bf3321a6f6305edcd5245" ],
    "hash_type" : "sha256",
    "rule_type" : "black_hash",
    "auto_block" : 1
  },
  "agent_ids" : [ "af08124fd77581dcd2a5f7cdaa208c285af0a1480f7ca9b5258193c021ca2636" ]
}