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

Создание связи подчинения между КЕ

POST /api/public/sm/v2/rsm/config-items/{parentId}/children

Запрос возвращает модель подчинённой КЕ.

Параметры запроса

Название параметра	Тип параметра	Обязательный параметр	Значение по умолчанию	Описание параметра
parentId	integer	да	нет	Идентификатор родительской КЕ

Тело запроса

{
  "id": 0
}

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
id	integer	да	нет	Идентификатор подчиняемой КЕ

Коды ответа

Код ответа	Описание
400	Неверная модель данных в теле запроса
400	Недопустимое значение идентификатора КЕ
400	Нельзя устанавливать связи подчинения между КЕ, принадлежащих разным рабочим группам
403	Недостаточно прав для управления родительской КЕ
404	Родительская КЕ с идентификатором {id} не найдена
404	Дочерняя КЕ с идентификатором {id} не найдена
415	Неправильный тип входных данных. Требуется указать тип: application/json

Создание связи влияния между КЕ

POST /api/public/sm/v2/rsm/config-items/{dependentId}/influentials

Запрос возвращает обновлённый список моделей влияющих КЕ с минимальным набором атрибутов: идентификатор {id} и имя {name}.

Параметры запроса

Название параметра	Тип параметра	Обязательный параметр	Значение по умолчанию	Описание параметра
dependentId	integer	да	нет	Идентификатор зависимой КЕ

Тело запроса

{
  "id": 0
}

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
id	integer	да	нет	Идентификатор влияющей КЕ

Коды ответа

Код ответа	Описание
400	Недопустимое значение идентификатора КЕ
403	Недостаточно прав для управления зависимой КЕ
403	Недостаточно прав для управления влияющей КЕ
404	Зависимая КЕ с идентификатором {id} не найдена
404	Влияющая КЕ с идентификатором {id} не найдена

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

DELETE /api/public/sm/v2/rsm/config-items/{parentId}/children/{childId}

Запрос возвращает модель ранее подчинённой КЕ.

Параметры запроса

Название параметра	Тип параметра	Обязательный параметр	Значение по умолчанию	Описание параметра
parentId	integer	да	нет	Идентификатор родительской КЕ
childId	integer	да	нет	Идентификатор подчинённой КЕ

Коды ответа

Код ответа	Описание
400	Недопустимое значение идентификатора КЕ
403	Недостаточно прав для управления родительской КЕ
404	Родительская КЕ с идентификатором {id} не найдена
404	Дочерняя КЕ с идентификатором {id} не найдена

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

DELETE /api/public/sm/v2/rsm/config-items/{dependentId}/influentials/{influentialId}

Запрос возвращает обновлённый список моделей влияющих КЕ с минимальным набором атрибутов: идентификатор {id} и имя {name}.

Параметры запроса

Название параметра	Тип параметра	Обязательный параметр	Значение по умолчанию	Описание параметра
dependentId	integer	да	нет	Идентификатор зависимой КЕ
influentialId	integer	да	нет	Идентификатор влияющей КЕ

Коды ответа

Код ответа	Описание
400	Недопустимое значение идентификатора КЕ
403	Недостаточно прав для управления зависимой КЕ
403	Недостаточно прав для управления влияющей КЕ
404	Зависимая КЕ с идентификатором {id} не найдена
404	Влияющая КЕ с идентификатором {id} не найдена

Пакетное создание нескольких связей между КЕ

POST /api/public/sm/v2/rsm/config-item-edges/batch

Запрос возвращает список моделей связей между КЕ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "type":"Hierarchy",
    "labels": {}
  },
  {
    "sourceId":2,
    "targetId":3,
    "type":"Influence",
    "labels": {}
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи
labels	object	нет	{}	Метки связи

Пакетное обновление нескольких связей между КЕ

PUT /api/public/sm/v2/rsm/config-item-edges/batch

Запрос возвращает обновлённый список моделей связей между КЕ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "type":"Hierarchy",
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    }
  },
  {
    "sourceId":2,
    "targetId":3,
    "type":"Influence",
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    }
  },
  {
    "sourceId":4,
    "targetId":5,
    "type":"Info",
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    }
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи
labels	object	нет	{}	Метки связи

