RetrieveDomainsIntegralStatusV2 - Получить интегральный статус узла дерева объектов

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

  1. Команда актуальна, начиная с версии 1.12. Данные выбирались из EMS-NBI, из контейнера объектов. Можно было передавать несколько доменов, разделенных запятой. В этой реализации была поддержка filters objtype, который позже был признан бесполезным.

  2. Используется в ЛК для отображения статуса регионов, площадок, каждом из которых соответствует узел в дереве объектов, однозначно идентифицирующийся по домену.

  3. В версии 1.18 данные начали выбираться из БД (без обращения в EMS). Теперь разрешено передавать только один домен и этот параметр является обязательным. Фильтры не поддерживаются.

  4. Для запроса порции данных и числа записей используются разные запросы.

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

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

domains

домен, внутри которого искать

String

Обязательно указывать один домен. Точка в начале домена означает Со всеми вложенными.

filters

NbiParameterArray Список фильтров

На данный момент фильтры не поддерживаются

NbiParameterArray

count

число записей, он же limit.

Integer

0, чтобы запросить только подсчет числа записей.

page

страница (для пагинации)

Integer

Параметр не используется, устарел, оставили только для совместимости API.

startIndex

пропустить N записей с начала, он же offset

Integer

locale

null

String

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

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

domains

Список данных по узлам

NbiDomainIntegralStatus

totalSize

Общее число записей, удовлетворяющих условиям фильтрации

int

code

Код ответа

int

detail

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

String

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

Код Описание

0

Успешно
Запрос порции данных
      <nbi:RetrieveDomainsIntegralStatusV2>
         <nbi:domains>.root</nbi:domains>
         <nbi:filters>
         </nbi:filters>
         <nbi:count>2</nbi:count>
         <nbi:page>0</nbi:page>
         <nbi:startIndex>1000</nbi:startIndex>
         <nbi:locale>ru_RU</nbi:locale>
      </nbi:RetrieveDomainsIntegralStatusV2>
Ответ
      <ns:RetrieveDomainsIntegralStatusV2Response>
         <ns:return>
            <ax21:code>0</ax21:code>
            <ax21:detail>Success</ax21:detail>
            <ax230:domains xsi:type="ax230:NbiDomainIntegralStatus">
               <ax230:domainName>8621-0437_ul_Pokalchuka_25.Sberbank.Kletskaya.Volgogradskaya_obl.Volgogradskiy_filial.Ug.Ap.root</ax230:domainName>
               <ax230:grayStatusCount>0</ax230:grayStatusCount>
               <ax230:greenStatusCount>2</ax230:greenStatusCount>
               <ax230:orangeStatusCount>0</ax230:orangeStatusCount>
               <ax230:pinkStatusCount>0</ax230:pinkStatusCount>
               <ax230:redStatusCount>0</ax230:redStatusCount>
               <ax230:yellowStatusCount>0</ax230:yellowStatusCount>
            </ax230:domains>
            <ax230:domains xsi:type="ax230:NbiDomainIntegralStatus">
               <ax230:domainName>Centr_Kulturnogo_Razvitiya_Lihacheva_6a.Shebekino.Bekgorodskaya_obl.Centr.Zapad.OTT.root</ax230:domainName>
               <ax230:grayStatusCount>0</ax230:grayStatusCount>
               <ax230:greenStatusCount>1</ax230:greenStatusCount>
               <ax230:orangeStatusCount>0</ax230:orangeStatusCount>
               <ax230:pinkStatusCount>0</ax230:pinkStatusCount>
               <ax230:redStatusCount>0</ax230:redStatusCount>
               <ax230:yellowStatusCount>0</ax230:yellowStatusCount>
            </ax230:domains>
            <ax230:totalSize>0</ax230:totalSize>
         </ns:return>
      </ns:RetrieveDomainsIntegralStatusV2Response>
Запрос общего числа записей
      <nbi:RetrieveDomainsIntegralStatusV2>
         <nbi:domains>.root</nbi:domains>
         <nbi:filters>
         </nbi:filters>
         <nbi:count>0</nbi:count>
         <nbi:page>0</nbi:page>
         <nbi:startIndex>1000</nbi:startIndex>
         <nbi:locale>ru_RU</nbi:locale>
      </nbi:RetrieveDomainsIntegralStatusV2>
Ответ
      <ns:RetrieveDomainsIntegralStatusV2Response>
         <ns:return>
            <ax21:code>0</ax21:code>
            <ax21:detail>Success</ax21:detail>
            <ax211:domains xsi:nil="true"/>
            <ax211:totalSize>10996</ax230:totalSize>
         </ns:return>
      </ns:RetrieveDomainsIntegralStatusV2Response>

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

См. также

Вернуться к списку команд
Версия 1.19-67
Дата публикации 07-05-2021 17:25:19