Merge branch 'main' into add-wait-for-modify-complete

.github/workflows/units.yml

@@ -6,63 +6,3 @@ on: [workflow_call]  # allow this workflow to be called from other workflows
 jobs:
   unit-source:
     uses: ansible-network/github_actions/.github/workflows/unit_source.yml@main
-    with:
-      matrix_exclude: >-
-          [
-            {
-              "python-version": "3.11"
-            },
-            {
-              "ansible-version": "stable-2.12",
-              "python-version": "3.7"
-            },
-            {
-              "ansible-version": "stable-2.13",
-              "python-version": "3.7"
-            },
-            {
-              "ansible-version": "stable-2.12",
-              "python-version": "3.8"
-            },
-            {
-              "ansible-version": "stable-2.13",
-              "python-version": "3.8"
-            },
-            {
-              "ansible-version": "stable-2.14",
-              "python-version": "3.7"
-            },
-            {
-              "ansible-version": "stable-2.14",
-              "python-version": "3.8"
-            },
-            {
-              "ansible-version": "stable-2.15",
-              "python-version": "3.7"
-            },
-            {
-              "ansible-version": "stable-2.15",
-              "python-version": "3.8"
-            },
-            {
-              "ansible-version": "milestone",
-              "python-version": "3.7"
-            },
-            {
-              "ansible-version": "milestone",
-              "python-version": "3.8"
-            },
-            {
-              "ansible-version": "devel",
-              "python-version": "3.7"
-            },
-            {
-              "ansible-version": "devel",
-              "python-version": "3.8"
-            },
-            {
-              "ansible-version": "devel",
-              "python-version": "3.9"
-            }
-          ]
-      collection_pre_install: ''

CHANGELOG.rst

@@ -5,6 +5,40 @@ amazon.aws Release Notes
 .. contents:: Topics
 
 
