Обновить тег
Обновляет существующий тег.
Добавлено в v.3.19.94.
Теги — специальные метки для поиска и групповых операций, фильтров аварий, дополнительных интерфейсов и автоматизации (в том числе discovery). Ранее в API были доступны создание тега и получение списка; в v.3.19.94 добавлено обновление с семантикой PATCH и PUT.
Запрос
HTTP Запросы
text
PATCH /node/api/tags/:id
PUT /node/api/tags/:id| Метод | Поведение |
|---|---|
PATCH | Изменяет только переданные поля, остальные сохраняются |
PUT | Полностью заменяет запись телом запроса |
Параметры пути
| Параметр | Тип | Описание |
|---|---|---|
| id | String обязательный | ID обновляемого тега. |
Параметры тела запроса
Модель Тег.
Тело запроса
json
{
"name": "XML-updated"
}Ответ
Ответ содержит обновлённый тег. Подробности — в статье Тег.
Пример
PATCH
bash
login=<...>
password=<...>
saymon_hostname=<...>
tag_id=<...>
url=https://$saymon_hostname/node/api/tags/$tag_id
curl -X PATCH $url -u $login:$password \
-H "Content-Type: application/json" \
--data '{"name": "XML-updated"}'PUT
bash
login=<...>
password=<...>
saymon_hostname=<...>
tag_id=<...>
url=https://$saymon_hostname/node/api/tags/$tag_id
curl -X PUT $url -u $login:$password \
-H "Content-Type: application/json" \
--data '{"name": "XML-replaced"}'