amazon.aws 6.0.0

Release Summary

This release brings some new plugins and features. Several bugfixes, breaking changes and deprecated features are also included. The amazon.aws collection has dropped support for botocore<1.25.0 and boto3<1.22.0. Support for Python 3.6 has also been dropped.

Minor Changes

• Add github actions to run unit and sanity tests.(ansible-collections#1393).
• AnsibleAWSModule - add support to the client and resource methods for overriding the default parameters (ansible-collections#1303).
• CONTRIBUTING.md - refactors and adds to contributor documentation (ansible-collections#924)
• Refactor inventory plugins and add aws_rds inventory unit tests (ansible-collections#1218).
• Refactor module_utils/cloudfront_facts.py and add unit tests (ansible-collections#1265).
• The black code formatter has been run across the collection to improve code consistency (ansible-collections#1465).
• amazon.aws inventory plugins - additional refactorization of inventory plugin connection handling (ansible-collections#1271).
• amazon.aws lookup plugins - aws_access_key has been renamed to access_key for consistency between modules and plugins, aws_access_key remains as an alias. This change should have no observable effect for users outside the module/plugin documentation (ansible-collections#1225).
• amazon.aws lookup plugins - aws_profile has been renamed to profile for consistency between modules and plugins, aws_profile remains as an alias. This change should have no observable effect for users outside the module/plugin documentation (ansible-collections#1225).
• amazon.aws lookup plugins - aws_secret_key has been renamed to secret_key for consistency between modules and plugins, aws_secret_key remains as an alias. This change should have no observable effect for users outside the module/plugin documentation (ansible-collections#1225).
• amazon.aws lookup plugins - aws_security_token has been renamed to session_token for consistency between modules and plugins, aws_security_token remains as an alias. This change should have no observable effect for users outside the module/plugin documentation (ansible-collections#1225).
• amazon.aws modules - bulk update of import statements following various refactors (ansible-collections#1310).
• autoscaling_group - minor linting fixes (ansible-collections#1181).
• aws_account_attribute - the aws_account_attribute lookup plugin has been refactored to use AWSLookupBase as its base class (ansible-collections#1225).
• aws_ec2 inventory - minor linting fixes (ansible-collections#1181).
• aws_secret - the aws_secret lookup plugin has been refactored to use AWSLookupBase as its base class (ansible-collections#1225).
• aws_secret - the aws_secret lookup plugin has been renamed secretsmanager_secret, aws_secret remains as an alias (ansible-collections#1225).
• aws_ssm - the aws_ssm lookup plugin has been refactored to use AWSLookupBase as its base class (ansible-collections#1225).
• aws_ssm - the aws_ssm lookup plugin has been renamed ssm_parameter, aws_ssm remains as an alias (ansible-collections#1225).
• backup - Add logic for backup_selection* modules (ansible-collections#1530).
• bulk migration of % and .format() to fstrings (ansible-collections#1483).
• cloud module_utils - minor linting fixes (ansible-collections#1181).
• cloudtrail_info - minor linting fixes (ansible-collections#1181).
• cloudwatchlogs_log_group - minor linting fixes (ansible-collections#1181).
• docs_fragments - amazon.aws.boto3 fragment now pulls the botocore version requirements from module_utils.botocore (ansible-collections#1248).
• docs_fragments - common parameters for modules and plugins have been synchronised and moved to amazon.aws.common.modules and amazon.aws.common.plugins (ansible-collections#1248).
• docs_fragments - region parameters for modules and plugins have been synchronised and moved to amazon.aws.region.modules and amazon.aws.region.plugins (ansible-collections#1248).
• ec2_ami - Extend the unit-test coverage of the module (ansible-collections#1159).
• ec2_ami - allow ImageAvailable waiter to retry when the image can't be found (ansible-collections#1321).
• ec2_ami_info - Add unit-tests coverage (ansible-collections#1252).
• ec2_eip - minor linting fixes (ansible-collections#1181).
• ec2_eni_info - Add unit-tests coverage (ansible-collections#1236).
• ec2_instance - avoid changing module.params (ansible-collections#1187).
• ec2_instance - updated to avoid manipulating module.params (ansible-collections#1337).
• ec2_security_group - added rule options to argument specifications to improve handling of inputs (ansible-collections#1214).
• ec2_security_group - refacter get_target_from_rule() (ansible-collections#1221).
• ec2_security_group - refactor rule expansion and add unit tests (ansible-collections#1261).
• ec2_snapshot - Reenable the integration tests (ansible-collections#1235).
• ec2_snapshot_info - Add unit-tests coverage (ansible-collections#1211).
• ec2_vpc_route_table - add support for Carrier Gateway entry (ansible-collections#926).
• ec2_vpc_subnet - retry fetching subnet details after creation if the first attempt fails (ansible-collections#1526).
• inventory aws ec2 - add parameter use_ssm_inventory allowing to query ssm inventory information for configured EC2 instances and populate hostvars (ansible-collections#704).
• inventory plugins - refactor cache handling (ansible-collections#1285).
• inventory plugins - refactor file verification handling (ansible-collections#1285).
• inventory_aws_ec2 integration tests - replace local module test_get_ssm_inventory by community.aws.ssm_inventory_info (ansible-collections#1416).
• kms_key_info - minor linting fixes (ansible-collections#1181).
• lambda - minor linting fixes (ansible-collections#1181).
• lambda - use common get_aws_account_info helper rather than reimplementing (ansible-collections#1181).
• lambda_alias - refactored to avoid passing around the complex module resource (ansible-collections#1336).
• lambda_alias - updated to avoid manipulating module.params (ansible-collections#1336).
• lambda_execute - minor linting fixes (ansible-collections#1181).
• lambda_info - updated to avoid manipulating module.params (ansible-collections#1336).
• lambda_layer_info - add support for parameter version_number to retrieve detailed information for a specific layer version (ansible-collections#1293).
• module_utils - move RetryingBotoClientWrapper into module_utils.retries for reuse with other plugin types (ansible-collections#1230).
• module_utils - move exceptions into dedicated python module (ansible-collections#1246).
• module_utils - refacter botocore version validation into module_utils.botocore for future reuse (ansible-collections#1227).
• module_utils.acm - Refactor ACMServiceManager class and add unit tests (ansible-collections#1273).
• module_utils.botocore - Add Ansible AWS User-Agent identification (ansible-collections#1306).
• module_utils.botocore - refactorization of get_aws_region, get_aws_connection_info so that the code can be reused by non-module plugins (ansible-collections#1231).
• module_utils.policy - minor refacter of code to reduce complexity and improve test coverage (ansible-collections#1136).
• module_utils.s3 - Refactor get_s3_connection into a module_utils for S3 modules and expand module_utils.s3 unit tests (ansible-collections#1139).
• module_utils/botocore - added support to _boto3_conn for passing dictionaries of configuration (ansible-collections#1307).
• plugin_utils - Ad...

amazon.aws 5.0.0

Release Summary

In this release we promoted many community modules to Red Hat supported status. Those modules have been moved from the commuity.aws to amazon.aws collection. This release also brings some new features, bugfixes, breaking changes and deprecated features. The amazon.aws collection has dropped support for botocore<1.21.0 and boto3<1.18.0. Support for ansible-core<2.11 has also been dropped.

Major Changes

• autoscaling_group - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.autoscaling_group.
• autoscaling_group_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.autoscaling_group_info.
• cloudtrail - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.cloudtrail.
• cloudwatch_metric_alarm - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.cloudwatch_metric_alarm.
• cloudwatchevent_rule - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.cloudwatchevent_rule.
• cloudwatchlogs_log_group - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.cloudwatchlogs_log_group.
• cloudwatchlogs_log_group_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.cloudwatchlogs_log_group_info.
• cloudwatchlogs_log_group_metric_filter - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.cloudwatchlogs_log_group_metric_filter.
• ec2_eip - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.ec2_eip.
• ec2_eip_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.ec2_eip_info.
• elb_application_lb - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.elb_application_lb.
• elb_application_lb_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.elb_application_lb_info.
• execute_lambda - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.execute_lambda.
• iam_policy - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.iam_policy.
• iam_policy_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.iam_policy_info.
• iam_user - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.iam_user.
• iam_user_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.iam_user_info.
• kms_key - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.kms_key.
• kms_key_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.kms_key_info.
• lambda - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.lambda.
• lambda_alias - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.lambda_alias.
• lambda_event - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.lambda_event.
• lambda_execute - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.lambda_execute.
• lambda_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.lambda_info.
• lambda_policy - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.lambda_policy.
• rds_cluster - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_cluster.
• rds_cluster_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_cluster_info.
• rds_cluster_snapshot - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_cluster_snapshot.
• rds_instance - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_instance.
• rds_instance_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_instance_info.
• rds_instance_snapshot - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_instance_snapshot.
• rds_option_group - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_option_group.
• rds_option_group_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_option_group_info.
• rds_param_group - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_param_group.
• rds_snapshot_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_snapshot_info.
• rds_subnet_group - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.rds_subnet_group.
• route53 - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.route53.
• route53_health_check - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.route53_health_check.
• route53_info - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.route53_info.
• route53_zone - The module has been migrated from the community.aws collection. Playbooks using the Fully Qualified Collection Name for this module should be updated to use amazon.aws.route53_zone.

Minor Changes

• Ability to record and replay the API interaction of a module for testing purpose. Show case the feature with an example (ansible-collections#998).
• Remove the empty __init__.py file from the distribution, they were not required anymore (ansible-collections#1018).
• amazon.aws modules - the ec2_url parameter has been renamed to endpoint_url for consistency, ec2_url remains as an alias (ansible-collections#992).
• aws_caller_info - minor linting fixes (ansible-collections#968).
• aws_ec2 - introduce the allow_duplicated_hosts configuration key (ansible-collections#1026).
• cloudformation - avoid catching Exception, catch more specific errors instead (ansible-collections#968).
• cloudwatch_metric_alarm_info - Added a new module that describes the cloudwatch metric alarms (ansible-collections#988).
• ec2_group - The ec2_group module has been renam...

amazon.aws 1.1.0

Major Changes

• ec2 module_utils - The AWSRetry decorator no longer catches NotFound exceptions by default. NotFound exceptions need to be explicitly added using catch_extra_error_codes. Some AWS modules may see an increase in transient failures due to AWS''s eventual consistency model.

Minor Changes

• Add aws_security_token, aws_endpoint_url and endpoint_url aliases to improve AWS module parameter naming consistency.
• Add support for aws_ca_bundle to boto3 based AWS modules
• Add support for configuring boto3 profiles using AWS_PROFILE and AWS_DEFAULT_PROFILE
• Added check_mode support to aws_az_info
• Added check_mode support to ec2_eni_info
• Added check_mode support to ec2_snapshot_info
• ansible_dict_to_boto3_filter_list - convert integers and bools to strings before using them in filters.
• aws_direct_connect_virtual_interface - add direct_connect_gateway_id parameter. This field is only applicable in private VIF cases (public=False) and is mutually exclusive to virtual_gateway_id.
• cloudformation - Return change_set_id in the cloudformation output if a change set was created.
• ec2 - deprecate allowing both group and group_id - currently we ignore group_id if both are passed.
• ec2_ami_info - allow integer and bool values for filtering images (ansible/ansible#43570).
• ec2_asg - Add support for Max Instance Lifetime
• ec2_asg - Add the ability to use mixed_instance_policy in launch template driven autoscaling groups
• ec2_asg - Migrated to AnsibleAWSModule
• ec2_placement_group - make name a required field.
• ec2_vol_info - Code cleanup and use of the AWSRetry decorator to improve stability
• ec2_vpc_net - Enable IPv6 CIDR assignment

Breaking Changes / Porting Guide

• aws_s3 - can now delete versioned buckets even when they are not empty - set mode to delete to delete a versioned bucket and everything in it.

Deprecated Features

• cloudformation - The template_format option had no effect since Ansible 2.3 and will be removed after 2022-06-01
• cloudformation - the template_format option has been deprecated and will be removed in a later release. It has been ignored by the module since Ansible 2.3.
• data_pipeline - The version option had no effect and will be removed in after 2022-06-01
• ec2 - in a later release, the group and group_id options will become mutually exclusive. Currently group_id is ignored if you pass both.
• ec2_ami - The no_device alias NoDevice has been deprecated and will be removed after 2022-06-01
• ec2_ami - The virtual_name alias VirtualName has been deprecated and will be removed after 2022-06-01
• ec2_eip - The wait_timeout option had no effect and will be removed after 2022-06-01
• ec2_key - The wait_timeout option had no effect and will be removed after 2022-06-01
• ec2_key - The wait option had no effect and will be removed after 2022-06-01
• ec2_key - the wait_timeout option has been deprecated and will be removed in a later release. It has had no effect since Ansible 2.5.
• ec2_key - the wait option has been deprecated and will be removed in a later release. It has had no effect since Ansible 2.5.
• ec2_lc - The associate_public_ip_address option had no effect and will be removed after 2022-06-01
• ec2_tag - deprecate the list option in favor of ec2_tag_info
• ec2_tag - support for list as a state has been deprecated and will be removed in a later release. The ec2_tag_info can be used to fetch the tags on an EC2 resource.

Bugfixes

• aws_ec2 - fix idempotency when managing tags
• aws_ec2 - fix idempotency when metrics are enable
• aws_s3 - Delete objects and delete markers so versioned buckets can be removed.
• aws_s3 - Try to wait for the bucket to exist before setting the access control list.
• cloudformation_info - Fix a KeyError returning information about the stack(s).
• ec2_asg - Ensure wait is honored during replace operations
• ec2_launch_template - Update output to include latest_version and default_version, matching the documentation
• ec2_transit_gateway - Use AWSRetry before ClientError is handled when describing transit gateways
• ec2_transit_gateway - fixed issue where auto_attach set to yes was not being honored (ansible/ansible#61907)
• ec2_vol - fix filtering bug
• s3_bucket - Accept XNotImplemented response to support NetApp StorageGRID.