NAME

OpenSearch::Client::Core::3_0::Direct::Replication

VERSION

version 3.007004

SYNOPSIS

use OpenSearch::Client;

my $client = OpenSearch::Client->new( ... );

my $response = $client->replication-><methodname>(
  valone => $value1,
  valtwo => $value2
);

DESCRIPTION

Cross-cluster replication

Use these replication operations to programmatically manage cross-cluster replication.

See OpenSearch documentation for replication.

METHODS

replication->autofollow_stats

Retrieves information about any auto-follow activity and any replication rules configured on the specified cluster.

Paths served by this method:

GET /_plugins/_replication/autofollow_stats
$resp = $client->replication->autofollow_stats(
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.autofollow_stats

replication->create_replication_rule

Automatically starts the replication on indexes matching a specified pattern.

Paths served by this method:

POST /_plugins/_replication/_autofollow
$resp = $client->replication->create_replication_rule(
    
    'body'         =>  $body,      # optional
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.create_replication_rule

replication->delete_replication_rule

Deletes the specified replication rule.

Paths served by this method:

DELETE /_plugins/_replication/_autofollow
$resp = $client->replication->delete_replication_rule(
    
    'body'         =>  $body,      # optional
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.delete_replication_rule

replication->follower_stats

Retrieves information about any follower (syncing) indexes on a specified cluster.

Paths served by this method:

GET /_plugins/_replication/follower_stats
$resp = $client->replication->follower_stats(
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.follower_stats

replication->leader_stats

Retrieves information about any replicated leader indexes on a specified cluster.

Paths served by this method:

GET /_plugins/_replication/leader_stats
$resp = $client->replication->leader_stats(
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.leader_stats

replication->pause

Pauses the replication of the leader index.

Paths served by this method:

POST /_plugins/_replication/{index}/_pause
$resp = $client->replication->pause(
    
    'body'         =>  $body,      # optional
    
     # path parameters
    
    'index'        =>  $index,     # required
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.pause

replication->resume

Resumes replication of the leader index.

Paths served by this method:

POST /_plugins/_replication/{index}/_resume
$resp = $client->replication->resume(
    
    'body'         =>  $body,      # optional
    
     # path parameters
    
    'index'        =>  $index,     # required
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.resume

replication->start

Initiates the replication of an index from the leader cluster to the follower cluster.

Paths served by this method:

PUT /_plugins/_replication/{index}/_start
$resp = $client->replication->start(
    
    'body'         =>  $body,      # optional
    
     # path parameters
    
    'index'        =>  $index,     # required
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.start

replication->status

Retrieves the the status of an index replication.

Paths served by this method:

GET /_plugins/_replication/{index}/_status
$resp = $client->replication->status(
    
     # path parameters
    
    'index'        =>  $index,     # required
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.status

replication->stop

Terminates the replication and converts the follower index to a standard index.

Paths served by this method:

POST /_plugins/_replication/{index}/_stop
$resp = $client->replication->stop(
    
    'body'         =>  $body,      # optional
    
     # path parameters
    
    'index'        =>  $index,     # required
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.stop

replication->update_settings

Updates any settings on the follower index.

Paths served by this method:

PUT /_plugins/_replication/{index}/_update
$resp = $client->replication->update_settings(
    
    'body'         =>  $body,      # optional
    
     # path parameters
    
    'index'        =>  $index,     # required
    
     # Common API query string parameters
    
    'error_trace'  =>  $qval1,     # boolean
    'filter_path'  =>  $qval2,     # list
    'human'        =>  $qval3,     # boolean
    'pretty'       =>  $qval4,     # boolean
    'source'       =>  $qval5,     # string
);

OpenSearch documentation for replication.update_settings

MANUAL

Documentation index OpenSearch::Client::Manual

HISTORY

This distribution is derived from Search::Elasticsearch version 7.714. All subsequent changes are unique to this distribution.

AUTHOR

Mark Dootson <mdootson@cpan.org> ( current maintainer )

CREDITS

OpenSearch::Client is based on Search::Elasticsearch version 7.714 by Enrico Zimuel <enrico.zimuel@elastic.co>.

COPYRIGHT AND LICENSE

Copyright (C) 2026 by Mark Dootson ( this distribution )

Copyright (C) 2021 by Elasticsearch BV ( original distribution )

This is free software, licensed under:

The Apache License, Version 2.0, January 2004