maintenance.update

Описание

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

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

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

Параметры

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

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

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

Parameter Type Description
groups object/array Группы узлов сети, которые заменят текущие группы.

Группы узлов сети должны содержать только свойство groupid.

Поведение параметра:
- required если hosts не задан
hosts object/array Узлы сети, которые заменят текущие узлы сети.

Узлы сети должны содержать только свойство hostid.

Поведение параметра:
- required если groups не задан
timeperiods object/array Периоды времени обслуживания, которые заменят текущие периоды.
tags object/array Теги проблемы, которые заменят текущие теги.

Поведение параметра:
- supported если maintenance_type объекта обслуживания установлен в "with data collection"
groupids
(deprecated)		 array Этот параметр устарел, пожалуйста, используйте вместо него groups.
Идентификаторы групп узлов сети, которые будут переведены на обслуживание.
hostids
(deprecated)		 array Этот параметр устарел, пожалуйста, используйте вместо него hosts.
Идентификаторы узлов сети, которые будут переведены на обслуживание.

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

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

Примеры

Назначение других узлов сети

Замените узлы сети, которые в настоящее время назначены на обслуживание, на два других.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "maintenance.update",
    "params": {
        "maintenanceid": "3",
        "hosts": [
            {"hostid": "10085"},
            {"hostid": "10084"}
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "maintenanceids": [
            "3"
        ]
    },
    "id": 1
}

См. также

Источник

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