Селектор объектов - История изменений

IKuznetsov в 16:16, 2 января 2025

2025-01-02T16:16:17Z

← Предыдущая версия		Версия от 16:16, 2 января 2025
Строка 1:		Строка 1:
			'''''[[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=DELETE%20%D1%82%D0%B5%D0%B3%D0%BE%D0%B2-,%D0%A0%D0%B0%D0%B7%D0%B2%D1%91%D1%80%D1%82%D1%8B%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5,-%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C Развёртывание] / [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%9E%D1%82%D1%81%D0%BB%D0%B5%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5%20%D0%BE%D0%B1%D1%8A%D0%B5%D0%BA%D1%82%D1%8B%20v2 Отслеживаемые объекты v2] / Селектор объектов'''''

	Селектор объектов— это мощный инструмент для указания, какие сущности вы хотите включить в область вызовов API среды v2. Он используется в нескольких API, поэтому вам нужно выучить синтаксис только один раз, а затем повторно использовать его для нескольких вариантов использования.		Селектор объектов— это мощный инструмент для указания, какие сущности вы хотите включить в область вызовов API среды v2. Он используется в нескольких API, поэтому вам нужно выучить синтаксис только один раз, а затем повторно использовать его для нескольких вариантов использования.

Строка 25:		Строка 27:
	Тип объекта, который вы хотите запросить.		Тип объекта, который вы хотите запросить.

	Вы можете получить список доступных типов ~~службс~~ помощью вызова GET для всех типов служб.		Вы можете получить список доступных типов служб с помощью вызова GET для всех типов служб.
	{\| class="wikitable"		{\| class="wikitable"
	!		!
Строка 48:		Строка 50:
	Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.		Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.

	Вы можете получить список доступных ~~службс~~ помощью вызова списка службGET .		Вы можете получить список доступных служб с помощью вызова списка службGET .
	{\| class="wikitable"		{\| class="wikitable"
	!		!
Строка 69:		Строка 71:
	Имя запрошенного объекта.		Имя запрошенного объекта.

	Вы можете получить список доступных ~~службс~~ помощью вызова GET списка объектов .		Вы можете получить список доступных служб с помощью вызова GET списка объектов .
	{\| class="wikitable"		{\| class="wikitable"
	!		!

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

2024-12-26T14:52:36Z

← Предыдущая версия		Версия от 14:52, 26 декабря 2024
Строка 43:		Строка 43:
	\|}		\|}

	== Идентификатор объекта ~~Ключ-АСТРОМ~~ ==		== Идентификатор объекта АппОптима ==
	Идентификатор объекта ~~Ключ-АСТРОМ~~ запрошенного объекта.		Идентификатор объекта АппОптима запрошенного объекта.

	Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.		Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.

IKuznetsov в 17:18, 14 августа 2024

2024-08-14T17:18:58Z

← Предыдущая версия		Версия от 17:18, 14 августа 2024
Строка 1:		Строка 1:
	Селектор ~~сущностей —~~ это мощный инструмент для указания, какие сущности вы хотите включить в область вызовов API среды v2. Он используется в нескольких API, поэтому вам нужно выучить синтаксис только один раз, а затем повторно использовать его для нескольких вариантов использования.		Селектор объектов— это мощный инструмент для указания, какие сущности вы хотите включить в область вызовов API среды v2. Он используется в нескольких API, поэтому вам нужно выучить синтаксис только один раз, а затем повторно использовать его для нескольких вариантов использования.

	Необходимо указать один из следующих критериев:		Необходимо указать один из следующих критериев:
Строка 25:		Строка 25:
	Тип объекта, который вы хотите запросить.		Тип объекта, который вы хотите запросить.

	Вы можете получить список доступных типов ~~сущностей с~~ помощью вызова GET для всех типов ~~сущностей~~ .		Вы можете получить список доступных типов службс помощью вызова GET для всех типов служб.
	{\| class="wikitable"		{\| class="wikitable"
	!		!
Строка 48:		Строка 48:
	Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.		Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.

	Вы можете получить список доступных ~~сущностей с~~ помощью вызова списка ~~сущностей GET~~ .		Вы можете получить список доступных службс помощью вызова списка службGET .
	{\| class="wikitable"		{\| class="wikitable"
	!		!
Строка 69:		Строка 69:
	Имя запрошенного объекта.		Имя запрошенного объекта.

	Вы можете получить список доступных ~~сущностей с~~ помощью вызова GET списка объектов .		Вы можете получить список доступных службс помощью вызова GET списка объектов .
	{\| class="wikitable"		{\| class="wikitable"
	!		!

ENetrebin: Новая страница: «Селектор сущностей — это мощный инструмент для указания, какие сущности вы хотите включ...»

2022-10-14T11:03:15Z

Новая страница: «Селектор сущностей — это мощный инструмент для указания, какие сущности вы хотите включ...»

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

Селектор сущностей — это мощный инструмент для указания, какие сущности вы хотите включить в область вызовов API среды v2. Он используется в нескольких API, поэтому вам нужно выучить синтаксис только один раз, а затем повторно использовать его для нескольких вариантов использования.

Необходимо указать один из следующих критериев:

* Тип объекта
* Идентификатор объекта

Кроме того, вы можете указать следующие критерии в любой комбинации:

* Имя объекта
* Атрибут объекта
* Тэг
* Идентификатор зоны управления
* Название зоны управления
* Состояние здоровья

Если указать несколько критериев, в ответ будут включены только результаты, соответствующие всем критериям.

== Ограничения ==
Общая длина строки entitySelector ограничена 10 000 символов.

Вы можете выбрать только один тип объекта для каждого запроса.

== Тип объекта ==
Тип объекта, который вы хотите запросить.

Вы можете получить список доступных типов сущностей с помощью вызова GET для всех типов сущностей .
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>type("value")</code>
|-
|Несколько значений
|нет
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|нет
|}

== Идентификатор объекта Ключ-АСТРОМ ==
Идентификатор объекта Ключ-АСТРОМ запрошенного объекта.

Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>). Все запрошенные сущности должны быть одного типа.

Вы можете получить список доступных сущностей с помощью вызова списка сущностей GET .
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>entityId("id-1","id-2")</code>
|-
|Несколько значений
|да
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|нет
|}

== Имя объекта ==
Имя запрошенного объекта.

Вы можете получить список доступных сущностей с помощью вызова GET списка объектов .
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>entityName("name")</code>
|-
|Несколько значений
|нет
|-
|Оператор значения
|<code>CONTAINS</code>
|-
|Значение с учетом регистра
|нет
|}

=== Старт с модификации ===
Изменяет оператор значения критерия имени объекта на <code>BEGINS WITH</code>.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>entityName.startsWith("name")</code>
|-
|Несколько значений
|нет
|-
|Оператор значения
|<code>BEGINS WITH</code>
|-
|Значение с учетом регистра
|нет
|}

=== Равная модификация ===
Изменяет оператор значения критерия имени объекта на <code>EQUALS</code>.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>entityName.equals("name")</code>
|-
|Несколько значений
|нет
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|нет
|}

=== Модификация одного из значений ===
Позволяет указать несколько значений для критерия имени объекта.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>entityName.in("name1","name2")</code>
|-
|Несколько значений
|да
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|нет
|}

=== Модификация с учетом регистра ===
По умолчанию оценка имен объектов не учитывает регистр. Вы можете ужесточить критерий, используя <code>caseSensitive</code>модификацию. Он принимает любой критерий имени объекта в качестве аргумента (включая те, которые уже изменены с помощью модификаторов <code>.startsWith</code>или <code>.equals</code>) и оценивает значения как чувствительные к регистру.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>caseSensitive(<entity name criterion>)</code>
|-
|Несколько аргументов
|нет
|}

== Атрибут объекта ==
Пара 'имя атрибута — значение атрибута', которую должен иметь запрошенный объект.

Чтобы указать несколько значений атрибута, разделите их запятыми ( <code>,</code>).

Чтобы получить список доступных атрибутов, выполните вызов типа объекта GET и проверьте поле свойств . Вы можете использовать атрибуты со значениями, которые могут быть представлены строкой.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code><attribute name>("attribute value")</code>
|-
|Несколько значений
|да
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Имя атрибута с учетом регистра
|нет
|-
|Значение атрибута с учетом регистра
|да
|}

=== Существующая модификация ===
Изменяет оператор критерия атрибута объекта на <code>EXISTS</code>. В этом случае условие выбирает объекты, которые имеют атрибут, независимо от значения атрибута.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code><attribute name>.exists()</code>
|-
|Оператор
|<code>EXISTS</code>
|}

