template.massupdate

Описание

object template.massupdate(параметры объекта)

Этот метод позволяет одновременно заменить или удалить связанные объекты и обновить свойства в нескольких шаблонах.

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

Параметры

(object) Параметры, содержащие IDs шаблонов для обновления и объекты для замены для шаблонов.

Метод принимает следующие параметры.

Parameter Type Description
templates object/array Шаблоны для обновления.

Шаблоны должны содержать только свойство templateid.

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

Группы шаблонов должны содержать только свойство groupid.
macros object/array Пользовательские макросы для замены всех текущих пользовательских макросов в указанных шаблонах.
templates_clear object/array Шаблоны для отвязки и очистки от указанных шаблонов.

Шаблоны должны содержать только свойство templateid.
templates_link object/array Шаблоны для замены текущих связанных шаблонов.

Шаблоны должны содержать только свойство templateid.

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

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

Примеры

Отвязка шаблона

Отвяжите и очистите шаблон "10091" от указанных шаблонов.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10085"
            },
            {
                "templateid": "10086"
            }
        ],
        "templates_clear": [
            {
                "templateid": "10091"
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10085",
            "10086"
        ]
    },
    "id": 1
}

Замена пользовательских макросов

Замените все пользовательские макросы указанным пользовательским макросом в нескольких шаблонах.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "template.massupdate",
    "params": {
        "templates": [
            {
                "templateid": "10074"
            },
            {
                "templateid": "10075"
            },
            {
                "templateid": "10076"
            },
            {
                "templateid": "10077"
            }
        ],
        "macros": [
            {
                "macro": "{$AGENT.TIMEOUT}",
                "value": "5m",
                "description": "Тайм-аут, после которого агент считается недоступным. Работает только для агентов, доступных с сервера/прокси Zabbix (пассивный режим)."
            }
        ]
    },
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "templateids": [
            "10074",
            "10075",
            "10076",
            "10077"
        ]
    },
    "id": 1
}

См. также

Источник

CTemplate::massUpdate() в ui/include/classes/api/services/CTemplate.php.