This is a translation of the original English documentation page. Help us make it better.

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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" は任意に選択されています。
条件タイプは演算子 "<>" で "ホストグループ" とします。

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:

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

参照

ソース

CCorrelation::create() in ui/include/classes/api/services/CCorrelation.php.