NAME

Search::Elasticsearch::Client::7_0::Direct::CCR - Plugin providing cross-cluster replication APIs for Search::Elasticsearch 7.x

VERSION

version 8.12

DESCRIPTION

This module provides methods to use the cross-cluster replication feature.

The full documentation for CCR is available here: https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-apis.html

FOLLOW METHODS

follow()

$response = $es->ccr->follow(
    index   => $index,  # required
    body    => {...}    # required
)

The follow() method creates a new follower index that is configured to follow the referenced leader index.

Query string parameters: error_trace, filter_path, human, wait_for_active_shards

See the CCR follow docs for more information.

pause_follow()

$response = $es->ccr->pause_follow(
    index   => $index,  # required
)

The pause_follow() method pauses following of an index.

Query string parameters: error_trace, filter_path, human

See the CCR pause follow docs for more information.

resume_follow()

$response = $es->ccr->resume_follow(
    index   => $index,  # required
)

The resume_follow() method resumes following of an index.

Query string parameters: error_trace, filter_path, human

See the CCR resume follow docs for more information.

unfollow()

$response = $es->ccr->unfollow(
    index   => $index,  # required
)

The unfollow() method converts a follower index into a normal index.

Query string parameters: error_trace, filter_path, human

See the CCR unfollow docs for more information.

forget_follower()

$response = $es->ccr->forget_follower(
    index   => $index,  # required
)

The forget_follower() method removes the follower retention leases from the leader.

Query string parameters: error_trace, filter_path, human

See the CCR forget_follower docs for more information.

STATS METHODS

stats()

$response = $es->ccr->stats()

The stats() method returns all stats related to cross-cluster replication.

Query string parameters: error_trace, filter_path, human

See the CCR stats docs for more information.

follow_stats()

$response = $es->ccr->follow_stats(
    index   => $index | \@indices,  # optional
)

The follow_stats() method returns shard-level stats about follower indices.

Query string parameters: error_trace, filter_path, human

See the CCR follow stats docs for more information.

follow_info()

$response = $es->ccr->follow_info(
    index   => $index | \@indices,  # optional
)

The follow_info() method returns the parameters and the status for each follower index.

Query string parameters: error_trace, filter_path, human

See the CCR follow info docs for more information.

AUTO-FOLLOW METHODS

put_auto_follow_pattern()

$response = $es->ccr->put_auto_follow_pattern(
    name    => $name    # required
)

The put_auto_follow_pattern() method creates a new named collection of auto-follow patterns against the remote cluster specified in the request body.

Query string parameters: error_trace, filter_path, human

See the CCR put auto follow pattern docs for more information.

get_auto_follow_pattern()

$response = $es->ccr->get_auto_follow_pattern(
    name    => $name    # optional
)

The get_auto_follow_pattern() method retrieves a named collection of auto-follow patterns, or all patterns.

Query string parameters: error_trace, filter_path, human

See the CCR get auto follow pattern docs for more information.

delete_auto_follow_pattern()

$response = $es->ccr->delete_auto_follow_pattern(
    name    => $name    # required
)

The delete_auto_follow_pattern() method deletes a named collection of auto-follow patterns.

Query string parameters: error_trace, filter_path, human

See the CCR delete auto follow pattern docs for more information.

AUTHOR

Enrico Zimuel <enrico.zimuel@elastic.co>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2024 by Elasticsearch BV.

This is free software, licensed under:

The Apache License, Version 2.0, January 2004