Replicating delete markers between buckets - Amazon Simple Storage Service

Welcome to the new Amazon S3 User Guide! The Amazon S3 User Guide combines information and instructions from the three retired guides: Amazon S3 Developer Guide, Amazon S3 Console User Guide, and Amazon S3 Getting Started Guide.

Replicating delete markers between buckets

By default, when Amazon S3 Replication is enabled and an object is deleted in the source bucket, Amazon S3 adds a delete marker in the source bucket only. This action protects data from malicious deletions.

If you have delete marker replication enabled, these markers are copied to the destination buckets, and Amazon S3 behaves as if the object was deleted in both source and destination buckets. For more information about how delete markers work, see Working with delete markers.


Delete marker replication is not supported for tag-based replication rules. Delete marker replication also does not adhere to the 15-minute SLA granted when using S3 Replication Time Control.

If you are not using the latest replication configuration version, delete operations will affect replication differently. For more information, see How delete operations affect replication.

Enabling delete marker replication

You can start using delete marker replication with a new or existing replication rule. You can apply it to an entire S3 bucket or to Amazon S3 objects that have a specific prefix.

To enable delete marker replication using the Amazon S3 console, see Using the S3 console. This topic provides instructions for enabling delete marker replication in your replication configuration when buckets are owned by the same or different AWS accounts.

To enable delete marker replication using the AWS Command Line Interface (AWS CLI), you must add a replication configuration to the source bucket with DeleteMarkerReplication enabled.

In the following example configuration, delete markers are replicated to the destination bucket DOC-EXAMPLE-BUCKET for objects under the prefix Tax.

{ "Rules": [ { "Status": "Enabled", "Filter": { "Prefix": "Tax" }, "DeleteMarkerReplication": { "Status": "Enabled" }, "Destination": { "Bucket": "arn:aws:s3:::DOC-EXAMPLE-BUCKET" }, "Priority": 1 } ], "Role": "IAM-Role-ARN" }

For full instructions on creating replication rules through the AWS CLI, see Configuring replication for source and destination buckets owned by the same account in the Replication walkthroughs section.