prepare 3.1.0 (#938)

* prepare 3.1.0 * dafuq
ansible-collections · Feb 14, 2022 · 9ccdbdf · 9ccdbdf
1 parent ca884b0
commit 9ccdbdf
Show file tree

Hide file tree

Showing 31 changed files with 610 additions and 227 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -5,6 +5,42 @@ community.aws Release Notes
 .. contents:: Topics
 
 
+v3.1.0
+======
+
+Release Summary
+---------------
+
+This is the minor release of the ``community.aws`` collection.
+This changelog contains all changes to the modules and plugins in this collection
+that have been made after the previous release.
+
+Minor Changes
+-------------
+
+- aws_secret - Add ``resource_policy`` parameter (https://github.com/ansible-collections/community.aws/pull/843).
+- aws_ssm connection plugin - add parameters to explicitly specify SSE mode and KMS key id for uploads on the file transfer bucket. (https://github.com/ansible-collections/community.aws/pull/763)
+- dynamodb_table - the ``table_class`` parameter has been added (https://github.com/ansible-collections/community.aws/pull/880).
+- ec2_launch_template - Add metadata options parameter ``http_protocol_ipv6`` and ``instance_metadata_tags`` (https://github.com/ansible-collections/community.aws/pull/917).
+- ec2_lc - add support for throughput parameter (https://github.com/ansible-collections/community.aws/pull/790).
+- ec2_placement_group - add support for partition strategy and partition count (https://github.com/ansible-collections/community.aws/pull/872).
+- elb_instance - `wait` parameter is no longer ignored (https://github.com/ansible-collections/community.aws/pull/826)
+- elb_target_group - add support for parameter ``deregistration_connection_termination`` (https://github.com/ansible-collections/community.aws/pull/913).
+- iam_managed_policy - refactor module adding ``check_mode`` and better AWSRetry backoff logic (https://github.com/ansible-collections/community.aws/pull/893).
+- iam_user - add parameter ``password_reset_required`` (https://github.com/ansible-collections/community.aws/pull/860).
+- wafv2_web_acl - Documentation updates wafv2_web_acl and aws_waf_web_acl (https://github.com/ansible-collections/community.aws/pull/721).
+- wafv2_web_acl - Extended the wafv2_web_acl module to also take the ``custom_response_bodies`` argument (https://github.com/ansible-collections/community.aws/pull/721).
+
+Bugfixes
+--------
+
+- Add backoff retry logic to route53_info (https://github.com/ansible-collections/community.aws/pull/865).
+- Add backoff retry logic to route53_zone (https://github.com/ansible-collections/community.aws/pull/865).
+- cloudfront_distribution - Dont pass ``s3_origin_access_identity_enabled`` to API request (https://github.com/ansible-collections/community.aws/pull/881).
+- execute_lambda - Wait for Lambda function State = Active before executing (https://github.com/ansible-collections/community.aws/pull/857)
+- lambda - Wait for Lambda function State = Active & LastUpdateStatus = Successful before updating (https://github.com/ansible-collections/community.aws/pull/857)
+- rds_instance - Fix updates of ``iops`` or ``allocated_storage`` for ``io1`` DB instances when only one value is changing (https://github.com/ansible-collections/community.aws/pull/878).
+
 v3.0.1
 ======
 

diff --git a/README.md b/README.md
diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml
@@ -1632,3 +1632,58 @@ releases:
     - 794-s3_lifecycle_abort_expire.yml
     - 863-requirements-doc-fix.yml
     release_date: '2022-01-18'
+  3.1.0:
+    changes:
+      bugfixes:
+      - Add backoff retry logic to route53_info (https://github.com/ansible-collections/community.aws/pull/865).
+      - Add backoff retry logic to route53_zone (https://github.com/ansible-collections/community.aws/pull/865).
+      - cloudfront_distribution - Dont pass ``s3_origin_access_identity_enabled``
+        to API request (https://github.com/ansible-collections/community.aws/pull/881).
+      - execute_lambda - Wait for Lambda function State = Active before executing
+        (https://github.com/ansible-collections/community.aws/pull/857)
+      - lambda - Wait for Lambda function State = Active & LastUpdateStatus = Successful
+        before updating (https://github.com/ansible-collections/community.aws/pull/857)
+      - rds_instance - Fix updates of ``iops`` or ``allocated_storage`` for ``io1``
+        DB instances when only one value is changing (https://github.com/ansible-collections/community.aws/pull/878).
+      minor_changes:
+      - aws_secret - Add ``resource_policy`` parameter (https://github.com/ansible-collections/community.aws/pull/843).
+      - aws_ssm connection plugin - add parameters to explicitly specify SSE mode
+        and KMS key id for uploads on the file transfer bucket. (https://github.com/ansible-collections/community.aws/pull/763)
+      - dynamodb_table - the ``table_class`` parameter has been added (https://github.com/ansible-collections/community.aws/pull/880).
+      - ec2_launch_template - Add metadata options parameter ``http_protocol_ipv6``
+        and ``instance_metadata_tags`` (https://github.com/ansible-collections/community.aws/pull/917).
+      - ec2_lc - add support for throughput parameter (https://github.com/ansible-collections/community.aws/pull/790).
+      - ec2_placement_group - add support for partition strategy and partition count
+        (https://github.com/ansible-collections/community.aws/pull/872).
+      - elb_instance - `wait` parameter is no longer ignored (https://github.com/ansible-collections/community.aws/pull/826)
+      - elb_target_group - add support for parameter ``deregistration_connection_termination``
+        (https://github.com/ansible-collections/community.aws/pull/913).
+      - iam_managed_policy - refactor module adding ``check_mode`` and better AWSRetry
+        backoff logic (https://github.com/ansible-collections/community.aws/pull/893).
+      - iam_user - add parameter ``password_reset_required`` (https://github.com/ansible-collections/community.aws/pull/860).
+      - wafv2_web_acl - Documentation updates wafv2_web_acl and aws_waf_web_acl (https://github.com/ansible-collections/community.aws/pull/721).
+      - wafv2_web_acl - Extended the wafv2_web_acl module to also take the ``custom_response_bodies``
+        argument (https://github.com/ansible-collections/community.aws/pull/721).
+      release_summary: 'This is the minor release of the ``community.aws`` collection.
+
+        This changelog contains all changes to the modules and plugins in this collection
+
+        that have been made after the previous release.'
+    fragments:
+    - 3.1.0.yml
+    - 721-wafv2_web_acl.yml
+    - 763-aws_ssm_connection-add-sse-parameters.yml
+    - 790-ec2_lc-add-throughput-param-support.yml
+    - 825-fix-elb-wait.yml
+    - 843-add_aws_secret_resource_policy_support.yml
+    - 857-lambda-wait-before.yml
+    - 860-add-missing-parameter.yml
+    - 865-add-backoff-retry-logic-route53_zone.yml
+    - 872-ec2_placement_group_partition_strategy.yml
+    - 878-fix-iops-updates-rds.yml
+    - 880-add-table-class-param.yml
+    - 881-cloudfront-bug.yml
+    - 893-refactor-iam_managed_policy.yml
+    - 913-tg-dereg-conn-param.yml
+    - 917-add-launch-template-metadata-parameters.yml
+    release_date: '2022-02-14'
diff --git a/changelogs/fragments/721-wafv2_web_acl.yml b/changelogs/fragments/721-wafv2_web_acl.yml
diff --git a/changelogs/fragments/763-aws_ssm_connection-add-sse-parameters.yml b/changelogs/fragments/763-aws_ssm_connection-add-sse-parameters.yml
diff --git a/changelogs/fragments/790-ec2_lc-add-throughput-param-support.yml b/changelogs/fragments/790-ec2_lc-add-throughput-param-support.yml
diff --git a/changelogs/fragments/825-fix-elb-wait.yml b/changelogs/fragments/825-fix-elb-wait.yml
diff --git a/changelogs/fragments/843-add_aws_secret_resource_policy_support.yml b/changelogs/fragments/843-add_aws_secret_resource_policy_support.yml
diff --git a/changelogs/fragments/857-lambda-wait-before.yml b/changelogs/fragments/857-lambda-wait-before.yml
diff --git a/changelogs/fragments/860-add-missing-parameter.yml b/changelogs/fragments/860-add-missing-parameter.yml
diff --git a/changelogs/fragments/865-add-backoff-retry-logic-route53_zone.yml b/changelogs/fragments/865-add-backoff-retry-logic-route53_zone.yml
diff --git a/changelogs/fragments/872-ec2_placement_group_partition_strategy.yml b/changelogs/fragments/872-ec2_placement_group_partition_strategy.yml
diff --git a/changelogs/fragments/878-fix-iops-updates-rds.yml b/changelogs/fragments/878-fix-iops-updates-rds.yml
diff --git a/changelogs/fragments/880-add-table-class-param.yml b/changelogs/fragments/880-add-table-class-param.yml
diff --git a/changelogs/fragments/881-cloudfront-bug.yml b/changelogs/fragments/881-cloudfront-bug.yml
diff --git a/changelogs/fragments/893-refactor-iam_managed_policy.yml b/changelogs/fragments/893-refactor-iam_managed_policy.yml
diff --git a/changelogs/fragments/913-tg-dereg-conn-param.yml b/changelogs/fragments/913-tg-dereg-conn-param.yml
diff --git a/changelogs/fragments/917-add-launch-template-metadata-parameters.yml b/changelogs/fragments/917-add-launch-template-metadata-parameters.yml
diff --git a/docs/community.aws.aws_acm_module.rst b/docs/community.aws.aws_acm_module.rst
@@ -18,6 +18,7 @@ Version added: 1.0.0
 Synopsis
 --------
 - Import and delete certificates in Amazon Web Service's Certificate Manager (AWS ACM).
+
 - This module does not currently interact with AWS-provided certificates. It currently only manages certificates provided to AWS by the user.
 
 - The ACM API allows users to upload multiple certificates for the same domain name, and even multiple identical certificates. This module attempts to restrict such freedoms, to be idempotent, as per the Ansible philosophy. It does this through applying AWS resource "Name" tags to ACM certificates.
@@ -37,6 +38,7 @@ Synopsis
 
 
 
+
 Requirements
 ------------
 The below requirements are needed on the host that executes this module.
@@ -214,7 +216,7 @@ Parameters
                 <td>
                         <div>The domain name of the certificate.</div>
                         <div>If <em>state=absent</em> and <em>domain_name</em> is specified, this task will delete all ACM certificates with this domain.</div>
-                        <div>Exactly one of <em>domain_name</em>, <em>name_tag</em>  and <em>certificate_arn</em> must be provided.</div>
+                        <div>Exactly one of <em>domain_name</em>, <em>name_tag</em> and <em>certificate_arn</em> must be provided.</div>
                         <div>If <em>state=present</em> this must not be specified. (Since the domain name is encoded within the public certificate&#x27;s body.)</div>
                         <div style="font-size: small; color: darkgreen"><br/>aliases: domain</div>
                 </td>

diff --git a/docs/community.aws.aws_secret_module.rst b/docs/community.aws.aws_secret_module.rst
@@ -243,6 +243,22 @@ Parameters
                         <div style="font-size: small; color: darkgreen"><br/>aliases: aws_region, ec2_region</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>resource_policy</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">json</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>Specifies JSON-formatted resource policy to attach to the secret. Useful when granting cross-account access to secrets.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -407,6 +423,14 @@ Examples
         secret_type: 'string'
         secret: "{{ super_secret_string }}"
 
+    - name: Add a secret with resource policy attached
+      community.aws.aws_secret:
+        name: 'test_secret_string'
+        state: present
+        secret_type: 'string'
+        secret: "{{ super_secret_string }}"
+        resource_policy: "{{ lookup('template', 'templates/resource_policy.json.j2', convert_data=False) | string }}"
+
     - name: remove string from AWS Secrets Manager
       community.aws.aws_secret:
         name: 'test_secret_string'

diff --git a/docs/community.aws.aws_waf_web_acl_module.rst b/docs/community.aws.aws_waf_web_acl_module.rst
@@ -5,7 +5,7 @@
 community.aws.aws_waf_web_acl
 *****************************
 
-**Create and delete WAF Web ACLs.**
+**Create and delete WAF Web ACLs**
 
 
 Version added: 1.0.0
@@ -17,7 +17,8 @@ Version added: 1.0.0
 
 Synopsis
 --------
-- Read the AWS documentation for WAF https://aws.amazon.com/documentation/waf/.
+- Module for WAF classic, for WAF v2 use the *wafv2_** modules.
+- Read the AWS documentation for WAF https://docs.aws.amazon.com/waf/latest/developerguide/classic-waf-chapter.html.
 
 
 

diff --git a/docs/community.aws.dynamodb_table_module.rst b/docs/community.aws.dynamodb_table_module.rst
@@ -553,6 +553,27 @@ Parameters
                         <div>Create or delete the table.</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>table_class</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">string</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 3.1.0</div>
+                </td>
+                <td>
+                        <ul style="margin: 0; padding: 0"><b>Choices:</b>
+                                    <li>STANDARD</li>
+                                    <li>STANDARD_INFREQUENT_ACCESS</li>
+                        </ul>
+                </td>
+                <td>
+                        <div>The class of the table.</div>
+                        <div>Requires at least botocore version 1.23.18.</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="2">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -723,6 +744,23 @@ Common return values are documented `here <https://docs.ansible.com/ansible/late
             <th>Returned</th>
             <th width="100%">Description</th>
         </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="return-"></div>
+                    <b>table</b>
+                    <a class="ansibleOptionLink" href="#return-" title="Permalink to this return value"></a>
+                    <div style="font-size: small">
+                      <span style="color: purple">complex</span>
+                    </div>
+                </td>
+                <td>success</td>
+                <td>
+                            <div>The returned table params from the describe API call.</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;">{&#x27;arn&#x27;: &#x27;arn:aws:dynamodb:us-east-1:721066863947:table/ansible-test-table&#x27;, &#x27;attribute_definitions&#x27;: [{&#x27;attribute_name&#x27;: &#x27;id&#x27;, &#x27;attribute_type&#x27;: &#x27;N&#x27;}], &#x27;billing_mode&#x27;: &#x27;PROVISIONED&#x27;, &#x27;creation_date_time&#x27;: &#x27;2022-02-04T13:36:01.578000+00:00&#x27;, &#x27;id&#x27;: &#x27;533b45fe-0870-4b66-9b00-d2afcfe96f19&#x27;, &#x27;item_count&#x27;: 0, &#x27;key_schema&#x27;: [{&#x27;attribute_name&#x27;: &#x27;id&#x27;, &#x27;key_type&#x27;: &#x27;HASH&#x27;}], &#x27;name&#x27;: &#x27;ansible-test-14482047-alinas-mbp&#x27;, &#x27;provisioned_throughput&#x27;: {&#x27;number_of_decreases_today&#x27;: 0, &#x27;read_capacity_units&#x27;: 1, &#x27;write_capacity_units&#x27;: 1}, &#x27;size&#x27;: 0, &#x27;status&#x27;: &#x27;ACTIVE&#x27;, &#x27;table_arn&#x27;: &#x27;arn:aws:dynamodb:us-east-1:721066863947:table/ansible-test-table&#x27;, &#x27;table_id&#x27;: &#x27;533b45fe-0870-4b66-9b00-d2afcfe96f19&#x27;, &#x27;table_name&#x27;: &#x27;ansible-test-table&#x27;, &#x27;table_size_bytes&#x27;: 0, &#x27;table_status&#x27;: &#x27;ACTIVE&#x27;, &#x27;tags&#x27;: {}}</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="return-"></div>