correlation.update

説明

object correlation.update(object/array correlations)

このメソッドは、既存の相関関係を更新することができます。

このメソッドは、Super adminタイプのユーザーのみ利用可能です。メソッドを呼び出す権限は、ユーザーの役割の設定で取り消すことができます。詳細はユーザーの役割を参照してください。

パラメータ

(object/array) 更新する相関関係のプロパティ。

各相関関係について correlationid プロパティを定義する必要があり、 その他のプロパティはすべて任意です。渡されたプロパティのみが 更新され、その他はすべて変更されません。

このメソッドは、標準の相関関係 プロパティに加えて、以下の パラメータを受け付けます。

Parameter Type Description
filter object 現在のフィルターを置き換えるための相関関係フィルターオブジェクト。
operations array 既存の操作を置き換えるための相関関係操作

戻り値

(object) correlationids`プロパティの下で更新された相関関係IDを含むオブジェクトを返します。

相関関係の無効化

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "correlation.update",
    "params": {
        "correlationid": "1",
        "status": "1"
    },
    "id": 1
}

レスポンス:

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

評価方法を維持したままで条件の置き換え

リクエスト:

{
    "jsonrpc": "2.0",
    "method": "correlation.update",
    "params": {
        "correlationid": "1",
        "filter": {
            "conditions": [
                {
                    "type": 3,
                    "oldtag": "error",
                    "newtag": "ok"
                }
            ]
        }
    },
    "id": 1
}

レスポンス:

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

関連項目

ソース

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