Перейти к основному содержимому
Версия: 7.9

Функции для работы с РСМ

Описание и характеристика функций модуля Автоматизации, которые можно использовать при разработке сценариев автоматического построения РСМ.

GetConfigItemTypes​

  • Назначение: Получение доступных типов КЕ

  • Описание: Функция выполняет запрос к API [GET] /api/public/sm/v2/rsm/config-item-types и возвращает список доступных типов конфигурационных единиц.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemTypesStruct:Automaton.CMDB.ConfigItemType (Array)Возвращает список моделей типов КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GetConfigItemByUniqueKey​

  • Назначение: Получение КЕ по уникальному ключу из кэша

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/attributes/unique-keys и возвращает упрощенную модель КЕ.

    • Определение ключевых параметров для формирования уникального ключа определяется пользователем в настройках типа КЕ. Подробнее - Управление атрибутами типа КЕ

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemTypeIdInteger64Идентификатор типа КЕСвязь/контрол
      AttributesDynamicКлючевые параметры атрибутовСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemByUniqueKey (Single)Упрощенная модель КЕ (ID и стадия ЖЦ)Связь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GetWorkGroups​

  • Назначение: Получение доступных рабочих групп

  • Описание: Функция выполняет запрос к API [GET] /api/public/sm/v2/rsm/work-groups и возвращает список доступных рабочих групп.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      WorkGroupsStruct:Automaton.CMDB.WorkGroup (Array)Возвращает список моделей доступных рабочих группСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GetAllConfigItems​

  • Назначение: Получение всех доступных КЕ

  • Описание: Функция выполняет запрос к API [GET] /api/public/sm/v2/rsm/config-items и возвращает список доступных конфигурационных единиц.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      WorkGroupsStruct:Automaton.CMDB.ConfigItemShort (Array)Возвращает список моделей доступных конфигурационных единицСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

FilterConfigItems​

  • Назначение: Получение доступных КЕ по фильтру

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/filter и возвращает список доступных конфигурационных единиц согласно условиям фильтра.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      FilterStruct:Automaton.CMDB.ConfigItemFilterМодель фильтраСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigitemsStruct:Automaton.CMDB.ConfigItemFilterResult (Array)Возвращает список моделей доступных конфигурационных единиц согласно фильтраСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

FilterConfigItemsExpanded​

  • Назначение: Получение доступных КЕ по фильтру (Expanded)

  • Описание: Функция аналогична функции FilterConfigItems за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      IdsInteger64 (Array)Идентификатор КЕСвязь
      NamesString (Array)Название КЕСвязь
      LabelsDynamicМетки КЕСвязь
      StageCategoriesString (Array)Стадии жизненного цикла КЕСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemsStruct:Automaton.CMDB.ConfigItemFilterResult (Array)Возвращает список моделей доступных конфигурационных единиц согласно фильтраСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

FilterConfigItemsExtended​

  • Назначение: Получение доступных КЕ по фильтру (Extended)

  • Описание:

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

    • Возможность указать маску полей (fieldMask)

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      PagingPagingModelМодель постраничного запроса, с возможностью указать дополнительные параметры фильтрацииСвязь
      FieldMaskStringМаска возвращаемых полейСвязь
      IdsInteger64 (Array)Идентификаторы КЕСвязь
      NamesString (Array)Название КЕСвязь
      TypeIdsInteger64 (Array)Тип КЕСвязь
      StageCategoriesString (Array)Стадии жизненного цикла КЕСвязь
      LabelsDynamicМетки КЕСвязь
      OwnerWorkGroupsInteger64 (Array)Владелец КЕСвязь
      FieldMask

      Представляет собой строку с названиями полей модели, разделёнными запятой.

      В модели ответа структура будет статичной, но если поля не указаны в параметрах FieldMask, их значения будут пустыми.

      По умолчанию возвращается только id.

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemsStruct:ConfigItemExtended (Array)Возвращает список моделей полученных конфигурационных единиц по фильтруСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

