CreateNas – Создание новой точки доступа

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

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

name

Имя точки

^[a-zA-Z0-9_-]{1,32}$

Текст английскими буквами разного регистра без пробелов и спецсимволов длиной до 32-х символов. Допускаются цифры, знаки тире и нижнее подчеркивание.

domain

Домен области видимости точки

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

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

secret

Ключ для работы с сервером RADIUS

^[a-zA-Z0-9]{0,60}$

Текст английскими буквами разного регистра без пробелов и спецсимволов длиной до 60-ти символов. Допускаются цифры.

decsr

Описание точки

.{0,200}$

До 200 любых символов.

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

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

code

Код ответа

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

detail

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

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

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

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

30

Нет IP-адреса или он не верен
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.300</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>wifi.root</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            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:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

8

Нет домена или домен не соответствует правилам
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain></xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            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:CreateNasResponse>
    </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:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>test1.root</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            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:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

31

Нет обязательного поля secret или оно некорректно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>wifi.root</xsd:domain>
            <xsd:secret></xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>31</ns:code>
                <ns:detail>Incorrect field 'secret'</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

33

Нет обязательного поля name или оно не соответствует правилам
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name></xsd:name>
            <xsd:domain>wifi.root</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>33</ns:code>
                <ns:detail>Incorrect field 'name'</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

32

Поле descr содержит больше 200 символов
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>wifi.root</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifidddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>32</ns:code>
                <ns:detail>Incorrect field 'descr'</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

5

Nas уже существует
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>wifi.root</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>5</ns:code>
                <ns:detail>NAS with ip '192.168.201.160' already exists</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Домен роли не имеет прав на домен NAS
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:CreateNas>
            <xsd:ip>192.168.201.16</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>wifi</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            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: 'wifi'. Role`s domains: 'root'</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен
Запрос
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>18</ns:code>
                <ns:detail>Failed to send http request: The host did not accept the connection within timeout of 5000 ms</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

3

Ошибка от сервиса NBI EMS
Запрос
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>3</ns:code>
                <ns:detail>Error from EMS server: code 208, message 'For action 'restartRadius' no handler.'</ns:detail>
            </ns:return>
        </ns:CreateNasResponse>
    </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:CreateNas>
            <xsd:ip>192.168.201.160</xsd:ip>
            <xsd:name>test</xsd:name>
            <xsd:domain>wifi.root</xsd:domain>
            <xsd:secret>password</xsd:secret>
            <xsd:descr>TDwifi</xsd:descr>
        </xsd:CreateNas>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:CreateNasResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail/>
            </ns:return>
        </ns:CreateNasResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.20-2055
Дата публикации 13-08-2021 02:44:15