RetrieveRadiusUserMacs – Запрос списка привязок MAC-адресов устройств к учетным записям пользователей услуги Wi-Fi

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

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

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

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

usernаme

Фильтр по логину УЗ пользователя услуги Wi-Fi, если установлен, то выдается список аккаунтов, логин которых содержит значение данного поля. Используйте специальные символы ? (один символ) и % (неограниченное кол-во символов).

^.{1,64}$

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

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

domain

Домен клиента, может быть пустым. Если домен начинается с символа ".", то в выборку включаются все поддомены, иначе только данный конкрентный домен.

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

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

Domain

mac

Фильтр по MAC-адресу устройства пользователя услуги Wi-Fi. Используйте специальные символы ? (один символ) и % (неограниченное кол-во символов).

.*

6 двузначных шестнадцатеричных чисел, разделенных ':'.

count

Кол-во выводимых элементов, обязательно.

^[1-9][0-9]*$

Целое положительное число

page

Номер страницы, порции выдаваемых элементов, обязательно.

^[1-9][0-9]*$

Целое положительное число

orderBy

Поле, определяющее, по какому элементу сортировать выдаваемые данные.

.*

user_name, user_domain, mac, last_activity или expires

orderType

Поле определяющее тип сортировки. (По умолчанию ASC)

^(ASC|DESC)$

ASC или DESC

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

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

code

Код ответа

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

detail

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

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

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

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

112

Количество элементов не передано или является неположительным числом
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserMacs>
            <nbi:username></nbi:username>
            <nbi:domain></nbi:domain>
            <nbi:mac></nbi:mac>
            <nbi:count>-1</nbi:count>
            <nbi:page></nbi:page>
            <nbi:orderBy></nbi:orderBy>
            <nbi:orderType></nbi:orderType>
        </nbi:RetrieveRadiusUserMacs>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserMacsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserMacExpiresInfo"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://tariff.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://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://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>112</ax21:code>
                <ax21:detail>Count must be positive integer</ax21:detail>
                <ax21:response xsi:type="ax21:NbiRadiusUserMacExpiresInfoArray">
                    <ax21:item xsi:nil="true"/>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserMacsResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

113

