rds_instance - add deletion_protection param (#1105) (#1138)

[PR #1105/77cb0974 backport][stable-3] rds_instance - add deletion_protection param

This is a backport of PR #1105 as merged into main (77cb097).
Depends-On: #1116
SUMMARY
Fixes #922
ISSUE TYPE

Feature Pull Request

COMPONENT NAME
rds_instance

Reviewed-by: Alina Buzachis <None>

changelogs/fragments/1105-rds_instance-add-deletion_protection-parameter.yml

@@ -0,0 +1,2 @@
+minor_changes:
+  - rds_instance - add `deletion_protection` parameter (https://github.com/ansible-collections/community.aws/pull/1105).

plugins/modules/rds_instance.py

@@ -160,6 +160,13 @@
         aliases:
           - subnet_group
         type: str
+    deletion_protection:
+        description:
+          -  A value that indicates whether the DB instance has deletion protection enabled.
+             The database can't be deleted when deletion protection is enabled.
+             By default, deletion protection is disabled.
+        type: bool
+        version_added: 3.3.0
     domain:
         description:
           - The Active Directory Domain to restore the instance in.
@@ -666,6 +673,12 @@
   returned: always
   type: str
   sample: db-UHV3QRNWX4KB6GALCIGRML6QFA
+deletion_protection:
+  description: C(True) if the DB instance has deletion protection enabled, C(False) if not.
+  returned: always
+  type: bool
+  sample: False
+  version_added: 3.3.0
 domain_memberships:
   description: The Active Directory Domain membership records associated with the DB instance.
   returned: always
@@ -1256,6 +1269,7 @@ def main():
         db_security_groups=dict(type='list', elements='str'),
         db_snapshot_identifier=dict(),
         db_subnet_group_name=dict(aliases=['subnet_group']),
+        deletion_protection=dict(type='bool'),
         domain=dict(),
         domain_iam_role_name=dict(),
         enable_cloudwatch_logs_exports=dict(type='list', aliases=['cloudwatch_log_exports'], elements='str'),

plugins/modules/rds_instance_info.py

@@ -188,6 +188,12 @@
       returned: always
       type: str
       sample: db-AAAAAAAAAAAAAAAAAAAAAAAAAA
+    deletion_protection:
+      description: C(True) if the DB instance has deletion protection enabled, C(False) if not.
+      returned: always
+      type: bool
+      sample: False
+      version_added: 3.3.0
     domain_memberships:
       description: List of domain memberships
       returned: always