Получение всех конфигураций мониторинга: различия между версиями
Материал из Документация Ключ-АСТРОМ
ENetrebin (обсуждение | вклад) |
ENetrebin (обсуждение | вклад) |
||
Строка 22: | Строка 22: | ||
!Тип | !Тип | ||
!Описание | !Описание | ||
! | !In | ||
! | !Необходимость | ||
|- | |- | ||
|nextPageKey | |nextPageKey |
Версия 20:20, 4 октября 2022
Список всех конфигураций мониторинга указанного расширения Extensions 2.0.
Запрос создает application/json
полезную нагрузку.
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations
|
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations
| |
Окружающая среда АктивногоШлюза | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations
|
Аутентификация
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций мониторинга расширений ( extensionConfigurations.read
) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
Параметр | Тип | Описание | In | Необходимость |
---|---|---|---|---|
nextPageKey | string | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
запрос | по желанию |
pageSize | integer | Количество расширений в полезной нагрузке одного ответа.
Максимально допустимый размер страницы — 100. Если не установлено, используется 20. |
запрос | по желанию |
extensionName | string | Имя запрошенного расширения 2.0. | дорожка | требуется |
version | string | Фильтрует результирующий набор конфигураций по версии расширения 2.0. | запрос | по желанию |
active | boolean | Фильтрует результирующий набор конфигураций по активному состоянию. | запрос | по желанию |
Ответ
Коды ответов
Код | Тип | Описание |
---|---|---|
200 | ExtensionMonitoringConfigurationsList | Успех |
400 | ErrorEnvelope | Не удалось. Ввод недействителен. |
404 | ErrorEnvelope | Не удалось. Запрошенный ресурс не существует. |
Объекты тела ответа
Объект _ ExtensionMonitoringConfigurationsList
Элемент | Тип | Описание |
---|---|---|
items | ExtensionMonitoringConfiguration[] | Список конфигураций мониторинга расширений. |
totalCount | integer | Общее количество записей в результате. |
pageSize | integer | Количество записей на странице. |
nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение null на последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. |
Объект _ ExtensionMonitoringConfiguration
Элемент | Тип | Описание |
---|---|---|
objectId | string | Идентификатор конфигурации |
scope | string | Объем конфигурации |
value | string | Конфигурация |
JSON-модель тела ответа
{
"items": [
{
"objectId": "string",
"scope": "string",
"value": "string"
}
],
"totalCount": 1,
"pageSize": 1,
"nextPageKey": "AQAAABQBAAAABQ=="
}