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:
カスタム・フィルター条件を使用する相関を作成します。このとき式ID "A" または "B" は任意に選択されています。
条件タイプは演算子 "<>" で "ホストグループ" とします。
Request:
{
"jsonrpc": "2.0",
"method": "correlation.create",
"params": {
"name": "new host group correlation",
"description": "a custom description",
"status": 0,
"filter": {
"evaltype": 3,
"formula": "A or B",
"conditions": [
{
"type": 2,
"operator": 1,
"formulaid": "A"
},
{
"type": 2,
"operator": 1,
"formulaid": "B"
}
]
},
"operations": [
{
"type": 1
}
]
},
"auth": "343baad4f88b4106b9b5961e77437688",
"id": 1
}
Response:
CCorrelation::create() in ui/include/classes/api/services/CCorrelation.php.