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.