42 lines
1.3 KiB
Plaintext
42 lines
1.3 KiB
Plaintext
--
|
|
:api: ccr-put-follow
|
|
:request: PutFollowRequest
|
|
:response: PutFollowResponse
|
|
--
|
|
[role="xpack"]
|
|
[id="{upid}-{api}"]
|
|
=== Put Follow API
|
|
|
|
|
|
[id="{upid}-{api}-request"]
|
|
==== Request
|
|
|
|
The Put Follow API allows creates a follower index and make that index follow a leader index.
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests-file}[{api}-request]
|
|
--------------------------------------------------
|
|
<1> The name of the remote cluster alias.
|
|
<2> The name of the leader in the remote cluster.
|
|
<3> The name of the follower index that gets created as part of the put follow API call.
|
|
<4> The number of active shard copies to wait for before the put follow API returns a
|
|
response, as an `ActiveShardCount`
|
|
|
|
[id="{upid}-{api}-response"]
|
|
==== Response
|
|
|
|
The returned +{response}+ indicates if the put follow request was received.
|
|
|
|
["source","java",subs="attributes,callouts,macros"]
|
|
--------------------------------------------------
|
|
include-tagged::{doc-tests-file}[{api}-response]
|
|
--------------------------------------------------
|
|
<1> Whether the follower index was created.
|
|
<2> Whether the follower shards are started.
|
|
<3> Whether the follower index started following the leader index.
|
|
|
|
include::../execution.asciidoc[]
|
|
|
|
|