event.acknowledge

説明

object event.acknowledge(object/array parameters)

このメソッドはイベントを更新するためのものです。以下の更新アクションを実行できます:

イベントのクローズ。イベントがすでに解決済みの場合、このアクションはスキップされます。
イベントのアクノレッジ。イベントがすでにアクノレッジされている場合、このアクションはスキップされます。
イベントのアクノレッジ解除。イベントがアクノレッジされていない場合、このアクションはスキップされます。
メッセージの追加。
イベントの深刻度の変更。イベントがすでに同じ深刻度の場合、このアクションはスキップされます。
イベントの抑制。イベントがすでに抑制されている場合、このアクションはスキップされます。
イベントの抑制解除。イベントが抑制されていない場合、このアクションはスキップされます。

トリガーイベントのみが更新できます。
問題イベントのみが更新できます。
イベントをクローズしたり、イベントの深刻度を変更するには、トリガーに対する読み書き権限が必要です。
イベントをクローズするには、トリガーで手動クローズが許可されている必要があります。

このメソッドは、すべての種類のユーザーが利用できます。
メソッドの呼び出し権限は、ユーザーロールの設定で取り消すことができます。詳細はユーザーロールを参照してください。

パラメータ

(object/array) イベントのIDと実行する更新操作を含むパラメータ。

パラメータ	タイプ	説明
eventids	ID/array	承認するイベントのID。パラメータの動作: - 必須
action	integer	イベントの更新アクション。可能なビットマップ値: 1 - 問題をクローズ; 2 - イベントを承認; 4 - メッセージを追加; 8 - 深刻度を変更; 16 - イベントの承認を解除; 32 - イベントを抑制; 64 - イベントの抑制を解除; 128 - イベントのランクを原因に変更; 256 - イベントのランクを症状に変更。このフィールドはビットマスクです。可能なビットマップ値の任意の合計が許容されます（例: 34はイベントの承認と抑制）。パラメータの動作: - 必須
cause_eventid	ID	原因イベントのID。パラメータの動作: - `action`に「イベントのランクを症状に変更」ビットが含まれている場合は必須
message	string	メッセージのテキスト。パラメータの動作: - `action`に「メッセージを追加」ビットが含まれている場合は必須
severity	integer	イベントの新しい深刻度。可能な値: 0 - 未分類; 1 - 情報; 2 - 警告; 3 - 軽度; 4 - 高度; 5 - 障害。パラメータの動作: - `action`に「深刻度を変更」ビットが含まれている場合は必須
suppress_until	integer	イベントを抑制するUnixタイムスタンプ。 "0"に設定すると、抑制は無期限になります。パラメータの動作: - `action`に「イベントを抑制」ビットが含まれている場合は必須

戻り値

(object) eventids プロパティの下で更新されたイベントの ID を含むオブジェクトを返します。

例

イベントの確認

1つのイベントを確認し、メッセージを残します。

リクエスト:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": "20427",
               "action": 6,
               "message": "Problem resolved."
           },
           "id": 1
       }

レスポンス:

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

イベントの深刻度の変更

複数のイベントの深刻度を変更し、メッセージを残します。