DELETE тегов - История изменений

IKuznetsov в 14:14, 24 декабря 2024

2024-12-24T14:14:09Z

← Предыдущая версия		Версия от 14:14, 24 декабря 2024
Строка 1:		Строка 1:
	'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [~~[API АппОптима~~#:~:text=~~информацию о кластере~~-,~~Пользовательские теги~~,-~~править\|~~Пользовательские теги]] / DELETE тегов'''''		'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [https://docs.expert-apm.ru/index.php/API_%D0%90%D0%BF%D0%BF%D0%9E%D0%BF%D1%82%D0%B8%D0%BC%D0%B0#:~:text=%D0%B8%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D1%8E%20%D0%BE%20%D0%BA%D0%BB%D0%B0%D1%81%D1%82%D0%B5%D1%80%D0%B5-,%D0%9F%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D1%82%D0%B5%D0%BB%D1%8C%D1%81%D0%BA%D0%B8%D0%B5%20%D1%82%D0%B5%D0%B3%D0%B8,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Пользовательские теги] / DELETE тегов'''''

	Данная функция удаляет указанный пользовательский тег из указанных отслеживаемых объектов.		Данная функция удаляет указанный пользовательский тег из указанных отслеживаемых объектов.
Строка 140:		Строка 140:
	<{		<{
	"matchedEntitiesCount": 2		"matchedEntitiesCount": 2
	}~~</code>~~		}
	==Пример==		==Пример==
	В этом примере запрос удаляет пользовательский тег 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>.
Строка 147:		Строка 147:
	====Curl====		====Curl====
	<curl -L -X DELETE '<nowiki>https://mySampleEnv.live.AppOptima.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test'</nowiki> \		<curl -L -X DELETE '<nowiki>https://mySampleEnv.live.AppOptima.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'~~</code>~~		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
	====URL-адрес запроса====		====URL-адрес запроса====
	<code><nowiki>https://mySampleEnv.live.AppOptima.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test</nowiki></code>		<code><nowiki>https://mySampleEnv.live.AppOptima.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test</nowiki></code>
Строка 153:		Строка 153:
	<{		<{
	"matchedEntitiesCount": 3		"matchedEntitiesCount": 3
	}~~</code>~~		}
	====Код ответа====		====Код ответа====
	200		200

IKuznetsov в 12:27, 24 декабря 2024

2024-12-24T12:27:27Z

← Предыдущая версия		Версия от 12:27, 24 декабря 2024
Строка 1:		Строка 1:
	'''''[[API ~~Ключ-АСТРОМ~~]] / [[API ~~Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B~~\|Эндпойнты среды]] / [[API ~~Ключ~~-~~АСТРОМ#.D0.9F.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D0.B5%20.D1.82.D0.B5.D0.B3.D0.B8~~\|Пользовательские теги]] / DELETE тегов'''''		'''''[[API АппОптима]] / [[API АппОптима\|Эндпойнты среды]] / [[API АппОптима#:~:text=информацию о кластере-,Пользовательские теги,-править\|Пользовательские теги]] / DELETE тегов'''''

	Данная функция удаляет указанный пользовательский тег из указанных отслеживаемых объектов.		Данная функция удаляет указанный пользовательский тег из указанных отслеживаемых объектов.
Строка 6:		Строка 6:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="2" \|DELETE		\| rowspan="2" \|DELETE
	\|~~Managed~~		\|АппОптима
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tags</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tags</nowiki></code>
	\|-		\|-
Строка 52:		Строка 52:
	Вы должны установить один из этих критериев:		Вы должны установить один из этих критериев:
	*Тип объекта:<code>type("TYPE")</code>		*Тип объекта:<code>type("TYPE")</code>
	*Идентификатор объекта ~~Ключ-Астром~~: <code>entityId("id")</code>. Вы можете указать несколько идентификаторов, разделенных запятой ( <code>entityId("id-1","id-2")</code>). Все запрошенные сущности должны быть одного типа.		*Идентификатор объекта АппОптима: <code>entityId("id")</code>. Вы можете указать несколько идентификаторов, разделенных запятой ( <code>entityId("id-1","id-2")</code>). Все запрошенные сущности должны быть одного типа.
	Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное.		Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное.
	*Тег: <code>tag("value")</code>. Теги в форматах <code>[context]key:value</code>, <code>key:value</code>и <code>value</code>обнаруживаются и анализируются автоматически. Любые двоеточия ( <code>:</code>), которые являются частью ключа или значения, должны быть экранированы обратной косой чертой ( <code>\</code>), в противном случае она будет интерпретироваться как разделитель между ключом и значением. Все значения тегов чувствительны к регистру.		*Тег: <code>tag("value")</code>. Теги в форматах <code>[context]key:value</code>, <code>key:value</code>и <code>value</code>обнаруживаются и анализируются автоматически. Любые двоеточия ( <code>:</code>), которые являются частью ключа или значения, должны быть экранированы обратной косой чертой ( <code>\</code>), в противном случае она будет интерпретироваться как разделитель между ключом и значением. Все значения тегов чувствительны к регистру.
