Major Changes
- amazon.aws collection - The amazon.aws collection has dropped support for
botocore<1.20.0
andboto3<1.17.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
- aws_s3 - Add
validate_bucket_name
option, to control bucket name validation (#615). - aws_s3 - The
aws_s3
module has been renamed tos3_object
(#869). - aws_s3 -
resource_tags
has been added as an alias for thetags
parameter (#845). - ec2_eni - Change parameter
device_index
data type to string when passing todescribe_network_inter
api call (#877). - ec2_eni -
resource_tags
has been added as an alias for thetags
parameter (#845). - ec2_group - add
egress_rules
as an alias forrules_egress
(#878). - ec2_group - add
purge_egress_rules
as an alias forpurge_rules_egress
(#878). - ec2_instance - Add missing
metadata_options
parameters (#715). - ec2_key -
resource_tags
has been added as an alias for thetags
parameter (#845). - ec2_vpc_net - add support for managing VPCs by ID (#848).
- ec2_vpc_subnet - add support for OutpostArn param (#598).
- elb_classic_lb -
resource_tags
has been added as an alias for thetags
parameter (#845). - s3_bucket - Add
validate_bucket_name
option, to control bucket name validation (#615). - s3_bucket -
resource_tags
has been added as an alias for thetags
parameter (#845).
Breaking Changes / Porting Guide
- Tags beginning with
aws:
will not be removed when purging tags, these tags are reserved by Amazon and may not be updated or deleted (#817). - amazon.aws collection - the
profile
parameter is now mutually exclusive with theaws_access_key
,aws_secret_key
andsecurity_token
parameters (#834). - aws_az_info - the module alias
aws_az_facts
was deprecated in Ansible 2.9 and has now been removed (#832). - aws_s3 - the default value for
ensure overwrite
has been changed todifferent
instead ofalways
so that the module is idempotent by default (#811). - aws_ssm - on_denied and on_missing now both default to error, for consistency with both aws_secret and the base Lookup class (#617).
- ec2 - The
ec2
module has been removed in release 4.0.0 and replaced by theec2_instance
module (#630). - ec2_vpc_igw_info - The default value for
convert_tags
has been changed toTrue
(#835). - elb_classic_lb - the
ec2_elb
fact has been removed (#827). - module_utils - Support for the original AWS SDK aka
boto
has been removed, including all relevant helper functions. All modules should now use theboto3
/botocore
AWS SDK (#630)
Deprecated Features
- aws_s3 - The
S3_URL
alias for the s3_url option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - ec2_ami - The
DeviceName
alias for the device_name option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - ec2_ami - The
NoDevice
alias for the no_device option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - ec2_ami - The
VirtualName
alias for the virtual_name option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - ec2_ami - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#846). - 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). - ec2_instance - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#849). - ec2_key - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#846). - ec2_vol - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#846). - ec2_vpc_dhcp_option_info - The
DhcpOptionIds
alias for the dhcp_option_ids option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - ec2_vpc_dhcp_option_info - The
DryRun
alias for the dry_run option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - ec2_vpc_endpoint - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#846). - ec2_vpc_net - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#848). - ec2_vpc_route_table - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(#846). - s3_bucket - The
S3_URL
alias for the s3_url option has been deprecated and will be removed in release 5.0.0 (ansible-collections/community.aws#795). - s3_object - Support for creation and deletion of S3 buckets has been deprecated. Please use the
amazon.aws.s3_bucket
module to create and delete buckets (#869).
Removed Features (previously deprecated)
- cloudformation - the
template_format
option has been removed. It has been ignored by the module since Ansible 2.3 (#833). - ec2_key - the
wait_timeout
option had no effect, was deprecated in release 1.0.0, and has now been removed (#830). - ec2_key - the
wait
option had no effect, was deprecated in release 1.0.0, and has now been removed (#830). - ec2_tag - the previously deprecated state
list
has been removed. To list tags on an EC2 resource theec2_tag_info
module can be used (#829). - ec2_vol - the previously deprecated state
list
has been removed. To list volumes theec2_vol_info
module can be used (#828). - module_utils.batch - the class
ansible_collections.amazon.aws.plugins.module_utils.batch.AWSConnection
has been removed. Please useAnsibleAWSModule.client()
instead (#831).
Bugfixes
- ec2_group - fix uncaught exception when running with
--diff
and--check
to create a new security group (#440). - ec2_instance - Add a condition to handle default
`instance_type`
value for fix breaking on instance creation with launch template (#587). - ec2_instance - raise an error when missing permission to stop instance when
state
is set torebooted`
(#671). - ec2_vpc_igw - use gateway_id rather than filters to paginate if possible to fix 'NoneType' object is not subscriptable error (#766).
- ec2_vpc_net - fix a bug where CIDR configuration would be updated in check mode (ansible/ansible#62678).
- ec2_vpc_net - fix a bug where the module would get stuck if DNS options were updated in check mode (ansible/ansible#62677).
- elb_classic_lb - modify the return value of _format_listeners method to resolve a failure creating https listeners (#860).