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

Успешно
Запрос
        <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>
                <xsd:parameter>
                    <xsd:name>profile_id</xsd:name>
                    <xsd:value>1,2,3</xsd:value>
                </xsd:parameter>
            </nbi:params>
        </nbi:CreateDomain>
Ответ
        <ns:CreateDomainResponse>
            <ns:return>
                <ax21:code>0</ax21:code>
                <ax21:detail/>
            </ns:return>
        </ns:CreateDomainResponse>
Код Описание ошибки

2

Ошибка взаимодействия с базой данных

3

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

8

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

10

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

18

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

33

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

62

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

67

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

74

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

263

Ограничение количества пользователей больше, чем у родительского домена

266

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

281

Не найден обязательный параметр запроса (домен)

313

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

423

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

442

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

522

Профиль юрлица не найден

535

Выбранный 'hotel_id' уже существует

536

Некорректный 'hotel_id'

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

См. также

Вернуться к списку команд
Версия 1.23-2635
Дата публикации 12-08-2022 08:29:16