community.aws 3.3.0 (#1180)

community.aws 3.3.0

SUMMARY
community.aws 3.3.0 release
ISSUE TYPE


Bugfix Pull Request
Docs Pull Request
Feature Pull Request
New Module Pull Request

COMPONENT NAME
entire collection

Reviewed-by: Mark Chappell <None>
Reviewed-by: Alina Buzachis <None>

CHANGELOG.rst

@@ -5,6 +5,55 @@ community.aws Release Notes
 .. contents:: Topics
 
 
+v3.3.0
+======
+
+Release Summary
+---------------
+
+This is the minor release of the ``community.aws`` collection.
+
+Minor Changes
+-------------
+
+- aws_kms - add extra key/value pair to return data (key_policies) to return each policy as a dictionary rather than json string (https://github.com/ansible-collections/community.aws/pull/1052).
+- aws_kms - fix some bugs in integration tests and add check mode support for key rotation as well as document issues with time taken for requested changes to be reflected on AWS (https://github.com/ansible-collections/community.aws/pull/1052).
+- ec2_asg - add check mode support (https://github.com/ansible-collections/community.aws/pull/1033).
+- iam_policy - update broken examples and add RETURN section to documentation; add extra integration tests for idempotency check mode runs (https://github.com/ansible-collections/community.aws/pull/1093).
+- iam_user - add `user` value to return data structure to deprecate old `iam_user` (https://github.com/ansible-collections/community.aws/pull/1059).
+- lambda - add kms_key_arn parameter (https://github.com/ansible-collections/community.aws/pull/1108).
+- rds_instance - add `deletion_protection` parameter (https://github.com/ansible-collections/community.aws/pull/1105).
+- rds_instance - add support for addition/removal of iam roles to db instance (https://github.com/ansible-collections/community.aws/pull/1002).
+- rds_instance_snapshot - add ``check_mode`` (https://github.com/ansible-collections/community.aws/pull/789).
+- rds_instance_snapshot - add copy_db_snapshot functionality (https://github.com/ansible-collections/community.aws/pull/1078).
+- rds_instance_snapshot - add integration tests (https://github.com/ansible-collections/community.aws/pull/789).
+- rds_instance_snapshot - update module to use handlers defined in module_utils/rds.py (https://github.com/ansible-collections/community.aws/pull/789).
+- route53 - add support for GeoLocation param (https://github.com/ansible-collections/amazon.aws/pull/1117).
+
+Bugfixes
+--------
+
+- dynamodb_table - fix an issue when creating secondary indexes with global_keys_only (https://github.com/ansible-collections/community.aws/issues/967).
+- ecs_service - add missing change detect of ``health_check_grace_period_seconds`` parameter (https://github.com/ansible-collections/community.aws/pull/1145).
+- ecs_service - fix broken compare of ``task_definition`` that results always in a changed task (https://github.com/ansible-collections/community.aws/pull/1145).
+- ecs_service - fix validation for ``placement_constraints``. It's possible to use ``distinctInstance`` placement constraint now (https://github.com/ansible-collections/community.aws/issues/1058)
+- ecs_taskdefinition - fix broken change detect of ``launch_type`` parameter (https://github.com/ansible-collections/community.aws/pull/1145).
+- execute_lambda - add waiter for function_updated (https://github.com/ansible-collections/community.aws/pull/1108).
+- execute_lambda - fix check mode and update RETURN documentation (https://github.com/ansible-collections/community.aws/pull/1115).
+- iam_policy - require one of `policy_document` and `policy_json` when state is present to prevent MalformedPolicyDocumentException from being thrown (https://github.com/ansible-collections/community.aws/pull/1093).
+- iam_user - don't delete user login profile on check mode (https://github.com/ansible-collections/community.aws/pull/1059).
+- iam_user_info - gracefully handle when no users are found (https://github.com/ansible-collections/community.aws/pull/1059).
+- 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).
+- 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).
+
+New Modules
+-----------
+
+- aws_api_gateway_domain - Manage AWS API Gateway custom domains
+
 v3.2.1
 ======
 

README.md

@@ -9,8 +9,8 @@ AWS related modules and plugins supported by the Ansible Cloud team are in the [
 
 This collection has been tested against following Ansible versions: **>=2.9.10**.
 
-For collections that support Ansible 2.9, please ensure you update your `network_os` to use the 
-fully qualified collection name (for example, `cisco.ios.ios`). 
+For collections that support Ansible 2.9, please ensure you update your `network_os` to use the
+fully qualified collection name (for example, `cisco.ios.ios`).
 Plugins and modules within a collection may be tested with only specific Ansible versions.
 A collection may contain metadata that identifies these versions.
 PEP440 is the schema used to describe the versions of Ansible.
@@ -37,6 +37,7 @@ Name | Description
 [community.aws.aws_acm](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_acm_module.rst)|Upload and delete certificates in the AWS Certificate Manager service
 [community.aws.aws_acm_info](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_acm_info_module.rst)|Retrieve certificate information from AWS Certificate Manager service
 [community.aws.aws_api_gateway](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_api_gateway_module.rst)|Manage AWS API Gateway APIs
+[community.aws.aws_api_gateway_domain](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_api_gateway_domain_module.rst)|Manage AWS API Gateway custom domains
 [community.aws.aws_application_scaling_policy](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_application_scaling_policy_module.rst)|Manage Application Auto Scaling Scaling Policies
 [community.aws.aws_batch_compute_environment](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_batch_compute_environment_module.rst)|Manage AWS Batch Compute Environments
 [community.aws.aws_batch_job_definition](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.aws_batch_job_definition_module.rst)|Manage AWS Batch Job Definitions
@@ -182,7 +183,7 @@ Name | Description
 [community.aws.rds_cluster_info](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_cluster_info_module.rst)|Obtain information about one or more RDS clusters
 [community.aws.rds_instance](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_instance_module.rst)|Manage RDS instances
 [community.aws.rds_instance_info](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_instance_info_module.rst)|obtain information about one or more RDS instances
-[community.aws.rds_instance_snapshot](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_instance_snapshot_module.rst)|manage Amazon RDS snapshots.
+[community.aws.rds_instance_snapshot](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_instance_snapshot_module.rst)|Manage Amazon RDS instance snapshots
 [community.aws.rds_option_group](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_option_group_module.rst)|rds_option_group module
 [community.aws.rds_option_group_info](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_option_group_info_module.rst)|rds_option_group_info module
 [community.aws.rds_param_group](https://github.com/ansible-collections/community.aws/blob/stable-3/docs/community.aws.rds_param_group_module.rst)|manage RDS parameter groups

changelogs/changelog.yaml

@@ -1887,3 +1887,73 @@ releases:
     - 1064-ec2_asg_change_purge_tags.yml
     - 3.2.1.yml
     release_date: '2022-04-14'
+  3.3.0:
+    changes:
+      bugfixes:
+      - dynamodb_table - fix an issue when creating secondary indexes with global_keys_only
+        (https://github.com/ansible-collections/community.aws/issues/967).
+      - ecs_service - add missing change detect of ``health_check_grace_period_seconds``
+        parameter (https://github.com/ansible-collections/community.aws/pull/1145).
+      - ecs_service - fix broken compare of ``task_definition`` that results always
+        in a changed task (https://github.com/ansible-collections/community.aws/pull/1145).
+      - ecs_service - fix validation for ``placement_constraints``. It's possible
+        to use ``distinctInstance`` placement constraint now (https://github.com/ansible-collections/community.aws/issues/1058)
+      - ecs_taskdefinition - fix broken change detect of ``launch_type`` parameter
+        (https://github.com/ansible-collections/community.aws/pull/1145).
+      - execute_lambda - add waiter for function_updated (https://github.com/ansible-collections/community.aws/pull/1108).
+      - execute_lambda - fix check mode and update RETURN documentation (https://github.com/ansible-collections/community.aws/pull/1115).
+      - iam_policy - require one of `policy_document` and `policy_json` when state
+        is present to prevent MalformedPolicyDocumentException from being thrown (https://github.com/ansible-collections/community.aws/pull/1093).
+      - iam_user - don't delete user login profile on check mode (https://github.com/ansible-collections/community.aws/pull/1059).
+      - iam_user_info - gracefully handle when no users are found (https://github.com/ansible-collections/community.aws/pull/1059).
+      - 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).
+      - 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:
+      - aws_kms - add extra key/value pair to return data (key_policies) to return
+        each policy as a dictionary rather than json string (https://github.com/ansible-collections/community.aws/pull/1052).
+      - aws_kms - fix some bugs in integration tests and add check mode support for
+        key rotation as well as document issues with time taken for requested changes
+        to be reflected on AWS (https://github.com/ansible-collections/community.aws/pull/1052).
+      - ec2_asg - add check mode support (https://github.com/ansible-collections/community.aws/pull/1033).
+      - iam_policy - update broken examples and add RETURN section to documentation;
+        add extra integration tests for idempotency check mode runs (https://github.com/ansible-collections/community.aws/pull/1093).
+      - iam_user - add `user` value to return data structure to deprecate old `iam_user`
+        (https://github.com/ansible-collections/community.aws/pull/1059).
+      - lambda - add kms_key_arn parameter (https://github.com/ansible-collections/community.aws/pull/1108).
+      - rds_instance - add `deletion_protection` parameter (https://github.com/ansible-collections/community.aws/pull/1105).
+      - rds_instance - add support for addition/removal of iam roles to db instance
+        (https://github.com/ansible-collections/community.aws/pull/1002).
+      - rds_instance_snapshot - add ``check_mode`` (https://github.com/ansible-collections/community.aws/pull/789).
+      - rds_instance_snapshot - add copy_db_snapshot functionality (https://github.com/ansible-collections/community.aws/pull/1078).
+      - rds_instance_snapshot - add integration tests (https://github.com/ansible-collections/community.aws/pull/789).
+      - rds_instance_snapshot - update module to use handlers defined in module_utils/rds.py
+        (https://github.com/ansible-collections/community.aws/pull/789).
+      - route53 - add support for GeoLocation param (https://github.com/ansible-collections/amazon.aws/pull/1117).
+      release_summary: This is the minor release of the ``community.aws`` collection.
+    fragments:
+    - 0000-ecs_taskdefinition_fix.yml
+    - 1002-rds_instance-stabilize-and-support-iam-roles.yml
+    - 1033-ec2_asg-check-mode-support.yml
+    - 1052-aws_kms-stabilize-integration-tests.yml
+    - 1059-iam_user-add-new-ret-val-handle-errors.yml
+    - 1077-s3_lifecycle-transition-days-zero.yml
+    - 1078-rds_instance_snapshot-add-copy-snapshot.yml
+    - 1085-s3_lifecycle-check-that-configuration-is-complete-before-returning.yml
+    - 1093-iam_policy-update-docs-and-add-required_if.yml
+    - 1105-rds_instance-add-deletion_protection-parameter.yml
+    - 1108-lambda-checkmode-fix-kms_key_arn-param.yml
+    - 1115-execute_lambda-checkmode-fix-update-return-docs.yml
+    - 1117-route53-add_geo_location_support.yml
+    - 1300-ecs_service-placementConstraints.yml
+    - 3.3.0.yml
+    - 789-rds_instance_snapshot.yml
+    - 967-dynamodb_table.yml
+    modules:
+    - description: Manage AWS API Gateway custom domains
+      name: aws_api_gateway_domain
+      namespace: ''
+    release_date: '2022-05-30'

docs/community.aws.aws_acm_info_module.rst

@@ -229,7 +229,8 @@ Parameters
                         <div><code>AWS STS security token</code>. If not set then the value of the <code>AWS_SECURITY_TOKEN</code> or <code>EC2_SECURITY_TOKEN</code> environment variable is used.</div>
                         <div>If <em>profile</em> is set this parameter is ignored.</div>
                         <div>Passing the <em>security_token</em> and <em>profile</em> options at the same time has been deprecated and the options will be made mutually exclusive after 2022-06-01.</div>
-                        <div style="font-size: small; color: darkgreen"><br/>aliases: aws_security_token, access_token</div>
+                        <div>Aliases <em>aws_session_token</em> and <em>session_token</em> have been added in version 3.2.0.</div>
+                        <div style="font-size: small; color: darkgreen"><br/>aliases: aws_session_token, session_token, aws_security_token, access_token</div>
                 </td>
             </tr>
             <tr>