› › ›

API удаления задач агрегации

Устарело в версии 8.11.0.

Агрегации будут удалены в будущей версии. Используйте downsampling вместо этого.

Удаляет существующую задачу агрегации.

Запрос

DELETE _rollup/job/<job_id>

Предварительные условия

Если включены функции безопасности Elasticsearch, вам необходимо иметь manage или manage_rollup привилегии кластера для использования этого API. Дополнительная информация приведена в Справочнике по привилегиям безопасности.

Описание

Задача должна быть остановлена перед удалением. Если вы попытаетесь удалить запущенную задачу, произойдет ошибка. Аналогично, при попытке удалить несуществующую задачу, возникнет исключение.

При удалении задачи удаляется только процесс, активно отслеживающий и агрегирующий данные. Предыдущие агрегированные данные не удаляются. Это сделано намеренно; пользователь может захотеть агрегировать статический набор данных. Поскольку набор данных статичен, после его полной агрегации нет необходимости сохранять задачу индексирования агрегации (поскольку новых данных не будет). Поэтому задачу можно удалить, оставив агрегированные данные для анализа.

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

POST my_rollup_index/_delete_by_query
{
  "query": {
    "term": {
      "_rollup.id": "the_rollup_job_id"
    }
  }
}

Параметры пути

<job_id>: (Обязательно, строка) Идентификатор задачи.

Коды ответов

404 (Отсутствующие ресурсы): Этот код указывает на то, что ресурсов, соответствующих запросу, нет. Он появляется, если вы пытаетесь удалить задачу, которая не существует.

Пример

Если у нас есть задача агрегации с именем sensor, ее можно удалить с помощью:

resp = client.rollup.delete_job(
    id="sensor",
)
print(resp)

response = client.rollup.delete_job(
  id: 'sensor'
)
puts response

const response = await client.rollup.deleteJob({
  id: "sensor",
});
console.log(response);

DELETE _rollup/job/sensor

Что вернет ответ:

{
  "acknowledged": true
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/rollup-delete-job.html