› › ›

API возобновления фолловера

Возобновляет индекс-фолловера.

Запрос

POST /<follower_index>/_ccr/resume_follow
{
}

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

Если включены функции безопасности Elasticsearch, у вас должны быть write и monitor права доступа к индексу-фолловеру. У вас должны быть read и monitor права доступа к индексу-лидеру. У вас также должны быть manage_ccr права доступа к кластеру, содержащему индекс-фолловера. Более подробную информацию см. в разделе Права доступа к безопасности.

Описание

Этот API возобновляет индекс-фолловера, который был приостановлен либо явно с помощью API приостановки фолловера, либо неявно из-за выполнения, которое не может быть повторно выполнено из-за сбоя во время слежения. После возврата этого API индекс-фолловера возобновит извлечение операций из индекса-лидера.

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

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

Тело запроса

settings: (объект) Настройки для перезаписи из индекса-лидера. Обратите внимание, что некоторые настройки нельзя перезаписывать (например, index.number_of_shards).
max_read_request_operation_count: (целое число) Максимальное количество операций для извлечения за один запрос из удаленного кластера.
max_outstanding_read_requests: (длинное целое число) Максимальное количество незавершенных запросов чтения из удаленного кластера.
max_read_request_size: (значение байта) Максимальный размер в байтах за один запрос для пакета операций, извлеченных из удаленного кластера.
max_write_request_operation_count: (целое число) Максимальное количество операций в запросе пакетной записи, выполняемом на фолловере.
max_write_request_size: (значение байта) Максимальный общий объем операций в запросе пакетной записи, выполняемом на фолловере.
max_outstanding_write_requests: (целое число) Максимальное количество незавершенных запросов записи на фолловере.
max_write_buffer_count: (целое число) Максимальное количество операций, которые могут быть помещены в очередь для записи. При достижении этого предела чтение из удаленного кластера будет отложено до тех пор, пока количество операций в очереди не станет меньше предела.
max_write_buffer_size: (значение байта) Максимальный общий объем операций, которые могут быть помещены в очередь для записи. При достижении этого предела чтение из удаленного кластера будет отложено до тех пор, пока общий объем операций в очереди не станет меньше предела.
max_retry_delay: (значение времени) Максимальное время ожидания перед повторной попыткой выполнения операции, которая завершилась ошибкой. При повторной попытке используется стратегия экспоненциального увеличения интервала.
read_poll_timeout: (значение времени) Максимальное время ожидания новых операций в удаленном кластере, когда индекс-фолловера синхронизирован с индексом-лидером. После истечения таймаута запрос на операции вернется фолловеру, чтобы он мог обновить некоторые статистические данные. Затем фолловера немедленно попытается снова прочитать из лидера.

Значения по умолчанию

Следующий вывод из API follow info описывает все значения по умолчанию для параметров запроса к follow индексу, описанных выше:

{
  "follower_indices" : [
    {
      "parameters" : {
        "max_read_request_operation_count" : 5120,
        "max_read_request_size" : "32mb",
        "max_outstanding_read_requests" : 12,
        "max_write_request_operation_count" : 5120,
        "max_write_request_size" : "9223372036854775807b",
        "max_outstanding_write_requests" : 9,
        "max_write_buffer_count" : 2147483647,
        "max_write_buffer_size" : "512mb",
        "max_retry_delay" : "500ms",
        "read_poll_timeout" : "1m"
      }
    }
  ]
}

Примеры

В этом примере возобновляется индекс-фолловера с именем follower_index:

POST /follower_index/_ccr/resume_follow
{
  "max_read_request_operation_count" : 1024,
  "max_outstanding_read_requests" : 16,
  "max_read_request_size" : "1024k",
  "max_write_request_operation_count" : 32768,
  "max_write_request_size" : "16k",
  "max_outstanding_write_requests" : 8,
  "max_write_buffer_count" : 512,
  "max_write_buffer_size" : "512k",
  "max_retry_delay" : "10s",
  "read_poll_timeout" : "30s"
}

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

{
  "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/7.17/ccr-post-resume-follow.html