SetSSIDByDomain –Установить SSID на домен ТД

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

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

  2. Начиная с версии 1.19, команда больше не создает асинхронные задачи в EMS. Идентификатор асинхронной задачи всегда равен 0. Для создания асинхронных задач исправления привязки нужно воспользоваться командой SyncSSID.

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

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

nasDomain

Домен Nas, определяющий группу точек доступа.

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

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

Domain

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:SetSSIDByDomain>
            <xsd:nasDomain></xsd:nasDomain>
            <xsd:ssidName>test7</xsd:ssidName>
            <xsd:ssidDomain>wifi.root</xsd:ssidDomain>
        </xsd:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            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:SetSSIDByDomainResponse>
    </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:SetSSIDByDomain>
            <xsd:nasDomain>wifi</xsd:nasDomain>
            <xsd:ssidName>test7</xsd:ssidName>
            <xsd:ssidDomain>wifi.root</xsd:ssidDomain>
        </xsd:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            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: 'wifi'. Role`s domains: 'root'</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Домен SSID или домен ТД не зарегистрирован
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByDomain>
            <xsd:nasDomain>test1.root</xsd:nasDomain>
            <xsd:ssidName>test7</xsd:ssidName>
            <xsd:ssidDomain>test1.root</xsd:ssidDomain>
        </xsd:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>62</ns:code>
                <ns:detail>Such 'test1.root' is not registered in ELTEX_EMS.DOMAINS</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

227

Нет обязательного поля name или оно не соответствует правилам
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:nbi="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <nbi:SetSSIDByDomain>
            <nbi:nasDomain>root</nbi:nasDomain>
            <nbi:ssidName>SSID12 </nbi:ssidName>
            <nbi:ssidDomain>root</nbi:ssidDomain>
        </nbi:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            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:SetSSIDByDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен
Запрос
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            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:SetSSIDByDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

3

Ошибка от сервиса NBI EMS
Запрос
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            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:SetSSIDByDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

43

SSID уже содержит связку с данным доменом
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:SetSSIDByDomain>
            <xsd:nasDomain>101.enterprise.root</xsd:nasDomain>
            <xsd:ssidName>local</xsd:ssidName>
            <xsd:ssidDomain>enterprise.root</xsd:ssidDomain>
        </xsd:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>43</ns:code>
                <ns:detail>SSID 'local[enterprise.root]' already contains NAS domain 101.enterprise.root</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByDomainResponse>
    </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:SetSSIDByDomain>
            <xsd:nasDomain>wifi.root</xsd:nasDomain>
            <xsd:ssidName>tes</xsd:ssidName>
            <xsd:ssidDomain>wifi.root</xsd:ssidDomain>
        </xsd:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>16</ns:code>
                <ns:detail>No SSID with name 'tes[wifi.root]'</ns:detail>
                <ns:response/>
                <ns:taskId/>
            </ns:return>
        </ns:SetSSIDByDomainResponse>
    </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:SetSSIDByDomain>
            <xsd:nasDomain>wifi.root</xsd:nasDomain>
            <xsd:ssidName>test7</xsd:ssidName>
            <xsd:ssidDomain>wifi.root</xsd:ssidDomain>
        </xsd:SetSSIDByDomain>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:SetSSIDByDomainResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail/>
                <ns:response>80</ns:response>
                <ns:taskId>1</ns:taskId>
                <ns:taskId>2</ns:taskId>
                <ns:taskId>3</ns:taskId>
            </ns:return>
        </ns:SetSSIDByDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>

Вернуться к списку команд
Версия 1.23-2695
Дата публикации 02-09-2022 11:42:18