Удаление тегов: различия между версиями
Lobanov (обсуждение | вклад) м (→Параметры) |
ENetrebin (обсуждение | вклад) |
||
Строка 168: | Строка 168: | ||
В этом примере запрос удаляет пользовательский тег REST-test , созданный в примере запроса POST ( <code>key=REST-test</code>). Параметр запроса entitySelector снова имеет значение <code>type("HOST"),tag("easyTravel")</code>. | В этом примере запрос удаляет пользовательский тег REST-test , созданный в примере запроса POST ( <code>key=REST-test</code>). Параметр запроса entitySelector снова имеет значение <code>type("HOST"),tag("easyTravel")</code>. | ||
Маркер API передается в заголовке авторизации . | Маркер API передается в заголовке авторизации. | ||
==== Curl ==== | ==== Curl ==== |
Текущая версия на 06:46, 12 августа 2022
Данная функция удаляет указанный пользовательский тег из указанных отслеживаемых объектов.
Запрос создает application/json
полезную нагрузку.
DELETE | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/tags
|
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/tags
| |
Environment АктивныйШлюз | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tags
|
Аутентификация
Чтобы выполнить этот запрос, вам необходимо разрешение на запись объектов ( entities.write
) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
key | string | Ключ удаляемого тега.
Если deleteAllWithKey равно Для тегов только со значением укажите значение здесь. |
запрос | требуется |
value | string | Значение удаляемого тега. Значение игнорируется, если для deleteAllWithKey установлено значение true .
Для тегов только со значением укажите значение в ключевом параметре. |
запрос | необязательный |
deleteAllWithKey | boolean |
Если не установлено, |
запрос | необязательный |
entitySelector | string | Указывает сущности, для которых вы хотите удалить теги.
Вы должны установить один из этих критериев:
Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и
Дополнительные сведения см. в разделе Селектор объектов в документации Ключ-Астром. Чтобы задать несколько критериев, разделите их запятой ( Длина строки ограничена 10 000 символов. |
запрос | требуется |
from | string | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не установлено, используется относительный временной интервал 24 часа ( |
запрос | необязательный |
to | string | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
запрос | необязательный |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | DeletedEntityTags | Успех |
Объекты тела ответа
Объект _ DeletedEntityTags
Удален пользовательский тег.
Элемент | Тип | Описание |
---|---|---|
matchedEntitiesCount | integer | Количество отслеживаемых объектов, где тег был удален.
Может быть |
JSON-модель тела ответа
{
"matchedEntitiesCount": 2
}
Пример
В этом примере запрос удаляет пользовательский тег REST-test , созданный в примере запроса POST ( key=REST-test
). Параметр запроса entitySelector снова имеет значение type("HOST"),tag("easyTravel")
.
Маркер API передается в заголовке авторизации.
Curl
curl -L -X DELETE 'https://mySampleEnv.live.dynatrace.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test
Тело ответа
{
"matchedEntitiesCount": 3
}
Код ответа
200