== Тэг ==
Тег запрошенных сущностей. Теги в форматах <code>[context]key:value</code>, <code>key:value</code>и <code>value</code>обнаруживаются и анализируются автоматически. Если в теге, содержащем только значение, есть двоеточие ( <code>:</code>), вы должны экранировать двоеточие обратной косой чертой ( <code>\</code>). В противном случае тег будет проанализирован как <code>key:value</code>тег.

Чтобы указать несколько тегов, разделите их запятой ( <code>,</code>). Объект с любым из указанных тегов включается в ответ.

Вы можете получить список доступных тегов с помощью пользовательских тегов GET и вызовов автоматических тегов GET .
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>tag("[context]key1:value-1","key2:value-2","value-3")</code>
|-
|Несколько значений
|да
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|да
|}

== Идентификатор зоны управления ==
Идентификатор зоны управления, к которой принадлежат запрошенные объекты.

Чтобы указать несколько идентификаторов, разделите их запятой ( <code>,</code>).

Вы можете получить список доступных зон управления с помощью вызова GET для всех зон управления .
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>mzId("123456789","987654321")</code>
|-
|Несколько значений
|да
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|неприменимо
|}

== Название зоны управления ==
Имя зоны управления, к которой принадлежат запрошенные объекты.

Чтобы указать несколько имен, разделите их запятой ( <code>,</code>).

