Получение всех свойств события: различия между версиями
ENetrebin (обсуждение | вклад) (Новая страница: «Список всех свойств событий, предоставляемых Dynatrace. Запрос создает <code>application/json</code>поле...») |
ENetrebin (обсуждение | вклад) |
||
Строка 1: | Строка 1: | ||
Список всех свойств событий, предоставляемых | Список всех свойств событий, предоставляемых Ключ-АСТРОМ. | ||
Запрос создает <code>application/json</code>полезную нагрузку. | Запрос создает <code>application/json</code>полезную нагрузку. | ||
{| class="wikitable" | {| class="wikitable" | ||
| rowspan="3" |ПОЛУЧИТЬ | | rowspan="3" |ПОЛУЧИТЬ | ||
Строка 14: | Строка 10: | ||
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/eventProperties</nowiki></code> | |<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/eventProperties</nowiki></code> | ||
|- | |- | ||
|Окружающая среда | |Окружающая среда АктивногоШлюза | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/eventProperties</nowiki></code> | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/eventProperties</nowiki></code> | ||
|} | |} | ||
== Аутентификация == | == Аутентификация == | ||
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение событий ( <code>events.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация . | Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение событий ( <code>events.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] . | ||
== Параметры == | == Параметры == | ||
Строка 26: | Строка 22: | ||
!Тип | !Тип | ||
!Описание | !Описание | ||
! | !In | ||
! | !Необходимость | ||
|- | |- | ||
|ключ следующей страницы | |ключ следующей страницы | ||
| | |string | ||
|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа. | |Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа. | ||
Строка 40: | Строка 36: | ||
|- | |- | ||
|размер страницы | |размер страницы | ||
| | |integer | ||
|Количество свойств события в полезной нагрузке одного ответа. | |Количество свойств события в полезной нагрузке одного ответа. | ||
Строка 59: | Строка 55: | ||
|- | |- | ||
|200 | |200 | ||
| | |EventPropertyDetails | ||
|Успех | |Успех | ||
|} | |} | ||
Строка 72: | Строка 68: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |eventProperties | ||
| | |EventPropertyDetail[] | ||
|Список свойств события. | |Список свойств события. | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |pageSize | ||
| | |integer | ||
|Количество записей на странице. | |Количество записей на странице. | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |nextPageKey | ||
| | |string | ||
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице. | |Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице. | ||
Строка 92: | Строка 88: | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |totalCount | ||
| | |integer | ||
|Общее количество записей в результате. | |Общее количество записей в результате. | ||
|} | |} | ||
Строка 104: | Строка 100: | ||
!Описание | !Описание | ||
|- | |- | ||
| | |displayName | ||
| | |string | ||
|Отображаемое имя свойства события. | |Отображаемое имя свойства события. | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |writable | ||
|логический | |логический | ||
|Указывает, может ли свойство быть установлено во время приема события. | |Указывает, может ли свойство быть установлено во время приема события. | ||
Строка 116: | Строка 112: | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |key | ||
| | |string | ||
|Ключ свойства события. | |Ключ свойства события. | ||
Может быть <code>null</code>. | Может быть <code>null</code>. | ||
|- | |- | ||
| | |description | ||
| | |string | ||
|Краткое описание свойства события. | |Краткое описание свойства события. | ||
Строка 149: | Строка 145: | ||
Маркер API передается в заголовке авторизации . | Маркер API передается в заголовке авторизации . | ||
==== | ==== Curl ==== | ||
<code>curl --request GET \ | <code>curl --request GET \ | ||
--url '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/eventProperties?pageSize=3'</nowiki> \ | --url '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/eventProperties?pageSize=3'</nowiki> \ |
Версия 14:13, 14 апреля 2022
Список всех свойств событий, предоставляемых Ключ-АСТРОМ.
Запрос создает application/json
полезную нагрузку.
ПОЛУЧИТЬ | Удалось | https://{your-domain}/e/{your-environment-id}/api/v2/eventProperties
|
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/eventProperties
| |
Окружающая среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/eventProperties
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение событий ( events.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
ключ следующей страницы | string | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
запрос | необязательный |
размер страницы | integer | Количество свойств события в полезной нагрузке одного ответа.
Максимально допустимый размер страницы – 500. Если не установлено, используется 100. |
запрос | необязательный |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | EventPropertyDetails | Успех |
Объекты тела ответа
Объект _ EventPropertyDetails
Список свойств события.
Элемент | Тип | Описание |
---|---|---|
eventProperties | EventPropertyDetail[] | Список свойств события.
Может быть |
pageSize | integer | Количество записей на странице.
Может быть |
nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. Может быть |
totalCount | integer | Общее количество записей в результате. |
Объект _ EventPropertyDetail
Конфигурация свойства события.
Элемент | Тип | Описание |
---|---|---|
displayName | string | Отображаемое имя свойства события.
Может быть |
writable | логический | Указывает, может ли свойство быть установлено во время приема события.
Может быть |
key | string | Ключ свойства события.
Может быть |
description | string | Краткое описание свойства события.
Может быть |
JSON-модель тела ответа
{
"eventProperties": [
{
"displayName": "Custom description",
"writable": true,
"key": "dt.event.description",
"description": "string"
}
],
"pageSize": 1,
"nextPageKey": "AQAAABQBAAAABQ==",
"totalCount": 1
}
Пример
В этом примере в запросе перечислены все доступные свойства событий, доступные в среде mySampleEnv . Результат усекается до трех записей
Маркер API передается в заголовке авторизации .
Curl
curl --request GET \
--url 'https://mySampleEnv.live.dynatrace.com/api/v2/eventProperties?pageSize=3' \
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
URL-адрес запроса
https://mySampleEnv.live.dynatrace.com/api/v2/eventProperties?pageSize=3
Тело ответа
{
"totalCount": 23,
"pageSize": 3,
"nextPageKey": "AQAAAAMBAAAAAw==",
"eventProperties": [
{
"key": "dt.event.allow_davis_merge",
"displayName": "Allow Davis merge",
"description": "Allow Davis AI to merge this event into existing problems (true) or force creating a new problem (false)",
"writable": true
},
{
"key": "dt.event.baseline.service_method",
"displayName": "Baseline affected service method",
"description": "Lists affected service methods of the triggered service event",
"writable": false
},
{
"key": "dt.event.baseline.total_load",
"displayName": "Baseline total load",
"description": "The load (calls per minute) of the entire service or application for triggered event",
"writable": false
}
]
}
Код ответа
200