+ /// Amazon S3 can return this header if your request involves a
+ /// bucket that is either a source or a destination in a replication rule.
In replication,
+ /// you have a source bucket on which you configure replication and destination bucket or buckets
+ /// where Amazon S3 stores object replicas. When you request an object (GetObject
) or
+ /// object metadata (HeadObject
) from these buckets, Amazon S3 will
+ /// return the x-amz-replication-status
header in the response as follows:
+ /// -
If requesting an object from the source bucket, Amazon S3 will return the
+ /// x-amz-replication-status
header if the object in your request is eligible for
+ /// replication.
For example, suppose that in your replication configuration, you specify
+ /// object prefix TaxDocs
requesting Amazon S3 to replicate objects with key
+ /// prefix TaxDocs
. Any objects you upload with this key name prefix, for example
+ /// TaxDocs/document1.pdf
, are eligible for replication. For any object request with
+ /// this key name prefix, Amazon S3 will return the x-amz-replication-status
header
+ /// with value PENDING, COMPLETED or FAILED indicating object replication status.
-
If
+ /// requesting an object from a destination bucket, Amazon S3 will return the
+ /// x-amz-replication-status
header with value REPLICA if the object in your
+ /// request is a replica that Amazon S3 created.
-
When replicating objects
+ /// to multiple destination buckets the x-amz-replication-status
header acts differently.
+ /// The header of the source object will only return a value of COMPLETED when replication is
+ /// successful to all destinations. The header will remain at value PENDING until replication has
+ /// completed for all destinations. If one or more destinations fails replication the header will
+ /// return FAILED.
For more information,
+ /// see Replication.
+ ///
+ ///