Table of Contents
相关性 object
以下objects与correlation API直接相关。
关联
关联object具有以下属性。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| correlationid | ID | 关联的ID。 属性行为: - 只读 - update操作中必填 |
| name | string | 关联的名称。 属性行为: - create操作中必填 |
| description | string | 关联的描述。 |
| status | integer | 关联是否启用或禁用。 可能的值: 0 - (默认) 启用; 1 - 禁用。 |
关联操作
关联操作object定义了执行关联时将执行的操作。它具有以下属性。
关联过滤器
关联过滤器object定义了一组必须满足的条件才能执行配置的关联操作. 它具有以下属性.
| 属性 | 数据类型 | 描述 |
|---|---|---|
| conditions | array | 用于过滤结果的过滤条件集合. 条件将按其公式中放置的顺序进行排序. 属性行为: - 必填 |
| evaltype | integer | 过滤条件评估方法. 可能的值: 0 - 与/或; 1 - 与; 2 - 或; 3 - 自定义表达式. 属性行为: - 必填 |
| eval_formula | string | 用于评估过滤条件的生成表达式. 该表达式包含通过formulaid引用特定过滤条件的ID. 对于具有自定义表达式的过滤器,eval_formula的值等于formula的值.属性行为: - 只读 |
| formula | string | 用于评估具有自定义表达式的过滤器条件的用户定义表达式. 该表达式必须包含通过formulaid引用特定过滤条件的ID. 表达式中使用的ID必须与过滤条件中定义的ID完全匹配: 不能有任何条件未被使用或遗漏.属性行为: - 必填 如果 evaltype设置为"自定义表达式" |
关联过滤条件
关联过滤器条件object定义了在执行关联操作前必须检查的特定条件。
| 属性 | 数据类型 | 描述 |
|---|---|---|
| type | integer | 条件类型。 可选值: 0 - 旧事件标签; 1 - 新事件标签; 2 - 新事件主机组; 3 - 事件标签对; 4 - 旧事件标签值; 5 - 新事件标签值。 属性行为: - 必填 |
| tag | string | 事件标签(旧或新)。 属性行为: - 必填 如果 type设置为"旧事件标签"、"新事件标签"、"旧事件标签值"或"新事件标签值" |
| groupid | ID | 主机组ID。 属性行为: - 必填 如果 type设置为"新事件主机组" |
| oldtag | string | 旧事件标签。 属性行为: - 必填 如果 type设置为"事件标签对" |
| newtag | string | 旧事件标签。 属性行为: - 必填 如果 type设置为"事件标签对" |
| value | string | 事件标签(旧或新)值。 属性行为: - 必填 如果 type设置为"旧事件标签值"或"新事件标签值" |
| formulaid | string | 用于从自定义表达式引用该条件的任意唯一ID。只能包含大写字母。修改过滤条件时必须由用户定义该ID，但在后续请求时会重新生成。 |
| operator | integer | 条件运算符。 属性行为: - 必填 如果 type设置为"新事件主机组"、"旧事件标签值"或"新事件标签值" |
要更好地理解如何将过滤器与各种表达式类型配合使用，请参阅 correlation.get和 correlation.create方法 页面上的示例。
以下列出了每种条件类型支持的运算符和值。
| 条件 | 条件名称 | 支持的运算符 | 期望值 |
|---|---|---|---|
| 2 | Host group | =, <> | 主机组 ID。 |
| 4 | Old event tag value | =, <>, like, not like | string |
| 5 | New event tag value | =, <>, like, not like | string |