event.acknowledge

Опис

object event.acknowledge(object/array parameters)

Овај метод омогућава ажурирање догађаја. Следеће акције ажурирања се могу извршити:

  • Затвори догађај. Ако је догађај већ решен, ова акција ће бити прескочена.
  • Потврди догађај. Ако је догађај већ потврђен, ова акција ће бити прескочена.
  • Поништи потврду догађаја. Ако догађај није потврђен, ова акција ће бити прескочена.
  • Додај поруку.
  • Промени озбиљност догађаја. Ако догађај већ има исту озбиљност, ова акција ће бити прескочена.
  • Поништи догађај. Ако је догађај већ потиснут, ова акција ће бити прескочена.
  • Поништи потискивање догађаја. Ако догађај није потиснут, ова акција ће бити прескочена.

Могу се ажурирати само догађаји окидача.
Могу се ажурирати само проблемски догађаји.
Права читања/писања за окидач су потребна да би се догађај затворио или да би се променила озбиљност догађаја.
Да затворите догађај, ручно затварање треба да буде дозвољено у окидачу.

Ова метода је доступна корисницима било ког типа. Дозволе за позивање методе могу се опозвати у подешавањима улоге корисника. Погледајте Корисничке улоге за више информација.

Параметри

(object/array) Параметри који садрже ID-ијеве догађаја и операција ажурирања које треба извршити.

|Parameter|Type|Description| |--|--|--- ---| |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) Враћа објекат који садржи ID-ијеве ажурираних догађаја у оквиру својства eventids.

Примери

Потврда догађаја

Потврдите један догађај и оставите поруку.

Request:

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

Одговор:

{
            "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
            },
            "id": 1
       }

Одговор:

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

Извор

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