Получение всех конфигураций мониторинга: различия между версиями
Материал из Dynatrace
ENetrebin (обсуждение | вклад)  | 
				ENetrebin (обсуждение | вклад)   | 
				||
| Строка 3: | Строка 3: | ||
Запрос создает <code>application/json</code>полезную нагрузку.  | Запрос создает <code>application/json</code>полезную нагрузку.  | ||
{| class="wikitable"  | {| class="wikitable"  | ||
| rowspan="3" |  | | rowspan="3" |GET  | ||
|  | |Managed  | ||
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations</nowiki></code>  | |<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations</nowiki></code>  | ||
|-  | |-  | ||
| Строка 10: | Строка 10: | ||
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations</nowiki></code>  | |<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/extensions/{extensionName}/monitoringConfigurations</nowiki></code>  | ||
|-  | |-  | ||
|Окружающая среда   | |Окружающая среда АктивногоШлюза  | ||
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations</nowiki></code>  | |<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/extensions/{extensionName}/monitoringConfigurations</nowiki></code>  | ||
|}  | |}  | ||
== Аутентификация ==  | == Аутентификация ==  | ||
Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций мониторинга расширений ( <code>extensionConfigurations.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .  | Чтобы выполнить этот запрос, вам нужен токен доступа с областью действия Чтение конфигураций мониторинга расширений ( <code>extensionConfigurations.read</code>) . Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .  | ||
== Параметры ==  | == Параметры ==  | ||
| Строка 25: | Строка 25: | ||
!Необходимый  | !Необходимый  | ||
|-  | |-  | ||
|  | |nextPageKey  | ||
|  | |string  | ||
|Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.  | |Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.  | ||
| Строка 35: | Строка 35: | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|  | |pageSize  | ||
|  | |integer  | ||
|Количество расширений в полезной нагрузке одного ответа.  | |Количество расширений в полезной нагрузке одного ответа.  | ||
| Строка 45: | Строка 45: | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|  | |extensionName  | ||
|  | |string  | ||
|Имя запрошенного расширения 2.0.  | |Имя запрошенного расширения 2.0.  | ||
|дорожка  | |дорожка  | ||
|требуется  | |требуется  | ||
|-  | |-  | ||
|  | |version  | ||
|  | |string  | ||
|Фильтрует результирующий набор конфигураций по версии расширения 2.0.  | |Фильтрует результирующий набор конфигураций по версии расширения 2.0.  | ||
|запрос  | |запрос  | ||
|по желанию  | |по желанию  | ||
|-  | |-  | ||
|  | |active  | ||
|  | |boolean  | ||
|Фильтрует результирующий набор конфигураций по активному состоянию.  | |Фильтрует результирующий набор конфигураций по активному состоянию.  | ||
|запрос  | |запрос  | ||
| Строка 73: | Строка 73: | ||
|-  | |-  | ||
|200  | |200  | ||
|  | |ExtensionMonitoringConfigurationsList  | ||
|Успех  | |Успех  | ||
|-  | |-  | ||
| Строка 93: | Строка 93: | ||
!Описание  | !Описание  | ||
|-  | |-  | ||
|  | |items  | ||
|  | |ExtensionMonitoringConfiguration[]  | ||
|Список конфигураций мониторинга расширений.  | |Список конфигураций мониторинга расширений.  | ||
|-  | |-  | ||
|  | |totalCount  | ||
|  | |integer  | ||
|Общее количество записей в результате.  | |Общее количество записей в результате.  | ||
|-  | |-  | ||
|  | |pageSize  | ||
|  | |integer  | ||
|Количество записей на странице.  | |Количество записей на странице.  | ||
|-  | |-  | ||
|  | |nextPageKey  | ||
|  | |string  | ||
|Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.  | |Курсор для следующей страницы результатов. Имеет значение <code>null</code>на последней странице.  | ||
| Строка 118: | Строка 118: | ||
!Описание  | !Описание  | ||
|-  | |-  | ||
|  | |objectId  | ||
|  | |string  | ||
|Идентификатор конфигурации  | |Идентификатор конфигурации  | ||
|-  | |-  | ||
|  | |scope  | ||
|  | |string  | ||
|Объем конфигурации  | |Объем конфигурации  | ||
|-  | |-  | ||
|  | |value  | ||
|  | |string  | ||
|Конфигурация  | |Конфигурация  | ||
|}  | |}  | ||
Версия 20:18, 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) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | В | Необходимый | 
|---|---|---|---|---|
| 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=="
}