RetrieveDomain – Получить список атрибутов домена по имени в системе SoftWLC

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

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

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

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

domain

Фильтр по домену. Не может быть пустым.

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

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

Domain

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

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

code

Код ответа

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

detail

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

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

response

Объект NbiDomain

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

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

8

Домен не соответствует правилам
Запрос
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nbi="http://nbi.radius.eltex.org">
   <soap:Header/>
   <soap:Body>
      <nbi:RetrieveDomain>
         <nbi:domain>?</nbi:domain>
      </nbi:RetrieveDomain>
   </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:RetrieveDomainResponse xmlns:ns="http://nbi.radius.eltex.org">
         <ns:return>
            <ax21:code>8</ax21:code>
            <ax21:detail>Domain '?' does not conform to the rules FQDN</ax21:detail>
            <ax239:response xsi:type="ax21:NbiDomain">
               <ax21:descr xsi:nil="true"/>
               <ax21:name xsi:nil="true"/>
               <ax21:params xsi:nil="true"/>
            </ax239:response>
         </ns:return>
      </ns:RetrieveDomainResponse>
   </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

62

Домен не зарегистрирован
Запрос
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nbi="http://nbi.radius.eltex.org">
   <soap:Header/>
   <soap:Body>
      <nbi:RetrieveDomain>
         <nbi:domain>rt.root</nbi:domain>
      </nbi:RetrieveDomain>
   </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:RetrieveDomainResponse xmlns:ns="http://nbi.radius.eltex.org">
         <ns:return>
            <ax21:code>62</ax21:code>
            <ax21:detail>Such domain 'rt.root' is not registered in ELTEX_EMS.DOMAINS</ax21:detail>
            <ax239:response xsi:type="ax21:NbiDomain">
               <ax21:descr xsi:nil="true"/>
               <ax21:name xsi:nil="true"/>
               <ax21:params xsi:nil="true"/>
            </ax239:response>
         </ns:return>
      </ns:RetrieveDomainResponse>
   </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

10

Домен роли не имеет прав на домен
Запрос
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nbi="http://nbi.radius.eltex.org">
   <soap:Header/>
   <soap:Body>
      <nbi:RetrieveDomain>
         <nbi:domain>root</nbi:domain>
      </nbi:RetrieveDomain>
   </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:RetrieveDomainResponse xmlns:ns="http://nbi.radius.eltex.org">
         <ns:return>
            <ax21:code>10</ax21:code>
            <ax21:detail>Role have no rights on domain 'root'</ax21:detail>
            <ax239:response xsi:type="ax21:NbiDomain">
               <ax21:descr xsi:nil="true"/>
               <ax21:name xsi:nil="true"/>
               <ax21:params xsi:nil="true"/>
            </ax239:response>
         </ns:return>
      </ns:RetrieveDomainResponse>
   </soapenv:Body>
</soapenv:Envelope>
Код Описание ошибки

0

Успешно
Запрос
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:nbi="http://nbi.radius.eltex.org">
   <soap:Header/>
   <soap:Body>
      <nbi:RetrieveDomain>
         <nbi:domain>omsk1.omsk.root</nbi:domain>
      </nbi:RetrieveDomain>
   </soap:Body>
</soap:Envelope>
Ответ
<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:RetrieveDomainResponse xmlns:ns="http://nbi.radius.eltex.org">
         <ns:return>
            <ax21:code>0</ax21:code>
            <ax21:detail/>
            <ax239:response xsi:type="ax21:NbiDomain">
               <ax21:descr/>
               <ax21:name>omsk1.omsk.root</ax21:name>
               <ax21:params xsi:type="ax21:NbiParameterArray">
                  <ax21:parameter xsi:type="ax21:NbiParameter">
                     <ax21:name>users_limit</ax21:name>
                     <ax21:value>100</ax21:value>
                  </ax21:parameter>
                  <ax21:parameter xsi:type="ax21:NbiParameter">
                     <ax21:name>domain_type</ax21:name>
                     <ax21:value>service</ax21:value>
                  </ax21:parameter>
               </ax21:params>
            </ax239:response>
         </ns:return>
      </ns:RetrieveDomainResponse>
   </soapenv:Body>
</soapenv:Envelope>

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