Получение лога аудита: различия между версиями
ENetrebin (обсуждение | вклад) |
Lobanov (обсуждение | вклад) |
||
| Строка 14: | Строка 14: | ||
|- | |- | ||
|SaaS | |SaaS | ||
|<code><nowiki>https://{your-environment-id}.live. | |<code><nowiki>https://{your-environment-id}.live.{server-name}.com/api/v2/auditlogs</nowiki></code> | ||
|- | |- | ||
|Environment Ключ-АСТРОМ | |Environment Ключ-АСТРОМ | ||
| Строка 300: | Строка 300: | ||
] | ] | ||
}</code> | }</code> | ||
Версия 17:18, 15 марта 2022
Данная функция извлекает журнал аудита вашей среды Ключ-АСТРОМ.
Полный список может быть длинным, поэтому вы можете сузить его, указав параметры фильтра, такие как теги. См. раздел Параметры для более подробной информации.
Вы можете ограничить вывод, используя нумерацию страниц:
- Укажите количество результатов на странице в параметре запроса pageSize .
- Затем используйте курсор из поля nextPageKey предыдущего ответа в параметре запроса nextPageKey для получения последующих страниц.
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/auditlogs
|
| SaaS | https://{your-environment-id}.live.{server-name}.com/api/v2/auditlogs
| |
| Environment Ключ-АСТРОМ | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/auditlogs
|
Аутентификация
Чтобы выполнить этот запрос, вам необходимо разрешение на чтение журналов аудита ( auditLogs.read) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
Параметры
| Параметр | Тип | Описание | In | Необходимость |
|---|---|---|---|---|
| nextPageKey | string | Курсор для следующей страницы результатов. Вы можете найти его в поле nextPageKey предыдущего ответа.
Первая страница всегда возвращается, если вы не укажете параметр запроса nextPageKey . Когда nextPageKey настроен на получение последующих страниц, вы должны опустить все остальные параметры запроса. |
запрос | необязательный |
| pageSize | integer | Количество записей журнала в полезной нагрузке одного ответа.
Максимально допустимый размер страницы — 5000. Если не установлено, используется 1000. |
запрос | необязательный |
| filter | string | Фильтрует журнал аудита. Вы можете использовать следующие критерии:
Для каждого критерия можно указать несколько альтернатив со значениями, разделенными запятыми. В этом случае применяется логика ИЛИ. Например, Вы можете указать несколько критериев, разделенных запятыми, например Укажите значение критерия в виде строки в кавычках. Следующие специальные символы должны быть экранированы тильдой (
|
запрос | необязательный |
| from | string | Начало запрошенного таймфрейма.
Вы можете использовать один из следующих форматов:
Если не задано, используется относительный двухнедельный таймфрейм ( |
запрос | необязательный |
| to | string | Конец запрошенного периода времени.
Вы можете использовать один из следующих форматов:
Если не установлено, используется текущая метка времени. |
запрос | необязательный |
| sort | string | Сортировка записей журнала аудита:
Если не установлено, применяется самая новая первая сортировка. |
запрос | необязательный |
Ответ
Коды ответов
| Код | Тип | Описание |
|---|---|---|
| 200 | Журнал аудита | Успех |
Объекты тела ответа
Объект _ AuditLog
Журнал аудита вашей среды.
| Элемент | Тип | Описание |
|---|---|---|
| totalCount | integer | Общее количество записей в результате. |
| pageSize | integer | Количество записей на странице.
Может быть |
| nextPageKey | string | Курсор для следующей страницы результатов. Имеет значение nullна последней странице.
Используйте его в параметре запроса nextPageKey для получения последующих страниц результата. Может быть |
| auditLogs | AuditLogEntry[] | Список записей журнала аудита, упорядоченных по отметке времени создания.
Может быть |
Объект _ AuditLogEntry
Запись журнала аудита.
| Элемент | Тип | Описание |
|---|---|---|
| logId | string | Идентификатор записи журнала. |
| eventType | string | Тип записываемой операции.
Элемент может содержать эти значения
|
| category | string | Категория записываемой операции.
Элемент может содержать эти значения
|
| entityId | string | ID объекта из категории .
Например, это может быть идентификатор конфигурации для Может быть |
| environmentId | string | Идентификатор среды Ключ-АСТРОМ, в которой произошла записанная операция. |
| user | string | Идентификатор пользователя, выполнившего записанную операцию. |
| userType | string | Тип аутентификации пользователя .
Элемент может содержать эти значения
|
| userOrigin | string | Происхождение и IP-адрес пользователя .
Может быть |
| timestamp | integer | Отметка времени создания записи в миллисекундах UTC. |
| success | boolean | Записанная операция выполнена успешно ( true) или неудачно ( false).
|
| message | string | Зарегистрированное сообщение.
Может быть |
| patch | object | Патч записанной операции в виде JSON-представления.
Формат представляет собой расширенный RFC 6902. Патч также содержит предыдущее значение в поле oldValue . Может быть |
JSON-модель тела ответа
{
"totalCount": 10,
"pageSize": 5,
"nextPageKey": "___a7acX3q0AAAAAACJidWlsdGluOnNlcnZpY2lUVEJCUzBaNVIxVjJOSGt6Y3oyLTcwMUZWRkxlclH__9rtpxferQ",
"auditLogs": [
{
"logId": "197425568800060000",
"eventType": "UPDATE",
"category": "CONFIG",
"entityId": "MOBILE_RUM: MOBILE_APPLICATION-752C223D59734CD2",
"environmentId": "prod-env-13",
"user": "test.user@company.com",
"userType": "USER_NAME",
"userOrigin": "webui (192.168.0.2)",
"timestamp": 1974255688445,
"success": true,
"patch": [
{
"op": "replace",
"path": "/refreshTimeIntervalMillis",
"value": 30000,
"oldValue": 20000
}
]
}
]
}
