DELETE тэга

Развёртывание / Топология и Smartscape v1 / Хосты / 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