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

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

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	Тип записываемой операции. Элемент может содержать эти значения CREATE DELETE GENERAL GET LOGIN LOGOUT PATCH POST PUT READ REVOKE TAG_ADD TAG_REMOVE TAG_UPDATE UPDATE
category	string	Категория записываемой операции. Элемент может содержать эти значения CONFIG DEBUG_UI MANUAL_TAGGING_SERVICE TOKEN WEB_UI
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