› › ›

API очистки хранилища снимков

Вызывает проверку содержимого хранилища снимков и удаляет устаревшие данные, на которые не ссылаются существующие снимки. См. Очистка хранилища.

POST /_snapshot/my_repository/_cleanup

Запрос

POST /_snapshot/<repository>/_cleanup

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

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

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

<repository>: (Обязательный, строка) Название хранилища снимков, которое нужно проверить и очистить.

Параметры запроса

master_timeout: (Необязательный, единицы времени) Время ожидания подключения к мастер-узлу. Если ответ не получен до истечения таймаута, запрос завершается ошибкой. По умолчанию 30s.
timeout: (Необязательный, единицы времени) Время ожидания ответа. Если ответ не получен до истечения таймаута, запрос завершается ошибкой. По умолчанию 30s.

Тело ответа

results

(объект) Содержит статистику операций очистки.

Свойства results

deleted_bytes: (целое число) Количество байт, освобожденных операциями очистки.
deleted_blobs: (целое число) Количество бинарных больших объектов (BLOB) удаленных из хранилища снимков во время операций очистки. Любое ненулевое значение указывает, что были найдены неиспользуемые BLOB и затем они были очищены.

Примеры

POST /_snapshot/my_repository/_cleanup

API возвращает следующий ответ:

{
  "results": {
    "deleted_bytes": 20,
    "deleted_blobs": 5
  }
}

© 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/7.17/clean-up-snapshot-repo-api.html