CreateDomain – Создание домена в системе SoftWLC

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

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

  2. Начиная с версии 1.19 команда также создает узел дерева (средствами EMS), если тип домена (domain_type) ap или both. Узел создается непосредственным обращением NBI в БД. Для перечитывания дерева объектов в EMS, на EMS-NBI уходит команда notifyTreeChanged. Результат выполнения команды notifyTreeChanged не влияет на итоговый результат для CreateDomain.

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

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

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-х символов. Допускаются цифры, знаки тире и нижнее подчеркивание.

decsr

Описание нового узла домена.

.{0,255}$

До 255-ти любых символов.

params

Атрибуты домена, ожидается 0 или более объектов NbiParameter.

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

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

code

Код ответа

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

detail

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

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

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

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

0

Успешно
Запрос
<soap:Envelope
    xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
    xmlns:nbi="http://nbi.radius.eltex.org"
    xmlns:xsd="http://response.object.nbi.radius.eltex.org/xsd">
    <soap:Header/>
    <soap:Body>
        <nbi:CreateDomain>
            <nbi:parentDomain>root</nbi:parentDomain>
            <nbi:name>wifi</nbi:name>
            <nbi:descr></nbi:descr>
            <nbi:params>
                <xsd:parameter>
                    <xsd:name>users_limit</xsd:name>
                    <xsd:value>100</xsd:value>
                </xsd:parameter>
                <xsd:parameter>
                    <xsd:name>domain_type</xsd:name>
                    <xsd:value>service</xsd:value>
                </xsd:parameter>
            </nbi:params>
        </nbi:CreateDomain>
    </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope
    xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
    <soapenv:Body>
        <ns:CreateDomainResponse
            xmlns:ns="http://nbi.radius.eltex.org">
            <ns:return xsi:type="ax21:NbiResponse"
                xmlns:ax226="http://tariff.object.nbi.radius.eltex.org/xsd"
                xmlns:ax27="http://authService.object.nbi.radius.eltex.org/xsd"
                xmlns:ax213="http://ssidstats.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax210="http://statistic.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax222="http://subnets.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax23="http://object.nbi.radius.eltex.org/xsd"
                xmlns:ax25="http://request.object.nbi.radius.eltex.org/xsd"
                xmlns:ax21="http://response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax219="http://shaper.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:ax216="http://service.pcrf.response.object.nbi.radius.eltex.org/xsd"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                <ax21:code>0</ax21:code>
                <ax21:detail/>
            </ns:return>
        </ns:CreateDomainResponse>
    </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

3

Ошибка от сервера EMS

7

Нет родительского домена

8

Родительский домен не соответствует правилам

10

Домен роли не имеет прав на родительский домен

18

В конфигурации неверно настроен адрес EMS NBI или он недоступен

33

Нет обязательного поля name или оно некорректно

62

Родительский домен не зарегистрирован

67

Создаваемый домен уже существует

74

Некорректное значение атрибута

266

Некорректная длина полного домена

313

Некорректное название атрибута

423

Тип создаваемого домена имеет тип, отличающийся от типа родительского домена.

442

Некорректный идентификатор таймзоны

Пример использования

См. также

Вернуться к списку команд
Версия 1.19-79
Дата публикации 09-06-2021 14:30:17