SetRuleByIp – Однократное назначение правила инициализации на уже инициализированное устройство по IP-адресу с целью переконфигурации

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

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

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

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

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], разделенных точкой.

ruleName

Имя правила инициализации.

.*

Любые символы

ruleDomain

Домен правила.

(?=^.{1,235}$)(^((?!-|_|.*(__|--).*)[a-zA-Z0-9_\-]{1,63}\.)*((?!-|_|.*(__|--).*)[a-zA-Z0-9_\-]{1,63})$)

Текст длиной до 235 символов, удовлетворяющий правилам FQDN.

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

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

code

Код ответа

Целое неотрицательное число.

detail

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

Текст английскими буквами с пробелами и спецсимволами.

Примеры команд и кодов

Код Описание ошибки

8

Домен правила или домен узла не соответствует правилам
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName>test2</xsd:ruleName>
            <xsd:ruleDomain></xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>8</ns:code>
                <ns:detail>Domain '' does not conform to the rules FQDN</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Домен роли не имеет прав на домен правила
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName>test2</xsd:ruleName>
            <xsd:ruleDomain>root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>10</ns:code>
                <ns:detail>The role of the user does not have rights to this domain: 'root'. Role`s domains: 'enterprise.root test.root hotspot.root'</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Домен не зарегистрирован
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName>test2</xsd:ruleName>
            <xsd:ruleDomain>test1.root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>62</ns:code>
                <ns:detail>Such 'test1.root' is not registered in ELTEX_EMS.DOMAINS</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

30

IP-адрес отсутствует или не удовлетворяет формату
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip></xsd:ip>
            <xsd:ruleName>test45</xsd:ruleName>
            <xsd:ruleDomain>enterprise.root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>30</ns:code>
                <ns:detail>Incorrect field 'ip'</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

54

Нет правила инициализации с таким именем и доменом
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName>test45</xsd:ruleName>
            <xsd:ruleDomain>enterprise.root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>54</ns:code>
                <ns:detail>No Rules with name test45[enterprise.root]</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

52

Отсутствует имя правила инициализации
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName></xsd:ruleName>
            <xsd:ruleDomain>enterprise.root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>52</ns:code>
                <ns:detail>Incorrect field 'ruleName'</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

3

Ошибка от сервера EMS
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName>test2</xsd:ruleName>
            <xsd:ruleDomain>enterprise.root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>3</ns:code>
                <ns:detail>Error from EMS server: code 1, message 'Роль пользователя не имеет прав на домен '[ DomainObj : name = 100010101; descr = ; id = 7; parentId = 1; fullName param = null; child size = 0 ]'. Домены роли: ' enterprise.root test.root hotspot.root''</ns:detail>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

0

Успешно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetRuleByIp>
            <xsd:ip>192.168.0.5</xsd:ip>
            <xsd:ruleName>test2</xsd:ruleName>
            <xsd:ruleDomain>enterprise.root</xsd:ruleDomain>
        </xsd:SetRuleByIp>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetRuleByIpResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail/>
            </ns:return>
        </ns:SetRuleByIpResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.23-2695
Дата публикации 02-09-2022 11:42:18