RetrieveRadiusSSIDIntervalStatistics - Запрос статистики SSID разделённой по временным промежуткам

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

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

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

ssid

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

Имя SSID

domain

Домен SSID.

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

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

Domain

intervalLength

Продолжительность (в минутах) периода дискретизации статистики

Целое число от 1 до 2147483647

[multiblock cell omitted]

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	Массив объектов NbiRadiusSSIDIntervalStatisticsItem

Параметр

Значение

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

code

Код ответа

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

detail

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

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

response

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

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

Код	Описание ошибки
8	Некорректное значение поля domain

Запрос

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusSSIDIntervalStatistics>
            <nbi:ssid>Eltex-Local</nbi:ssid>
            <nbi:domain>Плохой@домен</nbi:domain>
            <nbi:intervalLength>60</nbi:intervalLength>
            <nbi:timeStart>2015-08-03T00:00:00</nbi:timeStart>
            <nbi:timeEnd>2015-08-04T00:00:00</nbi:timeEnd>
        </nbi:RetrieveRadiusSSIDIntervalStatistics>
    </soapenv:Body>
</soapenv:Envelope>

Ответ

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusSSIDIntervalStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://ssidstats.response.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>8</ax21:code>
                <ax21:detail>Domain 'Плохой@домен' does not conform to the rules FQDN</ax21:detail>
                <ax210:response xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsArray"/>
            </ns:return>
        </ns:RetrieveRadiusSSIDIntervalStatisticsResponse>
    </soapenv:Body>
</soapenv:Envelope>

Код	Описание ошибки
223	Некорректное значение поля intervalLength

Запрос

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:RetrieveRadiusSSIDIntervalStatistics>
            <nbi:ssid>Eltex-Local</nbi:ssid>
            <nbi:domain>enterprise.root</nbi:domain>
            <nbi:intervalLength>0</nbi:intervalLength>
            <nbi:timeStart>2015-08-03T00:00:00</nbi:timeStart>
            <nbi:timeEnd>2015-08-04T00:00:00</nbi:timeEnd>
        </nbi:RetrieveRadiusSSIDIntervalStatistics>
    </soapenv:Body>
</soapenv:Envelope>

Ответ

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusSSIDIntervalStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://ssidstats.response.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>223</ax21:code>
                <ax21:detail>Time interval not specified or have incorrect value</ax21:detail>
                <ax210:response xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsArray"/>
            </ns:return>
        </ns:RetrieveRadiusSSIDIntervalStatisticsResponse>
    </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:RetrieveRadiusSSIDIntervalStatistics>
            <nbi:ssid>Eltex-Local</nbi:ssid>
            <nbi:domain>enterprise.root</nbi:domain>
            <nbi:intervalLength>60</nbi:intervalLength>
            <nbi:timeStart>2015-08-05T00:00:00</nbi:timeStart>
            <nbi:timeEnd>2015-08-04T00:00:00</nbi:timeEnd>
        </nbi:RetrieveRadiusSSIDIntervalStatistics>
    </soapenv:Body>
</soapenv:Envelope>

Ответ

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusSSIDIntervalStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://ssidstats.response.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>
                <ax210:response xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsArray"/>
            </ns:return>
        </ns:RetrieveRadiusSSIDIntervalStatisticsResponse>
    </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:RetrieveRadiusSSIDIntervalStatistics>
            <nbi:ssid>Eltex-Local</nbi:ssid>
            <nbi:domain>enterprise.root</nbi:domain>
            <nbi:intervalLength>60</nbi:intervalLength>
            <nbi:timeStart>2015-08-03T05:00:00</nbi:timeStart>
            <nbi:timeEnd>2015-08-03T08:00:00</nbi:timeEnd>
        </nbi:RetrieveRadiusSSIDIntervalStatistics>
    </soapenv:Body>

Ответ

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:RetrieveRadiusSSIDIntervalStatisticsResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsResponse"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://ssidstats.response.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/>
                <ax210:response xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsArray">
                    <ax210:item xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsItem">
                        <ax210:bytesIn>0</ax210:bytesIn>
                        <ax210:bytesOut>0</ax210:bytesOut>
                        <ax210:connectionsCount>0</ax210:connectionsCount>
                        <ax210:intervalStart>2015-08-03T05:00:00.000+06:00</ax210:intervalStart>
                        <ax210:pcktsLost>0</ax210:pcktsLost>
                        <ax210:summary>false</ax210:summary>
                        <ax210:uniqMacCount>0</ax210:uniqMacCount>
                        <ax210:uniqUsersCount>0</ax210:uniqUsersCount>
                    </ax210:item>
                    <ax210:item xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsItem">
                        <ax210:bytesIn>2158000</ax210:bytesIn>
                        <ax210:bytesOut>2014706</ax210:bytesOut>
                        <ax210:connectionsCount>8</ax210:connectionsCount>
                        <ax210:intervalStart>2015-08-03T06:00:00.000+06:00</ax210:intervalStart>
                        <ax210:pcktsLost>0</ax210:pcktsLost>
                        <ax210:summary>false</ax210:summary>
                        <ax210:uniqMacCount>2</ax210:uniqMacCount>
                        <ax210:uniqUsersCount>2</ax210:uniqUsersCount>
                    </ax210:item>
                    <ax210:item xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsItem">
                        <ax210:bytesIn>95868</ax210:bytesIn>
                        <ax210:bytesOut>297031</ax210:bytesOut>
                        <ax210:connectionsCount>9</ax210:connectionsCount>
                        <ax210:intervalStart>2015-08-03T07:00:00.000+06:00</ax210:intervalStart>
                        <ax210:pcktsLost>0</ax210:pcktsLost>
                        <ax210:summary>false</ax210:summary>
                        <ax210:uniqMacCount>6</ax210:uniqMacCount>
                        <ax210:uniqUsersCount>5</ax210:uniqUsersCount>
                    </ax210:item>
                    <ax210:item xsi:type="ax210:NbiRadiusSSIDIntervalStatisticsItem">
                        <ax210:bytesIn>2253868</ax210:bytesIn>
                        <ax210:bytesOut>2311737</ax210:bytesOut>
                        <ax210:connectionsCount>17</ax210:connectionsCount>
                        <ax210:intervalStart xsi:nil="true"/>
                        <ax210:pcktsLost>0</ax210:pcktsLost>
                        <ax210:summary>true</ax210:summary>
                        <ax210:uniqMacCount>8</ax210:uniqMacCount>
                        <ax210:uniqUsersCount>7</ax210:uniqUsersCount>
                    </ax210:item>
                </ax210:response>
            </ns:return>
        </ns:RetrieveRadiusSSIDIntervalStatisticsResponse>
    </soapenv:Body>
</soapenv:Envelope>

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