Пакетное частичное обновление нескольких связей между КЕ

PATCH /api/public/sm/v2/rsm/config-item-edges/batch

Запрос возвращает обновлённый список моделей связей между КЕ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "type":"Hierarchy",
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    }
  },
  {
    "sourceId":2,
    "targetId":3,
    "type":"Influence",
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    }
  },
  {
    "sourceId":4,
    "targetId":5,
    "type":"Info",
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    }
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи
labels	object	нет	{}	Метки связи

Пакетное удаление нескольких связей между КЕ

DELETE /api/public/sm/v2/rsm/config-item-edges/batch

При успешном исполнении запроса возвращается пустой ответ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "type":"Hierarchy"
  },
  {
    "sourceId":2,
    "targetId":3,
    "type":"Influence"
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи

Пакетное создание нескольких связей влияния между КЕ

POST /api/public/sm/v2/rsm/config-item-edges/influence/batch

Запрос возвращает список моделей связей между КЕ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Direct",
      "weight": 100,
      "threshold": 100
    },
    "componentName": "Common"
  },
  {
    "sourceId":2,
    "targetId":3,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Weight",
      "weight": 100,
      "threshold": 100
    },
    "componentName": null
  },
  {
    "sourceId":4,
    "targetId":5,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Weight",
      "weight": 100,
      "threshold": 100
    },
    "componentName": "Common"
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи
labels	object	нет	{}	Метки связи
health	object	нет	{"type": "Weight","weight": 100, "threshold": 100}	Настройки влияния на здоровье КЕ
componentName	string	нет	Common	Название компонента зависимой КЕ

Пакетное обновление нескольких связей влияния между КЕ

PUT /api/public/sm/v2/rsm/config-item-edges/influence/batch

Запрос возвращает список моделей связей между КЕ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Direct",
      "weight": 100,
      "threshold": 100
    },
    "componentName": "Common"
  },
  {
    "sourceId":2,
    "targetId":3,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Weight",
      "weight": 100,
      "threshold": 100
    },
    "componentName": null
  },
  {
    "sourceId":4,
    "targetId":5,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Weight",
      "weight": 100,
      "threshold": 100
    },
    "componentName": "Common"
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи
labels	object	нет	{}	Метки связи
health	object	нет	null	Настройки влияния на здоровье КЕ
componentName	string	нет	null	Название компонента зависимой КЕ

Пакетное частичное обновление нескольких связей влияния между КЕ

PATCH /api/public/sm/v2/rsm/config-item-edges/influence/batch

Запрос возвращает список моделей связей между КЕ.

Тело запроса

[
  {
    "sourceId":0,
    "targetId":1,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Direct",
      "weight": 100,
      "threshold": 100
    },
    "componentName": "Common"
  },
  {
    "sourceId":2,
    "targetId":3,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Weight",
      "weight": 100,
      "threshold": 100
    },
    "componentName": null
  },
  {
    "sourceId":4,
    "targetId":5,
    "labels": {
      "label_a_name": "label_value",
      "label_b_name": ["label_value_1", "label_value_2"],
      "label_c_name": null
    },
    "health": {
      "type": "Weight",
      "weight": 100,
      "threshold": 100
    },
    "componentName": "Common"
  }
]

Поля тела запроса

Название поля	Тип поля	Обязательное поле	Значение по умолчанию	Описание поля
sourceId	integer	да	нет	Идентификатор исходной КЕ
targetId	integer	да	нет	Идентификатор целевой КЕ
type	string	да	нет	Тип связи
labels	object	нет	{}	Метки связи
health	object	нет	null	Настройки влияния на здоровье КЕ
componentName	string	нет	null	Название компонента зависимой КЕ