DELETE тэга

Материал из Документация Ключ-АСТРОМ

Удаляет указанный пользовательский тег с указанного хоста. Удаление не может быть отменено.

DELETE Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag}
Cреда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v1/entity/infrastructure/hosts/{meIdentifier}/tags/{tag}

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр Тип Описание In Необходимость
meIdentifier string Идентификатор объекта Ключ-АСТРОМ хоста. path требуется
tag string Тег, который нужно удалить. path требуется

Ответ

Коды ответов

Код Тип Описание
204 Успех. Тег хоста удален.
400 ErrorEnvelope Не удалось. Ввод недействителен.
404 Отказ. Тег не найден.

Пример

В этом примере запрос удаляет тег Rack123 с хоста tag009 , который имеет идентификатор HOST-B7A6F9EE9F366CB5 .

Маркер API передается в заголовке авторизации .

Curl

curl -X POST \
  https://mySampleEnv.live.ruscomtech.ru/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5/tags/Rack123 \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.ruscomtech.ru/api/v1/entity/infrastructure/hosts/HOST-B7A6F9EE9F366CB5/tags/Rack123

Код ответа

204