EditTreeObject - Редактировать параметры объекта дерева
Общая информация
-
Команда для редактирования объекта дерева по его ID.
-
Команда актуальна, начиная с версии 1.22.
Входные параметры
| Параметр | Значение | Формат значения | Расшифровка формата | Ссылка |
|---|---|---|---|---|
id |
Уникальный идентификатор объекта дерева |
Integer |
Целое неотрицательное число |
|
params |
Параметры объекта дерева |
NbiParameterArray |
Основные характеристики объекта (имя, тип, подтип) и параметры доступа, название которых можно посмотреть на странице со всеми параметрами объекта дерева. |
Редактируемые параметры устройства
| Параметр | Значение | Формат значения | Расшифровка формата |
|---|---|---|---|
name |
Имя объекта дерева |
String |
В именах объектов дерева, кроме узлов, запрещены символы |
type |
String |
Редактирование типа не поддержано. |
|
subtype |
String |
Редактирование подтипа не поддержано. |
Также редактируются параметры доступа объекта дерева.
Список параметров доступа определяется в зависимости от типа и подтипа объекта (совпадает с тем, что отображается в EMS GUI на вкладке 'Доступ').
Корректные названия параметров можно посмотреть в разделе Атрибуты объекта дерева.
Выходные параметры
| Параметр | Значение | Формат значения |
|---|---|---|
code |
Код ответа |
int |
detail |
Пояснение к ответу |
String |
Коды ответа
| Код | Описание |
|---|---|
0 |
Успешно |
3 |
Ошибка от EMS сервера |
10 |
У роли нет прав на домен редактируемого устройства или устройство с заданным ID не существует |
45 |
Неизвестный статус ответа от EMS сервера |
281 |
Не найден обязательный параметр запроса |
502 |
У имени параметра в запросе пустое значение |
539 |
Параметр ID должен быть целым положительным числом |
541 |
Дублирующийся параметр в запросе |
999 |
Системная ошибка |
Пример использования
Запрос
<soapenv:Envelope>
<soapenv:Header/>
<soapenv:Body>
<nbi:EditTreeObject>
<nbi:id>44</nbi:id>
<nbi:params>
<xsd:parameter>
<xsd:name>name</xsd:name>
<xsd:value>WOP-2ac-LR5_E0:D9:E3:7B:84:C0</xsd:value>
</xsd:parameter>
<xsd:parameter>
<xsd:name>Port</xsd:name>
<xsd:value>162</xsd:value>
</xsd:parameter>
<xsd:parameter>
<xsd:name>IpAddress</xsd:name>
<xsd:value>10.25.96.103</xsd:value>
</xsd:parameter>
</nbi:params>
</nbi:EditTreeObject>
</soapenv:Body>
</soapenv:Envelope>Ответ
<soapenv:Envelope>
<soapenv:Body>
<ns:EditTreeObjectResponse>
<ns:return xsi:type="ax23:NbiResponse">
<ax23:code>0</ax23:code>
<ax23:detail>Success</ax23:detail>
</ns:return>
</ns:EditTreeObjectResponse>
</soapenv:Body>
</soapenv:Envelope>