AWS Security ChangesHomeSearch

AWS AmazonRDS: Document copying DB option groups across accounts/regions

Service: AmazonRDS · 2026-11-05 · Documentation low

File: AmazonRDS/latest/UserGuide/USER_CopySnapshot.md

Summary

Updates the RDS copy-snapshot guide to document copying the DB option group associated with a source snapshot to a different AWS account, Region, or both, including new console steps, a new --tag-specifications/TagSpecifications option for tagging the copied option group (resource type 'og'), and new CLI/API examples. Also renumbers console steps and refreshes a screenshot reference.

Security assessment

The diff is a feature/documentation update describing cross-account and cross-Region copying of DB option groups plus tagging of the copied option group. It references no vulnerability, CVE, or incident, and adds no authentication, encryption, or IAM guidance. The only security-adjacent note is that 'only the options that support cross-account copying are included in the copy', which is a functional limitation rather than security hardening, so this is a low-severity, non-security change.

Evidence

+  * `--copy-option-group` – Copy the DB option group associated with the source snapshot to the target AWS account or AWS Region and associate it with the snapshot copy.

Diff

diff --git a/AmazonRDS/latest/UserGuide/USER_CopySnapshot.md b/AmazonRDS/latest/UserGuide/USER_CopySnapshot.md
index 84b400b..385e57e 100644
--- a//AmazonRDS/latest/UserGuide/USER_CopySnapshot.md
+++ b//AmazonRDS/latest/UserGuide/USER_CopySnapshot.md
@@ -39 +39 @@ The **Copy snapshot** page appears.
-![Copy a DB snapshot.](/images/AmazonRDS/latest/UserGuide/images/DBSnapshotCopy1.png)
+![Copy a DB snapshot.](/images/AmazonRDS/latest/UserGuide/images/copy-db-snapshot-with-option-group.png)
@@ -41 +41,7 @@ The **Copy snapshot** page appears.
-  5. For **Target option group (optional)** , choose a new option group if you want.
+  5. (Optional) For Oracle DB instances, select the **Copy option group from source DB snapshot** check box to copy the DB option group associated with the source snapshot and associate it with the snapshot copy.
+
+You can copy the option group to a different AWS account, a different AWS Region, or both. If you choose this option, you can't choose a **Target DB option group**. For more information, see Considerations for option groups.
+
+(Optional) To tag the copied option group, add one or more tags.
+
+  6. For **Target DB option group** , if you aren't copying the DB option group from the source snapshot, choose an existing option group in the destination AWS Region.
@@ -47 +53 @@ If your source DB instance uses Transparent Data Encryption for Oracle or Micros
-  6. (Optional) To copy the DB snapshot to a different AWS Region, for **Destination Region** , choose the new AWS Region.
+  7. (Optional) To copy the DB snapshot to a different AWS Region, for **Destination Region** , choose the new AWS Region.
@@ -53 +59 @@ The destination AWS Region must have the same database engine version available
-  7. For **New DB snapshot identifier** , enter the name of the DB snapshot copy.
+  8. For **New DB snapshot identifier** , enter the name of the DB snapshot copy.
@@ -57 +63 @@ You can make multiple copies of an automated backup or manual snapshot, but each
-  8. (Optional) Select **Copy Tags** to copy tags and values from the snapshot to the copy of the snapshot.
+  9. (Optional) Select **Copy Tags** to copy tags and values from the snapshot to the copy of the snapshot.
@@ -59 +65 @@ You can make multiple copies of an automated backup or manual snapshot, but each
-  9. (Optional) For **Encryption** , do the following:
+  10. (Optional) For **Encryption** , do the following:
@@ -69 +75 @@ If the DB snapshot is encrypted, you must encrypt the copy, so the check box is
-  10. Choose **Copy snapshot**.
+  11. Choose **Copy snapshot**.
@@ -92 +98,3 @@ The following options are used to copy a DB snapshot. Not all options are requir
-  * `--copy-option-group` – Copy the option group from a snapshot that has been shared with your AWS account.
+  * `--copy-option-group` – Copy the DB option group associated with the source snapshot to the target AWS account or AWS Region and associate it with the snapshot copy.
+
+  * `--tag-specifications` – (Optional) The tags to assign to the copied option group. Use the resource type `og` to tag the copied option group. You can specify this option only when `--copy-option-group` is used. By default, the copied option group isn't tagged.
@@ -176,0 +185,22 @@ For Windows:
+###### Example across Regions, copying the option group with tags
+
+The following code copies a snapshot across AWS Regions, copies the DB option group associated with the source snapshot to the destination AWS Region, and assigns a tag to the copied option group. Run the command in the destination Region.
+
+For Linux, macOS, or Unix:
+    
+    
+    aws rds copy-db-snapshot \
+        --source-db-snapshot-identifier arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20161115 \
+        --target-db-snapshot-identifier mydbsnapshotcopy \
+        --copy-option-group \
+        --tag-specifications 'ResourceType=og,Tags=[{Key=environment,Value=production}]'
+
+For Windows:
+    
+    
+    aws rds copy-db-snapshot ^
+        --source-db-snapshot-identifier arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20161115 ^
+        --target-db-snapshot-identifier mydbsnapshotcopy ^
+        --copy-option-group ^
+        --tag-specifications "ResourceType=og,Tags=[{Key=environment,Value=production}]"
+
@@ -199 +229,3 @@ The following parameters are used to copy a DB snapshot. Not all parameters are
-  * `CopyOptionGroup` – Set this parameter to `true` to copy the option group from a shared snapshot to the copy of the snapshot. The default is `false`.
+  * `CopyOptionGroup` – Set this parameter to `true` to copy the DB option group associated with the source snapshot to the target AWS account or AWS Region and associate it with the snapshot copy. The default is `false`.
+
+  * `TagSpecifications` – (Optional) The tags to assign to the copied option group. Use the resource type `og` to tag the copied option group. You can specify this parameter only when `CopyOptionGroup` is `true`. By default, the copied option group isn't tagged.
@@ -278,0 +311,22 @@ The following code creates a copy of a snapshot, with the new name `mydbsnapshot
+###### Example across Regions, copying the option group with tags
+
+The following code copies a snapshot to the US West (N. California) Region, copies the DB option group associated with the source snapshot to that Region, and assigns a tag to the copied option group.
+    
+    
+    https://rds.us-west-1.amazonaws.com/
+    	?Action=CopyDBSnapshot
+    	&CopyOptionGroup=true
+    	&TagSpecifications.item.1.ResourceType=og
+    	&TagSpecifications.item.1.Tags.Tag.1.Key=environment
+    	&TagSpecifications.item.1.Tags.Tag.1.Value=production
+    	&SignatureMethod=HmacSHA256
+    	&SignatureVersion=4
+    	&SourceDBSnapshotIdentifier=arn%3Aaws%3Ards%3Aus-east-1%3A123456789012%3Asnapshot%3Amysql-instance1-snapshot-20130805
+    	&TargetDBSnapshotIdentifier=mydbsnapshotcopy
+    	&Version=2013-09-09
+    	&X-Amz-Algorithm=AWS4-HMAC-SHA256
+    	&X-Amz-Credential=AKIADQKE4SARGYLE/20140429/us-west-1/rds/aws4_request
+    	&X-Amz-Date=20140429T175351Z
+    	&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
+    	&X-Amz-Signature=9164337efa99caf850e874a1cb7ef62f3cea29d0b448b9e0e7c53b288ddffed2
+
@@ -630 +684,3 @@ DB option groups are specific to the AWS Region that they are created in, and yo
-For Oracle databases, you can use the AWS CLI or RDS API to copy the custom DB option group from a snapshot that has been shared with your AWS account. You can only copy option groups within the same AWS Region. The option group isn't copied if it has already been copied to the destination account and no changes have been made to it since being copied. If the source option group has been copied before, but has changed since being copied, RDS copies the new version to the destination account. Default option groups aren't copied.
+For Oracle databases, when you copy a snapshot, you can use the AWS Management Console, AWS CLI, or RDS API to copy the DB option group associated with the source snapshot and associate it with the snapshot copy. You can copy the option group to a different AWS account, a different AWS Region, or both. When you copy an option group to another AWS account, only the options that support cross-account copying are included in the copy. Likewise, when you copy an option group to another AWS Region, only the options that support cross-Region copying are included in the copy. The option group isn't copied if it has already been copied to the destination and no changes have been made to it since being copied. If the source option group has been copied before, but has changed since being copied, RDS copies the new version to the destination. Default option groups aren't copied.
+
+You can assign tags to the copied option group by using the `--tag-specifications` option (AWS CLI) or the `TagSpecifications` parameter (RDS API) with the resource type `og`.