RetrieveRadiusUserAcctData - Запрос данных аккаунтинга для Wi-Fi пользователя по ip-адресу

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

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

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

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

userIp

Адрес устройства Wi-Fi пользователя.

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

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

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

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

104

Некорректное значение поля userIp
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:RetrieveRadiusUserAcctData>
            <xsd:userIp>192.12.3</xsd:userIp>
            <xsd:timeStart></xsd:timeStart>
            <xsd:timeEnd></xsd:timeEnd>
        </xsd:RetrieveRadiusUserAcctData>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAcctDataResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>104</ns:code>
                <ns:detail>Illegal value '192.12.3' for field 'userIp'!</ns:detail>
                <ns:response/>
            </ns:return>
        </ns:RetrieveRadiusUserAcctDataResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

107

Некорректный временной период. timeStart больше timeEnd
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:RetrieveRadiusUserAcctData>
            <xsd:userIp>100.12.3.3</xsd:userIp>
            <xsd:timeStart>2014-12-01T00:00:00+03:00</xsd:timeStart>
            <xsd:timeEnd>2014-11-01T00:00:00+03:00</xsd:timeEnd>
        </xsd:RetrieveRadiusUserAcctData>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAcctDataResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>107</ns:code>
                <ns:detail>Incorrect time period. Time start must be before time end.</ns:detail>
                <ns:response/>
            </ns:return>
        </ns:RetrieveRadiusUserAcctDataResponse>
    </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:RetrieveRadiusUserAcctData>
            <xsd:userIp>100.16.1.16</xsd:userIp>
            <xsd:timeStart>2014-12-01T00:00:00+03:00</xsd:timeStart>
            <xsd:timeEnd></xsd:timeEnd>
        </xsd:RetrieveRadiusUserAcctData>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusUserAcctDataResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail>1000 items from 163152</ns:detail>
                <ns:response>
                    <ns:acct>
                        <ns:authentic>RADIUS</ns:authentic>
                        <ns:connectionInfoStart>CONNECT 0Mbps 802.11g</ns:connectionInfoStart>
                        <ns:connectionInfoStop>CONNECT 0Mbps 802.11g</ns:connectionInfoStop>
                        <ns:domain>enterprise.root</ns:domain>
                        <ns:framedAddress>100.16.1.16</ns:framedAddress>
                        <ns:framedProtocol/>
                        <ns:groupname/>
                        <ns:inputBytesDrop>0</ns:inputBytesDrop>
                        <ns:inputOctets>0</ns:inputOctets>
                        <ns:inputPacketsDrop>0</ns:inputPacketsDrop>
                        <ns:nasDomain>root</ns:nasDomain>
                        <ns:nasIP>192.168.40.30</ns:nasIP>
                        <ns:nasMac>A8-F9-4B-B0-04-80:Eltex-Local</ns:nasMac>
                        <ns:nasPortId>0</ns:nasPortId>
                        <ns:nasPortType>Wireless-802.11</ns:nasPortType>
                        <ns:nasSecret>eltex</ns:nasSecret>
                        <ns:outputBytesDrop>0</ns:outputBytesDrop>
                        <ns:outputOctets>0</ns:outputOctets>
                        <ns:outputPacketLost>0</ns:outputPacketLost>
                        <ns:outputPacketsDrop>0</ns:outputPacketsDrop>
                        <ns:realm>enterprise</ns:realm>
                        <ns:serviceType/>
                        <ns:sessionId>1A049FB9-5830074B</ns:sessionId>
                        <ns:sessionTime>67</ns:sessionTime>
                        <ns:startDelay>0</ns:startDelay>
                        <ns:startTime>2014-11-30T14:18:57.000+03:00</ns:startTime>
                        <ns:stopDelay>0</ns:stopDelay>
                        <ns:stopTime>2014-12-01T17:35:44.000+07:00</ns:stopTime>
                        <ns:terminateCause/>
                        <ns:uniqueId>6cd7f5179d688aa2</ns:uniqueId>
                        <ns:userMAC>74-DE-2B-FD-59-D9</ns:userMAC>
                        <ns:username>victor.fedkovich</ns:username>
                        <ns:xascendSessionSvrKey/>
                    </ns:acct>
                </ns:response>
            </ns:return>
        </ns:RetrieveRadiusUserAcctDataResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.29-3315
Дата публикации 01-02-2024 12:35:34