Получение аудит-логов
Возвращает список событий в аудит-логе организации. Для этого у организации должен быть подключен тариф с поддержкой аудит-логов. Какие есть тарифы
Поддерживает фильтрацию по времени, типам событий, пользователям, источнику запроса и IP-адресу пользователя — инициатора события. Использует постраничную навигацию для обработки больших наборов данных.
Для выполнения запроса требуется право ya360_security:read_auditlog.
Request
GET
https://cloud-api.yandex.net/v1/auditlog/organizations/{org_id}/events
Path parameters
|
Name |
Description |
|
org_id |
Type: integer Идентификатор организации. |
Query parameters
|
Name |
Description |
|
count |
Type: integer Максимальное количество событий на одной странице результатов от |
|
ended_at |
Type: string<date-time> Дата и время окончания аудит-лога в формате ISO 8601, например Example: |
|
exclude_uids |
Type: string Идентификаторы пользователей, действия которых должны быть исключены из списка событий. Чтобы указать несколько человек, задайте их идентификаторы через запятую без пробела, например Example: |
|
include_uids |
Type: string Идентификаторы пользователей, действия которых должны быть включены в список событий. Чтобы указать несколько человек, задайте их идентификаторы через запятую без пробела, например Example: |
|
ip |
Type: string IP-адрес, с которого было выполнено действие. Может принимать только одно значение. Example: |
|
iteration_key |
Type: string Ключ для получения следующей страницы результатов. Example: |
|
service |
Type: string Источник запроса — может принимать только одно значение:
Example: |
|
started_at |
Type: string<date-time> Дата и время начала аудит-лога в формате ISO 8601, например Default: `` Example: |
|
types |
Type: string Типы событий, которые должны быть включены в список. Чтобы указать несколько типов, задайте их через запятую без пробела, например Example: |
Responses
200 OK
Получен список событий в аудит-логе и ключ для перехода к следующей странице результатов.
Body
application/json
{
"iteration_key": "5",
"items": [
{
"event": {
"uid": 1230000000000001,
"org_id": 1234567,
"occurred_at": "2025-04-28T13:50:17+00:00",
"type": "id_cookie.set",
"service": "ID",
"request_id": "request-1234567890abcdef",
"idempotency_id": "12345678-90ab-cdef-1234-567890abcdef",
"ip": "192.0.2.1",
"is_system": false,
"status": "Success",
"meta": {}
},
"user_login": "user@example.com",
"user_name": "Иван Иванов"
}
]
}
|
Name |
Description |
|
items |
Type: AuditlogEventArray Массив событий в аудит-логе. Example
|
|
iteration_key |
Type: string Ключ для получения следующей страницы результатов. Отсутствует, если событий больше нет. Example: |
AuditlogEvent
Событие с указанием всех параметров.
|
Name |
Description |
|
idempotency_id |
Type: string Идентификатор события. Example: |
|
ip |
Type: string IP-адрес пользователя — инициатора события. Для автоматических событий, инициированных не пользователем, указывается адрес локального хоста. Example: |
|
is_system |
Type: boolean Параметр не используется, возвращается всегда |
|
meta |
Type: objectJSON-фрагмент с дополнительными параметрами. Example
|
|
occurred_at |
Type: string<date-time> Дата и время события в формате ISO 8601, например Example: |
|
org_id |
Type: integer Идентификатор организации. |
|
request_id |
Type: string Идентификатор запроса — для его отслеживания и быстрой диагностики проблем. Example: |
|
service |
Type: string Источник запроса.
Enum: |
|
status |
Type: string Результат запроса. Возможные значения:
Enum: |
|
type |
Type: string Тип события. Какие есть типы Example: |
|
uid |
Type: integer Идентификатор пользователя — инициатора события. |
Example
{
"uid": 1230000000000001,
"org_id": 1234567,
"occurred_at": "2025-04-28T13:50:17+00:00",
"type": "id_cookie.set",
"service": "ID",
"request_id": "request-1234567890abcdef",
"idempotency_id": "12345678-90ab-cdef-1234-567890abcdef",
"ip": "192.0.2.1",
"is_system": false,
"status": "Success",
"meta": {}
}
EnrichedEvent
Событие с указанием логина и имени пользователя — инициатора события.
|
Name |
Description |
|
event |
Type: AuditlogEvent Событие с указанием всех параметров. Example
|
|
user_login |
Type: string Логин пользователя. Example: |
|
user_name |
Type: string Имя пользователя. Example: |
Example
{
"event": {
"uid": 1230000000000001,
"org_id": 1234567,
"occurred_at": "2025-04-28T13:50:17+00:00",
"type": "id_cookie.set",
"service": "ID",
"request_id": "request-1234567890abcdef",
"idempotency_id": "12345678-90ab-cdef-1234-567890abcdef",
"ip": "192.0.2.1",
"is_system": false,
"status": "Success",
"meta": {}
},
"user_login": "user@example.com",
"user_name": "Иван Иванов"
}
AuditlogEventArray
Массив событий в аудит-логе.
Type: EnrichedEvent[]
Example
[
{
"event": {
"uid": 1230000000000001,
"org_id": 1234567,
"occurred_at": "2025-04-28T13:50:17+00:00",
"type": "id_cookie.set",
"service": "ID",
"request_id": "request-1234567890abcdef",
"idempotency_id": "12345678-90ab-cdef-1234-567890abcdef",
"ip": "192.0.2.1",
"is_system": false,
"status": "Success",
"meta": {}
},
"user_login": "user@example.com",
"user_name": "Иван Иванов"
}
]
400 Bad Request
Request parameters are not set or are incorrect.
Body
application/json
{
"error": "bad_request",
"description": "Request parameters are not set or are incorrect.",
"message": "Request parameters are not set or are incorrect.",
"details": {}
}
|
Name |
Description |
|
description |
Type: string Техническое описание ошибки. Example: |
|
error |
Type: string Код ошибки Example: |
|
message |
Type: string Сообщение об ошибке. Example: |
|
details |
Type: objectДополнительные детали ошибки Example
|
403 Forbidden
Insufficient permissions to perform the operation.
Body
application/json
{
"error": "forbidden",
"description": "Insufficient permissions to perform the operation.",
"message": "Insufficient permissions to perform the operation.",
"details": {}
}
|
Name |
Description |
|
description |
Type: string Техническое описание ошибки. Example: |
|
error |
Type: string Код ошибки Example: |
|
message |
Type: string Сообщение об ошибке. Example: |
|
details |
Type: objectДополнительные детали ошибки Example
|
404 Not Found
The requested audit log for the organization was not found.
Body
application/json
{
"error": "not_found",
"description": "The requested audit log for the organization was not found.",
"message": "The requested audit log for the organization was not found.",
"details": {}
}
|
Name |
Description |
|
description |
Type: string Техническое описание ошибки. Example: |
|
error |
Type: string Код ошибки Example: |
|
message |
Type: string Сообщение об ошибке. Example: |
|
details |
Type: objectДополнительные детали ошибки Example
|
Типы событий в ответе
Этот метод не возвращает список событий Почты. Как его получить
События авторизации пользователей-сотрудников
|
Имя события |
Описание |
|
|
Вход через браузер или мобильное приложение. |
|
|
Вход с помощью OAuth-токена. |
|
|
Вход через мобильное приложение. |
|
|
Вход с использованием пароля приложения. |
|
|
Выход из аккаунта на всех устройствах. |
|
|
Смена пароля пользователя. |
В зависимости от способа входа возвращается одно или несколько событий:
|
Способ входа |
Отображаемые события |
|
Браузер |
Только |
|
Мобильное приложение |
|
События управления аккаунтами пользователей-сотрудников
|
Имя события |
Описание |
|
|
Создание пользователя. |
|
|
Удаление пользователя. |
|
|
Блокировка пользователя. |
|
|
Разблокировка пользователя. |
|
|
Изменение данных пользователя. |
|
|
Добавление почтового алиаса — дополнительного адреса электронной почты, письма с которого перенаправляются на основной почтовый ящик пользователя. |
|
|
Удаление почтового алиаса. |
|
|
Смена пароля пользователя администратором. |
|
|
Создание ссылки для приглашения пользователя в организацию. |
|
|
Переход по ссылке-приглашению. |
События управления организацией
|
Имя события |
Описание |
|
|
Смена владельца организации. |
|
|
Изменение данных организации. |
|
|
Изменение настроек единого входа (SSO). |
|
|
Добавление домена. |
|
|
Удаление домена. |
|
|
Изменение домена. |
События управления группами и подразделениями
|
Имя события |
Описание |
|
|
Создание группы. |
|
|
Удаление группы. |
|
|
Изменение параметров группы. |
|
|
Добавление в группу. |
|
|
Удаление из группы. |
|
|
Создание подразделения. |
|
|
Удаление подразделения. |
|
|
Изменение данных подразделения. |
|
|
Добавление в подразделение. |
|
|
Удаление из подразделения. |
События управления групповыми политиками
|
Имя события |
Описание |
|
|
Создание групповой политики. |
|
|
Изменение групповой политики. |
|
|
Удаление групповой политики. |
|
|
Добавление сотрудника, группы или подразделения в политику. |
|
|
Удаление сотрудника, группы или подразделения из политики. |
|
|
Добавление ресурса в политику. |
|
|
Удаление ресурса из политики. |
События ресурсов организации
|
Имя события |
Описание |
|
|
Создание общего ящика. |
|
|
Удаление общего ящика. |
|
|
Изменение данных общего ящика. |
|
|
Делегирование почтового ящика — предоставление доступа к почтовому ящику для работы от имени его владельца. |
|
|
Отмена делегирования почтового ящика. |
|
|
Создание общего диска. |
|
|
Удаление общего диска. |
|
|
Создание офиса. |
|
|
Удаление офиса. |
|
|
Изменение данных офиса. |
|
|
Создание переговорки. |
|
|
Удаление переговорки. |
|
|
Изменение данных переговорки. |
|
|
Создание внешнего контакта. |
|
|
Удаление внешнего контакта. |
|
|
Изменение данных внешнего контакта. |
События Телемоста
|
Имя события |
Описание |
|
|
Создание конференции с уровнем доступа |
|
|
Изменение уровня доступа конференции. |
|
|
Начало конференции. |
|
|
Завершение конференции. |
|
|
Подключение участника к конференции в роли |
|
|
Отключение участника от конференции. |
|
|
Удаление участника конференции модератором. |
|
|
Изменение роли участника конференции модератором. |
|
|
Подключение участника к комнате ожидания. |
|
|
Переход участника из комнаты ожидания в конференцию. |
|
|
Выход участника из комнаты ожидания. |
|
|
Создание трансляции с уровнем доступа |
|
|
Начало трансляции. |
|
|
Изменение уровня доступа трансляции. |
|
|
Приостановка трансляции. |
|
|
Завершение трансляции. |
|
|
Подключение участника к трансляции. |
События Мессенджера
В список входят события чатов в пространстве организации и события внешних чатов.
|
Имя события |
Описание |
|
|
Создание чата типа |
|
|
Изменение настроек чата. |
|
|
Обновление ссылки на чат. |
|
|
Изменение прав участников чата. |
|
|
Добавление пользователя в роли |
|
|
Изменение роли участника. |
|
|
Удаление пользователя из чата. |
|
|
Добавление группы в чат. |
|
|
Удаление группы из чата. |
|
|
Добавление подразделения в чат. |
|
|
Удаление подразделения из чата. |
|
|
Отправка файла в чат. |
|
|
Удаление сообщения из чата. |
|
|
Начало звонка в чате. |
|
|
Скачивание архива данных Мессенджера пользователем. |
События Диска
|
Имя события |
Описание |
Параметры |
|
|
Создание новой папки. |
Список параметров события
|
|
|
Загрузка нового файла или редактирование существующего. |
Список параметров события
|
|
|
Копирование ресурса — файла или папки. |
Список параметров события
|
|
|
Перемещение или переименование ресурса — файла или папки. |
Список параметров события
|
|
|
Просмотр содержимого файла. |
Список параметров события
|
|
|
Просмотр содержимого общего файла. |
Список параметров события
|
|
|
Скачивание файла. |
Список параметров события
|
|
|
Создание ссылки для общего доступа к ресурсу — файлу или папке. |
Список параметров события
|
|
|
Удаление ссылки и закрытие общего доступа к ресурсу — файлу или папке. |
Список параметров события
|
|
|
Настройка общего или персонального доступа к ресурсу — файлу или папке. |
Список параметров события
|
|
|
Отзыв общего или персонального доступа к ресурсу — файлу или папке. |
Список параметров события
|
|
|
Перемещение ресурса — файла или папки — в корзину. |
Список параметров события
|
|
|
Восстановление ресурса — файла или папки — из корзины. |
Список параметров события
|
|
|
Безвозвратное удаление ресурса — файла или папки — из корзины. |
Список параметров события
|
|
|
Безвозвратное удаление содержимого корзины. |
Список параметров события
|
|
|
Безвозвратное удаление ресурса — файла или папки — через API. |
Список параметров события
|
|
|
Создание общей папки. |
Список параметров события
|
|
|
Выдача доступа пользователю в общую папку. |
Список параметров события
|
|
|
Принятие пользователем приглашения в общую папку. |
Список параметров события
|
|
|
Изменение прав доступа пользователя к общей папке. |
Список параметров события
|
|
|
Отзыв доступа пользователя в общую папку. |
Список параметров события
|
Unix-время показывает, сколько секунд прошло с 1 января 1970 года 00:00:00 UTC.
Поддерживаемые типы файлов описаны в Справке API Яндекс Диска
Общие диски — это специальные папки, которыми можно пользоваться совместно с коллегами. Как это работает
Персональные диски — это папки, закрепленные за конкретными сотрудниками и предназначенные для их самостоятельной работы. Как это работает
Общий доступ выдается любому пользователю, у которого есть ссылка. Как это работает
Персональный доступ выдается только конкретным пользователям, группам или подразделениям. Как это работает