action.get

Описание

целое число/массив action.get(объект параметры)

Этот метод позволяет получать действия в соответствии с заданными параметрами.

Параметры

(объект) Параметры задают желаемый вывод.

Этот метод поддерживает следующие параметры.

Параметр	Тип	Тип
actionids	строка/массив	Возврат действий только с заданными ID.
groupids	строка/массив	Возврат только тех действий, которые используют заданные группы узлов сети в условиях действия.
hostids	строка/массив	Возврат только тех действий, которые используют заданные узлы сети в условиях действий.
triggerids	строка/массив	Возврат только тех действий, которые используют заданные триггеры в условиях действий.
mediatypeids	строка/массив	Возврат только тех действий, которые используют заданные способы оповещения для отправки сообщений.
usrgrpids	строка/массив	Возврат только тех действий, которые настроены на отправку сообщений заданным группам пользователей.
userids	строка/массив	Возврат только тех действий, которые настроены на отправку сообщений заданным пользователям.
scriptids	строка/массив	Возврат только тех действий, которые настроены на выполнение заданных скриптов.
selectFilter	запрос	Возврат фильтра действия в свойстве `filter`.
selectOperations	запрос	Возврат операций действия в свойстве `operations`.
sortfield	строка/массив	Сортировка результата в соответствии с заданными свойствами. Возможные значения: `actionid`, `name` и `status`.
countOutput	флаг	Эти параметры являются общими для всех методов `get` и они описаны в справочных комментариях.
editable	логический
excludeSearch	флаг
filter	объект
limit	целое число
output	запрос
preservekeys	флаг
search	объект
searchByAny	логический
searchWildcardsEnabled	логический
sortorder	строка/массив
startSearch	флаг

Возвращаемые значения

(целое число/массив) Возвращает либо:

массив объектов;
количество найденных объектов, если используется параметр countOutput.

Примеры

Получение действий на обнаружение

Получение всех добавленных действий на обнаружение вместе с условиями и операциями действия. Фильтр использует "и" тип вычисления, таким образом свойство formula пустое и eval_formula генерируется автоматически.

Запрос:

{
           "jsonrpc": "2.0",
           "method": "action.get",
           "params": {
               "output": "extend",
               "selectOperations": "extend",
               "selectFilter": "extend",
               "filter": {
                   "eventsource": 1
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Ответ:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "actionid": "2",
                   "name": "Auto discovery. Linux servers.",
                   "eventsource": "1",
                   "status": "1",
                   "esc_period": "0",
                   "def_shortdata": "",
                   "def_longdata": "",
                   "recovery_msg": "0",
                   "r_shortdata": "",
                   "r_longdata": "",
                   "filter": {
                       "evaltype": "0",
                       "formula": "",
                       "conditions": [
                           {
                               "conditiontype": "10",
                               "operator": "0",
                               "value": "0",
                               "formulaid": "B"
                           },
                           {
                               "conditiontype": "8",
                               "operator": "0",
                               "value": "9",
                               "formulaid": "C"
                           },
                           {
                               "conditiontype": "12",
                               "operator": "2",
                               "value": "Linux",
                               "formulaid": "A"
                           }
                       ],
                       "eval_formula": "A and B and C"
                   },
                   "operations": [
                       {
                           "operationid": "1",
                           "actionid": "2",
                           "operationtype": "6",
                           "esc_period": "0",
                           "esc_step_from": "1",
                           "esc_step_to": "1",
                           "evaltype": "0",
                           "opconditions": [],
                           "optemplate": [
                               {
                                   "operationid": "1",
                                   "templateid": "10001"
                               }
                           ]
                       },
                       {
                           "operationid": "2",
                           "actionid": "2",
                           "operationtype": "4",
                           "esc_period": "0",
                           "esc_step_from": "1",
                           "esc_step_to": "1",
                           "evaltype": "0",
                           "opconditions": [],
                           "opgroup": [
                               {
                                   "operationid": "2",
                                   "groupid": "2"
                               }
                           ]
                       }
                   ]
               }
           ],
           "id": 1
       }

Смотрите также

Исходный код

CAction::get() в frontends/php/include/classes/api/services/CAction.php.

Documentation