SetSSIDByMac – Установить SSID на точку доступа по MAC-адресу

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

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

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

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

nasMac

MAC-адрес точки доступа

^([0-9a-fA-F]{2}[:-]){5}([0-9a-fA-F]{2})$

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

AP

ssidName

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

Имя SSID

ssidDomain

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

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

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

Domain

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

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

code

Код ответа

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

detail

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

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

response

Идентификатор связки

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

taskId

Идентификатор созданной асинхронной задачи

Целое положительное число (может быть несколько)

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

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

8

Нет домена или домен не соответствует правилам
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByMac>
            <xsd:nasMac>a8:f9:4b:1f:f3:e0</xsd:nasMac>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain></xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>8</ns:code>
                <ns:detail>Domain '' does not conform to the rules FQDN</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Домен роли не имеет прав на домен SSID
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByMac>
            <xsd:nasMac>a8:f9:4b:1f:f3:e0</xsd:nasMac>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain>root</xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>10</ns:code>
                <ns:detail>The role of the user does not have rights to this domain: 'root'. Role`s domains: 'enterprise.root test.root hotspot.root'</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Домен не зарегистрирован
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByMac>
            <xsd:nasMac>a8:f9:4b:1f:f3:e0</xsd:nasMac>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain>1.root</xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>62</ns:code>
                <ns:detail>Such '1.root' is not registered in ELTEX_EMS.DOMAINS</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

227

Имя SSID не задано или не удовлетворяет требованиям
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:SetSSIDByMac>
            <nbi:nasMac>00:11:22:33:44:55</nbi:nasMac>
            <nbi:ssidName>SSID12 </nbi:ssidName>
            <nbi:ssidDomain>root</nbi:ssidDomain>
        </nbi:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax23:NbiCodeAsyncTasksResponse"
                xmlns:ax218="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://statistics.object.nbi.radius.eltex.org/xsd"
                xmlns:ax227="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xmlns:ax236="http://domains.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax28="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax224="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax221="http://apList.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax233="http://urlFilters.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax230="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax26="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://object.nbi.radius.eltex.org/xsd">
                <ax23:code>227</ax23:code>
                <ax23:detail>Incorrect SSID name</ax23:detail>
                <ax23:response/>
                <ax23:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен
Запрос
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>18</ns:code>
                <ns:detail>Failed to send http request: The host did not accept the connection within timeout of 5000 ms</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

3

Ошибка от сервиса NBI EMS
Запрос
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>3</ns:code>
                <ns:detail>Error from EMS server: code 103, message 'No handler for action'</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

63

Нет NasMac или он не верен
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByMac>
            <xsd:nasMac></xsd:nasMac>
            <xsd:ssidName></xsd:ssidName>
            <xsd:ssidDomain></xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>63</ns:code>
                <ns:detail>Incorrect field 'nasMac'</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

43

NAS уже содержит SSID
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByMac>
            <xsd:nasMac>a8:f9:4b:1f:f3:e0</xsd:nasMac>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain>enterprise.root</xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>43</ns:code>
                <ns:detail>SSID 'local[enterprise.root]' already contains NAS with mac a8:f9:4b:1f:f3:e0</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

16

SSID не существует
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByMac>
            <xsd:nasMac>a8:f9:4b:1f:f3:e0</xsd:nasMac>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain>hotspot.root</xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>16</ns:code>
                <ns:detail>No SSID with name 'local[hotspot.root]'</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </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:SetSSIDByMac>
            <xsd:nasMac>a8:f9:4b:1f:f3:e0</xsd:nasMac>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain>enterprise.root</xsd:ssidDomain>
        </xsd:SetSSIDByMac>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByMacResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail/>
                <ns:response>83</ns:response>
                <ns:taskId>1</ns:taskId>
                <ns:taskId>2</ns:taskId>
                <ns:taskId>3</ns:taskId>
            </ns:return>
        </ns:SetSSIDByMacResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.19-62
Дата публикации 16-04-2021 12:11:48