CreateConfigItem​

  • Назначение: Создание КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items?makeNameUnique=false для создания конфигурационной единицы.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemStruct:Automaton.CMDB.ConfigItemPostМодель создаваемой КЕСвязь
      MakeNameIsUniqueBooleanПризнак уникальности названия конфигурационной единицы. Если True - КЕ будет создана с добавлением индекса к названию, если КЕ с таким названием уже существует. Если False и КЕ уже существует будет возвращена ошибка 400 и КЕ создана не будетСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemsStruct:Automaton.CMDB.ConfigItemВозвращает модель созданной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

CreateConfigItemExpanded​

  • Назначение: Создание КЕ (Expanded)

  • Описание: Функция аналогична функции CreateConfigItem за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      NameStringНазвание КЕСвязь/контрол
      DescriptionStringОписание КЕСвязь/контрол
      ParentIdInteger64Идентификатор родительской КЕСвязь/контрол
      ConfigItemTypeIdInteger64Идентификатор типа КЕСвязь/контрол
      OwnerWorkGroupIdInteger64Идентификатор РГ владельца КЕСвязь/контрол
      LabelsDynamicМетки КЕСвязь/контрол
      SharedToWorkGroupsStruct:Automaton.CMDB:WorkGroupGrantModelПредоставление доступа к КЕ другим Рабочим группамСвязь/контрол
      MakeNameIsUniqueBooleanПризнак уникальности названия конфигурационной единицы. Если True - КЕ будет создана с добавлением индекса к названию, если КЕ с таким названием уже существует. Если False и КЕ уже существует будет возвращена ошибка 400 и КЕ создана не будетСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemВозвращает модель созданной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

DeleteConfigItem​

  • Назначение: Удаление КЕ

  • Описание: Функция выполняет запрос к API [DELETE] /api/public/sm/v2/rsm/config-items/{id}?applyGrants=false для полного удаления конфигурационной единицы.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор удаляемой КЕСвязь
      ApplyGrantsBooleanЕсли задано True – применить настройки доступа удаляемой КЕ к подчинённым КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateConfigItem​

  • Назначение: Изменение основной информации о КЕ

  • Описание: Функция выполняет запрос к API [PUT] /api/public/sm/v2/rsm/config-items/{id}?makeNameUnique=false для обновления информации о КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      ConfigItemPutStruct:Automaton.CMDB.ConfigItemPutМодель обновленной КЕСвязь
      MakeNameIsUniqueBooleanПризнак уникальности названия конфигурационной единицы.Связь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      UpdatedConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateConfigItemExpanded​

  • Назначение: Изменение основной информации о КЕ

  • Описание: Функция аналогична функции UpdateConfigItem за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      NameStringНазвание КЕСвязь/контрол
      DescriptionStringОписание КЕСвязь/контрол
      ParentIdInteger64Идентификатор родительской КЕСвязь/контрол
      ConfigItemTypeIdInteger64Идентификатор типа КЕСвязь/контрол
      OwnerWorkGroupIdInteger64Идентификатор РГ владельца КЕСвязь/контрол
      LabelsDynamicМетки КЕСвязь/контрол
      MakeNameIsUniqueBooleanПризнак уникальности названия конфигурационной единицы. Если True - КЕ будет создана с добавлением индекса к названию, если КЕ с таким названием уже существует. Если False и КЕ уже существует будет возвращена ошибка 400 и КЕ создана не будетСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      UpdatedConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GrantAccessToConfigItem​

  • Назначение: Предоставление доступа к КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{id}/work-groups для предоставления доступа к КЕ рабочей группе.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      WorkGroupGrantStruct:Automaton.CMDB.WorkGroupGrantModelМодель запросаСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GrantAccessToConfigItemExpanded​

  • Назначение: Предоставление доступа к КЕ (Expanded)

  • Описание: Функция аналогична функции GrantAccessToConfigItem за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      WorkGroupIdInteger64Идентификатор рабочей группы, которой предоставляется доступ к КЕСвязь/контрол
      ShareTypeStringТип предоставляемых правСвязь/контрол
      GrantsString (Array)Предоставляемые рабочим группам праваСвязь
      Справка

      Тип предоставляемых прав​

      ТипОписание
      ConfigItemПредоставить права доступа только для КЕ
      TreeПредоставить права доступа для КЕ и подчинённого ей дерева
      ChildrenTreeПредоставить права доступа только для подчинённого данной КЕ дерева

      Предоставляемые рабочим группам права​

      ТипОписание
      base-system.rsm.config-items-basic-readПраво на чтение базовой информации
      base-system.rsm.config-items-monitoring-readПраво на чтение привязок КЕ
      base-system.rsm.config-items-readПраво на полное чтение КЕ
      base-system.rsm.config-items-writeПраво на полное управление КЕ

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateAccessToConfigItem​

  • Назначение: Обновление предоставленного доступа к КЕ

  • Описание: Функция выполняет запрос к API [PUT] /api/public/sm/v2/rsm/config-items/{id}/work-groups для обновления предоставленного доступа к КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      WorkGroupGrantStruct:Automaton.CMDB.WorkGroupGrantModelМодель запросаСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateAccessToConfigItemExpanded​

  • Назначение: Обновление предоставленного доступа к КЕ (Expanded)

  • Описание: Функция аналогична функции UpdateAccessToConfigItem за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      WorkGroupIdInteger64Идентификатор рабочей группы, которой предоставляется доступ к КЕСвязь/контрол
      ShareTypeStringТип предоставляемых правСвязь/контрол
      GrantsString (Array)Предоставляемые рабочим группам праваСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

