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

Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

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
       }

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

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

Request:

{
           "jsonrpc": "2.0",
           "method": "event.acknowledge",
           "params": {
               "eventids": ["20427", "20428"],
               "action": 12,
               "message": "Maintenance required to fix it.",
               "severity": 4
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

ソース

CEvent::acknowledge() in ui/include/classes/api/services/CEvent.php.