Управление связями КЕ
Создание связи подчинения между КЕ
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 | Название компонента зависимой КЕ |