AWS Security ChangesHomeSearch

AWS AmazonECR: ECR replication of deletes and ecr:ReplicateImageDelete permission

Service: AmazonECR · 2026-11-17 · Documentation medium

File: AmazonECR/latest/userguide/replication.md · Type: iam

Summary

Documents the new replication-of-deletes capability: adds the `ecr:ReplicateImageDelete` action to the required destination registry permissions policy (with a full example policy), notes that tag immutability does not block replicated deletes, updates troubleshooting steps (including CloudTrail review of failed ReplicateImageDelete calls), and adds a new 'Replicating image deletions' topic link.

Security assessment

The change documents a new cross-account IAM action (`ecr:ReplicateImageDelete`) that must be granted in the destination registry permissions policy, plus an example policy granting CreateRepository/ReplicateImage/ReplicateImageDelete to a source account principal. This is IAM permission guidance with cross-account access implications, but it documents a feature rather than fixing a specific vulnerability.

Evidence

+  * `ecr:ReplicateImageDelete` \- Allows the source account to replicate image deletes to the destination registry. This action is only required when the source registry's replication rule has the `deleteReplication` setting enabled

Diff

diff --git a/AmazonECR/latest/userguide/replication.md b/AmazonECR/latest/userguide/replication.md
index 142b43b..2eee7aa 100644
--- a//AmazonECR/latest/userguide/replication.md
+++ b//AmazonECR/latest/userguide/replication.md
@@ -11 +11 @@ Replication policy requirementsConsiderations for private image replication
-You can configure your Amazon ECR private registry to support the replication of your repositories. Amazon ECR supports both cross-Region and cross-account replication. For cross-account replication to occur, the destination account must configure a registry permissions policy to allow replication from the source registry to occur. For more information, see [Private registry permissions in Amazon ECR](./registry-permissions.html).
+You can configure your Amazon ECR private registry to support the replication of your repositories. Amazon ECR supports both cross-Region and cross-account replication. For cross-account replication to occur, the destination account must configure a registry permissions policy to allow replication from the source registry to occur. For more information, see [Private registry permissions in Amazon ECR](./registry-permissions.html). You can also enable replication of deletes on a replication rule so that Amazon ECR replicates image deletions and image tag removals from the source registry to the replication destinations. For more information, see [Replicating image deletions in Amazon ECR](./replication-delete.html).
@@ -13 +13 @@ You can configure your Amazon ECR private registry to support the replication of
-###### Topics
+## Topics
@@ -18,0 +19,2 @@ You can configure your Amazon ECR private registry to support the replication of
+  * [Replicating image deletions in Amazon ECR](./replication-delete.html)
+
@@ -52,0 +55,2 @@ The destination account must configure a registry permissions policy that grants
+  * `ecr:ReplicateImageDelete` \- Allows the source account to replicate image deletes to the destination registry. This action is only required when the source registry's replication rule has the `deleteReplication` setting enabled
+
@@ -56 +60 @@ The destination account must configure a registry permissions policy that grants
-###### Important
+Important
@@ -87,0 +92,24 @@ JSON
+If the source registry's replication rule has the `deleteReplication` setting enabled, the destination registry policy must also grant the `ecr:ReplicateImageDelete` action:
+    
+    
+    {
+        "Version": "2012-10-17",
+        "Statement": [
+            {
+                "Sid": "ReplicationAccessCrossAccount",
+                "Effect": "Allow",
+                "Principal": {
+                    "AWS": "arn:aws:iam::111122223333:root"
+                },
+                "Action": [
+                    "ecr:CreateRepository",
+                    "ecr:ReplicateImage",
+                    "ecr:ReplicateImageDelete"
+                ],
+                "Resource": [
+                    "arn:aws:ecr:us-west-2:444455556666:repository/*"
+                ]
+            }
+        ]
+    }
+
@@ -126 +154 @@ If cross-account replication is failing, check the following:
-  * Ensure the registry policy includes both `ecr:ReplicateImage` and `ecr:CreateRepository` actions
+  * Ensure the registry policy includes both the `ecr:ReplicateImage` and `ecr:CreateRepository` actions. If the source registry's replication rule has replication of deletes enabled, also ensure the policy includes the `ecr:ReplicateImageDelete` action.
@@ -133,0 +162,2 @@ If cross-account replication is failing, check the following:
+  * If replicated deletions fail, review CloudTrail logs for failed `ReplicateImageDelete` API calls
+
@@ -163 +193 @@ The following should be considered when using private image replication.
-  * Registry replication doesn't perform any delete actions or archive actions. Replicated images and repositories can be deleted or archived when they are no longer being used.
+  * Registry replication doesn't perform any archive actions, and by default it doesn't perform any delete actions. Replicated images and repositories can be deleted or archived when they are no longer being used. If a replication rule has replication of deletes enabled, Amazon ECR replicates image deletions to the destinations that the rule specifies. For more information, see [Replicating image deletions in Amazon ECR](./replication-delete.html).
@@ -173 +203 @@ The following should be considered when using private image replication.
-  * If tag immutability is enabled on a repository and an image is replicated that uses the same tag as an existing image, the image is replicated but won't contain the duplicated tag. This might result in the image being untagged.
+  * If tag immutability is enabled on a repository and an image is replicated that uses the same tag as an existing image, the image is replicated but won't contain the duplicated tag. This might result in the image being untagged. Tag immutability doesn't prevent replication of deletes. When you enable replication of deletes, Amazon ECR replicates image deletions and image tag removals from the source registry even when the destination repository has tag immutability enabled.
@@ -180 +210 @@ The following should be considered when using private image replication.
-###### Note
+Note
@@ -192 +222 @@ Troubleshooting pull through cache issues
-Replication examples
+Replicating image deletions