amazon.aws 2.2.0

Minor Changes

• ec2_instance - add count parameter support (#539).

Bugfixes

• aws_ec2 inventory - use the iam_role_arn configuration parameter to assume the role before trying to call DescribeRegions if the regions configuration is not set and AWS credentials provided without enough privilege to perform the DescribeRegions action. (#566).
• ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed, to allow modifying volume types that require passing an iops value to boto. (#606)
• ec2_vol - changing a volume from a type that does not support IOPS (like standard) to a type that does (like gp3) fails (#626).
• ec2_vpc_igw - fix 'NoneType' object is not subscriptable error (#691).
• ec2_vpc_igw - use paginator for describe internet gateways and add retry to fix NoneType object is not subscriptable error (#695).
• elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (#592).

amazon.aws 3.1.1

Minor Changes

• bump the release version of the amazon.aws collection from 3.1.0 to 3.1.1 because of a bug that occurred while uploading to Galaxy.

amazon.aws 3.1.0

Minor Changes

• add new parameters hostvars_prefix and hostvars_suffix for inventory plugins aws_ec2 and aws_rds (#535).
• aws_s3 - Add validate_bucket_name option, to control bucket name validation (#615).
• aws_s3 - add latest choice on overwrite parameter to get latest object on S3 (#595).
• ec2_vol - add support for OutpostArn param (#597).
• ec2_vol - tag volume on creation (#603).
• ec2_vpc_route_table - add support for IPv6 in creating route tables (#601).
• s3_bucket - Add validate_bucket_name option, to control bucket name validation (#615).

Deprecated Features

• ec2_instance - The default value for `instance_type` has been deprecated, in the future release you must set an instance_type or a launch_template (#587).

Bugfixes

• Various modules and plugins - use vendored version of distutils.version instead of the deprecated Python standard library distutils (#599).
• aws_acm - No longer raising ResourceNotFound exception while retrieving ACM certificates.
• aws_s3 - fix exception raised when using module to copy from source to destination and key is missing from source (#602).
• ec2_instance - Add a condition to handle default `instance_type` value for fix breaking on instance creation with launch template (#587).
• ec2_key - add support for ED25519 key type (#572).
• ec2_vol - Sets the Iops value in req_obj even if the iops value has not changed, to allow modifying volume types that require passing an iops value to boto. (#606)
• elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (#592).
• s3_bucket - Enable the management of bucket-level ACLs (#573).

amazon.aws 3.0.0

Major Changes

• amazon.aws collection - The amazon.aws collection has dropped support for botocore<1.19.0 and boto3<1.16.0. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (#574).

Minor Changes

• ec2_instance - add count parameter support (#539).

Breaking Changes / Porting Guide

• aws_caller_facts - Remove deprecated aws_caller_facts alias. Please use aws_caller_info instead.
• cloudformation_facts - Remove deprecated cloudformation_facts alias. Please use cloudformation_info instead.
• ec2_ami_facts - Remove deprecated ec2_ami_facts alias. Please use ec2_ami_info instead.
• ec2_eni_facts - Remove deprecated ec2_eni_facts alias. Please use ec2_eni_info instead.
• ec2_group_facts - Remove deprecated ec2_group_facts alias. Please use ec2_group_info instead.
• ec2_instance_facts - Remove deprecated ec2_instance_facts alias. Please use ec2_instance_info instead.
• ec2_snapshot_facts - Remove deprecated ec2_snapshot_facts alias. Please use ec2_snapshot_info instead.
• ec2_vol_facts - Remove deprecated ec2_vol_facts alias. Please use ec2_vol_info instead.
• ec2_vpc_dhcp_option_facts - Remove deprecated ec2_vpc_dhcp_option_facts alias. Please use ec2_vpc_dhcp_option_info instead.
• ec2_vpc_endpoint_facts - Remove deprecated ec2_vpc_endpoint_facts alias. Please use ec2_vpc_endpoint_info instead.
• ec2_vpc_igw_facts - Remove deprecated ec2_vpc_igw_facts alias. Please use ec2_vpc_igw_info instead.
• ec2_vpc_nat_gateway_facts - Remove deprecated ec2_vpc_nat_gateway_facts alias. Please use ec2_vpc_nat_gateway_info instead.
• ec2_vpc_net_facts - Remove deprecated ec2_vpc_net_facts alias. Please use ec2_vpc_net_info instead.
• ec2_vpc_route_table_facts - Remove deprecated ec2_vpc_route_table_facts alias. Please use ec2_vpc_route_table_info instead.
• ec2_vpc_subnet_facts - Remove deprecated ec2_vpc_subnet_facts alias. Please use ec2_vpc_subnet_info instead.

Deprecated Features

• module_utils - support for the original AWS SDK boto has been deprecated in favour of the boto3/botocore SDK. All boto based modules have either been deprecated or migrated to botocore, and the remaining support code in module_utils will be removed in release 4.0.0 of the amazon.aws collection. Any modules outside of the amazon.aws and community.aws collections based on the boto library will need to be migrated to the boto3/botocore libraries (#575).

amazon.aws 2.1.0

Minor Changes

• aws_service_ip_ranges - add new option ipv6_prefixes to get only IPV6 addresses and prefixes for Amazon services (#430)
• cloudformation - fix detection when there are no changes. Sometimes when there are no changes, the change set will have a status FAILED with StatusReason No updates are to be performed (#507).
• ec2_ami - add check_mode support (#516).
• ec2_ami - use module_util helper for tagging AMIs (#520).
• ec2_ami - when creating an AMI from an instance pass the tagging options at creation time (#551).
• ec2_elb_lb - module renamed to elb_classic_lb (#377).
• ec2_eni - add check mode support (#534).
• ec2_eni - use module_util helper for tagging ENIs (#522).
• ec2_instance - use module_util helpers for tagging (#527).
• ec2_key - add support for tagging key pairs (#548).
• ec2_snapshot - add check_mode support (#512).
• ec2_vol - add check_mode support (#509).
• ec2_vpc_dhcp_option - use module_util helpers for tagging (#531).
• ec2_vpc_endpoint - added vpc_endpoint_security_groups parameter to support defining the security group attached to an interface endpoint (#544).
• ec2_vpc_endpoint - added vpc_endpoint_subnets parameter to support defining the subnet attached to an interface or gateway endpoint (#544).
• ec2_vpc_endpoint - use module_util helper for tagging (#525).
• ec2_vpc_endpoint - use module_util helpers for tagging (#531).
• ec2_vpc_igw - use module_util helper for tagging (#523).
• ec2_vpc_igw - use module_util helpers for tagging (#531).
• ec2_vpc_nat_gateway - use module_util helper for tagging (#524).
• ec2_vpc_nat_gateway - use module_util helpers for tagging (#531).
• elb_classic_lb - added retries on common AWS temporary API failures (#377).
• elb_classic_lb - added support for check_mode (#377).
• elb_classic_lb - added support for wait during creation (#377).
• elb_classic_lb - added support for wait during instance addition and removal (#377).
• elb_classic_lb - migrated to boto3 SDK (#377).
• elb_classic_lb - various error messages changed due to refactor (#377).
• module_utils.ec2 - moved generic tagging helpers into module_utils.tagging (#527).
• module_utils.tagging - add new helper to generate TagSpecification lists (#527).

Deprecated Features

• ec2_classic_lb - setting of the ec2_elb fact has been deprecated and will be removed in release 4.0.0 of the collection. The module now returns elb which can be accessed using the register keyword (#552).

Bugfixes

• AWS action group - added missing ec2_instance_facts entry (#557)
• ec2_ami - fix problem when creating an AMI from an instance with ephemeral volumes (#511).
• ec2_instance - ensure that ec2_instance falls back to the tag(Name) parameter when no filter and no name parameter is passed (#526).
• s3_bucket - update error handling to better support DigitalOcean Space (#508).

amazon.aws 1.5.1

Minor Changes

• ec2_instance - remove unnecessary raise when exiting with a failure (#460).

Bugfixes

• ec2_vol - Fixes changed status when modify_volume is used, but no new disk is being attached. The module incorrectly reported that no change had occurred even when disks had been modified (iops, throughput, type, etc.). (#482).
• ec2_vol - fix iops setting and enforce iops/throughput parameters usage (#334)

amazon.aws 2.0.0

Major Changes

• amazon.aws collection - Due to the AWS SDKs announcing the end of support for Python less than 3.6 (https://boto3.amazonaws.com/v1/documentation/api/1.17.64/guide/migrationpy3.html) this collection now requires Python 3.6+ (#298).
• amazon.aws collection - The amazon.aws collection has dropped support for botocore<1.18.0 and boto3<1.15.0. Most modules will continue to work with older versions of the AWS SDK, however compatibility with older versions of the SDK is not guaranteed and will not be tested. When using older versions of the SDK a warning will be emitted by Ansible (#502).
• ec2_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.ec2_instance.
• ec2_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.ec2_instance_info.
• ec2_vpc_endpoint - 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_vpc_endpoint.
• ec2_vpc_endpoint_facts - 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_vpc_endpoint_info.
• ec2_vpc_endpoint_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_vpc_endpoint_info.
• ec2_vpc_endpoint_service_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_vpc_endpoint_service_info.
• ec2_vpc_igw - 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_vpc_igw.
• ec2_vpc_igw_facts - 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_vpc_igw_facts.
• ec2_vpc_igw_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_vpc_igw_info.
• ec2_vpc_nat_gateway - 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_vpc_nat_gateway.
• ec2_vpc_nat_gateway_facts - 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_vpc_nat_gateway_info.
• ec2_vpc_nat_gateway_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_vpc_nat_gateway_info.
• ec2_vpc_route_table - 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_vpc_route_table.
• ec2_vpc_route_table_facts - 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_vpc_route_table_facts.
• ec2_vpc_route_table_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_vpc_route_table_info.

Minor Changes

• aws_ec2 - use a generator rather than list comprehension (#465).
• aws_s3 - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• aws_s3 - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• aws_s3 - add tags and purge_tags features for an S3 object (#335)
• aws_s3 - new mode to copy existing on another bucket (#359).
• aws_secret - added support for gracefully handling deleted secrets (#455).
• aws_ssm - add on_missing and on_denied option (#370).
• cloudformation - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• cloudformation - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_ami - ensure tags are propagated to the snapshot(s) when creating an AMI (#437).
• ec2_eni - fix idempotency when security_groups attribute is specified (#337).
• ec2_eni - timeout increased when waiting for ENIs to finish detaching (#501).
• ec2_group - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_group - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_group - use a generator rather than list comprehension (#465).
• ec2_group - use system ipaddress module, available with Python >= 3.3, instead of vendored copy (#461).
• ec2_instance - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_instance - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_instance - add throughput parameter for gp3 volume types (#433).
• ec2_instance - add support for controlling metadata options (#414).
• ec2_instance - remove unnecessary raise when exiting with a failure (#460).
• ec2_instance_info - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_instance_info - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_snapshot - migrated to use the boto3 python library (#356).
• ec2_spot_instance_info - Added a new module that describes the specified Spot Instance requests (#487).
• ec2_vol - add parameter multi_attach to support Multi-Attach on volume creation/update (#362).
• ec2_vol - relax the boto3/botocore requirements and only require botocore 1.19.27 for modifying the throughput parameter (#346).
• ec2_vpc_dhcp_option - Now also returns a boto3-style resource description in the dhcp_options result key. This includes any tags for the dhcp_options_id and has the same format as the current return value of ec2_vpc_dhcp_option_info. (#252)
• ec2_vpc_dhcp_option_info - Now also returns a user-friendly dhcp_config key that matches the historical new_config key from ec2_vpc_dhcp_option, and alleviates the need to use items2dict(key_name='key', value_name='values') when parsing the output of the module. (#252)
• ec2_vpc_subnet - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• ec2_vpc_subnet - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• integration tests - remove dependency with collection community.general (#361).
• module_utils/waiter - add RDS cluster cluster_available waiter (#464).
• module_utils/waiter - add RDS cluster cluster_deleted waiter (#464).
• module_utils/waiter - add Route53 resource_record_sets_changed waiter (#350).
• s3_bucket - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• s3_bucket - Tests for compatibility with older versions of the AWS SDKs have been removed (#442).
• s3_bucket - add new option object_ownership to configure object ownership (#311)
• s3_bucket - updated to use HeadBucket instead of ListBucket when testing for bucket existen...

amazon.aws 1.5.0

Minor Changes

• AWS inventory plugins - use shared HAS_BOTO3 helper rather than copying code (#288).
• AWS lookup plugins - use shared HAS_BOTO3 helper rather than copying code (#288).
• aws_account_attribute - add retries on common AWS failures (#295).
• aws_ec2 inventory - expose a new configuration key use_contrib_script_compatible_ec2_tag_keys to reproduce a behavior of the old ec2.py inventory script. With this option enabled, each tag is exposed using a ec2_tag_TAGNAME key (#331).
• aws_ec2 inventory - expose to new keys called include_filters and exclude_filters to give the user the ability to compose an inventory with multiple queries (#328).
• aws_ec2 inventory plugin - Added support for using Jinja2 templates in the authentication fields (#57).
• cloudformation - added support for StackPolicyDuringUpdateBody (#155).
• ec2_metadata_facts - add support for IMDSv2 (#43).
• ec2_snapshot_info - add the max_results along with next_token_id option (#321).
• ec2_tag - use common code for tagging resources (#309).
• ec2_tag_info - use common code for tagging resources (#309).
• ec2_vol - add the purge_tags option (#242).
• ec2_vol - use common code for tagging resources (#309).
• ec2_vpc_net - use a custom waiter which can handle API rate limiting (#270).
• ec2_vpc_subnet - use AWSRetry decorator to more consistently handle API rate limiting (#270).
• ec2_vpc_subnet - use common code for tagging resources (#309).
• module_utils.cloudfront_facts - linting cleanup (#291).
• module_utils.ec2 - linting cleanup (#291).
• module_utils/core - add a helper function normalize_boto3_result (#271).
• module_utils/core - add parameter descend_into_lists to scrub_none_parameters helper function (#262).
• module_utils/ec2 - added additional helper functions for tagging EC2 resources (#309).
• sanity tests - add ignore.txt for 2.12 (#315).

Bugfixes

• ec2_vol - create or update now preserves the existing tags, including Name (#229)
• ec2_vol - fix exception when platform information isn't available (#305).

amazon.aws 1.4.1

Minor Changes

• module_utils - the ipaddress module utility has been vendored into this collection. This eliminates the collection dependency on ansible.netcommon (which had removed the library in its 2.0 release). The ipaddress library is provided for internal use in this collection only. (#273)-

amazon.aws 1.4.0

Minor Changes

• aws_ec2 - Add hostname options concatenation
• aws_ec2 inventory plugin - avoid a superfluous import of ansible.utils.display.Display (#226).
• aws_ec2 module - Replace inverse aws instance-state-name filters !terminated, !shutting-down in favor of postive filters pending, running, stopping, stopped. Issue 235. (#237)
• aws_secret - add bypath functionality (#192).
• ec2_key - add AWSRetry decorator to automatically retry on common temporary failures (#213).
• ec2_vol - Add support for gp3 volumes and support for modifying existing volumes (#55).
• module_utils/elbv2 - add logic to compare_rules to suit Values list nested within dicts unique to each field type. Fixes issue (#187)
• various AWS plugins and module_utils - Cleanup unused imports (#217).

Bugfixes

• ec2_vol - a creation or update now returns a structure with an up to date list of tags (#241).