DeleteAccessToConfigItem​

  • Назначение: Удаление предоставленного доступа к КЕ

  • Описание: Функция выполняет запрос к API [DELETE] /api/public/sm/v2/rsm/config-items/{id}/work-groups/{sharedId} для удаления предоставленного доступа к КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор обновляемой КЕСвязь/контрол
      SharedWorkGroupIdInteger64Идентификатор модели предоставления доступа к КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GetConfigItem​

  • Назначение: Получение информации о КЕ

  • Описание: Функция выполняет запрос к API [GET] /api/public/sm/v2/rsm/config-items/{id}?includeState=false&includeHealth=false для получения информации о КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      IdInteger64Идентификатор КЕСвязь/контрол
      IncludeStateBooleanЕсли задано True – включить информацию по статусу КЕ. По умолчанию – FalseСвязь/контрол
      IncludeHealthBooleanЕсли задано True – включить информацию по здоровью КЕ. По умолчанию – FalseСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель обновленной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

  • Назначение: Создать связь подчинения между КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{parentId}/children для установки связи подчинения между КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ParentIdInteger64Идентификатор родительской КЕСвязь/контрол
      ChildIdInteger64Идентификатор подчиняемой КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель подчиненной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

  • Назначение: Создать связь влияния между КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{parentId}/children для установки связи влияния между КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      DependentIdInteger64Идентификатор зависимой КЕСвязь/контрол
      InfluentialIdInteger64Идентификатор влияющей КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ImpactConfigItemsStruct:Automaton.CMDB.ImpactLinkConfigitem (Array)Обновлённый список моделей влияющих КЕ с минимальным набором атрибутов: идентификатор id, название name и словарь меток labelsСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

  • Назначение: Удаление связи подчинения между КЕ

  • Описание: Функция выполняет запрос к API [DELETE] /api/public/sm/v2/rsm/config-items/{parentId}/children/{childId} для удаления связи подчинения между КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ParentIdInteger64Идентификатор родительской КЕСвязь/контрол
      ChildIdInteger64Идентификатор подчиненной КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemStruct:Automaton.CMDB.ConfigItemМодель ранее подчиненной КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

  • Назначение: Удаление связи влияния между КЕ

  • Описание: Функция выполняет запрос к API [DELETE] /api/public/sm/v2/rsm/config-items/{dependentId}/influentials/{influentialId} для удаления связи влияния между КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      DependentIdInteger64Идентификатор зависимой КЕСвязь/контрол
      InfluentialIdInteger64Идентификатор влияющей КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ImpactConfigItemsStruct:Automaton.CMDB.ImpactLinkConfigitem (Array)Обновлённый список моделей влияющих КЕ с минимальным набором атрибутов: идентификатор id, название name и словарь меток labelsСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

