Облачная платформаEvolution

Получить аудит-логи проекта

Эта статья полезна?

Примечание

Доступ к функциональности ограничен. Чтобы получать аудит-логи проекта, обратитесь в техническую поддержку.

  1. Пройдите аутентификацию в API. Вместо токена вы можете получить API-ключ. Токен или API-ключ передаются в заголовке Authorization при каждом запросе к сервису в следующих форматах:

    • токен:

      Authorization: Bearer <ACCESS_TOKEN>
    • API-ключ:

      Authorization: Api-Key <ACCESS_KEY>
  2. Выполните запрос:

    curl -X GET "https://audit.api.cloud.ru/events/list/{project_id}" \
    -H "Authorization: Bearer ACCESS_TOKEN"

    Где {project_id} — идентификатор проекта в формате UUID.

    В запросе можно указывать параметры для фильтрации или сортировки. Подробное описание параметров читайте в справочнике API.

    Примеры запросов с фильтрацией и сортировкой:

Ограничения на выгрузку логов

Временной диапазон, устанавливаемый с помощью параметров start и end, нужно подбирать в зависимости от количества логов — чем больше их поток, тем меньше должен быть диапазон. Так вы сможете быстрее получать список аудит-логов. Рекомендуемые значения диапазонов:

  • при частых логах — до 30 минут;

  • при редких логах — от 1 до 3 часов.

Если вам нужно получить данные за большой интервал времени, получайте их поэтапно. Вместо одного запроса с большим интервалом отправляйте несколько запросов с рекомендуемыми выше временными диапазонами. Например, если вы хотите получить логи, приходившие с 10 до 11 часов, разделите данные на два запроса: для временных интервалов 10:00–10:30 и 10:31–11:00.

Для постраничного вывода логов используйте nextPageToken для каждого временного диапазона. Если токена нет в ответе, то это последняя страница.