[comment]: # translation:outdated

[comment]: # ({2ccfd922-2ccfd922})
# event.acknowledge

[comment]: # ({/2ccfd922-2ccfd922})

[comment]: # ({eed7fdda-eed7fdda})
### 説明

`object event.acknowledge(object/array parameters)`

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

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

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

::: noteclassic
このメソッドは、どのタイプのユーザーでも利用可能です。このメソッドを呼び出す許可は、ユーザーロール設定で<br>
取り消すことができます。詳しくは [User roles](/manual/web_interface/frontend_sections/administration/user_roles) をご覧ください。
:::

[comment]: # ({/eed7fdda-eed7fdda})

[comment]: # ({4f7f6cc3-32560b88})
### パラメータ

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

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

[comment]: # ({/4f7f6cc3-32560b88})

[comment]: # ({94f3ab84-94f3ab84})
### 戻り値
`(object)` `eventids` プロパティの下で更新されたイベントの ID を含むオブジェクトを返します。

[comment]: # ({/94f3ab84-94f3ab84})

[comment]: # ({b41637d2-b41637d2})
### 例

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({2a20eeea-9e923e4c})
#### イベントの確認

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

リクエスト:

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

レスポンス:

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

[comment]: # ({/2a20eeea-9e923e4c})

[comment]: # ({7d16988e-94e25d7e})
#### イベントの深刻度の変更

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

リクエスト:

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

レスポンス:

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

[comment]: # ({/7d16988e-94e25d7e})

[comment]: # ({aadd99f7-aadd99f7})
### ソース

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

[comment]: # ({/aadd99f7-aadd99f7})