Вы можете получить список доступных зон управления с помощью вызова GET для всех зон управления .
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>mzName("name-1","name-2")</code>
|-
|Несколько значений
|да
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|да
|}

== Состояние здоровья ==
Состояние работоспособности запрошенных сущностей. Возможные значения <code>HEALTHY</code>и <code>UNHEALTHY</code>.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>healthState("HEALTHY")</code>
|-
|Несколько значений
|нет
|-
|Оператор значения
|<code>EQUALS</code>
|-
|Значение с учетом регистра
|да
|}

== Первый взгляд ==
Отметка времени (в миллисекундах UTC), когда объект был замечен в первый раз.
{| class="wikitable"
|Синтаксис
|<code>firstSeenTms.<operator>(timestamp)</code>
|-
|Несколько значений
|нет
|-
|Оператор значения
|
* <code>lte</code>: раньше или в указанное время
* <code>lt</code>: раньше указанного времени
* <code>gte</code>: позже или в указанное время
* <code>gt</code>: позже указанного времени
|-
|Значение с учетом регистра
|неприменимо
|}

== Отношения ==
Отношения, которые должен иметь запрошенный объект.

Чтобы получить список доступных отношений, выполните вызов типа объекта GET и проверьте поля fromRelationships и toRelationships .
{| class="wikitable"
|Синтаксис
|
* <code>fromRelationships.<relationship>(<entitySelector>)</code>
* <code>toRelationships.<relationship>(<entitySelector>)</code>
|-
|Несколько аргументов
|нет
|-
|Примечание
|Принимает селектор объекта в качестве атрибута.
|}

== Критерий отрицания ==
Вы можете использовать <code>not</code>модификацию для инвертирования любого критерия, кроме типа . Он принимает критерий в качестве аргумента и инвертирует условие. Например, <code>not(tag("Infrastructure:Linux"))</code>критерий выбирает объекты, у которых нет ''тега'' Infrastructure :Linux .

Вы можете использовать инвертированные критерии как часть сложных селекторов, как и любые другие критерии.
{| class="wikitable"
!
!
|-
|Синтаксис
|<code>not (<criterion>)</code>
|-
|Несколько аргументов
|нет
|-
|Примечание
|Не поддерживает критерии типа .
|}