⌂ > 🛠 Конфигурационный REST API > ⇄ Путь

secobjects : Изменение существующих объектов безопасности🔗

Предупреждение

Доступно только в лицензиях Enterprise и ULTRA.

Данный запрос может выполняться только пользователем с максимальными правами, то есть входящим в группу Старшие администраторы.

Важно

Во всех примерах указан локальный хост (localhost). При отправке реальных запросов замените его на адрес и порт сервера, на который отправляете запрос.

Параметры🔗

Параметр	Описание
ParentId	Идентификатор родительского объекта безопасности. Если поле не указать, то объект безопасности добавится к корневому объекту безопасности
Name	Название объекта безопасности
ChildObjects	Вложенные объекты безопасности. Указывайте здесь уже существующие объекты безопасности. Если объект безопасности на момент выполнения запроса был вложен в другой объект безопасности, то он будет перенесен в создаваемый объект. Объекты, содержащиеся внутри массива ChildObjects аналогичны рассматриваемому JSON-объекту
ChildChannels	Вложенные камеры. Указывайте здесь уже существующие камеры. Если камера на момент выполнения запроса была вложена в другой объект безопасности, то она будет перенесена в создаваемый объект. Смотрите описание JSON-объектов, содержащихся внутри массива ChildChannels ниже

Описание объектов, содержащихся в массиве ChildChannels:

Параметр	Описание
Id	Обязательный параметр. Идентификатор камеры, содержащейся внутри соответствующего объекта безопасности

Пример запроса🔗

PUT http://localhost:8080/configure/secobjects

Пример PUT-запроса запроса🔗

Примечание

Тело PUT-запроса должно содержать JSON-объекты, соответствующие объектам безопасности (см. /configure/secobjects/{secobject-id} : Настройки объекта безопасности).

Пример тела PUT-запроса, изменяющего 2 объекта безопасности:

[
    {
        "Name": "Renamed object 1"
    "Id": "7169e12e-5a50-41d0-bd7f-bd57f5d1f042"
    },
    {
        "Name": "Renamed object 2",
    "Id": "1a8e582b-7b72-4224-bd15-61334575a4d6",
        "ChildObjects": [
                {
                    "Id": "7169e12e-5a50-41d0-bd7f-bd57f5d1f042",
                }
        ],
        "ChildChannels": [
                {
                    "Id": "7d69e586-25c6-470e-a368-5570d57b2631",
                }
        ]
    }
]

Примечание

Для изменения нескольких объектов безопасности используется PUT-запрос, но он изменяет не весь массив объектов безопасности (т.е. изменяются не все существующие объекты безопасности), а лишь объекты безопасности, для которых указаны идентификаторы. Это является отступлением от rest, но позволяет удобно изменять сразу несколько объектов безопасности.