IsDomainUsed – Проверка на использование домена где-либо в системе SoftWLC

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

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

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

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

parentDomain

Родительский домен

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

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

Domain

name

Имя узла домена.

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

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

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

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

code

Код ответа

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

detail

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

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

usages

Место использования (список)

Cтрока в произвольном формате

subdomains

Список поддоменов

Cтрока в произвольном формате

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

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

7

Нет родительского домена
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain></xsd:parentDomain>
            <xsd:name></xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>7</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Incorrect field 'parentDomain'</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

8

Родительский домен не соответствует правилам
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain>-123</xsd:parentDomain>
            <xsd:name></xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>8</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Domain '-123' does not conform to the rules FQDN</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </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:IsDomainUsed>
            <xsd:parentDomain>rot</xsd:parentDomain>
            <xsd:name></xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>62</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Such 'rot' is not registered in ELTEX_EMS.DOMAINS</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

33

Нет обязательного поля name или оно некорректно
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain>enterprise.root</xsd:parentDomain>
            <xsd:name></xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>33</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Incorrect field 'name'</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

67

Создаваемый домен уже существует
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain>enterprise.root</xsd:parentDomain>
            <xsd:name>test</xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>67</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Domain 'test.enterprise.root' already exists!</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

3

Ошибка от сервера EMS
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain>enterprise.root</xsd:parentDomain>
            <xsd:name>sber</xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>3</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Error from EMS server: code 103, message 'null'</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Домен роли не имеет прав на родительский домен
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain>root</xsd:parentDomain>
            <xsd:name></xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>10</ns:code>
                <ns:response>false</ns:response>
                <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:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен
Запрос
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://nbi.radius.eltex.org">
    <soapenv:Header/>
    <soapenv:Body>
        <xsd:IsDomainUsed>
            <xsd:parentDomain>enterprise.root</xsd:parentDomain>
            <xsd:name>sber</xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>18</ns:code>
                <ns:response>false</ns:response>
                <ns:detail>Failed to send http request: The host did not accept the connection within timeout of 5000 ms</ns:detail>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </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:IsDomainUsed>
            <xsd:parentDomain>enterprise.root</xsd:parentDomain>
            <xsd:name>alpha</xsd:name>
        </xsd:IsDomainUsed>
    </soapenv:Body>
</soapenv:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soapenv:Body>
        <ns:IsDomainUsedResponse
            xmlns:ns="http://org.eltex.radius.nbi/xsd">
            <ns:return>
                <ns:code>0</ns:code>
                <ns:detail/>
                <ax21:subDomains>Domain 'Guest.alpha.enterprise.root'</ax21:subDomains>
                <ns:usages>EMS role</ns:usages>
                <ns:usages>EMS device</ns:usages>
                <ns:usages>RADIUS user check attributes</ns:usages>
                <ns:usages>SSID</ns:usages>
                <ns:usages>Tariff</ns:usages>
                <ns:usages>Initialization rule</ns:usages>
                <ns:usages>System role reply attributes</ns:usages>
            </ns:return>
        </ns:IsDomainUsedResponse>
    </soapenv:Body>
</soapenv:Envelope>

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