RetrieveRadiusUserAccountTimeStatistics - Запрос статистики по учетной записи Wi-Fi клиента по временному интервалу

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

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

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

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

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

username

Логин аккаунта Wi-Fi пользователя.

^.{1,64}$

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

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

domain

Домен аккаунта Wi-Fi пользователя.

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

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

Domain

timeStart

Поле для поиска по времени активности в формате «yyyy-MM-ddTHH:mm:ss±HH:MM». Время окончания сессии не может быть раньше этого параметра. Может быть пустым.

.*

Время по стандарту "ISO 8601" в формате «yyyy-MM-ddTHH:mm:ss±HH:MM», например "2008-11-15T22:52:58+03:00"

timeEnd

Поле для поиска повремени активности в формате «yyyy-MM-ddTHH:mm:ss±HH:MM». Время начала сессии не может быть позже этого параметра. Может быть пустым.

.*

Время по стандарту "ISO 8601" в формате «yyyy-MM-ddTHH:mm:ss±HH:MM», например "2008-11-15T22:52:58+03:00"

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

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

code

Код ответа

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

detail

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

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

response

Объект NbiAccountStatistics. Поля inputPacketsDrop, inputBytesDrop, outputBytesDrop не используются.

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

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

20

Некорректный логин аккаунта
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>???</nbi:username>
            <nbi:domain>guest.13019013.KL.RT.root</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd></nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.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>
                <ax26:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

8

Некорректный домен аккаунта
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>79003545038</nbi:username>
            <nbi:domain>??</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd></nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>8</ax21:code>
                <ax21:detail>Domain '??' does not conform to the rules FQDN</ax21:detail>
                <ax26:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Данный домен не зарегистрирован в системе ELTEX_EMS
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>79003545038</nbi:username>
            <nbi:domain>ru</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd></nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.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>
                <ax26:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </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:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>79003545038</nbi:username>
            <nbi:domain>root</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd></nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.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>
                <ax26:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </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:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>79003545038</nbi:username>
            <nbi:domain>root</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd></nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.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 '79003545038' [ 'root' ]</ax21:detail>
                <ax26:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

107

Некорректный временной промежуток
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>79003545038</nbi:username>
            <nbi:domain>guest.13019013.KL.RT.root</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd>2014-10-15T22:52:58+03:00</nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>107</ax21:code>
                <ax21:detail>Time start must be before time end.</ax21:detail>
                <ax26:response xsi:nil="true"/>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </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:RetrieveRadiusUserAccountTimeStatistics>
            <nbi:username>79003545038</nbi:username>
            <nbi:domain>guest.13019013.KL.RT.root</nbi:domain>
            <nbi:timeStart>2014-11-15T22:52:58+03:00</nbi:timeStart>
            <nbi:timeEnd></nbi:timeEnd>
        </nbi:RetrieveRadiusUserAccountTimeStatistics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAccountTimeStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax26:NbiCodeAccountStatisticsResponse"
                xmlns:ax215="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax212="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax223="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax29="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax218="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>0</ax21:code>
                <ax21:detail/>
                <ax26:response xsi:type="ax26:NbiAccountStatistics">
                    <ax26:domain>guest.13019013.KL.RT.root</ax26:domain>
                    <ax26:inputBytesDrop xsi:nil="true"/>
                    <ax26:inputOctets>8387662</ax26:inputOctets>
                    <ax26:inputPacketsDrop xsi:nil="true"/>
                    <ax26:mac>D8-55-A3-D7-AB-65</ax26:mac>
                    <ax26:mac>A0-8D-16-77-B4-5B</ax26:mac>
                    <ax26:outputBytesDrop>7814</ax26:outputBytesDrop>
                    <ax26:outputOctets>50492311</ax26:outputOctets>
                    <ax26:outputPacketLost xsi:nil="true"/>
                    <ax26:outputPacketsDrop xsi:nil="true"/>
                    <ax26:sessionTime>2732</ax26:sessionTime>
                    <ax26:sessionsCount>5</ax26:sessionsCount>
                    <ax26:username>79003545038</ax26:username>
                </ax26:response>
            </ns:return>
        </ns:RetrieveRadiusUserAccountTimeStatisticsResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.29-3249
Дата публикации 21-12-2023 02:50:11