Creates a new named collection of auto-follow patterns against a specified remote cluster Added in 6.5.0
Newly created indices on the remote cluster matching any of the specified patterns will be automatically configured as follower indices.
Path parameters
-
The name of the collection of auto-follow patterns.
Body Required
-
The remote cluster containing the leader indices to match against.
-
follow_index_pattern string
-
leader_index_patterns array[string]
-
leader_index_exclusion_patterns array[string]
-
The maximum number of outstanding reads requests from the remote cluster.
-
settings object
Settings to override from the leader index. Note that certain settings can not be overrode (e.g., index.number_of_shards).
-
The maximum number of outstanding reads requests from the remote cluster.
-
read_poll_timeout string
A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. -
The maximum number of operations to pull per read from the remote cluster.
max_read_request_size number | string
-
max_retry_delay string
A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. -
max_write_buffer_count number
The maximum number of operations that can be queued for writing. When this limit is reached, reads from the remote cluster will be deferred until the number of queued operations goes below the limit.
max_write_buffer_size number | string
-
The maximum number of operations per bulk write request executed on the follower.
max_write_request_size number | string
curl \
-X PUT http://api.example.com/_ccr/auto_follow/{name} \
-H "Content-Type: application/json" \
-d '{"remote_cluster":"string","follow_index_pattern":"string","leader_index_patterns":["string"],"leader_index_exclusion_patterns":["string"],"max_outstanding_read_requests":42.0,"settings":{"additionalProperty1":{},"additionalProperty2":{}},"max_outstanding_write_requests":42.0,"read_poll_timeout":"string","max_read_request_operation_count":42.0,"":42.0,"max_retry_delay":"string","max_write_buffer_count":42.0,"max_write_request_operation_count":42.0}'
{
"remote_cluster": "string",
"follow_index_pattern": "string",
"leader_index_patterns": [
"string"
],
"leader_index_exclusion_patterns": [
"string"
],
"max_outstanding_read_requests": 42.0,
"settings": {
"additionalProperty1": {},
"additionalProperty2": {}
},
"max_outstanding_write_requests": 42.0,
"read_poll_timeout": "string",
"max_read_request_operation_count": 42.0,
"": 42.0,
"max_retry_delay": "string",
"max_write_buffer_count": 42.0,
"max_write_request_operation_count": 42.0
}
{
"acknowledged": true
}