event.acknowledge

説明

object event.acknowledge(object/array parameters)

このメソッドにより、イベントを更新することができる。以下の更新操作を行うことができます:

イベントを閉じる。イベントがすでに解決されている場合、このアクションはスキップされます。
イベントを確認します。イベントがすでに確認されている場合、このアクションはスキップされます。
メッセージを追加します。
イベントの重要度を変更します。イベントの重要度がすでに同じ場合は、このアクションはスキップされます。

トリガーイベントのみ更新可能です。問題イベントのみ更新可能です。イベントを閉じる、またはイベントの重要度を
変更するには、トリガに対する読み取り/書き込み権限が必要です。イベントを閉じるには、トリガで手動によるクローズを
許可する必要があります。

このメソッドは、どのタイプのユーザーでも利用可能です。このメソッドを呼び出す許可は、ユーザーロール設定で
取り消すことができます。詳しくは User roles をご覧ください。

パラメータ

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

パラメータ	Type	説明
eventids (required)	string/object	IDs of the events to acknowledge.
action (required)	integer	Event update action(s). This is bitmask field, any combination of values is acceptable. Possible values: 1 - close problem; 2 - acknowledge event; 4 - add message; 8 - change severity; 16 - unacknowledge event.
message	string	Text of the message. Required, if action contains 'add message' flag.
severity	integer	New severity for events. Required, if action contains 'change severity' flag. Possible values: 0 - not classified; 1 - information; 2 - warning; 3 - average; 4 - high; 5 - disaster.

戻り値

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

例

イベントの確認

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

Request:

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

Response:

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

イベントの重要度を変更する

複数のイベントの重要度を変更し、メッセージを残すことができます。