SetStageById​

  • Назначение: Управление стадией жизненного цикла КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{id}/stages для перевода КЕ по жизненному циклу.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор зависимой КЕСвязь/контрол
      StageIdInteger64Идентификатор стадии жизненного циклаСвязь/контрол
      ApplyGrantsBooleanЕсли задано True – применить настройки доступа к подчинённым КЕ. По умолчанию – False.Связь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      StageStruct:Automaton.CMDB.StageМодель стадии жизненного цикла, на которой сейчас находится КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

SetStageByCategory​

  • Назначение: Управление стадией жизненного цикла КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{id}/stages/category для перевода КЕ по жизненному циклу.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор зависимой КЕСвязь/контрол
      CategoryStringНазвание категории стадии жизненного цикла КЕСвязь/контрол
      ApplyGrantsBooleanЕсли задано True – применить настройки доступа к подчинённым КЕ. По умолчанию – False.Связь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      StageStruct:Automaton.CMDB.StageМодель стадии жизненного цикла, на которой сейчас находится КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

FilterAttributesConfigItem​

  • Назначение: Получение атрибутов КЕ по фильтру

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/attributes/filter для получения атрибутов КЕ по фильтру.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      AttributeFilterStruct:Automaton.CMDB.AttributeFilterМодель фильтра атрибутовСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      AttributesStruct:Automaton.CMDB.Attributes (Array)Список моделей атрибутов КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

FilterAttributesConfigItemExpanded​

  • Назначение: Получение атрибутов КЕ по фильтру (Expanded)

  • Описание: Функция аналогична функции FilterAttributesConfigItem за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdsInteger64 (Array)Список идентификаторов КЕСвязь/контрол
      KeyValuesStruct:Automaton.CMDB.AttributeFilterKeyValue (Array)Список моделей атрибутов КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      AttributesStruct:Automaton.CMDB.Attributes (Array)Список моделей атрибутов КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

CreateAttribute​

  • Назначение: Создание атрибута КЕ

  • Описание: Функция выполняет запрос к API [POST] /api/public/sm/v2/rsm/config-items/{id}/attributes для создания нового атрибута КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      AttributeRequestStruct:Automaton.CMDB.AttributeRequestМодель объекта атрибутаСвязь
      ConfigItemIdInteger64Идентификатор КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      AttributeStruct:Automaton.CMDB.AttributeМодель атрибута КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

CreateAttributeExpanded​

  • Назначение: Создание атрибута КЕ (Expanded)

  • Описание: Функция аналогична функции CreateAttribute за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор КЕСвязь/контрол
      KeyStringКлюч атрибута КЕСвязь/контрол
      ValueDynamicЗначение атрибута КЕСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      AttributeStruct:Automaton.CMDB.AttributeМодель атрибута КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateAttribute​

  • Назначение: Обновление атрибута КЕ

  • Описание: Функция выполняет запрос к API [PUT] /api/public/sm/v2/rsm/config-items/{id}/attributes для обновления существующего атрибута КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      AttributeRequestStruct:Automaton.CMDB.AttributeRequestОбновленная модель атрибута КЕСвязь/контрол
      ConfigItemIdInteger64Идентификатор КЕСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      UpdatedAttributeStruct:Automaton.CMDB.AttributeОбновленная модель атрибута КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateConfigItemAttributesBatch​

  • Назначение: Массовое обновление атрибутов КЕ

  • Описание: Функция выполняет запрос к API [PUT] /api/public/sm/v2/rsm/config-items/attributes/batch для массового обновления пространственных и типовых атрибутов КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      AttributePutModelsStruct:Automaton.CMDB.AttributePutBatch (Array)Модель атрибута КЕ (идентификатор КЕ, ключ и значение атрибута)Связь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      AttributesStruct:Automaton.CMDB.AttributesМассив полных моделей Атрибутов КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateAttributeExpanded​

  • Назначение: Создание атрибута КЕ (Expanded)

  • Описание: Функция аналогична функции UpdateAttribute за исключением входящих в нее пинов.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemIdInteger64Идентификатор КЕСвязь/контрол
      KeyStringКлюч атрибута КЕСвязь/контрол
      ValueDynamicЗначение атрибута КЕСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      UpdatedAttributeStruct:Automaton.CMDB.AttributeОбновленная модель атрибута КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

