CreateDetectionRule - 创建检测规则

创建检测规则。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用前面加 * 表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
yundun-sas:CreateDetectionRulecreate
*DetectionRule
acs:yundun-sas::{#accountId}:detection/*

请求参数

名称类型必填描述示例值
RegionIdstring

威胁分析的数据管理中心所在地。您需要根据资产所在地域,选择管理中心所在地。取值:

  • cn-hangzhou:资产属于中国内地。
  • ap-southeast-1:资产属于海外地域。
cn-hangzhou
Langstring

返回消息的语言类型。取值:

  • zh(默认):中文。
  • en:英文。
zh
DetectionRuleNamestring

检测规则名称。

dr-ha1i09ob3zmqrs85****
DetectionRuleDescriptionstring

检测规则描述。

dr-123
DetectionRuleTypestring

检测规则类型。取值:

  • preset:预置检测规则。
  • custom:自定义检测规则。
  • custom_template:规则模版。
custom
DetectionRuleStatusstring

检测规则状态。

0
AlertTypestring

告警类型。

WebShell
AlertLevelstring

告警威胁等级。 取值:

  • 5:严重。
  • 4:高危。
  • 3:中危。
  • 2:低危。
  • 1:信息。
1
AlertTacticIdstring

告警战术阶段。

TA0042
AlertAttCkstring

告警 Att&Ck。

Discovery
DetectionExpressionTypestring

检测规则表达式类型。取值:

  • sql:SQL。
  • playbook:剧本。
sql
DetectionExpressionContentstring

检测规则表达式内容。

*|set session mode=scan;SELECT * FROM log WHERE schema = 'PROCESS_START_ACTIVITY' AND ( proc_path LIKE '%/groups' OR ( ( proc_path LIKE '%/cat' OR proc_path LIKE '%/head' OR proc_path LIKE '%/tail' OR proc_path LIKE '%/more' ) AND cmdline LIKE '%/etc/group%' ) )
LogCategoryIdstring

日志规范化类别 ID。

NETWORK_CATEGORY
LogSchemaIdstring

日志规范化方案 ID。

API_RISK_ACTIVITY
AlertSchemaIdstring

检测规则告警模版 ID。取值:

  • ALERT_ACTIVITY:其他告警。
  • EDR_ALERT_ACTIVITY:端点检测响应与告警。
  • FIREWALL_ALERT_ACTIVITY:防火墙告警。
  • WAF_ALERT_ACTIVITY:web 应用防火墙告警。
ALERT_ACTIVITY
ScheduleTypestring

调度类型。取值:

  • fixed_rate:固定间隔。
  • cron:cron 表达式。
fixed_rate
ScheduleExpressionstring

调度 Cron 表达式,ScheduleType 取值为 cron 时需填写。

0/5 * * * *
ScheduleMaxRetriesinteger

超时最大重试次数,取值 1~100

1
ScheduleBeginTimelong

调度开始时间(13 位时间戳)。

1733269771123
ScheduleWindowstring

调度窗口长度。

5m
ScheduleMaxTimeoutinteger

超时最长时间,单位秒,取值 60~1800。

60
AlertThresholdPeriodstring

告警阈值周期长度。

5m
AlertThresholdCountinteger

告警阈值次数。

10
AlertThresholdGroupstring

告警阈值字段列表,以英文逗号分隔。

alert_type,ip
IncidentAggregationTypestring

事件聚合类型。取值:

  • none:不生成事件。
  • graph_compute:图计算(预定义规则支持)。
  • expert:专家规则。
  • passthrough:告警透出(1 对 1)。
  • window:同类聚合(窗口)。
window
IncidentAggregationExpressionstring

事件聚合周期配置。

5m
PlaybookUuidstring

剧本的 UUID。

system_aliyun_clb_process_book
PlaybookParametersstring

剧本用户自定义参数。

{ "ip": { "ip": "124.23.*.*" } }
RoleForlong

管理员切换成其他成员视角的用户 ID。

113091674488****
EntityMappingsstring

实体映射配置。

[{\"NormalizationSchemaId\":\"host\",\"NormalizationFieldMappings\":[{\"NormalizationFieldName\":\"uuid\",\"MappingFieldName\":\"host\",\"NormalizationFieldType\":\"varchar\"}]}]

返回参数

名称类型描述示例值
object

返回体。

RequestIdstring

请求消息 ID。

5CC09D0C-1CD7-54BD-A853-DCB2D945****
DetectionRuleIdstring

检测规则 ID。

dr-ha1i09ob3zmqrs85****

示例

正常返回示例

JSON格式

{
  "RequestId": "5CC09D0C-1CD7-54BD-A853-DCB2D945****",
  "DetectionRuleId": "dr-ha1i09ob3zmqrs85****"
}

错误码

HTTP status code错误码错误信息
400IdempotentParameterMismatchThe request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

访问错误中心查看更多错误码。