Получить аудит-лог Почты
Возвращает список событий в аудит-логе Почты организации.
HTTP-запрос
GET https://api360.yandex.net/security/v1/org/{orgId}/audit_log/mail\
?pageSize={integer}\
&pageToken={string}\
&beforeDate={string}\
&afterDate={string}\
&includeUids={array}\
&excludeUids={array}\
&types={array}
Path-параметры
* Обязательный параметр
Query-параметры
pageSize * | integer Количество событий на странице. Максимальное значение — |
pageToken | string Токен постраничной навигации. |
beforeDate | string Верхняя граница периода выборки в формате ISO 8601, например |
afterDate | string Нижняя граница периода выборки в формате ISO 8601, например |
includeUids | array Список пользователей, действия которых должны быть включены в список событий. |
excludeUids | array Список пользователей, действия которых должны быть исключены из списка событий. |
types | array Типы событий которые должны быть включены в список. По умолчанию включаются все события. |
pageSize * | integer Количество событий на странице. Максимальное значение — |
pageToken | string Токен постраничной навигации. |
beforeDate | string Верхняя граница периода выборки в формате ISO 8601, например |
afterDate | string Нижняя граница периода выборки в формате ISO 8601, например |
includeUids | array Список пользователей, действия которых должны быть включены в список событий. |
excludeUids | array Список пользователей, действия которых должны быть исключены из списка событий. |
types | array Типы событий которые должны быть включены в список. По умолчанию включаются все события. |
* Обязательный параметр
Ответы
Код 200
Запрос успешно выполнен.
{ "events": [ { "actorUid": string, "bcc": string, "cc": string, "clientIp": string, "date": string, "destMid": string, "eventType": string, "folderName": string, "folderType": string, "from": string, "labels": [ string ], "mid": string, "msgId": string, "orgId": integer, "requestId": string, "source": string, "subject": string, "to": string, "uniqId": string, "userLogin": string, "userName": string, "userUid": string } ], "nextPageToken": string }
Скопировано
Представление
Поля
events[] | array Список событий. |
events[]. | string Исполнитель операции от имени ящика. |
events[]. | string Адресат из поля «Скрытая копия». |
events[]. | string Адресат из поля «Копия». |
events[]. | string IP клиента. |
events[]. | string Дата и время события по UTC в формате ISO 8601: |
events[]. | string Идентификатор нового письма при копировании. |
events[]. | string Значение по умолчанию:
|
events[]. | string Название личной (созданной пользователем) папки. |
events[]. | string |
events[]. | string Отправитель (значение поля «От кого»). |
events[]. | array Системные метки письма.
|
events[]. | string Идентификатор письма. |
events[]. | string Заголовок |
events[]. | integer Идентификатор организации. |
events[]. | string Идентификатор запроса в системе. Может быть неуникальным, например при групповых операциях. |
events[]. | string Источник события.
|
events[]. | string Тема письма. |
events[]. | string Получатели (значение поля «Кому»). |
events[]. | string Уникальный идентификатор события. |
events[]. | string Логин пользователя. |
events[]. | string Имя пользователя. |
events[]. | string Идентификатор пользователя. |
nextPageToken | string Токен для получения следующей страницы постраничной навигации. |
events[] | array Список событий. |
events[]. | string Исполнитель операции от имени ящика. |
events[]. | string Адресат из поля «Скрытая копия». |
events[]. | string Адресат из поля «Копия». |
events[]. | string IP клиента. |
events[]. | string Дата и время события по UTC в формате ISO 8601: |
events[]. | string Идентификатор нового письма при копировании. |
events[]. | string Значение по умолчанию:
|
events[]. | string Название личной (созданной пользователем) папки. |
events[]. | string |
events[]. | string Отправитель (значение поля «От кого»). |
events[]. | array Системные метки письма.
|
events[]. | string Идентификатор письма. |
events[]. | string Заголовок |
events[]. | integer Идентификатор организации. |
events[]. | string Идентификатор запроса в системе. Может быть неуникальным, например при групповых операциях. |
events[]. | string Источник события.
|
events[]. | string Тема письма. |
events[]. | string Получатели (значение поля «Кому»). |
events[]. | string Уникальный идентификатор события. |
events[]. | string Логин пользователя. |
events[]. | string Имя пользователя. |
events[]. | string Идентификатор пользователя. |
nextPageToken | string Токен для получения следующей страницы постраничной навигации. |
* Обязательный параметр
Код 401
Пользователь не авторизован.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
* Обязательный параметр
Код 403
У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
* Обязательный параметр
Код 404
Запрашиваемый ресурс не найден.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
* Обязательный параметр
Код 500
Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.
{ "code": integer, "details": [ { "@type": string } ], "message": string }
Скопировано
Представление
Поля
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
code | integer Код ошибки. |
details[] | array Дополнительные сведения об ошибке. |
details[]. | string |
message | string Описание ошибки. |
* Обязательный параметр