ansible-collections/amazon.aws 10.0.0

amazon.aws 10.0.0

on GitHub

Release Summary

This major release introduces new support with the aws_ssm connection plugin, which has been promoted from community.aws, several bugfixes, minor changes and deprecated features.
Additionally, this release increases the minimum required versions of boto3 and botocore to 1.34.0 to align with updated AWS SDK support and support for ansible-core < 2.17 has been dropped.
Due to the AWS SDKs announcing the end of support for Python less than 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/), support for Python less than 3.8 by this collection was deprecated in 9.0.0 release and is removed in this 10.0.0 release.

Major Changes

• amazon.aws collection - The amazon.aws collection has dropped support for botocore<1.34.0 and boto3<1.34.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 (#2426).
• amazon.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.8 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/), support for Python less than 3.8 by this collection was deprecated in release 6.0.0 and removed in release 10.0.0. (#2426).
• connection/aws_ssm - 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.aws_ssm.

Minor Changes

• module_utils.s3 - added "501" to the list of error codes thrown by S3 replacements (#2447).
• module_utils/s3 - add initial ErrorHandler for S3 modules (#2060).
• s3_bucket - migrated to use updated error handlers for better handling of non-AWS errors (#2478).

Breaking Changes / Porting Guide

• amazon.aws collection - Support for ansible-core < 2.17 has been dropped (#2601).
• amazon.aws collection - Support for the EC2_ACCESS_KEY environment variable was deprecated in release 6.0.0 and has now been removed. Please use the access_key parameter or AWS_ACCESS_KEY_ID environment variable instead (#2527).
• amazon.aws collection - Support for the EC2_REGION environment variable was deprecated in release 6.0.0 and has now been removed. Please use the region parameter or AWS_REGION environment variable instead (#2527).
• amazon.aws collection - Support for the EC2_SECRET_KEY environment variable was deprecated in release 6.0.0 and has now been removed. Please use the secret_key parameter or AWS_SECRET_ACCESS_KEY environment variable instead (#2527).
• amazon.aws collection - Support for the EC2_SECURITY_TOKEN and AWS_SECURITY_TOKEN environment variables were deprecated in release 6.0.0 and have now been removed. Please use the session_token parameter or AWS_SESSION_TOKEN environment variable instead (#2527).
• amazon.aws collection - Support for the EC2_URL and S3_URL environment variables were deprecated in release 6.0.0 and have now been removed. Please use the endpoint_url parameter or AWS_URL environment variable instead (#2527).
• amazon.aws collection - The access_token, aws_security_token and security_token aliases for the session_token parameter were deprecated in release 6.0.0 and have now been removed. Please use the session_token name instead (#2527).
• amazon.aws collection - The boto_profile alias for the profile parameter was deprecated in release 6.0.0 and has now been removed. Please use the profile name instead (#2527).
• amazon.aws collection - The ec2_access_key alias for the access_key parameter was deprecated in release 6.0.0 and has now been removed. Please use the access_key name instead (#2527).
• amazon.aws collection - The ec2_region alias for the region parameter was deprecated in release 6.0.0 and has now been removed. Please use the region name instead (#2527).
• amazon.aws collection - The ec2_secret_key alias for the secret_key parameter was deprecated in release 6.0.0 and has now been removed. Please use the secret_key name instead (#2527).
• amazon.aws collection - The endpoint, ec2_url and s3_url aliases for the endpoint_url parameter were deprecated in release 6.0.0 and have now been removed. Please use the region name instead (#2527).
• docs_fragments - The previously deprecated amazon.aws.aws_credentials docs fragment has been removed please use amazon.aws.common.plugins instead (#2527).
• docs_fragments - The previously deprecated amazon.aws.aws_region docs fragment has been removed please use amazon.aws.region.plugins instead (#2527).
• docs_fragments - The previously deprecated amazon.aws.aws docs fragment has been removed please use amazon.aws.common.modules instead (#2527).
• docs_fragments - The previously deprecated amazon.aws.ec2 docs fragment has been removed please use amazon.aws.region.modules instead (#2527).
• ec2_vpc_peering_info - the result key has been removed from the return value. vpc_peering_connections should be used instead (#2618).
• module_utils.botocore - drop deprecated boto3 parameter for get_aws_region() and get_aws_connection_info(), this parameter has had no effect since release 4.0.0 (#2443).
• module_utils.ec2 - drop deprecated boto3 parameter for get_ec2_security_group_ids_from_names() and get_aws_connection_info(), this parameter has had no effect since release 4.0.0 (#2603).
• rds_param_group - the redirect has been removed and playbooks should be updated to use rds_instance_param_group (#2618).

Bugfixes

• s3_bucket - bucket ACLs now consistently returned (#2478).
• s3_bucket - fixed idempotency when setting bucket ACLs (#2478).