Получение записи лога аудита

Материал из Dynatrace
Версия от 09:41, 10 марта 2022; ENetrebin (обсуждение | вклад) (Новая страница: «Данная функция извлекает указанную запись журнала аудита. {| class="wikitable" | rowspan="3" |GET |Managed |<cod...»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)

Данная функция извлекает указанную запись журнала аудита.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v2/auditlogs/{id}
SaaS https://{your-environment-id}.live.dynatrace.com/api/v2/auditlogs/{id}
Environment АктивныйШлюз https://{your-activegate-domain}/e/{your-environment-id}/api/v2/auditlogs/{id}

Аутентификация

Чтобы выполнить этот запрос, вам необходимо разрешение на чтение журналов аудита ( auditLogs.read) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр Тип Описание В Необходимость
id string id необходимой записи журнала. path требуется

Ответ

Коды ответов

Код Тип Описание
200 AuditLogEntry Успех
400 ErrorEnvelope Не удалось. Недопустимый формат ID.
404 ErrorEnvelope Не удалось. Запрошенный ресурс не существует.

Объекты тела ответа

Объект _ AuditLogEntry

Запись журнала аудита.

Элемент Тип Описание
logId string Идентификатор записи журнала.
eventType string Тип записываемой операции.

Элемент может содержать эти значения

category string Категория записываемой операции.

Элемент может содержать эти значения

entityId string ID объекта из категории .

Например, это может быть идентификатор конфигурации для CONFIGкатегории или идентификатор токена для TOKENкатегории.

Может быть null.

environmentId string Идентификатор среды Dynatrace, в которой произошла записанная операция.
user string ID пользователя, выполнившего записанную операцию.
userType string Тип аутентификации пользователя .

Элемент может содержать эти значения

  • PUBLIC_TOKEN_IDENTIFIER
  • REQUEST_ID
  • SERVICE_NAME
  • TOKEN_HASH
  • USER_NAME
userOrigin string Происхождение и IP-адрес пользователя .

Может быть null.

timestamp integer Отметка времени создания записи в миллисекундах UTC.
success boolean Записанная операция выполнена успешно ( true) или неудачно ( false).
message string Зарегистрированное сообщение.

Может быть null.

patch object Патч записанной операции в виде JSON-представления.

Формат представляет собой расширенный RFC 6902. Патч также содержит предыдущее значение в поле oldValue .

Может быть null.

JSON-модель тела ответа

{
  "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
    }
  ]
}

Пример

В этом примере запрос получает запись журнала аудита с идентификатором 157607396300050000 .

В этой записи хранится информация об изменении конфигурации дашборда с идентификатором 14b3bfe7-69d8-48bf-b08a-4f9a2ff3f703 . Изменение представляет собой изменение положения и размера плитки, выполненное пользователем Dynatrace с идентификатором пользователя 643541629 .

Маркер API передается в заголовке авторизации .

Curl

curl -X GET \
  'https://mySampleEnv.live.dynatrace.com/api/v2/auditlogs/157607396300050000' \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

URL-адрес запроса

https://mySampleEnv.live.dynatrace.com/api/v2/auditlogs/157607396300050000

Тело ответа

{
  "logId": "157607396300050000",
  "eventType": "UPDATE",
  "category": "CONFIG",
  "entityId": "DASHBOARDS_SETTINGS: 14b3bfe7-69d8-48bf-b08a-4f9a2ff3f703",
  "environmentId": "yasmuoujsw",
  "user": "Dynatrace user #643541629",
  "userType": "USER_NAME",
  "userOrigin": "webui (240.204.62.255)",
  "timestamp": 1576074315483,
  "success": true,
  "patch": [
    {
      "op": "replace",
      "path": "/tiles/24/top",
      "value": 304,
      "oldValue": 380
    },
    {
      "op": "replace",
      "path": "/tiles/24/left",
      "value": 304,
      "oldValue": 798
    },
    {
      "op": "replace",
      "path": "/tiles/24/width",
      "value": 608,
      "oldValue": 304
    },
    {
      "op": "replace",
      "path": "/tiles/24/height",
      "value": 608,
      "oldValue": 304
    }
  ]
}

Код ответа

200