Get Bucket Replication
s3_get_bucket_replication | R Documentation |
This operation is not supported by directory buckets¶
Description¶
This operation is not supported by directory buckets.
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 S3 User Guide.
This action 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 get_bucket_replication
errors, see List of
replication-related error
codes
The following operations are related to get_bucket_replication
:
-
put_bucket_replication
-
delete_bucket_replication
Usage¶
Arguments¶
Bucket
[required] The bucket name for which to get the replication information.
ExpectedBucketOwner
The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code
403 Forbidden
(access denied).
Value¶
A list with the following syntax:
list(
ReplicationConfiguration = list(
Role = "string",
Rules = list(
list(
ID = "string",
Priority = 123,
Prefix = "string",
Filter = list(
Prefix = "string",
Tag = list(
Key = "string",
Value = "string"
),
And = list(
Prefix = "string",
Tags = list(
list(
Key = "string",
Value = "string"
)
)
)
),
Status = "Enabled"|"Disabled",
SourceSelectionCriteria = list(
SseKmsEncryptedObjects = list(
Status = "Enabled"|"Disabled"
),
ReplicaModifications = list(
Status = "Enabled"|"Disabled"
)
),
ExistingObjectReplication = list(
Status = "Enabled"|"Disabled"
),
Destination = list(
Bucket = "string",
Account = "string",
StorageClass = "STANDARD"|"REDUCED_REDUNDANCY"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"GLACIER"|"DEEP_ARCHIVE"|"OUTPOSTS"|"GLACIER_IR"|"SNOW"|"EXPRESS_ONEZONE",
AccessControlTranslation = list(
Owner = "Destination"
),
EncryptionConfiguration = list(
ReplicaKmsKeyID = "string"
),
ReplicationTime = list(
Status = "Enabled"|"Disabled",
Time = list(
Minutes = 123
)
),
Metrics = list(
Status = "Enabled"|"Disabled",
EventThreshold = list(
Minutes = 123
)
)
),
DeleteMarkerReplication = list(
Status = "Enabled"|"Disabled"
)
)
)
)
)