correlation.create

説明

object correlation.create(object/array correlations)

この方法によって、新しい相関関係を作り出すことができます。

このメソッドは、Super admin ユーザータイプにのみ使用できます。このメソッドを呼び出す許可は、
ユーザーロール設定で取り消すことができます。詳細については、User rolesを参照してください。

パラメータ

(object/array) 作成する相関関係

standard correlation propertiesに加えて、このメソッドは以下のパラメータを受け取ることができる。

	パラメータ	Type
operations (required)	array	Correlation operations to create for the correlation.
filter (required)	object	Correlation filter object for the correlation.

戻り値

(object) 作成された相関のIDを含むオブジェクトを返す。返される ID の順序は、渡された相関関係の順序と一致する。

例

イベントタグの相関関係を新規に作成する

AND/OR`の評価方法を用いて、1つの条件と1つの操作で相関を作成します。デフォルトでは、相関は有効になっています。

Request:

{
           "jsonrpc": "2.0",
           "method": "correlation.create",
           "params": {
               "name": "new event tag correlation",
               "filter": {
                   "evaltype": 0,
                   "conditions": [
                       {
                           "type": 1,
                           "tag": "ok"
                       }
                   ]
               },
               "operations": [
                   {
                       "type": 0
                   }
               ]
           },
           "auth": "343baad4f88b4106b9b5961e77437688",
           "id": 1
       }

Response:

{
           "jsonrpc": "2.0",
           "result": {
               "correlationids": [
                   "1"
               ]
           },
           "id": 1
       }

カスタム式フィルタの使用

カスタム・フィルター条件を使用する相関を作成します。このとき式ID "A" または "B" は任意に選択されています。
条件タイプは演算子 "<>" で "ホストグループ" とします。