service.update

Описание

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

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

Этот метод доступен пользователям любого типа. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

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

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

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

Parameter Type Description
children array Дочерние сервисы, которые заменят текущие дочерние сервисы.

У дочерних сервисов должно быть определено только свойство serviceid.
parents array Родительские сервисы, которые заменят текущие родительские сервисы.

У родительских сервисов должно быть определено только свойство serviceid.
tags array Теги сервиса, которые заменят текущие теги сервиса.
problem_tags array Теги проблемы, которые заменят текущие теги проблемы.
status_rules array Правила статуса, которые заменят текущие правила статуса.

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

(object) Возвращает объект, содержащий идентификаторы обновленных служб в свойстве serviceids.

Примеры

Установка родителя для сервиса

Сделать сервис с ID "3" родительским для сервиса с ID "5".

Запрос:

{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "5",
        "parents": [
            {
                "serviceid": "3"
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "serviceids": [
            "5"
        ]
    },
    "id": 1
}

Добавление запланированного периода недоступности

Добавьте период недоступности для сервиса с ID "4", запланированный еженедельно с понедельника 22:00 до вторника 10:00.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "service.update",
    "params": {
        "serviceid": "4",
        "times": [
            {
                "type": "1",
                "ts_from": "165600",
                "ts_to": "201600"
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "serviceids": [
            "4"
        ]
    },
    "id": 1
}

Источник

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