paws.storage (version 0.1.7)

s3_get_bucket_replication: Returns the replication configuration of a bucket

Description

Returns the replication configuration of a bucket.

Usage

s3_get_bucket_replication(Bucket)

Arguments

Bucket

[required] The bucket name for which to get the replication information.

Request syntax

svc$get_bucket_replication(
  Bucket = "string"
)

Details

It can take a while to propagate the put or delete a replication configuration to all Amazon S3 systems. Therefore, a get request soon after put or delete can return a wrong result.

For information about replication configuration, see Replication in the Amazon Simple Storage Service Developer Guide.

This operation requires permissions for the s3:GetReplicationConfiguration action. For more information about permissions, see Using Bucket Policies and User Policies.

If you include the Filter element in a replication configuration, you must also include the DeleteMarkerReplication and Priority elements. The response also returns those elements.

For information about GetBucketReplication errors, see ReplicationErrorCodeList

The following operations are related to GetBucketReplication:

• PutBucketReplication

• DeleteBucketReplication

Examples

# NOT RUN {
# The following example returns replication configuration set on a bucket.
# }
# NOT RUN {
svc$get_bucket_replication(
  Bucket = "examplebucket"
)
# }
# NOT RUN {
# }