aws:kms
).
/// 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.
///