Resume auto-follow pattern API

edit

Resumes an auto-follow pattern.

Request

edit

POST /_ccr/auto_follow/<auto_follow_pattern_name>/resume

Prerequisites

edit
  • If the Elasticsearch security features are enabled, you must have manage_ccr cluster privileges on the cluster that contains the follower index. For more information, see Security privileges.

Description

edit

This API resumes an auto-follow pattern that has been paused with the pause auto-follow pattern API. When this API returns, the auto-follow pattern will resume configuring following indices for newly created indices on the remote cluster that match its patterns. Remote indices created while the pattern was paused will also be followed, unless they have been deleted or closed in the meantime.

Path parameters

edit
<auto_follow_pattern_name>
(Required, string) Specifies the name of the auto-follow pattern to resume.

Query parameters

edit
master_timeout
(Optional, time units) Period to wait for the master node. If the master node is not available before the timeout expires, the request fails and returns an error. Defaults to 30s. Can also be set to -1 to indicate that the request should never timeout.

Examples

edit

This example resumes the activity of a paused auto-follow pattern named my_auto_follow_pattern:

response = client.ccr.resume_auto_follow_pattern(
  name: 'my_auto_follow_pattern'
)
puts response
POST /_ccr/auto_follow/my_auto_follow_pattern/resume

The API returns the following result:

{
  "acknowledged" : true
}