Строка 71:		Строка 71:
	*Отношения: <code>fromRelationships.<relationshipName>()</code>и <code>toRelationships.<relationshipName>()</code>. Критерий принимает селектор объектов в качестве атрибута. Чтобы получить список доступных отношений, выполните запрос типа сущности GET и проверьте поля fromRelationships и toRelationships .		*Отношения: <code>fromRelationships.<relationshipName>()</code>и <code>toRelationships.<relationshipName>()</code>. Критерий принимает селектор объектов в качестве атрибута. Чтобы получить список доступных отношений, выполните запрос типа сущности GET и проверьте поля fromRelationships и toRelationships .
	*Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type .		*Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type .
	Дополнительные сведения см. в разделе Селектор объектов в документации ~~Ключ-Астром~~.		Дополнительные сведения см. в разделе Селектор объектов в документации АппОптима.

	Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям.		Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям.
Строка 138:		Строка 138:
	\|}		\|}
	===JSON-модель тела ответа===		===JSON-модель тела ответа===
	<~~code>~~{		<{
	"matchedEntitiesCount": 2		"matchedEntitiesCount": 2
	}</code>		}</code>
Строка 146:		Строка 146:
	Маркер API передается в заголовке авторизации.		Маркер API передается в заголовке авторизации.
	====Curl====		====Curl====
	<~~code>~~curl -L -X DELETE '<nowiki>https://mySampleEnv.live.~~astromkey~~.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test'</nowiki> \		<curl -L -X DELETE '<nowiki>https://mySampleEnv.live.AppOptima.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test'</nowiki> \
	-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>		-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
	====URL-адрес запроса====		====URL-адрес запроса====
	<code><nowiki>https://mySampleEnv.live.~~astromkey~~.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test</nowiki></code>		<code><nowiki>https://mySampleEnv.live.AppOptima.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test</nowiki></code>
	====Тело ответа====		====Тело ответа====
	<~~code>~~{		<{
	"matchedEntitiesCount": 3		"matchedEntitiesCount": 3
	}</code>		}</code>
	====Код ответа====		====Код ответа====
	200		200

ENetrebin: Новая страница: «'''''API Ключ-АСТРОМ / API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндп...»

2024-06-05T18:48:58Z

Новая страница: «'''''API Ключ-АСТРОМ / API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндп...»

Новая страница

'''''[[API Ключ-АСТРОМ]] / [[API Ключ-АСТРОМ#.D0.AD.D0.BD.D0.B4.D0.BF.D0.BE.D0.B9.D0.BD.D1.82.D1.8B%20.D1.81.D1.80.D0.B5.D0.B4.D1.8B|Эндпойнты среды]] / [[API Ключ-АСТРОМ#.D0.9F.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D1.82.D0.B5.D0.BB.D1.8C.D1.81.D0.BA.D0.B8.D0.B5%20.D1.82.D0.B5.D0.B3.D0.B8|Пользовательские теги]] / DELETE тегов'''''

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

