action.update

Описание

object action.update(объект/массив actions)

Этот метод позволяет обновлять существующие действия.

Этот метод доступен только для пользователей, имеющих типы Администратор и Супер-администратор. Права вызывать этот метод могут быть отменены в настройках роли пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(object/array) Свойства действия, которые необходимо обновить.

Свойство actionid должно быть определено для каждого действия, все остальные свойства необязательны. Будут обновлены только переданные свойства, все остальные останутся без изменений.

В дополнение к стандартным свойствам действия, метод принимает следующие параметры.

Параметр Тип Описание
filter object Объект фильтра действия для замены текущего фильтра.
operations array Операции действия для замены существующих операций.
recovery_operations array Операции восстановления действия для замены существующих операций восстановления.

Поведение параметра:
- поддерживается, если eventsource объекта Action object установлен в "event created by a trigger", "internal event" или "event created on service status update"
update_operations array Операции обновления действия для замены существующих операций обновления.

Поведение параметра:
- поддерживается, если eventsource объекта Action object установлен в "event created by a trigger" или "event created on service status update"

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

(object) Возвращает объект, содержащий ID обновленных действий под свойством actionids.

Примеры

Деактивация действия

Деактивировать действие, то есть, выставить его статус в "1".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "action.update",
    "params": {
        "actionid": "2",
        "status": "1"
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "actionids": [
            "2"
        ]
    },
    "id": 1
}

См. также

Источник

CAction::update() в ui/include/classes/api/services/CAction.php.