Обновить тег

Обновить тег

Обновить тег ​

Обновляет существующий тег.

Добавлено в 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Полностью заменяет запись телом запроса

Параметры пути ​

ПараметрТипОписание
idString обязательный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"}'