RetrieveRadiusUserTimeStatistics - Запрос статистики по сессиям учётной записи

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

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

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

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

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

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

Массив объектов NbiAcct

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

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

69

Некорректное значение поля username
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserTimeStatisics>
            <nbi:username></nbi:username>
            <nbi:domain>enterprise.root</nbi:domain>
            <nbi:timeStart>2015-12-24T09:31:27</nbi:timeStart>
            <nbi:timeEnd>2015-12-30T09:31:27</nbi:timeEnd>
        </nbi:RetrieveRadiusUserTimeStatisics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserTimeStatisicsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeAcctResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>69</ax21:code>
                <ax21:detail>Username is null or absent.</ax21:detail>
                <ax21:response xsi:type="ax21:NbiAcctArray"/>
            </ns:return>
        </ns:RetrieveRadiusUserTimeStatisicsResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

107

Некорректный временной период. timeStart больше timeEnd
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusUserTimeStatisics>
            <nbi:username>kirill.mishustin</nbi:username>
            <nbi:domain>enterprise.root</nbi:domain>
            <nbi:timeStart>2015-12-30T09:31:27</nbi:timeStart>
            <nbi:timeEnd>2015-12-24T09:31:27</nbi:timeEnd>
        </nbi:RetrieveRadiusUserTimeStatisics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserTimeStatisicsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeAcctResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>107</ax21:code>
                <ax21:detail>Incorrect time period. Time start must be before time end.</ax21:detail>
                <ax21:response xsi:type="ax21:NbiAcctArray"/>
            </ns:return>
        </ns:RetrieveRadiusUserTimeStatisicsResponse>
    </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:RetrieveRadiusUserTimeStatisics>
            <nbi:username>kirill.mishustin</nbi:username>
            <nbi:domain>enterprise.root</nbi:domain>
            <nbi:timeStart>2015-12-24T18:14:55</nbi:timeStart>
            <nbi:timeEnd>2015-12-24T18:14:56</nbi:timeEnd>
        </nbi:RetrieveRadiusUserTimeStatisics>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserTimeStatisicsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiCodeAcctResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://request.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:NbiAcctArray">
                    <ax21:acct xsi:type="ax21:NbiAcct">
                        <ax21:authentic>RADIUS</ax21:authentic>
                        <ax21:connectionInfoStart>CONNECT 0Mbps 802.11g</ax21:connectionInfoStart>
                        <ax21:connectionInfoStop>CONNECT 0Mbps 802.11g</ax21:connectionInfoStop>
                        <ax21:domain>enterprise.root</ax21:domain>
                        <ax21:framedAddress>192.168.40.106</ax21:framedAddress>
                        <ax21:framedProtocol/>
                        <ax21:groupname/>
                        <ax21:inputBytesDrop>0</ax21:inputBytesDrop>
                        <ax21:inputOctets>2081</ax21:inputOctets>
                        <ax21:inputPacketsDrop>0</ax21:inputPacketsDrop>
                        <ax21:nasDomain xsi:nil="true"/>
                        <ax21:nasIP>192.168.40.10</ax21:nasIP>
                        <ax21:nasMac>A8-F9-4B-B0-03-C1:Eltex-Local</ax21:nasMac>
                        <ax21:nasPortId>0</ax21:nasPortId>
                        <ax21:nasPortType>Wireless-802.11</ax21:nasPortType>
                        <ax21:nasSecret xsi:nil="true"/>
                        <ax21:outputBytesDrop>0</ax21:outputBytesDrop>
                        <ax21:outputOctets>7257</ax21:outputOctets>
                        <ax21:outputPacketLost>0</ax21:outputPacketLost>
                        <ax21:outputPacketsDrop>0</ax21:outputPacketsDrop>
                        <ax21:realm/>
                        <ax21:serviceType/>
                        <ax21:sessionId>4FC6719E-538D5E41</ax21:sessionId>
                        <ax21:sessionTime>36</ax21:sessionTime>
                        <ax21:startDelay>0</ax21:startDelay>
                        <ax21:startTime>2015-12-24T18:14:55.000+06:00</ax21:startTime>
                        <ax21:stopDelay>0</ax21:stopDelay>
                        <ax21:stopTime>2015-12-24T18:15:31.000+06:00</ax21:stopTime>
                        <ax21:terminateCause>User-Request</ax21:terminateCause>
                        <ax21:uniqueId>87c33d9a5a602481</ax21:uniqueId>
                        <ax21:userMAC>C0-EE-FB-03-3C-80</ax21:userMAC>
                        <ax21:username>kirill.mishustin</ax21:username>
                        <ax21:xascendSessionSvrKey/>
                    </ax21:acct>
                </ax21:response>
            </ns:return>
        </ns:RetrieveRadiusUserTimeStatisicsResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.19-67
Дата публикации 07-05-2021 17:25:19