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

Управление связями между КЕ

Раздел содержит описание функций для управления связями между конфигурационными единицами.


Функции управления связями КЕ

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
DependentIdInteger64Идентификатор зависимой КЕ
InfluentialIdInteger64Идентификатор влияющей КЕ

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ImpactConfigItemsStruct: Automaton.CMDB.ImpactLinkConfigitem (array)Обновленный список моделей влияющих КЕ с минимальным набором атрибутов: идентификатор id, название name и метки labels

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
ParentIdInteger64Идентификатор родительской КЕ
ChildIdInteger64Идентификатор подчиняемой КЕ

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemStruct: Automaton.CMDB.ConfigItemМодель подчиненной КЕ

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
DependentIdInteger64Идентификатор зависимой КЕ
InfluentialIdInteger64Идентификатор влияющей КЕ

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ImpactConfigItemsStruct: Automaton.CMDB.ImpactLinkConfigitem (array)Обновленный список моделей влияющих КЕ с минимальным набором атрибутов: идентификатор id, название name и метки labels

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
ParentIdInteger64Идентификатор родительской КЕ
ChildIdInteger64Идентификатор подчиненной КЕ

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemStruct: Automaton.CMDB.ConfigItemМодель ранее подчиненной КЕ

CreateLinksBatch

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
LinkPostModelsStruct: ConfigItemLinkPost (array)Модель запроса для установки связей любого типа

Модель запроса установки связей

  • SourceId - идентификатор КЕ, от которой идет связь подчинения или влияния
  • TargetId - идентификатор КЕ, к которой идет связь подчинения и влияния
  • Type - доступные типы связей:
    • Influence - связь влияния
    • Hierarchy - связь подчинения
    • Info - информационная связь
  • Labels - метки

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemLinksStruct: ConfigItemInfluenceLink (array)Массив моделей созданных связей

UpdateLinksBatch

Назначение: Пакетное обновление общей информации о связи любого типа
Описание: Функция выполняет запрос к API на массовое обновление общих параметров связи любого типа. Обновляются все общие параметры связи любого типа.

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
LinkPutModelsStruct: ConfigItemLinkPut (array)Модель запроса для обновления связей любого типа

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemLinksStruct: ConfigItemLinkPostResult (array)Массив моделей обновленных связей

PartialUpdateLinksBatch

Назначение: Пакетное обновление (частичное) общей информации о связи любого типа
Описание: Функция выполняет запрос к API на массовое частичное обновление общих параметров связи любого типа.

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
LinkPatchModelsStruct: ConfigItemLinkPatch (array)Модель запроса для обновления связей любого типа

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemLinksStruct: ConfigItemLinkPostResult (array)Массив моделей обновленных связей

DeleteLinksBatch

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
LinkDeleteModelsStruct: ConfigItemLinkDelete (array)Модель запроса для удаления связей любого типа

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemLinksStruct: ConfigItemInfluenceLink (array)Массив моделей удаленных связей

CreateInfluenceLinksBatch

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

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
InfluenceLinkPostModelsStruct: ConfigItemInfluenceLinkPost (array)Модель запроса для установки связей влияния

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
ConfigItemLinksStruct: ConfigItemInfluenceLink (array)Массив моделей созданных связей

UpdateInfluenceLinksBatch

Назначение: Массовое обновление связей влияния
Описание: Функция выполняет запрос к API на массовое обновление параметров связей влияния. Обновляются все параметры связей влияния.

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
InfluenceLinkPutModelsStruct: ConfigItemInfluenceLinkPutМодель связи влияния

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
InfluenceLinksStruct: ConfigItemInfluenceLink (array)Список моделей обновленных связей влияния

PartialUpdateInfluenceLinksBatch

Назначение: Массовое (частичное) обновление связей влияния
Описание: Функция выполняет запрос к API на массовое обновление параметров связей влияния.

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

Inputs

НазваниеТипОписание
In, BearerTokenОбщие параметры для функций
InfluenceLinkPatchModelsStruct: ConfigItemInfluenceLinkPatchМодель связи влияния

Outputs

НазваниеТипОписание
Ok, Failed, ResponseОбщие параметры для функций
InfluenceLinksStruct: ConfigItemInfluenceLink (array)Список моделей обновленных связей влияния