+v6.2.0
+======
+
+Release Summary
+---------------
+
+This release brings some new modules, features, and several bugfixes.
+
+Minor Changes
+-------------
+
+- backup_selection - add validation and documentation for all conditions suboptions (https://github.com/ansible-collections/amazon.aws/pull/1633).
+- ec2_instance - refactored ARN validation handling (https://github.com/ansible-collections/amazon.aws/pull/1619).
+- iam_user - refactored ARN validation handling (https://github.com/ansible-collections/amazon.aws/pull/1619).
+- module_utils.arn - add ``resource_id`` and ``resource_type`` to ``parse_aws_arn`` return values (https://github.com/ansible-collections/amazon.aws/pull/1619).
+- module_utils.arn - added ``validate_aws_arn`` function to handle common pattern matching for ARNs (https://github.com/ansible-collections/amazon.aws/pull/1619).
+
+Bugfixes
+--------
+
+- cloudwatchevent_rule - Fixes changed status to report False when no change has been made. The module had incorrectly always reported a change. (https://github.com/ansible-collections/amazon.aws/pull/1589)
+- lambda_execute - Fixes to the stack trace output, where it does not contain spaces between each character. The module had incorrectly always outputted extra spaces between each character. (https://github.com/ansible-collections/amazon.aws/pull/1615)
+- backup_plan - Use existing ``scrub_none_values`` function from module_utils to remove None values from nested dicts in supplied params. Nested None values were being retained and causing an error when sent through to the boto3 client operation (https://github.com/ansible-collections/amazon.aws/pull/1611).
+- backup_vault - fix error when updating tags on a backup vault by using the correct boto3 client methods for tagging and untagging backup resources (https://github.com/ansible-collections/amazon.aws/pull/1610).
+- ec2_vpc_nat_gateway - adding a boolean parameter called ``default_create`` to allow users to have the option to choose whether they want to display an error message or create a NAT gateway when an EIP address is not found. The module (ec2_vpc_nat_gateway) had incorrectly failed silently if EIP didn't exist (https://github.com/ansible-collections/amazon.aws/issues/1295).
+- ec2_vpc_nat_gateway - fixes to nat gateway so that when the user creates a private NAT gateway, an Elastic IP address should not be allocated. The module had inncorrectly always allocate elastic IP address when creating private nat gateway (https://github.com/ansible-collections/amazon.aws/pull/1632).
+- module_utils.backup - get_selection_details fix empty list returned when multiple backup selections exist (https://github.com/ansible-collections/amazon.aws/pull/1633).
+
+New Modules
+-----------
+
+- iam_instance_profile - manage IAM instance profiles
+- iam_instance_profile_info - gather information on IAM instance profiles
+
 v6.1.0
 ======
 

changelogs/changelog.yaml

@@ -2174,3 +2174,60 @@ releases:
     - release_summary.yml
     - test-reqs.yml
     release_date: '2023-06-07'
+  6.2.0:
+    changes:
+      bugfixes:
+      - cloudwatchevent_rule - Fixes changed status to report False when no change has been made. The module
+        had incorrectly always reported a change. (https://github.com/ansible-collections/amazon.aws/pull/1589)
+      - lambda_execute - Fixes to the stack trace output, where it does not contain spaces between
+        each character. The module had incorrectly always outputted extra spaces between
+        each character. (https://github.com/ansible-collections/amazon.aws/pull/1615)
+      - backup_plan - Use existing ``scrub_none_values`` function from module_utils
+        to remove None values from nested dicts in supplied params. Nested None values
+        were being retained and causing an error when sent through to the boto3 client
+        operation (https://github.com/ansible-collections/amazon.aws/pull/1611).
+      - backup_vault - fix error when updating tags on a backup vault by using the
+        correct boto3 client methods for tagging and untagging backup resources (https://github.com/ansible-collections/amazon.aws/pull/1610).
+      - ec2_vpc_nat_gateway - adding a boolean parameter called ``default_create``
+        to allow users to have the option to choose whether they want to display an
+        error message or create a NAT gateway when an EIP address is not found. The
+        module (ec2_vpc_nat_gateway) had incorrectly failed silently if EIP didn't
+        exist (https://github.com/ansible-collections/amazon.aws/issues/1295).
+      - ec2_vpc_nat_gateway - fixes to nat gateway so that when the user creates a
+        private NAT gateway, an Elastic IP address should not be allocated. The module
+        had inncorrectly always allocate elastic IP address when creating private
+        nat gateway (https://github.com/ansible-collections/amazon.aws/pull/1632).
+      - module_utils.backup - get_selection_details fix empty list returned when multiple
+        backup selections exist (https://github.com/ansible-collections/amazon.aws/pull/1633).
+      minor_changes:
+      - backup_selection - add validation and documentation for all conditions suboptions
+        (https://github.com/ansible-collections/amazon.aws/pull/1633).
+      - ec2_instance - refactored ARN validation handling (https://github.com/ansible-collections/amazon.aws/pull/1619).
+      - iam_user - refactored ARN validation handling (https://github.com/ansible-collections/amazon.aws/pull/1619).
+      - module_utils.arn - add ``resource_id`` and ``resource_type`` to ``parse_aws_arn``
+        return values (https://github.com/ansible-collections/amazon.aws/pull/1619).
+      - module_utils.arn - added ``validate_aws_arn`` function to handle common pattern
+        matching for ARNs (https://github.com/ansible-collections/amazon.aws/pull/1619).
+      release_summary: This release brings some new modules, features, and several
+        bugfixes.
+    fragments:
+    - 1589-return_false_when_no_change..yml
+    - 1604-c2_vpc_nat_gateway-fails-silently.yml
+    - 1615-no_formatted_with_extra_space.yml
+    - 1632-changes-to-no-allocate-eip-when-connectivity_type=private.yml
+    - 1633-backup-selection-conditions.yml
+    - 1843-iam_instance_profile.yml
+    - 1846-arn-validation.yml
+    - 20230506-autoscaling_group-fix_sanity.yml
+    - 202306012-backup_plan-remove-none-from-nested-params.yml
+    - 20230612-backup_vault-fix-tag-update.yml
+    - 20230627-ci-fixup.yml
+    - release_summary.yml
+    modules:
+    - description: manage IAM instance profiles
+      name: iam_instance_profile
+      namespace: ''
+    - description: gather information on IAM instance profiles
+      name: iam_instance_profile_info
+      namespace: ''
+    release_date: '2023-07-05'

changelogs/fragments/1587-LooseVersion.yml

@@ -0,0 +1,4 @@
+breaking_changes:
+- module_utils._version - vendored copy of distutils.version has been dropped (https://github.com/ansible-collections/amazon.aws/pull/1587).
+minor_changes:
+- module_utils.botocore - migrate from vendored copy of LooseVersion to packaging.version.Version (https://github.com/ansible-collections/amazon.aws/pull/1587).

changelogs/fragments/1631-route53_health_check-added-calculcated.yml

@@ -0,0 +1,5 @@
+---
+minor_changes:
+  - route53_health_check - add support for another ``type`` choice called ``CALCULATED`` (https://github.com/ansible-collections/amazon.aws/pull/1631). 
+  - route53_health_check - add support for a string list parameter called ``child_health_checks`` to specify health checks that must be healthy for the calculated health check (https://github.com/ansible-collections/amazon.aws/pull/1631).
+  - route53_health_check - add support for an integer parameter called ``health_threshold`` to specify the minimum number of healthy child health checks that must be healthy for the calculated health check (https://github.com/ansible-collections/amazon.aws/pull/1631).

changelogs/fragments/20230713-rds_cluster-fix_params_passage.yml

@@ -0,0 +1,2 @@
+bugfixes:
+  - rds_cluster - Add ``AllocatedStorage``, ``DBClusterInstanceClass``, ``StorageType``, ``Iops``, and ``EngineMode`` to the list of parameters that can be passed when creating or modifying a Multi-AZ RDS cluster (https://github.com/ansible-collections/amazon.aws/pull/1657).

changelogs/fragments/20230725-rds_cluster-fix.yml

@@ -0,0 +1,2 @@
+bugfixes:
+  - rds_cluster - Allow to pass GlobalClusterIdentifier to rds cluster on creation (https://github.com/ansible-collections/amazon.aws/pull/1663)."

changelogs/fragments/ec2_vpc_route_table_info-filter-fix.yml

@@ -0,0 +1,2 @@
+bugfixes:
+  - ec2_vpc_route_table_info - default filters to empty dictionary (https://github.com/ansible-collections/amazon.aws/issues/1668).