Запрос создает <code>application/json</code>полезную нагрузку.
{| class="wikitable"
| rowspan="2" |DELETE
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/tags</nowiki></code>
|-
|Среда АктивногоШлюза
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/tags</nowiki></code>
|}
==Аутентификация==
Чтобы выполнить этот запрос, вам необходимо разрешение на запись объектов ( <code>entities.write</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .
==Параметры==
{| class="wikitable"
!Параметр
!Тип
!Описание
!In
!Необходимость
|-
|key
|string
|Ключ удаляемого тега.
Если deleteAllWithKey равно <code>true</code>, то удаляются все теги с этим ключом. В противном случае удаляются только теги с точным соответствием ключа и значения.

Для тегов только со значением укажите значение здесь.
|запрос
|требуется
|-
|value
|string
|Значение удаляемого тега. Значение игнорируется, если для deleteAllWithKey установлено значение <code>true</code>.
Для тегов только со значением укажите значение в ключевом параметре.
|запрос
|необязательный
|-
|deleteAllWithKey
|boolean
|
*Если <code>true</code>, удаляются все теги с указанным ключом, независимо от значения.
*Если , удаляются <code>false</code>только теги с точным соответствием ключа и значения.
Если не установлено, <code>false</code>используется.
|запрос
|необязательный
|-
|entitySelector
|string
|Указывает сущности, для которых вы хотите удалить теги.
Вы должны установить один из этих критериев:
*Тип объекта:<code>type("TYPE")</code>
*Идентификатор объекта Ключ-Астром: <code>entityId("id")</code>. Вы можете указать несколько идентификаторов, разделенных запятой ( <code>entityId("id-1","id-2")</code>). Все запрошенные сущности должны быть одного типа.
Вы можете добавить один или несколько следующих критериев. Значения чувствительны к регистру, и <code>EQUALS</code>оператор используется, если не указано иное.
*Тег: <code>tag("value")</code>. Теги в форматах <code>[context]key:value</code>, <code>key:value</code>и <code>value</code>обнаруживаются и анализируются автоматически. Любые двоеточия ( <code>:</code>), которые являются частью ключа или значения, должны быть экранированы обратной косой чертой ( <code>\</code>), в противном случае она будет интерпретироваться как разделитель между ключом и значением. Все значения тегов чувствительны к регистру.
*Идентификатор зоны управления:<code>mzId(123)</code>
*Название зоны управления:<code>mzName("value")</code>
*Имя объекта: <code>entityName("value")</code>. По умолчанию это фильтрует объекты, имя которых содержит заданное значение и не чувствительно к регистру. Доступны следующие модификации:
**<code>entityName.equals</code>: изменяет оператор на <code>EQUALS</code>.
**<code>entityName.startsWith</code>: изменяет оператор на <code>BEGINS WITH</code>.
**<code>entityName.in</code>: позволяет указать несколько значений. Оператор <code>EQUALS</code>обращается.
**<code>caseSensitive(entityName("value"))</code>: принимает любой критерий имени сущности в качестве аргументов и делает значение чувствительным к регистру.
*Состояние здоровья (ЗДОРОВЫЙ, НЕЗДОРОВЫЙ):<code>healthState("HEALTHY")</code>
*Отметка времени первого увиденного: <code>firstSeenTms.<operator>(now-3h)</code>. Используйте любой формат метки времени из параметров from / to . Доступны следующие операторы:
**<code>lte</code>: раньше или в указанное время
**<code>lt</code>: раньше указанного времени
**<code>gte</code>: позже или в указанное время
**<code>gt</code>: позже указанного времени
*Атрибут объекта: <code><attribute>("value1","value2")</code>и <code><attribute>.exists()</code>. Чтобы получить список доступных атрибутов, выполните запрос типа сущности GET и проверьте поле свойств ответа.
*Отношения: <code>fromRelationships.<relationshipName>()</code>и <code>toRelationships.<relationshipName>()</code>. Критерий принимает селектор объектов в качестве атрибута. Чтобы получить список доступных отношений, выполните запрос типа сущности GET и проверьте поля fromRelationships и toRelationships .
*Отрицание: <code>not(<criterion>)</code>. Инвертирует любой критерий, кроме type .
Дополнительные сведения см. в разделе Селектор объектов в документации Ключ-Астром.

Чтобы задать несколько критериев, разделите их запятой ( <code>,</code>). Например, <code>type("HOST"),healthState("HEALTHY")</code>. В ответ включаются только результаты, соответствующие всем критериям.

Длина строки ограничена 10 000 символов.
|запрос
|требуется
|-
|from
|string
|Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
*Отметка времени в миллисекундах UTC.
*Читаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
*Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
**<code>m</code>: минуты
**<code>h</code>: часы
**<code>d</code>: дни
**<code>w</code>: недели
**<code>M</code>: месяцы
**<code>y</code>: годы
Если не установлено, используется относительный временной интервал 24 часа ( <code>now-24h</code>).
|запрос
|необязательный
|-
|to
|string
|Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
*Отметка времени в миллисекундах UTC.
*Человекочитаемый формат <code>2021-01-25T05:57:01.123+01:00</code>. Если часовой пояс не указан, используется UTC. Вы можете использовать пробел вместо <code>T</code>. Секунды и доли секунды не являются обязательными.
*Относительный таймфрейм, назад. Формат: <code>now-NU/A</code>, где <code>N</code>количество времени, <code>U</code>единица времени и <code>A</code>выравнивание. Выравнивание округляет все меньшие значения до ближайшего нуля в прошлом. Например, <code>now-1y/w</code>это один год назад, выровненный на неделю. Вы также можете указать относительный таймфрейм без выравнивания: <code>now-NU</code>. Поддерживаемые единицы времени для относительного таймфрейма:
**<code>m</code>: минут
**<code>h</code>: часы
**<code>d</code>: дней
**<code>w</code>: недели
**<code>M</code>: месяцы
**<code>y</code>: годы
Если не установлено, используется текущая метка времени.
|запрос
|необязательный
|}
==Ответ==
===Коды ответов===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|DeletedEntityTags
|Успех
|}
===Объекты тела ответа===
====Объект <code>DeletedEntityTags</code>====
Удален пользовательский тег.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|matchedEntitiesCount
|integer
|Количество отслеживаемых объектов, где тег был удален.
Может быть <code>null</code>.
|}
===JSON-модель тела ответа===
<code>{
"matchedEntitiesCount": 2
}</code>
==Пример==
В этом примере запрос удаляет пользовательский тег REST-test , созданный в примере запроса POST ( <code>key=REST-test</code>). Параметр запроса entitySelector снова имеет значение <code>type("HOST"),tag("easyTravel")</code>.

Маркер API передается в заголовке авторизации.
====Curl====
<code>curl -L -X DELETE '<nowiki>https://mySampleEnv.live.astromkey.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test'</nowiki> \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'</code>
====URL-адрес запроса====
<code><nowiki>https://mySampleEnv.live.astromkey.com/api/v2/tags?entitySelector=type(%22HOST%22)%2Ctag(%22easyTrave%22)&key=REST-test</nowiki></code>
====Тело ответа====
<code>{
"matchedEntitiesCount": 3
}</code>
====Код ответа====
200