paws.storage (version 0.1.10)

s3_get_bucket_replication: Returns the replication configuration of a bucket

Description

Returns the replication configuration of a bucket.

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 List of replication-related error codes

The following operations are related to GetBucketReplication:

• PutBucketReplication

• DeleteBucketReplication

Usage

s3_get_bucket_replication(Bucket, ExpectedBucketOwner)

Arguments

Bucket

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

ExpectedBucketOwner

The account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

Request syntax

svc$get_bucket_replication(
  Bucket = "string",
  ExpectedBucketOwner = "string"
)

Examples

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