CreateTreeObject — создать объект в дереве

Общая информация

  1. Команда актуальна, начиная с версии 1.22.

Входные параметры

Параметр Значение Формат значения Расшифровка формата Ссылка

pid

Уникальный идентификатор родительского узла в дереве

int

type

Тип объекта

String

Типы и подтипы объектов в дереве

subtype

Подтип объекта

String

Это поле необязательно для объектов, не имеющих подтипа, например узлов (NODE).

Типы и подтипы объектов в дереве

name

Имя объекта

String

В именах объектов запрещены символы %, \, ', ", `, пробелы, а также буквы кириллицы.

В именах узлов запрещены символы %, \, ', ". Также недопустимы имена, состоящие только из пробелов.

ip

IP-адрес объекта

^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$

4 целых числа в диапазоне [0…255], разделённых точкой.

Если тип объекта NODE, это поле не используется и необязательно.

nodeDomain

Домен объекта

String

Необязательный параметр. Может быть указан при создании объекта типа NODE.

Если домен указан, то он должен быть дочерним по отношению к домену узла, в котором создаётся объект.

Выходные параметры

Параметр Значение Формат значения

response

ID (уникальный идентификатор) нового объекта

int

code

Код ответа

int

detail

Пояснение к ответу

String

Коды ответа

Код Описание

0

Успешно

3

Ошибка EMS-NBI

10

Нет прав на указанный домен

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен

30

Некорректное значение поля ip

33

Некорректное значение поля name

45

Неизвестный ответ от EMS сервера

281

Не найден обязательный параметр запроса

304

Несовместимый домен

416

Не найден объект в дереве

540

ID родительского объекта не является числом

999

Системная ошибка

Пример использования

Запрос
<soapenv:Envelope>
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:CreateTreeObject>
            <nbi:pid>1</nbi:pid>
            <nbi:type>WEP</nbi:type>
            <nbi:subtype>-12ac</nbi:subtype>
            <nbi:name>Test_Access_Point</nbi:name>
            <nbi:ip>10.25.96.115</nbi:ip>
        </nbi:CreateTreeObject>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<ns:CreateTreeObjectResponse>
    <ns:return xsi:type="ax21:NbiCodeResponse">
        <ax21:code>0</ax21:code>
        <ax21:detail>Success</ax21:detail>
        <ax21:response>5</ax21:response>
    </ns:return>
</ns:CreateTreeObjectResponse>

См. также

Вернуться к списку команд
Версия 1.26-3053
Дата публикации 31-03-2023 06:03:06