Prepare 3.4.0 (#1249)

Prepare 3.4.0

Depends-On: #1252
SUMMARY
Run add_docs, generate changelog, and update galaxy.yml for 3.4.0 collection release
ISSUE TYPE

Feature Pull Request

COMPONENT NAME
galaxy.yml
docs/
changelog.rst
Reviewed-by: NMarkus Bergholz <git@osuv.de>
Reviewed-by: Alina Buzachis <None>
Reviewed-by: Mark Chappell <None>
Reviewed-by: Joseph Torcasso <None>

changelogs/changelog.yaml

@@ -758,8 +758,8 @@ releases:
     changes:
       bugfixes:
       - aws_kms_info - fixed incompatibility with external and custom key-store keys.
-        The module was attempting to call  ``GetKeyRotationStatus``, which raises ``UnsupportedOperationException``
-        for these key types (https://github.com/ansible-collections/community.aws/pull/311).
+        The module was attempting to call  ``GetKeyRotationStatus``, which raises
+        ``UnsupportedOperationException`` for these key types (https://github.com/ansible-collections/community.aws/pull/311).
       - ec2_win_password - on success return state as not changed (https://github.com/ansible-collections/community.aws/issues/145)
       - ec2_win_password - return failed if unable to decode the password (https://github.com/ansible-collections/community.aws/issues/142)
       - ecs_service - fix element type for ``load_balancers`` parameter (https://github.com/ansible-collections/community.aws/issues/265).
@@ -1909,7 +1909,8 @@ releases:
       - lambda - fix check mode on creation (https://github.com/ansible-collections/community.aws/pull/1108).
       - rds_instance - fix check_mode and idempotency issues and added integration
         tests for all tests in suite (https://github.com/ansible-collections/community.aws/pull/1002).
-      - rds_instance_snapshot - don't require ``db_instance_identifier`` on state = present (https://github.com/ansible-collections/community.aws/pull/1078).
+      - rds_instance_snapshot - don't require ``db_instance_identifier`` on state
+        = present (https://github.com/ansible-collections/community.aws/pull/1078).
       - s3_lifecycle - add support of value *0* for ``transition_days`` (https://github.com/ansible-collections/community.aws/pull/1077).
       - s3_lifecycle - check that configuration is complete before returning (https://github.com/ansible-collections/community.aws/pull/1085).
       minor_changes:
@@ -1957,3 +1958,69 @@ releases:
       name: aws_api_gateway_domain
       namespace: ''
     release_date: '2022-05-30'
+  3.4.0:
+    changes:
+      bugfixes:
+      - aws_codebuild - fix bug where the result may be spuriously flagged as ``changed``
+        when multiple tags were set on the project (https://github.com/ansible-collections/community.aws/pull/1221).
+      - ecs_service - fix broken change detect of ``health_check_grace_period_seconds``
+        parameter when not specified (https://github.com/ansible-collections/community.aws/pull/1212).
+      - ecs_service - use default cluster name of ``default`` when not input (https://github.com/ansible-collections/community.aws/pull/1212).
+      - ecs_task - dont require ``cluster`` and use name of ``default`` when not input
+        (https://github.com/ansible-collections/community.aws/pull/1212).
+      - lambda_info - fix bug that forces query=config when getting info for all lambdas.
+        Now, if function name is specified, query will default to all.  This may have
+        a performance impact when querying a large number of lambdas. If function
+        name is not specified, query will default to config (https://github.com/ansible-collections/community.aws/pull/1152).
+      - rds_instance - fix bugs associated with restoring db instance from snapshot
+        (https://github.com/ansible-collections/community.aws/pull/1081).
+      - wafv2_ip_set - fix bug where incorrect changed state was returned when only
+        changing the description (https://github.com/ansible-collections/community.aws/pull/1211).
+      - wafv2_web_acl - consistently return web ACL info as described in module documentation
+        (https://github.com/ansible-collections/community.aws/pull/1216).
+      - wafv2_web_acl - fix ``changed`` status when description not specified (https://github.com/ansible-collections/community.aws/pull/1216).
+      deprecated_features:
+      - aws_codebuild - The ``tags`` parameter currently uses a non-standard format
+        and has been deprecated.  In release 6.0.0 this parameter will accept a simple
+        key/value pair dictionary instead of the current list of dictionaries.  It
+        is recommended to migrate to using the resource_tags parameter which already
+        accepts the simple dictionary format (https://github.com/ansible-collections/community.aws/pull/1221).
+      - route53_info - The CamelCase return values for ``HostedZones``, ``ResourceRecordSets``,
+        and ``HealthChecks`` have been deprecated, in the future release you must
+        use snake_case return values ``hosted_zones``, ``resource_record_sets``, and
+        ``health_checks`` instead respectively".
+      minor_changes:
+      - aws_codebuild - add support for ``purge_tags`` parameter (https://github.com/ansible-collections/community.aws/pull/1221).
+      - aws_codebuild - add the ``resource_tags`` parameter which takes the dictionary
+        format for tags instead of the list of dictionaries format (https://github.com/ansible-collections/community.aws/pull/1221).
+      - aws_codebuild - add the ``resource_tags`` return value which returns the standard
+        dictionary format for tags instead of the list of dictionaries format (https://github.com/ansible-collections/community.aws/pull/1221).
+      - aws_codebuild - the ``source`` and ``artifacts`` parameters are now optional
+        unless creating a new project (https://github.com/ansible-collections/community.aws/pull/1221).
+      - ecs_service - ``deployment_circuit_breaker`` has been added as a supported
+        feature (https://github.com/ansible-collections/community.aws/pull/1215).
+      - ecs_service - add ``service`` alias to address the ecs service name with the
+        same parameter as the ecs_service_info module is doing (https://github.com/ansible-collections/community.aws/pull/1187).
+      - ecs_service_info - add ``name`` alias to address the ecs service name with
+        the same parameter as the ecs_service module is doing (https://github.com/ansible-collections/community.aws/pull/1187).
+      - ecs_tag - ``resource_tags`` has been added as an alias for the ``tags`` parameter
+        (https://github.com/ansible-collections/community.aws/pull/1184).
+      - efs_tag - ``resource_tags`` has been added as an alias for the ``tags`` parameter
+        (https://github.com/ansible-collections/community.aws/pull/1184).
+      - rds_instance - add snapshot tests to test suite to test restoring db from
+        snapshot (https://github.com/ansible-collections/community.aws/pull/1081).
+      - rds_instance_info - add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/1026).
+      - wafv2_web_acl - relax botocore requirement to bare minimum required (https://github.com/ansible-collections/community.aws/pull/1216).
+    fragments:
+    - 0001-ecs-service-aliases.yml
+    - 1026-aws-retry-rds-instance-info.yml
+    - 1081-rds_instance-snapshot-tests-and-restore-db.yml
+    - 1152-lambda_info-bugfix-all-lambdas.yml
+    - 1184-tagging.yml
+    - 1211-wafv2_ip_set-description.yml
+    - 1212-ecs_service-fix-broken-change-detect.yml
+    - 1215-ecs-service-deployment-circuit-breaker-support.yml
+    - 1216-wafv2_web_acl-return.yml
+    - 1221-aws_codebuild-tagging.yml
+    - 1236-route53_info-add-snake_case-return-values.yml
+    release_date: '2022-06-23'

changelogs/fragments/0001-ecs-service-aliases.yml

-minor_changes:
-- ecs_service - add ``service`` alias to address the ecs service name with the same parameter as the ecs_service_info module is doing (https://github.com/ansible-collections/community.aws/pull/1187).
-- ecs_service_info - add ``name`` alias to address the ecs service name with the same parameter as the ecs_service module is doing (https://github.com/ansible-collections/community.aws/pull/1187).
\ No newline at end of file

changelogs/fragments/1026-aws-retry-rds-instance-info.yml

-minor_changes:
-- rds_instance_info - add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/1026).

changelogs/fragments/1081-rds_instance-snapshot-tests-and-restore-db.yml

-minor_changes:
-  - rds_instance - add snapshot tests to test suite to test restoring db from snapshot (https://github.com/ansible-collections/community.aws/pull/1081).
-bugfixes:
-  - rds_instance - fix bugs associated with restoring db instance from snapshot (https://github.com/ansible-collections/community.aws/pull/1081).

changelogs/fragments/1152-lambda_info-bugfix-all-lambdas.yml

-bugfixes:
-  - lambda_info - fix bug that forces query=config when getting info for all lambdas. Now, if function name is specified, query will default to all.  This may have a performance impact when querying a large number of lambdas.
-    If function name is not specified, query will default to config (https://github.com/ansible-collections/community.aws/pull/1152).

changelogs/fragments/1184-tagging.yml

-minor_changes:
-- ecs_tag - ``resource_tags`` has been added as an alias for the ``tags`` parameter (https://github.com/ansible-collections/community.aws/pull/1184).
-- efs_tag - ``resource_tags`` has been added as an alias for the ``tags`` parameter (https://github.com/ansible-collections/community.aws/pull/1184).

changelogs/fragments/1211-wafv2_ip_set-description.yml

-bugfixes:
-- wafv2_ip_set - fix bug where incorrect changed state was returned when only changing the description (https://github.com/ansible-collections/community.aws/pull/1211).

changelogs/fragments/1212-ecs_service-fix-broken-change-detect.yml

-bugfixes:
-  - ecs_service - fix broken change detect of ``health_check_grace_period_seconds`` parameter when not specified (https://github.com/ansible-collections/community.aws/pull/1212).
-  - ecs_service - use default cluster name of ``default`` when not input (https://github.com/ansible-collections/community.aws/pull/1212).
-  - ecs_task - dont require ``cluster`` and use name of ``default`` when not input (https://github.com/ansible-collections/community.aws/pull/1212).

changelogs/fragments/1215-ecs-service-deployment-circuit-breaker-support.yml

-minor_changes:
-- ecs_service - ``deployment_circuit_breaker`` has been added as a supported feature (https://github.com/ansible-collections/community.aws/pull/1215).
\ No newline at end of file

changelogs/fragments/1216-wafv2_web_acl-return.yml

-bugfixes:
-- wafv2_web_acl - consistently return web ACL info as described in module documentation (https://github.com/ansible-collections/community.aws/pull/1216).
-- wafv2_web_acl - fix ``changed`` status when description not specified (https://github.com/ansible-collections/community.aws/pull/1216).
-minor_changes:
-- wafv2_web_acl - relax botocore requirement to bare minimum required (https://github.com/ansible-collections/community.aws/pull/1216).

changelogs/fragments/1221-aws_codebuild-tagging.yml

-minor_changes:
-- aws_codebuild - add support for ``purge_tags`` parameter
-  (https://github.com/ansible-collections/community.aws/pull/1221).
-- aws_codebuild - the ``source`` and ``artifacts`` parameters are now optional unless creating a new project
-  (https://github.com/ansible-collections/community.aws/pull/1221).
-- aws_codebuild - add the ``resource_tags`` parameter which takes the dictionary format for tags instead of the list of dictionaries format
-  (https://github.com/ansible-collections/community.aws/pull/1221).
-- aws_codebuild - add the ``resource_tags`` return value which returns the standard dictionary format for tags instead of the list of
-  dictionaries format
-  (https://github.com/ansible-collections/community.aws/pull/1221).
-
-bugfixes:
-- aws_codebuild - fix bug where the result may be spuriously flagged as ``changed`` when multiple tags were set on the project
-  (https://github.com/ansible-collections/community.aws/pull/1221).
-
-deprecated_features:
-- aws_codebuild - The ``tags`` parameter currently uses a non-standard format and has been deprecated.  In release 6.0.0 this parameter will
-  accept a simple key/value pair dictionary instead of the current list of dictionaries.  It is recommended to migrate to using the
-  resource_tags parameter which already accepts the simple dictionary format
- (https://github.com/ansible-collections/community.aws/pull/1221).

changelogs/fragments/1236-route53_info-add-snake_case-return-values.yml

-deprecated_features:
-  - route53_info - The CamelCase return values for ```HostedZones```, ```ResourceRecordSets```, and ```HealthChecks```
-    have been deprecated, in the future release you must use snake_case return values ```hosted_zones```, ```resource_record_sets```,
-    and ```health_checks``` instead respectively".
\ No newline at end of file

docs/community.aws.aws_codebuild_module.rst

@@ -48,13 +48,13 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">dictionary</span>
-                         / <span style="color: red">required</span>
                     </div>
                 </td>
                 <td>
                 </td>
                 <td>
                         <div>Information about the build output artifacts for the build project.</div>
+                        <div><em>artifacts</em> is required when creating a new project.</div>
                 </td>
             </tr>
                                 <tr>
@@ -477,6 +477,27 @@ Parameters
                         <div style="font-size: small; color: darkgreen"><br/>aliases: aws_profile</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>purge_tags</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">boolean</span>
+                    </div>
+                </td>
+                <td>
+                        <ul style="margin: 0; padding: 0"><b>Choices:</b>
+                                    <li>no</li>
+                                    <li><div style="color: blue"><b>yes</b>&nbsp;&larr;</div></li>
+                        </ul>
+                </td>
+                <td>
+                        <div>If <em>purge_tags=true</em> and <em>tags</em> is set, existing tags will be purged from the resource to match exactly what is defined by <em>tags</em> parameter.</div>
+                        <div>If the <em>resource_tags</em> parameter is not set then tags will not be modified, even if <em>purge_tags=True</em>.</div>
+                        <div>Tag keys beginning with <code>aws:</code> are reserved by Amazon and can not be modified.  As such they will be ignored for the purposes of the <em>purge_tags</em> parameter.  See the Amazon documentation for more information <a href='https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions'>https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html#tag-conventions</a>.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="2">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -493,6 +514,23 @@ Parameters
                         <div style="font-size: small; color: darkgreen"><br/>aliases: aws_region, ec2_region</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>resource_tags</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">dictionary</span>
+                    </div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>A dictionary representing the tags to be applied to the build project.</div>
+                        <div>If the <em>resource_tags</em> parameter is not set then tags will not be modified.</div>
+                        <div>Mutually exclusive with the <em>tags</em> parameter.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="2">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -534,13 +572,13 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">dictionary</span>
-                         / <span style="color: red">required</span>
                     </div>
                 </td>
                 <td>
                 </td>
                 <td>
                         <div>Configure service and location for the build input source.</div>
+                        <div><em>source</em> is required when creating a new project.</div>
                 </td>
             </tr>
                                 <tr>
@@ -662,6 +700,8 @@ Parameters
                 </td>
                 <td>
                         <div>A set of tags for the build project.</div>
+                        <div>Mutually exclusive with the <em>resource_tags</em> parameter.</div>
+                        <div>In release 6.0.0 this parameter will accept a simple dictionary instead of the list of dictionaries format.  To use the simple dictionary format prior to release 6.0.0 the <em>resource_tags</em> can be used instead of <em>tags</em>.</div>
                 </td>
             </tr>
                                 <tr>
@@ -980,6 +1020,24 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
                         <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">my_project</div>
                 </td>
             </tr>
+            <tr>
+                    <td class="elbow-placeholder">&nbsp;</td>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="return-"></div>
+                    <b>reource_tags</b>
+                    <a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
+                    <div style="font-size: small">
+                      <span style="color: purple">dictionary</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 4.0.0</div>
+                </td>
+                <td>when configured</td>
+                <td>
+                            <div>A simple dictionary representing the tags added to the project.</div>
+                            <div><em>tags</em> and <em>reource_tags</em> represent the same information in different formats.</div>
+                    <br/>
+                </td>
+            </tr>
             <tr>
                     <td class="elbow-placeholder">&nbsp;</td>
                 <td colspan="2">
@@ -1131,7 +1189,8 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
                 </td>
                 <td>when configured</td>
                 <td>
-                            <div>Tags added to the project</div>
+                            <div>Tags added to the project in the boto3 list of dictionaries format.</div>
+                            <div><em>tags</em> and <em>reource_tags</em> represent the same information in different formats.</div>
                     <br/>
                 </td>
             </tr>

docs/community.aws.ec2_customer_gateway_module.rst

@@ -123,7 +123,8 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>Border Gateway Protocol (BGP) Autonomous System Number (ASN), required when <em>state=present</em>.</div>
+                        <div>Border Gateway Protocol (BGP) Autonomous System Number (ASN).</div>
+                        <div>Defaults to <code>65000</code> if not specified when <em>state=present</em>.</div>
                 </td>
             </tr>
             <tr>

docs/community.aws.ecs_service_info_module.rst

@@ -265,6 +265,7 @@ Parameters
                 </td>
                 <td>
                         <div>One or more services to get details for</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: name</div>
                 </td>
             </tr>
             <tr>

docs/community.aws.ecs_tag_module.rst

@@ -306,6 +306,7 @@ Parameters
                 <td>
                         <div>A dictionary of tags to add or remove from the resource.</div>
                         <div>If the value provided for a tag is null and <em>state=absent</em>, the tag will be removed regardless of its current value.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: resource_tags</div>
                 </td>
             </tr>
             <tr>

docs/community.aws.ecs_task_module.rst

@@ -118,13 +118,14 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">string</span>
-                         / <span style="color: red">required</span>
                     </div>
                 </td>
                 <td>
+                        <b>Default:</b><br/><div style="color: blue">"default"</div>
                 </td>
                 <td>
                         <div>The name of the cluster to run the task on.</div>
+                        <div>If not specified, the cluster name will be <code>default</code>.</div>
                 </td>
             </tr>
             <tr>

docs/community.aws.efs_tag_module.rst

@@ -269,6 +269,7 @@ Parameters
                 <td>
                         <div>A dictionary of tags to add or remove from the resource.</div>
                         <div>If the value provided for a tag is null and <em>state=absent</em>, the tag will be removed regardless of its current value.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: resource_tags</div>
                 </td>
             </tr>
             <tr>

docs/community.aws.iam_server_certificate_info_module.rst

@@ -308,7 +308,9 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
                             <div>The asn1der encoded PEM string</div>
                     <br/>
                         <div style="font-size: smaller"><b>Sample:</b></div>
-                        <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">-----BEGIN CERTIFICATE----- bunch of random data -----END CERTIFICATE-----</div>
+                        <div style="font-size: smaller; color: blue; word-wrap: break-word; word-break: break-all;">-----BEGIN CERTIFICATE-----
+    bunch of random data
+    -----END CERTIFICATE-----</div>
                 </td>
             </tr>
             <tr>

docs/community.aws.lambda_info_module.rst

@@ -18,7 +18,7 @@ Version added: 1.0.0
 Synopsis
 --------
 - Gathers various details related to Lambda functions, including aliases, versions and event source mappings.
-- Use module :ref:`community.aws.lambda <community.aws.lambda_module>` to manage the lambda function itself, :ref:`community.aws.lambda_alias <community.aws.lambda_alias_module>` to manage function aliases and :ref:`community.aws.lambda_event <community.aws.lambda_event_module>` to manage lambda event source mappings.
+- Use module :ref:`community.aws.lambda <community.aws.lambda_module>` to manage the lambda function itself, :ref:`community.aws.lambda_alias <community.aws.lambda_alias_module>` to manage function aliases, :ref:`community.aws.lambda_event <community.aws.lambda_event_module>` to manage lambda event source mappings, and :ref:`community.aws.lambda_policy <community.aws.lambda_policy_module>` to manage policy statements.
 
 
 
@@ -207,7 +207,7 @@ Parameters
                 <td>
                         <ul style="margin: 0; padding: 0"><b>Choices:</b>
                                     <li>aliases</li>
-                                    <li><div style="color: blue"><b>all</b>&nbsp;&larr;</div></li>
+                                    <li>all</li>
                                     <li>config</li>
                                     <li>mappings</li>
                                     <li>policy</li>
@@ -216,7 +216,9 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>Specifies the resource type for which to gather information.  Leave blank to retrieve all information.</div>
+                        <div>Specifies the resource type for which to gather information.</div>
+                        <div>Defaults to <code>all</code> when <em>function_name</em> is specified.</div>
+                        <div>Defaults to <code>config</code> when <em>function_name</em> is NOT specified.</div>
                 </td>
             </tr>
             <tr>
@@ -300,17 +302,20 @@ Examples
         query: all
         function_name: myFunction
       register: my_function_details
+
     # List all versions of a function
     - name: List function versions
       community.aws.lambda_info:
         query: versions
         function_name: myFunction
       register: my_function_versions
-    # List all lambda function versions
-    - name: List all function
+
+    # List all info for all functions
+    - name: List all functions
       community.aws.lambda_info:
         query: all
       register: output
+
     - name: show Lambda information
       ansible.builtin.debug:
         msg: "{{ output['function'] }}"

docs/community.aws.rds_instance_module.rst

@@ -91,7 +91,7 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>A value that specifies whether modifying a cluster with <em>new_db_instance_identifier</em> and <em>master_user_password</em> should be applied as soon as possible, regardless of the <em>preferred_maintenance_window</em> setting. If false, changes are applied during the next maintenance window.</div>
+                        <div>A value that specifies whether modifying an instance with <em>new_db_instance_identifier</em> and <em>master_user_password</em> should be applied as soon as possible, regardless of the <em>preferred_maintenance_window</em> setting. If false, changes are applied during the next maintenance window.</div>
                 </td>
             </tr>
             <tr>
@@ -125,7 +125,7 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>A list of EC2 Availability Zones that instances in the DB cluster can be created in. May be used when creating a cluster or when restoring from S3 or a snapshot. Mutually exclusive with <em>multi_az</em>.</div>
+                        <div>A list of EC2 Availability Zones that the DB instance can be created in. May be used when creating an instance or when restoring from S3 or a snapshot. Mutually exclusive with <em>multi_az</em>.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: az, zone</div>
                 </td>
             </tr>
@@ -213,7 +213,7 @@ Parameters
                 <td>
                         <div>The number of days for which automated backups are retained.</div>
                         <div>When set to <code>0</code>, automated backups will be disabled. (Not applicable if the DB instance is a source to read replicas)</div>
-                        <div>May be used when creating a new cluster, when restoring from S3, or when modifying a cluster.</div>
+                        <div>May be used when creating a new instance, when restoring from S3, or when modifying an instance.</div>
                 </td>
             </tr>
             <tr>
@@ -243,7 +243,7 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>The character set to associate with the DB cluster.</div>
+                        <div>The character set to associate with the DB instance.</div>
                 </td>
             </tr>
             <tr>
@@ -392,7 +392,8 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>The identifier for the DB snapshot to restore from if using <em>creation_source=snapshot</em>.</div>
+                        <div>The identifier or ARN of the DB snapshot to restore from when using <em>creation_source=snapshot</em>.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: snapshot_identifier, snapshot_id</div>
                 </td>
             </tr>
             <tr>
@@ -529,7 +530,7 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>Enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. If this option is omitted when creating the cluster, Amazon RDS sets this to False.</div>
+                        <div>Enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts. If this option is omitted when creating the instance, Amazon RDS sets this to False.</div>
                 </td>
             </tr>
             <tr>
@@ -648,7 +649,7 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>Set to True to update your cluster password with <em>master_user_password</em>. Since comparing passwords to determine if it needs to be updated is not possible this is set to False by default to allow idempotence.</div>
+                        <div>Set to <code>True</code> to update your instance password with <em>master_user_password</em>. Since comparing passwords to determine if it needs to be updated is not possible this is set to False by default to allow idempotence.</div>
                 </td>
             </tr>
             <tr>
@@ -779,7 +780,7 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>The name of the master user for the DB cluster. Must be 1-16 letters or numbers and begin with a letter.</div>
+                        <div>The name of the master user for the DB instance. Must be 1-16 letters or numbers and begin with a letter.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: username</div>
                 </td>
             </tr>
@@ -859,7 +860,7 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>The new DB cluster (lowercase) identifier for the DB cluster when renaming a DB instance. The identifier must contain from 1 to 63 letters, numbers, or hyphens and the first character must be a letter and may not end in a hyphen or contain consecutive hyphens. Use <em>apply_immediately</em> to rename immediately, otherwise it is updated during the next maintenance window.</div>
+                        <div>The new DB instance (lowercase) identifier for the DB instance when renaming a DB instance. The identifier must contain from 1 to 63 letters, numbers, or hyphens and the first character must be a letter and may not end in a hyphen or contain consecutive hyphens. Use <em>apply_immediately</em> to rename immediately, otherwise it is updated during the next maintenance window.</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: new_instance_id, new_id</div>
                 </td>
             </tr>
@@ -1149,7 +1150,7 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>Set to False to promote a read replica cluster or true to create one. When creating a read replica <code>creation_source</code> should be set to &#x27;instance&#x27; or not provided. <code>source_db_instance_identifier</code> must be provided with this option.</div>
+                        <div>Set to <code>False</code> to promote a read replica instance or true to create one. When creating a read replica <code>creation_source</code> should be set to &#x27;instance&#x27; or not provided. <code>source_db_instance_identifier</code> must be provided with this option.</div>
                 </td>
             </tr>
             <tr>
@@ -1265,22 +1266,7 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>Whether a final DB cluster snapshot is created before the DB cluster is deleted. If this is false <em>final_db_snapshot_identifier</em> must be provided.</div>
-                </td>
-            </tr>
-            <tr>
-                <td colspan="2">
-                    <div class="ansibleOptionAnchor" id="parameter-"></div>
-                    <b>snapshot_identifier</b>
-                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
-                    <div style="font-size: small">
-                        <span style="color: purple">string</span>
-                    </div>
-                </td>
-                <td>
-                </td>
-                <td>
-                        <div>The ARN of the DB snapshot to restore from when using <em>creation_source=snapshot</em>.</div>
+                        <div>Whether a final DB instance snapshot is created before the DB instance is deleted. If this is false <em>final_db_snapshot_identifier</em> must be provided.</div>
                 </td>
             </tr>
             <tr>
@@ -1423,7 +1409,7 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>A dictionary of key value pairs to assign the DB cluster.</div>
+                        <div>A dictionary of key value pairs to assign the DB instance.</div>
                 </td>
             </tr>
             <tr>
@@ -1526,7 +1512,7 @@ Parameters
                 <td>
                 </td>
                 <td>
-                        <div>A list of EC2 VPC security groups to associate with the DB cluster.</div>
+                        <div>A list of EC2 VPC security groups to associate with the DB instance.</div>
                 </td>
             </tr>
             <tr>
@@ -1545,7 +1531,7 @@ Parameters
                         </ul>
                 </td>
                 <td>
-                        <div>Whether to wait for the cluster to be available, stopped, or deleted. At a later time a wait_timeout option may be added. Following each API call to create/modify/delete the instance a waiter is used with a 60 second delay 30 times until the instance reaches the expected state (available/stopped/deleted). The total task time may also be influenced by AWSRetry which helps stabilize if the instance is in an invalid state to operate on to begin with (such as if you try to stop it when it is in the process of rebooting). If setting this to False task retries and delays may make your playbook execution better handle timeouts for major modifications.</div>
+                        <div>Whether to wait for the instance to be available, stopped, or deleted. At a later time a <em>wait_timeout</em> option may be added. Following each API call to create/modify/delete the instance a waiter is used with a 60 second delay 30 times until the instance reaches the expected state (available/stopped/deleted). The total task time may also be influenced by AWSRetry which helps stabilize if the instance is in an invalid state to operate on to begin with (such as if you try to stop it when it is in the process of rebooting). If setting this to False task retries and delays may make your playbook execution better handle timeouts for major modifications.</div>
                 </td>
             </tr>
     </table>
@@ -1644,14 +1630,26 @@ Examples
       community.aws.rds_instance:
         id: "my-instance-id"
         state: present
-        engine: postgres
-        engine_version: 14.2
-        username: "{{ username }}"
-        password: "{{ password }}"
-        db_instance_class: db.m6g.large
-        allocated_storage: "{{ allocated_storage }}"
         purge_iam_roles: yes
 
+    # Restore DB instance from snapshot
+    - name: Create a snapshot and wait until completion
+      community.aws.rds_instance_snapshot:
+        instance_id: 'my-instance-id'
+        snapshot_id: 'my-new-snapshot'
+        state: present
+        wait: yes
+      register: snapshot
+
+    - name: Restore DB from snapshot
+      community.aws.rds_instance:
+        id: 'my-restored-db'
+        creation_source: snapshot
+        snapshot_identifier: 'my-new-snapshot'
+        engine: mariadb
+        state: present
+      register: restored_db
+
 
 
 Return Values

docs/community.aws.wafv2_web_acl_module.rst

@@ -147,7 +147,7 @@ Parameters
                         <div>A map of custom response keys and content bodies. Define response bodies here and reference them in the rules by providing</div>
                         <div>the key of the body dictionary element.</div>
                         <div>Each element must have a unique dict key and in the dict two keys for <em>content_type</em> and <em>content</em>.</div>
-                        <div>Requires botocore &gt;= 1.21.0</div>
+                        <div>Requires botocore &gt;= 1.20.40</div>
                 </td>
             </tr>
             <tr>

galaxy.yml

 namespace: community
 name: aws
-version: 3.3.0
+version: 3.4.0
 readme: README.md
 authors:
   - Ansible (https://github.com/ansible)