CreateConfigItemsBatch​

  • Назначение: Массовое создание КЕ

  • Описание: Функция выполняет запрос к API Monq для пакетного создания КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemPostsStruct:Automaton.CMDB.ConfigItemPost (Array)Массив объектов КЕСвязь
      MakeNameIsUniqueBooleanПризнак уникальности названия конфигурационной единицыСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigitemsStruct:Automaton.CMDB.ConfigItemShort (Array)Массив моделей созданных КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

GetConfigItemsBatch​

  • Назначение: Пакетное получение информации по нескольким КЕ

  • Описание: Функция выполняет запрос к API Monq для пакетного получения полной информации о КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      IdsInteger64 (Array)Список идентификаторов КЕ, по которым будет возвращена информацияСвязь
      IncludeStateBooleanПараметр определяет, возвращать ли информацию по стадии ЖЦ в модели КЕ или нетСвязь/контрол
      IncludeHealthBooleanПараметр определяет, возвращать ли информацию по здоровью в модели КЕ или нетСвязь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemsStruct:Automaton.CMDB.ConfigItem (Array)Массив моделей созданных КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

UpdateConfigItemsBatch​

  • Назначение: Пакетное обновление информации о КЕ

  • Описание: Функция выполняет запрос к API Monq для пакетного обновления информации о КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      ConfigItemsPatchSpecific:ConfigItemPatchBatch (Array)Неполная модель КЕ, включает в себя обновление меток, типа КЕ и названияСвязь
      MakeNamesIsUniqueBooleanПризнак уникальности названия КЕ.
      True - к названию КЕ будет добавлен постфикс
      False - КЕ не будет переименована      		Связь/контрол

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      UpdatedConfigItemsSpecific:ConfigItemShort (Array)Массив неполных моделей обновленных КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

SetStageByCategoryBatch​

  • Назначение: Пакетная установка категорий жизненного цикла КЕ

  • Описание: Функция выполняет запрос к API Monq для пакетного обновления информации о категории жизненного цикла КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      StageCategoryPostsSpecific:StageCategoryPostBatch (Array)Модель запроса. Доступные категории ЖЦ: Active, Archive, DeletedСвязь

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      StagesSpecific:Stage (Array)Массив моделей стадий ЖЦ, на которой сейчас находятся КЕСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

CreateLinksBatch​

  • Назначение: Пакетная установка связей между КЕ

  • Описание: Функция выполняет запрос к API Monq для пакетной установки связи между КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      LinkPostModelsSpecific:ConfigItemLinkPost (Array)Модель запроса для установки связейСвязь
      • SourceId - идентификатор КЕ, от которой идет связь подчинения или влияния
      • TargetId - идентификатор КЕ, к которой идет связь подчинения и влияния
      • Доступные типы связей:
        • Influence - связь влияния
        • Hierarchy - связь подчинения

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemLinksSpecific:Stage (Array)Массив моделей созданных связейСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь

DeleteLinksBatch​

  • Назначение: Пакетное удаление связей между КЕ

  • Описание: Функция выполняет запрос к API Monq для пакетного удаления связей между КЕ.

    • Inputs

      НазваниеТипОписаниеПараметры
      InExecПин вызоваСвязь
      ScenarioStruct:ScenarioBaseСистемная переменнаяСвязь
      BearerTokenStringПо умолчанию BearerToken запрашивается из переменной Scenario, если указать вручную - в запросе к API будет применен указанныйСвязь/контрол
      LinkDeleteModelsSpecific:ConfigItemLinkDelete (Array)Модель запроса для удаления связейСвязь
      • SourceId - идентификатор КЕ, от которой идет связь подчинения или влияния
      • TargetId - идентификатор КЕ, к которой идет связь подчинения и влияния
      • Доступные типы связей для удаления:
        • Influence - связь влияния
        • Hierarchy - связь подчинения

    • Outputs

      НазваниеТипОписаниеПараметры
      OkExecПоследовательность активна в случае успешного выполнения запросаСвязь
      FailedExecПоследовательность активна если запрос выполнен с ошибкойСвязь
      ConfigItemLinksSpecific:Stage (Array)Массив моделей созданных связейСвязь
      ResponseStruct:AutomatonResponseВозвращает результат выполнения запроса согласно модели AutomatonResponseСвязь