RetrieveMacsByRadiusUser – Получить полное описание пользователя со списком зарегистрированных MAC-адресов для УЗ

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

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

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

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

usernаme

Логин клиента. Уникальность аккаунта определяется по логину и домену.

^.{1,64}$

Текст до 64-х символов.

Wi-Fi пользователь

domain

Домен клиента. Уникальность определяется по логину и домену.

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

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

Domain

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

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

code

Код ответа

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

detail

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

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

response

Объект NbiRadiusUserWithMac

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

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

20

Имя пользователя некорректно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>йцу</nbi:username>
            <nbi:domain>nsk.root</nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>20</ax21:code>
                <ax21:detail>Incorrect username</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

7

Не указан домен учетной записи пользователя.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>test</nbi:username>
            <nbi:domain></nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>7</ax21:code>
                <ax21:detail>In request by key 'domain' value is empty or null</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

8

Домен не удовлетворяет правилам FQDN.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>test</nbi:username>
            <nbi:domain>123!</nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>8</ax21:code>
                <ax21:detail>Domain '123!' does not conform to the rules FQDN</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Указанный домен не зарегистрирован.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>test</nbi:username>
            <nbi:domain>ru</nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>62</ax21:code>
                <ax21:detail>Such domain 'ru' is not registered in ELTEX_EMS.DOMAINS</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Пользователь, выполняющий операцию, не имеет прав на указанный домен.
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>test</nbi:username>
            <nbi:domain>root</nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>10</ax21:code>
                <ax21:detail>Role have no rights on domain 'root'</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

11

Такого пользователя не существует
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>tes</nbi:username>
            <nbi:domain>nsk.root</nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>11</ax21:code>
                <ax21:detail>No such RADIUS user 'tes' [ 'nsk.root' ]</ax21:detail>
                <ax21:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

0

Успешно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveMacsByRadiusUser>
            <nbi:username>test</nbi:username>
            <nbi:domain>nsk.root</nbi:domain>
        </nbi:RetrieveMacsByRadiusUser>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveMacsByRadiusUserResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserWithMacsResponse"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>0</ax21:code>
                <ax21:detail/>
                <ax21:response xsi:type="ax21:NbiRadiusUserWithMacs">
                    <ax21:clientCrtLink/>
                    <ax21:domain>nsk.root</ax21:domain>
                    <ax21:name>test</ax21:name>
                    <ax21:password>123</ax21:password>
                    <ax21:tariffCode/>
                    <ax21:check xsi:type="ax21:NbiAttrArray">
                        <ax21:attr xsi:type="ax21:NbiAttr">
                            <ax21:name>Cleartext-Password</ax21:name>
                            <ax21:oper>:=</ax21:oper>
                            <ax21:value>123</ax21:value>
                        </ax21:attr>
                    </ax21:check>
                    <ax21:common xsi:type="ax21:NbiAttrArray"/>
                    <ax21:reply xsi:type="ax21:NbiAttrArray">
                        <ax21:attr xsi:type="ax21:NbiAttr">
                            <ax21:name>Eltex-User-Create-Date</ax21:name>
                            <ax21:oper>=</ax21:oper>
                            <ax21:value>2016-11-10 15:31:46</ax21:value>
                        </ax21:attr>
                    </ax21:reply>
                    <ax21:mac xsi:type="ax21:NbiMacExpiresInfo">
                        <ax21:expiresTime>2018-01-01T00:00:00.000+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-10T16:56:02.493+07:00</ax21:lastActivityTime>
                        <ax21:mac>aa:bb:cc:dd:ee:00</ax21:mac>
                    </ax21:mac>
                    <ax21:mac xsi:type="ax21:NbiMacExpiresInfo">
                        <ax21:expiresTime>2018-01-01T00:00:00.000+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-10T16:56:11.156+07:00</ax21:lastActivityTime>
                        <ax21:mac>aa:bb:cc:dd:ee:01</ax21:mac>
                    </ax21:mac>
                    <ax21:mac xsi:type="ax21:NbiMacExpiresInfo">
                        <ax21:expiresTime>2018-01-01T00:00:00.000+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-10T16:56:15.223+07:00</ax21:lastActivityTime>
                        <ax21:mac>aa:bb:cc:dd:ee:02</ax21:mac>
                    </ax21:mac>
                </ax21:response>
            </ns:return>
        </ns:RetrieveMacsByRadiusUserResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.21-2344
Дата публикации 22-12-2021 05:34:48