Получение записи лога аудита - История изменений

IKuznetsov в 09:15, 8 января 2025

2025-01-08T09:15:03Z

← Предыдущая версия		Версия от 09:15, 8 января 2025
Строка 108:		Строка 108:
	\|environmentId		\|environmentId
	\|string		\|string
	\|Идентификатор среды ~~Ключ-АСТРОМ~~, в которой произошла записанная операция.		\|Идентификатор среды АппОптима, в которой произошла записанная операция.
	\|-		\|-
	\|user		\|user
Строка 175:		Строка 175:
	}		}
	]		]
	}~~</code>~~		}

IKuznetsov в 10:42, 26 декабря 2024

2024-12-26T10:42:38Z

← Предыдущая версия		Версия от 10:42, 26 декабря 2024
Строка 2:		Строка 2:
	{\| class="wikitable"		{\| class="wikitable"
	\| rowspan="3" \|GET		\| rowspan="3" \|GET
	\|~~Managed~~		\|АппОптима
	\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/auditlogs/{id}</nowiki></code>		\|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/auditlogs/{id}</nowiki></code>
	\|-		\|-
Строка 156:		Строка 156:

	=== JSON-модель тела ответа ===		=== JSON-модель тела ответа ===
	<~~code>~~{		<{
	"logId": "197425568800060000",		"logId": "197425568800060000",
	"eventType": "UPDATE",		"eventType": "UPDATE",

Lobanov в 17:22, 15 марта 2022

2022-03-15T17:22:29Z

@@ Строка 6: / Строка 6: @@
 |-
 |SaaS
-|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/auditlogs/{id}</nowiki></code>
+|<code><nowiki>https://{your-environment-id}.live.{server-name}.com/api/v2/auditlogs/{id}</nowiki></code>
 |-
 |Environment АктивныйШлюз
@@ Строка 176: / Строка 176: @@
+    ]
   }</code>

ENetrebin в 09:52, 10 марта 2022

2022-03-10T09:52:48Z

← Предыдущая версия		Версия от 09:52, 10 марта 2022
Строка 108:		Строка 108:
	\|environmentId		\|environmentId
	\|string		\|string
	\|Идентификатор среды ~~Dynatrace~~, в которой произошла записанная операция.		\|Идентификатор среды Ключ-АСТРОМ, в которой произошла записанная операция.
	\|-		\|-
	\|user		\|user
Строка 180:		Строка 180:
	В этом примере запрос получает запись журнала аудита с идентификатором 157607396300050000 .		В этом примере запрос получает запись журнала аудита с идентификатором 157607396300050000 .

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

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

ENetrebin в 09:49, 10 марта 2022

2022-03-10T09:49:10Z

@@ Строка 13: / Строка 13: @@
 == Аутентификация ==
-Чтобы выполнить этот запрос, вам необходимо разрешение на чтение журналов аудита ( <code>auditLogs.read</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .
+Чтобы выполнить этот запрос, вам необходимо разрешение на чтение журналов аудита ( <code>auditLogs.read</code>) , назначенное вашему токену API. Чтобы узнать, как его получить и использовать, см. раздел [[Токены и аутентификация (API)|Токены и аутентификация]] .
 == Параметры ==
@@ Строка 69: / Строка 69: @@
 Элемент может содержать эти значения
 |-
 |category
@@ Строка 75: / Строка 91: @@
 Элемент может содержать эти значения
 |-
 |entityId

ENetrebin: Новая страница: «Данная функция извлекает указанную запись журнала аудита. {| class="wikitable" | rowspan="3" |GET |Managed |
2022-03-10T09:41:19Z

Новая страница: «Данная функция извлекает указанную запись журнала аудита. {| class="wikitable" | rowspan="3" |GET |Managed |<cod...»

Новая страница
Данная функция извлекает указанную запись журнала аудита.
{| class="wikitable"
| rowspan="3" |GET
|Managed
|<code><nowiki>https://{your-domain}/e/{your-environment-id}/api/v2/auditlogs/{id}</nowiki></code>
|-
|SaaS
|<code><nowiki>https://{your-environment-id}.live.dynatrace.com/api/v2/auditlogs/{id}</nowiki></code>
|-
|Environment АктивныйШлюз
|<code><nowiki>https://{your-activegate-domain}/e/{your-environment-id}/api/v2/auditlogs/{id}</nowiki></code>
|}

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

== Параметры ==
{| class="wikitable"
!Параметр
!Тип
!Описание
!В
!Необходимость
|-
|id
|string
|id необходимой записи журнала.
|path
|требуется
|}

== Ответ ==

=== Коды ответов ===
{| class="wikitable"
!Код
|Тип
!Описание
|-
|200
|AuditLogEntry
|Успех
|-
|400
|ErrorEnvelope
|Не удалось. Недопустимый формат ID.
|-
|404
|ErrorEnvelope
|Не удалось. Запрошенный ресурс не существует.
|}

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

==== Объект _ <code>AuditLogEntry</code> ====
Запись журнала аудита.
{| class="wikitable"
!Элемент
!Тип
!Описание
|-
|logId
|string
|Идентификатор записи журнала.
|-
|eventType
|string
|Тип записываемой операции.

Элемент может содержать эти значения
|-
|category
|string
|Категория записываемой операции.

Элемент может содержать эти значения
|-
|entityId
|string
|ID объекта из категории .

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

Может быть <code>null</code>.
|-
|environmentId
|string
|Идентификатор среды Dynatrace, в которой произошла записанная операция.
|-
|user
|string
|ID пользователя, выполнившего записанную операцию.
|-
|userType
|string
|Тип аутентификации пользователя .

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

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

Может быть <code>null</code>.
|-
|timestamp
|integer
|Отметка времени создания записи в миллисекундах UTC.
|-
|success
|boolean
|Записанная операция выполнена успешно ( <code>true</code>) или неудачно ( <code>false</code>).
|-
|message
|string
|Зарегистрированное сообщение.

Может быть <code>null</code>.
|-
|patch
|object
|Патч записанной операции в виде JSON-представления.

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

Может быть <code>null</code>.
|}

=== JSON-модель тела ответа ===
<code>{
"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
}
]
}</code>

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

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

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

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

==== URL-адрес запроса ====
<code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v2/auditlogs/157607396300050000</nowiki></code>

==== Тело ответа ====
<code>{
"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
}
]
}</code>

==== Код ответа ====
200