service.update

Описание

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

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

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

Параметры

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

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

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

Параметр Type Описание
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.