[Документация Yandex Cloud](../../../index.md) > [Yandex SIEM](../../index.md) > [Пошаговые инструкции](../index.md) > [Запросы](index.md) > Управление запросами

# Управление запросами

{% note info %}

Функциональность находится на стадии [Preview](../../../overview/concepts/launch-stages.md). Чтобы получить доступ, обратитесь в [техническую поддержку](https://kz.center.yandex.cloud/support) или к вашему аккаунт-менеджеру.

{% endnote %}

В этом разделе описано, как создавать и выполнять запросы на языке [KQL (Kusto Query Language)](../../kql-reference.md), а также управлять ими.

## Создание нового запроса {#create-query}

Чтобы создать новый запрос:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Откройте расследование.
  1. Нажмите **Новый запрос**.
  1. В редакторе запросов введите KQL-запрос или выберите шаблон.

  {% note tip %}

  Используйте подсказку в редакторе: Введите запрос, используя синтаксис KQL, или выберите шаблон запроса.

  {% endnote %}

{% endlist %}

## Редактирование запроса {#edit-query}

Чтобы отредактировать запрос:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Откройте расследование с нужным запросом.
  1. Выберите вкладку с запросом.
  1. Внесите изменения в редакторе запросов.

  Изменения сохраняются автоматически.

{% endlist %}

## Выбор периода {#select-time-period}

Чтобы выбрать период для запроса:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Нажмите на селектор периода рядом с кнопкой запуска.
  1. Выберите один из пресетов:
     * Последние 5 минут;
     * Последние 30 минут;
     * Последний час;
     * Последние 3 часа;
     * Последние 6 часов;
     * Последние 12 часов;
     * Последний день.

  Или выберите произвольный период:

  1. Нажмите на селектор временного периода.
  1. Выберите произвольный период.
  1. Укажите дату и время начала периода.
  1. Укажите дату и время окончания периода.
  1. Нажмите **Применить**.

{% endlist %}

## Запуск запроса {#run-query}

Чтобы запустить запрос:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Убедитесь, что запрос введен в редакторе.
  1. Выберите временной период.
  1. Нажмите кнопку запуска запроса.

  После запуска запрос переходит в статус **Выполняется**. По завершении результаты отображаются в таблице и на гистограмме.

  {% note info %}
  
  Максимальное количество строк в результатах расследования — 1 000 000.
  
  {% endnote %}

{% endlist %}

## Остановка выполняющегося запроса {#stop-query}

Чтобы остановить выполняющийся запрос:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Во время выполнения запроса нажмите кнопку остановки.
  1. Запрос перейдет в статус **Остановлен**.

{% endlist %}

## Переименование запроса {#rename-query}

Чтобы переименовать запрос:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Нажмите на название запроса на вкладке.
  1. Введите новое название.
  1. Нажмите клавишу **Enter** или кликните вне поля ввода.

{% endlist %}

## Удаление запроса {#delete-query}

Чтобы удалить запрос:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Нажмите правой кнопкой мыши на вкладку запроса.
  1. Выберите **Удалить**.
  1. Подтвердите удаление.

  {% note warning %}

  Удаление запроса необратимо. Результаты и история выполнения будут удалены.

  {% endnote %}

{% endlist %}

## Поделиться запросом {#share-query}

Чтобы поделиться запросом:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Откройте запрос.
  1. В меню действий выберите **Поделиться**.
  1. Скопируйте ссылку на запрос.

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

{% endlist %}

## Настройка отображаемых полей в результатах {#configure-result-fields}

Чтобы настроить отображаемые поля в таблице результатов:

{% list tabs group=instructions %}

- Интерфейс Cloud Center {#cloud-center}

  1. Выполните запрос.
  1. В таблице результатов нажмите на значок настройки столбцов.
  1. Выберите поля, которые хотите отображать.
  1. Измените порядок полей перетаскиванием.
  1. Нажмите **Применить**.

{% endlist %}

#### Полезные ссылки {#see-also}

* [Расследования](../../concepts/investigations.md).
* [Запросы](../../concepts/queries.md).
* [Работа с шаблонами запросов](work-with-templates.md).
* [История запросов](query-history.md).