恢复跟随者 API
编辑恢复跟随者 API编辑
恢复已暂停的跟随者索引。
先决条件编辑
- 如果启用了 Elasticsearch 安全功能，则您必须对跟随者索引具有
write和monitor索引权限。您必须对领导者索引具有read和monitor索引权限。您还必须在包含跟随者索引的集群上具有manage_ccr集群权限。有关更多信息，请参阅安全权限。
描述编辑
此 API 恢复已暂停的跟随者索引，该索引可以通过 暂停跟随者 API 显式暂停，也可以由于在跟随期间发生故障而无法重试执行而隐式暂停。当此 API 返回时，跟随者索引将恢复从领导者索引获取操作。
路径参数编辑
-
<follower_index> - （必填，字符串）跟随者索引的名称。
请求正文编辑
-
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 的以下输出描述了上述索引跟随请求参数的所有默认值
{
"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
}