Zabbix Documentation 4.0

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


Sidebar

ru:manual:api:reference:screen:update

screen.update

Описание

объект screen.update(объект/массив комплексныеЭкраны)

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

Параметры

(объект/массив) Свойства комплексных экранов, которые будут обновлены.

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

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

Параметр Тип Описание
screenitems массив Элементы комплексного эркана, которые заменят существующие элементы комплексного экрана.

Элементы комплексного экрана обновляются по координатам, у каждого элемента должны быть заданы свойства x и y.
users массив Пользователь комплексного экрана, который заменит существующие разрешения на общий доступ к комплексному экрану.
userGroups массив Группа пользователей комплексного экрана, которая заменит существующие разрешения на общий доступ к комплексному экрану.

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

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

Примеры

Переименование комплексного экрана

Переименование комплексного экрана на “CPU Graphs”.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "screen.update",
    "params": {
        "screenid": "26",
        "name": "CPU Graphs"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "screenids": [
            "26"
        ]
    },
    "id": 1
}

Изменение владельца комплексного экрана

Доступно только администраторам и супер-администраторам.

Запрос:

{
    "jsonrpc": "2.0",
    "method": "screen.update",
    "params": {
        "screenid": "83",
        "userid": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}

Ответ:

{
    "jsonrpc": "2.0",
    "result": {
        "screenids": [
            "83"
        ]
    },
    "id": 2
}

Смотрите также

Исходный код

CScreen::update() в frontends/php/include/classes/api/services/CScreen.php.