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.