Номер страницы не передан или является неположительным числом
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserMacs>
            <nbi:username></nbi:username>
            <nbi:domain></nbi:domain>
            <nbi:mac></nbi:mac>
            <nbi:count>10</nbi:count>
            <nbi:page>-1</nbi:page>
            <nbi:orderBy></nbi:orderBy>
            <nbi:orderType></nbi:orderType>
        </nbi:RetrieveRadiusUserMacs>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserMacsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserMacExpiresInfo"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://tariff.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://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://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>113</ax21:code>
                <ax21:detail>Page must be positive integer</ax21:detail>
                <ax21:response xsi:type="ax21:NbiRadiusUserMacExpiresInfoArray">
                    <ax21:item xsi:nil="true"/>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserMacsResponse>
    </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:RetrieveRadiusUserMacs>
            <nbi:username>%a%</nbi:username>
            <nbi:domain>.`123</nbi:domain>
            <nbi:mac></nbi:mac>
            <nbi:count>10</nbi:count>
            <nbi:page>2</nbi:page>
            <nbi:orderBy>user_name</nbi:orderBy>
            <nbi:orderType>DESC</nbi:orderType>
        </nbi:RetrieveRadiusUserMacs>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserMacsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserMacExpiresInfo"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://tariff.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://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://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:type="ax21:NbiRadiusUserMacExpiresInfoArray">
                    <ax21:item xsi:nil="true"/>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserMacsResponse>
    </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:RetrieveRadiusUserMacs>
            <nbi:username>%a%</nbi:username>
            <nbi:domain>.ru</nbi:domain>
            <nbi:mac></nbi:mac>
            <nbi:count>10</nbi:count>
            <nbi:page>2</nbi:page>
            <nbi:orderBy>user_name</nbi:orderBy>
            <nbi:orderType>DESC</nbi:orderType>
        </nbi:RetrieveRadiusUserMacs>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserMacsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserMacExpiresInfo"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://tariff.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://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://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:type="ax21:NbiRadiusUserMacExpiresInfoArray">
                    <ax21:item xsi:nil="true"/>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserMacsResponse>
    </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:RetrieveRadiusUserMacs>
            <nbi:username></nbi:username>
            <nbi:domain>root</nbi:domain>
            <nbi:mac></nbi:mac>
            <nbi:count>10</nbi:count>
            <nbi:page>2</nbi:page>
            <nbi:orderBy></nbi:orderBy>
            <nbi:orderType></nbi:orderType>
        </nbi:RetrieveRadiusUserMacs>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserMacsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserMacExpiresInfo"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://tariff.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://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://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:type="ax21:NbiRadiusUserMacExpiresInfoArray">
                    <ax21:item xsi:nil="true"/>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserMacsResponse>
    </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:RetrieveRadiusUserMacs>
            <nbi:username>%a%</nbi:username>
            <nbi:domain>.root</nbi:domain>
            <nbi:mac></nbi:mac>
            <nbi:count>10</nbi:count>
            <nbi:page>2</nbi:page>
            <nbi:orderBy>user_name</nbi:orderBy>
            <nbi:orderType>DESC</nbi:orderType>
        </nbi:RetrieveRadiusUserMacs>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserMacsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeRadiusUserMacExpiresInfo"
                xmlns:ax225="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://tariff.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://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://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>1048</ax21:detail>
                <ax21:response xsi:type="ax21:NbiRadiusUserMacExpiresInfoArray">
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:01:04.188+07:00</ax21:lastActivityTime>
                        <ax21:mac>73-e8-69-fc-1d-89</ax21:mac>
                        <ax21:domain>root</ax21:domain>
                        <ax21:username>zazRE</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:01:10.775+07:00</ax21:lastActivityTime>
                        <ax21:mac>a3-27-fe-27-c0-ed</ax21:mac>
                        <ax21:domain>barnaul.root</ax21:domain>
                        <ax21:username>zaqud</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:00:52.440+07:00</ax21:lastActivityTime>
                        <ax21:mac>fc-39-87-37-1f-8b</ax21:mac>
                        <ax21:domain>msk.root</ax21:domain>
                        <ax21:username>zaasa</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:00:46.512+07:00</ax21:lastActivityTime>
                        <ax21:mac>6c-05-31-ea-9e-2d</ax21:mac>
                        <ax21:domain>omsk.root</ax21:domain>
                        <ax21:username>zaFUq</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:00:50.451+07:00</ax21:lastActivityTime>
                        <ax21:mac>75-90-b1-ff-52-4d</ax21:mac>
                        <ax21:domain>ekb.root</ax21:domain>
                        <ax21:username>zYaGo</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:00:45.829+07:00</ax21:lastActivityTime>
                        <ax21:mac>25-f1-b3-ba-21-e0</ax21:mac>
                        <ax21:domain>tomsk.root</ax21:domain>
                        <ax21:username>zSgta</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:01:08.051+07:00</ax21:lastActivityTime>
                        <ax21:mac>21-df-3e-96-f8-12</ax21:mac>
                        <ax21:domain>omsk.root</ax21:domain>
                        <ax21:username>zPaUW</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:00:50.269+07:00</ax21:lastActivityTime>
                        <ax21:mac>ce-87-32-f0-f0-3c</ax21:mac>
                        <ax21:domain>root</ax21:domain>
                        <ax21:username>zOPaH</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:01:07.480+07:00</ax21:lastActivityTime>
                        <ax21:mac>69-1b-06-42-1d-bf</ax21:mac>
                        <ax21:domain>omsk.root</ax21:domain>
                        <ax21:username>zNavU</ax21:username>
                    </ax21:item>
                    <ax21:item xsi:type="ax21:NbiRadiusUserMacExpiresInfo">
                        <ax21:expiresTime>2017-11-09T09:00:41.175+07:00</ax21:expiresTime>
                        <ax21:lastActivityTime>2016-11-09T09:00:50.213+07:00</ax21:lastActivityTime>
                        <ax21:mac>b6-3b-80-3d-3a-80</ax21:mac>
                        <ax21:domain>barnaul.root</ax21:domain>
                        <ax21:username>zJbay</ax21:username>
                    </ax21:item>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserMacsResponse>
    </soapenv:Body>
</soapenv:Envelope>

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