Prepare 1.4.0 release (#415)

* Prepare 1.4.0 release
ansible-collections · Feb 17, 2021 · 4bb4ad6 · 4bb4ad6
1 parent b3f5d45
commit 4bb4ad6
Show file tree

Hide file tree

Showing 34 changed files with 284 additions and 75 deletions.
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -5,6 +5,47 @@ community.aws Release Notes
 .. contents:: Topics
 
 
+v1.4.0
+======
+
+Minor Changes
+-------------
+
+- aws_kms - add support for setting the deletion window using `pending_window` (PendingWindowInDays) (https://github.com/ansible-collections/community.aws/pull/200).
+- aws_kms_info - Add ``key_id`` and ``alias`` parameters to support fetching a single key (https://github.com/ansible-collections/community.aws/pull/200).
+- dynamodb_ttl - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280).
+- ec2_instance - add automatic retries on all paginated queries for temporary errors (https://github.com/ansible-collections/community.aws/pull/373).
+- ec2_instance - migrate to shared implementation of get_ec2_security_group_ids_from_names. The module will now return an error if the subnet provided isn't in the requested VPC. (https://github.com/ansible-collections/community.aws/pull/214)
+- ec2_instance_info - added ``minimum_uptime`` option with alias ``uptime`` for filtering instances that have only been online for certain duration of time in minutes (https://github.com/ansible-collections/community.aws/pull/356).
+- ec2_launch_template - Add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/326).
+- ec2_vpc_peer - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280).
+- ecs_task - use ``botocore_at_least`` helper for checking the available botocore version (https://github.com/ansible-collections/community.aws/pull/280).
+- route53 - migrated from boto to boto3 (https://github.com/ansible-collections/community.aws/pull/405).
+- various community.aws modules - cleanup error handling to use ``is_boto3_error_code`` and ``is_boto3_error_message`` helpers (https://github.com/ansible-collections/community.aws/pull/268).
+- various community.aws modules - cleanup of Python imports (https://github.com/ansible-collections/community.aws/pull/360).
+- various community.aws modules - improve consistency of handling Boto3 exceptions (https://github.com/ansible-collections/community.aws/pull/268).
+- various community.aws modules - migrate exception error message handling from fail_json to fail_json_aws (https://github.com/ansible-collections/community.aws/pull/361).
+
+Deprecated Features
+-------------------
+
+- ec2_eip - formally deprecate the ``instance_id`` alias for ``device_id`` (https://github.com/ansible-collections/community.aws/pull/349).
+- ec2_vpc_endpoint - deprecate the policy_file option and recommend using policy with a lookup (https://github.com/ansible-collections/community.aws/pull/366).
+
+Bugfixes
+--------
+
+- aws_kms - fixes issue where module execution fails without the kms:GetKeyRotationStatus permission. (https://github.com/ansible-collections/community.aws/pull/200).
+- aws_kms_info - ensure that searching by tag works when tag only exists on some CMKs (https://github.com/ansible-collections/community.aws/issues/276).
+- aws_s3_cors - fix element type for rules parameter. (https://github.com/ansible-collections/community.aws/pull/408).
+- aws_ssm - fix the generation of CURL URL used to download Ansible Python file from S3 bucket by ```_get_url()``` due to due to non-assignment of aws region in the URL and not using V4 signature as specified for AWS S3 signature URL by ```_get_boto_client()``` in (https://github.com/ansible-collections/community.aws/pull/352).
+- aws_ssm - fixed ``UnicodeEncodeError`` error when using unicode file names (https://github.com/ansible-collections/community.aws/pull/295).
+- ec2_eip - fix eip association by instance id & private ip address due to case-sensitivity of the ``PrivateIpAddress`` parameter (https://github.com/ansible-collections/community.aws/pull/328).
+- ec2_vpc_endpoint - ensure ``changed`` is correctly set when deleting an endpoint (https://github.com/ansible-collections/community.aws/pull/362).
+- ec2_vpc_endpoint - fix exception when attempting to delete an endpoint which has already been deleted (https://github.com/ansible-collections/community.aws/pull/362).
+- ecs_task - use `required_if` to enforce mandatory parameters based on specified operation (https://github.com/ansible-collections/community.aws/pull/402).
+- elb_application_lb - during the removal of an instance, the associated listeners are also removed.
+
 v1.3.0
 ======
 

diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml
@@ -802,3 +802,80 @@ releases:
       name: s3_metrics_configuration
       namespace: ''
     release_date: '2020-12-10'
+  1.4.0:
+    changes:
+      bugfixes:
+      - aws_kms - fixes issue where module execution fails without the kms:GetKeyRotationStatus
+        permission. (https://github.com/ansible-collections/community.aws/pull/200).
+      - aws_kms_info - ensure that searching by tag works when tag only exists on
+        some CMKs (https://github.com/ansible-collections/community.aws/issues/276).
+      - aws_s3_cors - fix element type for rules parameter. (https://github.com/ansible-collections/community.aws/pull/408).
+      - aws_ssm - fix the generation of CURL URL used to download Ansible Python file
+        from S3 bucket by ```_get_url()``` due to due to non-assignment of aws region
+        in the URL and not using V4 signature as specified for AWS S3 signature URL
+        by ```_get_boto_client()``` in (https://github.com/ansible-collections/community.aws/pull/352).
+      - aws_ssm - fixed ``UnicodeEncodeError`` error when using unicode file names
+        (https://github.com/ansible-collections/community.aws/pull/295).
+      - ec2_eip - fix eip association by instance id & private ip address due to case-sensitivity
+        of the ``PrivateIpAddress`` parameter (https://github.com/ansible-collections/community.aws/pull/328).
+      - ec2_vpc_endpoint - ensure ``changed`` is correctly set when deleting an endpoint
+        (https://github.com/ansible-collections/community.aws/pull/362).
+      - ec2_vpc_endpoint - fix exception when attempting to delete an endpoint which
+        has already been deleted (https://github.com/ansible-collections/community.aws/pull/362).
+      - ecs_task - use `required_if` to enforce mandatory parameters based on specified
+        operation (https://github.com/ansible-collections/community.aws/pull/402).
+      - elb_application_lb - during the removal of an instance, the associated listeners
+        are also removed.
+      deprecated_features:
+      - ec2_eip - formally deprecate the ``instance_id`` alias for ``device_id`` (https://github.com/ansible-collections/community.aws/pull/349).
+      - ec2_vpc_endpoint - deprecate the policy_file option and recommend using policy
+        with a lookup (https://github.com/ansible-collections/community.aws/pull/366).
+      minor_changes:
+      - aws_kms - add support for setting the deletion window using `pending_window`
+        (PendingWindowInDays) (https://github.com/ansible-collections/community.aws/pull/200).
+      - aws_kms_info - Add ``key_id`` and ``alias`` parameters to support fetching
+        a single key (https://github.com/ansible-collections/community.aws/pull/200).
+      - dynamodb_ttl - use ``botocore_at_least`` helper for checking the available
+        botocore version (https://github.com/ansible-collections/community.aws/pull/280).
+      - ec2_instance - add automatic retries on all paginated queries for temporary
+        errors (https://github.com/ansible-collections/community.aws/pull/373).
+      - ec2_instance - migrate to shared implementation of get_ec2_security_group_ids_from_names.
+        The module will now return an error if the subnet provided isn't in the requested
+        VPC. (https://github.com/ansible-collections/community.aws/pull/214)
+      - ec2_instance_info - added ``minimum_uptime`` option with alias ``uptime``
+        for filtering instances that have only been online for certain duration of
+        time in minutes (https://github.com/ansible-collections/community.aws/pull/356).
+      - ec2_launch_template - Add retries on common AWS failures (https://github.com/ansible-collections/community.aws/pull/326).
+      - ec2_vpc_peer - use ``botocore_at_least`` helper for checking the available
+        botocore version (https://github.com/ansible-collections/community.aws/pull/280).
+      - ecs_task - use ``botocore_at_least`` helper for checking the available botocore
+        version (https://github.com/ansible-collections/community.aws/pull/280).
+      - route53 - migrated from boto to boto3 (https://github.com/ansible-collections/community.aws/pull/405).
+      - various community.aws modules - cleanup error handling to use ``is_boto3_error_code``
+        and ``is_boto3_error_message`` helpers (https://github.com/ansible-collections/community.aws/pull/268).
+      - various community.aws modules - cleanup of Python imports (https://github.com/ansible-collections/community.aws/pull/360).
+      - various community.aws modules - improve consistency of handling Boto3 exceptions
+        (https://github.com/ansible-collections/community.aws/pull/268).
+      - various community.aws modules - migrate exception error message handling from
+        fail_json to fail_json_aws (https://github.com/ansible-collections/community.aws/pull/361).
+    fragments:
+    - 200-aws_kms-deletion.yaml
+    - 214-get_ec2_security_group_ids_from_names.yml
+    - 268-is_boto3_error.yml
+    - 280-cleanup-botocore_at_least.yml
+    - 295-connection-aws_ssm.yml
+    - 326-launch_template_retry.yml
+    - 328-fix-ec2_eip-instance-id-private-ip-address.yml
+    - 349-ec2_eip-deprecate-instance_id.yml
+    - 350_elb_application_lb_purges_listeners.yaml
+    - 352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml
+    - 356_add_minimum_uptime_parameter.yaml
+    - 360-imports-cleanup.yml
+    - 361-fail_json_aws.yml
+    - 362-ec2_vpc_endpoint-deletion-changed.yml
+    - 366-ec2_vpc_endpoint-policy_file.yml
+    - 373-ec2_instance-retry-pagination.yml
+    - 402-ecs_task-mandatory_params.yml
+    - 404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml
+    - 405-route53-boto3.yml
+    release_date: '2021-02-16'
diff --git a/changelogs/fragments/200-aws_kms-deletion.yaml b/changelogs/fragments/200-aws_kms-deletion.yaml
diff --git a/changelogs/fragments/214-get_ec2_security_group_ids_from_names.yml b/changelogs/fragments/214-get_ec2_security_group_ids_from_names.yml
diff --git a/changelogs/fragments/268-is_boto3_error.yml b/changelogs/fragments/268-is_boto3_error.yml
diff --git a/changelogs/fragments/280-cleanup-botocore_at_least.yml b/changelogs/fragments/280-cleanup-botocore_at_least.yml
diff --git a/changelogs/fragments/295-connection-aws_ssm.yml b/changelogs/fragments/295-connection-aws_ssm.yml
diff --git a/changelogs/fragments/326-launch_template_retry.yml b/changelogs/fragments/326-launch_template_retry.yml
diff --git a/changelogs/fragments/328-fix-ec2_eip-instance-id-private-ip-address.yml b/changelogs/fragments/328-fix-ec2_eip-instance-id-private-ip-address.yml
diff --git a/changelogs/fragments/349-ec2_eip-deprecate-instance_id.yml b/changelogs/fragments/349-ec2_eip-deprecate-instance_id.yml
diff --git a/changelogs/fragments/350_elb_application_lb_purges_listeners.yaml b/changelogs/fragments/350_elb_application_lb_purges_listeners.yaml
diff --git a/changelogs/fragments/352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml b/changelogs/fragments/352-fix-aws-region-and-v4-signature-for-s3-boto-client.yml
diff --git a/changelogs/fragments/356_add_minimum_uptime_parameter.yaml b/changelogs/fragments/356_add_minimum_uptime_parameter.yaml
diff --git a/changelogs/fragments/360-imports-cleanup.yml b/changelogs/fragments/360-imports-cleanup.yml
diff --git a/changelogs/fragments/361-fail_json_aws.yml b/changelogs/fragments/361-fail_json_aws.yml
diff --git a/changelogs/fragments/362-ec2_vpc_endpoint-deletion-changed.yml b/changelogs/fragments/362-ec2_vpc_endpoint-deletion-changed.yml
diff --git a/changelogs/fragments/366-ec2_vpc_endpoint-policy_file.yml b/changelogs/fragments/366-ec2_vpc_endpoint-policy_file.yml
diff --git a/changelogs/fragments/373-ec2_instance-retry-pagination.yml b/changelogs/fragments/373-ec2_instance-retry-pagination.yml
diff --git a/changelogs/fragments/402-ecs_task-mandatory_params.yml b/changelogs/fragments/402-ecs_task-mandatory_params.yml
diff --git a/changelogs/fragments/404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml b/changelogs/fragments/404-fix-dict-element-for-rule-param-in-aws-s3-cors.yml
diff --git a/changelogs/fragments/405-route53-boto3.yml b/changelogs/fragments/405-route53-boto3.yml
diff --git a/docs/community.aws.aws_kms_info_module.rst b/docs/community.aws.aws_kms_info_module.rst
@@ -41,6 +41,24 @@ Parameters
             <th>Choices/<font color="blue">Defaults</font></th>
             <th width="100%">Comments</th>
         </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>alias</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 1.4.0</div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>Alias for key.</div>
+                        <div>Mutually exclusive with <em>key_id</em> and <em>filters</em>.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: key_alias</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="1">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>
@@ -159,6 +177,25 @@ Parameters
                 </td>
                 <td>
                         <div>A dict of filters to apply. Each dict item consists of a filter key and a filter value. The filters aren&#x27;t natively supported by boto3, but are supported to provide similar functionality to other modules. Standard tag filters (<code>tag-key</code>, <code>tag-value</code> and <code>tag:tagName</code>) are available, as are <code>key-id</code> and <code>alias</code></div>
+                        <div>Mutually exclusive with <em>alias</em> and <em>key_id</em>.</div>
+                </td>
+            </tr>
+            <tr>
+                <td colspan="1">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>key_id</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 1.4.0</div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>Key ID or ARN of the key.</div>
+                        <div>Mutually exclusive with <em>alias</em> and <em>filters</em>.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: key_arn</div>
                 </td>
             </tr>
             <tr>

diff --git a/docs/community.aws.aws_kms_module.rst b/docs/community.aws.aws_kms_module.rst
@@ -330,6 +330,26 @@ Parameters
                         <div style="font-size: small; color: darkgreen"><br/>aliases: key_arn</div>
                 </td>
             </tr>
+            <tr>
+                <td colspan="2">
+                    <div class="ansibleOptionAnchor" id="parameter-"></div>
+                    <b>pending_window</b>
+                    <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
+                    <div style="font-size: small">
+                        <span style="color: purple">integer</span>
+                    </div>
+                    <div style="font-style: italic; font-size: small; color: darkgreen">added in 1.4.0</div>
+                </td>
+                <td>
+                </td>
+                <td>
+                        <div>The number of days between requesting deletion of the CMK and when it will actually be deleted.</div>
+                        <div>Only used when <em>state=absent</em> and the CMK has not yet been deleted.</div>
+                        <div>Valid values are between 7 and 30 (inclusive).</div>
+                        <div>See also: <a href='https://docs.aws.amazon.com/kms/latest/APIReference/API_ScheduleKeyDeletion.html#KMS-ScheduleKeyDeletion-request-PendingWindowInDays'>https://docs.aws.amazon.com/kms/latest/APIReference/API_ScheduleKeyDeletion.html#KMS-ScheduleKeyDeletion-request-PendingWindowInDays</a></div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: deletion_delay</div>
+                </td>
+            </tr>
             <tr>
                 <td colspan="2">
                     <div class="ansibleOptionAnchor" id="parameter-"></div>

diff --git a/docs/community.aws.aws_s3_cors_module.rst b/docs/community.aws.aws_s3_cors_module.rst
@@ -202,7 +202,7 @@ Parameters
                     <a class="ansibleOptionLink" href="#parameter-" title="Permalink to this option"></a>
                     <div style="font-size: small">
                         <span style="color: purple">list</span>
-                         / <span style="color: purple">elements=string</span>
+                         / <span style="color: purple">elements=dictionary</span>
                     </div>
                 </td>
                 <td>