DELETE тэга
Материал из Документация Ключ-АСТРОМ
Версия от 17:28, 12 октября 2022; ENetrebin (обсуждение | вклад) (Новая страница: «Удаляет указанный пользовательский тег с указанного хоста. Удаление не может быть отмен...»)
Удаляет указанный пользовательский тег с указанного хоста. Удаление не может быть отменено.
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