AWS AmazonS3: Add DstKmsKeyNotSpecified replication failure reason and cross-links
Summary
Adds a new replication failure reason `DstKmsKeyNotSpecified` (rule uses Multi-Region key resolution but the object is encrypted with a single-Region KMS key and no `ReplicaKmsKeyID` is set, with the fix to add `ReplicaKmsKeyID`), links `DstKmsKeyInvalidState` and `DstKmsKeyNotFound` to the new Multi-Region key resolution section, and clarifies `SrcObjectNotEligible` wording to include objects excluded by a rule.
Security assessment
This is troubleshooting/reference documentation for replication metrics and events: a new failure code explains when a replica cannot be encrypted because no destination KMS key was specified under Multi-Region key resolution, plus links to the encryption-key guidance. It aids diagnosis and correct key configuration but documents no vulnerability, hardening measure, or best practice beyond referencing the KMS feature docs.
Evidence
+`DstKmsKeyNotSpecified` | The replication rule uses Multi-Region key resolution, and the object is encrypted with a single-Region AWS KMS key. The rule doesn't specify a destination key for these objects. To replicate them, add `ReplicaKmsKeyID` to the rule. For more information, see [Using Multi-Region key resolution](./replication-config-for-kms-objects.html#replication-kms-multi-region-keys).
Diff
diff --git a/AmazonS3/latest/userguide/replication-metrics-events.md b/AmazonS3/latest/userguide/replication-metrics-events.md index c11ab0b..d135041 100644 --- a//AmazonS3/latest/userguide/replication-metrics-events.md +++ b//AmazonS3/latest/userguide/replication-metrics-events.md @@ -102,2 +102,3 @@ Replication failure reason | Description -`DstKmsKeyInvalidState` | The AWS Key Management Service (AWS KMS) key for the destination bucket isn't in a valid state. Review and enable the required AWS KMS key. For more information about managing AWS KMS keys, see [Key states of AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) in the _AWS Key Management Service Developer Guide_. -`DstKmsKeyNotFound` | The AWS KMS key that's configured for the destination bucket in the replication configuration doesn't exist. +`DstKmsKeyInvalidState` | The AWS Key Management Service (AWS KMS) key for the destination bucket isn't in a valid state. Review and enable the required AWS KMS key. For Multi-Region key resolution, see [Using Multi-Region key resolution](./replication-config-for-kms-objects.html#replication-kms-multi-region-keys). For more information about managing AWS KMS keys, see [Key states of AWS KMS keys](https://docs.aws.amazon.com/kms/latest/developerguide/key-state.html) in the _AWS Key Management Service Developer Guide_. +`DstKmsKeyNotFound` | The AWS KMS key that's configured for the destination bucket in the replication configuration doesn't exist. For Multi-Region key resolution, see [Using Multi-Region key resolution](./replication-config-for-kms-objects.html#replication-kms-multi-region-keys). +`DstKmsKeyNotSpecified` | The replication rule uses Multi-Region key resolution, and the object is encrypted with a single-Region AWS KMS key. The rule doesn't specify a destination key for these objects. To replicate them, add `ReplicaKmsKeyID` to the rule. For more information, see [Using Multi-Region key resolution](./replication-config-for-kms-objects.html#replication-kms-multi-region-keys). @@ -126 +127 @@ Replication failure reason | Description -`SrcObjectNotEligible` | Some objects aren't eligible for replication. This may be due to the object's storage class or the object tags don't match the replication configuration. +`SrcObjectNotEligible` | Some objects aren't eligible for replication. This may be due to the object's storage class, or because the object doesn't match a rule in the replication configuration, including objects that a rule excludes.