amazon.aws Release Notes
Topics
v5.5.1
Release Summary
This release brings few bugfixes.
Bugfixes
autoscaling_group - fix ValidationError when describing an autoscaling group that has more than 20 target groups attached to it by breaking the request into chunks (https://github.com/ansible-collections/amazon.aws/pull/1593).
autoscaling_group_info - fix ValidationError when describing an autoscaling group that has more than 20 target groups attached to it by breaking the request into chunks (https://github.com/ansible-collections/amazon.aws/pull/1593).
aws_account_attribute - raise correct
AnsibleLookupError
rather thanAnsibleError
(https://github.com/ansible-collections/amazon.aws/issues/1528).aws_secret - raise correct
AnsibleLookupError
rather thanAnsibleError
(https://github.com/ansible-collections/amazon.aws/issues/1528).aws_service_ip_ranges raise correct
AnsibleLookupError
rather thanAnsibleError
(https://github.com/ansible-collections/amazon.aws/issues/1528).aws_ssm - raise correct
AnsibleLookupError
rather thanAnsibleError
(https://github.com/ansible-collections/amazon.aws/issues/1528).ec2_instance - fix check_mode issue when adding network interfaces (https://github.com/ansible-collections/amazon.aws/issues/1403).
elb_application_lb - fix missing attributes on creation of ALB. The
create_or_update_alb()
was including ALB-specific attributes when updating an existing ALB but not when creating a new ALB (https://github.com/ansible-collections/amazon.aws/issues/1510).
v5.5.0
Release Summary
This release contains a number of bugfixes, new features and new modules. This is the last planned minor release prior to the release of version 6.0.0.
Minor Changes
Add connectivity_type to ec2_vpc_nat_gateway module (https://github.com/ansible-collections/amazon.aws/pull/1267).
cloudwatch - Add metrics and extended_statistic keys to cloudwatch module (https://github.com/ansible-collections/amazon.aws/pull/1133).
ec2_ami - add support for BootMode, TpmSupport, UefiData params (https://github.com/ansible-collections/amazon.aws/pull/1037).
ec2_metadata_facts - added support to query instance tags in metadata (https://github.com/ansible-collections/amazon.aws/pull/1186).
kms_key - Add multi_region option to create_key (https://github.com/ansible-collections/amazon.aws/pull/1290).
lambda - add support for function layers when creating or updating lambda function (https://github.com/ansible-collections/amazon.aws/pull/1118).
lambda_event - Added support to set FunctionResponseTypes when creating lambda event source mappings (https://github.com/ansible-collections/amazon.aws/pull/1209).
module_utils/elbv2 - removed compatibility code for
botocore < 1.10.30
(https://github.com/ansible-collections/amazon.aws/pull/1477).rds_cluster - New
engine_mode
parameter (https://github.com/ansible-collections/amazon.aws/pull/941).rds_cluster - add new options (e.g.,
db_cluster_instance_class
,allocated_storage
,storage_type
,iops
) (https://github.com/ansible-collections/amazon.aws/pull/1191).rds_cluster - update list of supported engines with
mysql
andpostgres
(https://github.com/ansible-collections/amazon.aws/pull/1191).s3_bucket - ensure
public_access
is configured before updating policies (https://github.com/ansible-collections/amazon.aws/pull/1511).
Bugfixes
cloudwatch_metric_alarm - Don’t consider
StateTransitionedTimestamp
in change detection. (https://github.com/ansible-collections/amazon.aws/pull/1440).ec2_instance - Pick up
app_callback -> set_password
rather thanapp_callback -> set_passwd
(https://github.com/ansible-collections/amazon.aws/issues/1449).lambda_info - Do not convert environment variables to snake_case when querying lambda config. (https://github.com/ansible-collections/amazon.aws/pull/1457).
rds_instance - fix type of
promotion_tier
as passed to the APIs (https://github.com/ansible-collections/amazon.aws/pull/1475).
New Modules
lambda_layer - Creates an AWS Lambda layer or deletes an AWS Lambda layer version
lambda_layer_info - List lambda layer or lambda layer versions
v5.4.0
Release Summary
This minor release brings bugfixes and minor new features.
Minor Changes
ec2_spot_instance - add parameter
terminate_instances
to support terminate instances associated with spot requests. (https://github.com/ansible-collections/amazon.aws/pull/1402).route53_health_check - added support for enabling Latency graphs (MeasureLatency) during creation of a Route53 Health Check. (https://github.com/ansible-collections/amazon.aws/pull/1201).
Bugfixes
ec2_metadata_facts - fix
AttributeError
when running the ec2_metadata_facts module on Python 2 managed nodes (https://github.com/ansible-collections/amazon.aws/issues/1358).ec2_vol - handle ec2_vol.tags when the associated instance already exists (https://github.com/ansible-collections/amazon.aws/pull/1071).
rds_instance - Fixed
TypeError
when tagging RDS DB with storage typegp3
(https://github.com/ansible-collections/amazon.aws/pull/1437).route53_info - Add new return key
health_check_observations
for health check operations (https://github.com/ansible-collections/amazon.aws/pull/1419).route53_info - Fixed
Key Error
when getting status or failure_reason of a health check (https://github.com/ansible-collections/amazon.aws/pull/1419).
v5.3.0
Release Summary
This release brings some minor changes, bugfixes, and deprecated features.
Minor Changes
ec2_instance - more consistently return
instances
information (https://github.com/ansible-collections/amazon.aws/pull/964).ec2_instance - remove unused import (https://github.com/ansible-collections/amazon.aws/pull/1350).
ec2_key - Add unit-tests coverage (https://github.com/ansible-collections/amazon.aws/pull/1288).
ec2_vpc_nat_gateway - ensure allocation_id is defined before potential access (https://github.com/ansible-collections/amazon.aws/pull/1350).
route53_zone - added support for associating multiple VPCs to route53 hosted zones (https://github.com/ansible-collections/amazon.aws/pull/1300).
s3_bucket - add option to support creation of buckets with object lock enabled (https://github.com/ansible-collections/amazon.aws/pull/1372).
Deprecated Features
support for passing both profile and security tokens through a mix of environment variables and parameters has been deprecated and support will be removed in release 6.0.0. After release 6.0.0 it will only be possible to pass either a profile or security tokens, regardless of mechanism used to pass them. To explicitly block a parameter coming from an environment variable pass an empty string as the parameter value. Support for passing profile and security tokens together was originally deprecated in release 1.2.0, however only partially implemented in release 5.0.0 (https://github.com/ansible-collections/amazon.aws/pull/1355).
Bugfixes
cloudtrail - support to disabling encryption using
kms_key_id
(https://github.com/ansible-collections/amazon.aws/pull/1384).ec2_key - fix issue when trying to update existing key pair with the same key material (https://github.com/ansible-collections/amazon.aws/pull/1383).
module_utils/elbv2 - fix change detection by adding default values for
Scope
andSessionTimeout
parameters inauthenticate-oidc
rules (https://github.com/ansible-collections/amazon.aws/pull/1270).module_utils/elbv2 - respect
UseExistingClientSecret
parameter inauthenticate-oidc
rules (https://github.com/ansible-collections/amazon.aws/pull/1270).revert breaking change introduced in 5.2.0 when passing credentials through a mix of environment variables and parameters (https://github.com/ansible-collections/amazon.aws/issues/1353).
s3_bucket - empty bucket policy was throwing a JSONDecodeError - deal with it gracefully instead (https://github.com/ansible-collections/amazon.aws/pull/1368)
v5.2.0
Release Summary
A minor release containing bugfixes for the ec2_eni_info
module and the aws_rds
inventory plugin, as well as improvements to the rds_instance
module.
Minor Changes
amazon.aws collection - refacterization of code to use argument specification
fallback
when falling back to environment variables for security credentials and AWS connection details (https://github.com/ansible-collections/amazon.aws/pull/1174).rds_instance - Split up the integration test-suite in a series of smaller tests (https://github.com/ansible-collections/amazon.aws/pull/1185).
rds_instance - add support for gp3 storage type (https://github.com/ansible-collections/amazon.aws/pull/1266).
Bugfixes
aws_rds - fixes bug in RDS inventory plugin where config file was ignored (https://github.com/ansible-collections/amazon.aws/issues/1304).
lambda - fix flaky integration test which assumes there are no other lambdas in the account (https://github.com/ansible-collections/amazon.aws/issues/1277)
v5.1.0
Release Summary
This release brings some minor changes, bugfixes, security fixes and deprecated features.
Minor Changes
amazon.aws collection - The
aws_access_key
parameter has been renamed toaccess_key
,access_key
was previously an alias for this parameter andaws_access_key
remains as an alias. This change should have no observable effect for users outside the module/plugin documentation. (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
aws_secret_key
parameter has been renamed tosecret_key
,secret_key
was previously an alias for this parameter andaws_secret_key
remains as an alias. This change should have no observable effect for users outside the module/plugin documentation. (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
security_token
parameter has been renamed tosession_token
,security_token
was previously an alias for this parameter andsecurity_token
remains as an alias. This change should have no observable effect for users outside the module/plugin documentation. (https://github.com/ansible-collections/amazon.aws/pull/1172).aws_account_attribute lookup plugin - use
missing_required_lib
for more consistent error message when boto3/botocore is not available (https://github.com/ansible-collections/amazon.aws/pull/1152).aws_ec2 inventory - minor linting fixes (https://github.com/ansible-collections/amazon.aws/pull/1181).
aws_ec2 inventory plugin - use
missing_required_lib
for more consistent error message when boto3/botocore is not available (https://github.com/ansible-collections/amazon.aws/pull/1152).aws_rds inventory plugin - use
missing_required_lib
for more consistent error message when boto3/botocore is not available (https://github.com/ansible-collections/amazon.aws/pull/1152).aws_secret lookup plugin - use
missing_required_lib
for more consistent error message when boto3/botocore is not available (https://github.com/ansible-collections/amazon.aws/pull/1152).aws_ssm lookup plugin - use
missing_required_lib
for more consistent error message when boto3/botocore is not available (https://github.com/ansible-collections/amazon.aws/pull/1152).ec2_instance - minor fix for launching an instance in specified AZ when
vpc_subnet_id
is not provided (https://github.com/ansible-collections/amazon.aws/pull/1150).ec2_instance - refacter
tower_callback
code to handle parameter validation as part of the argument specification (https://github.com/ansible-collections/amazon.aws/pull/1199).ec2_instance - the
instance_role
parameter has been renamed toiam_instance_profile
to better reflect what it is,instance_role
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/1151).ec2_instance - the
tower_callback
parameter has been renamed toaap_callback
,tower_callback
remains as an alias. This change should have no observable effect for users outside the module documentation (https://github.com/ansible-collections/amazon.aws/pull/1199).s3_object_info - minor linting fixes (https://github.com/ansible-collections/amazon.aws/pull/1181).
Deprecated Features
amazon.aws collection - Support for the
EC2_ACCESS_KEY
environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use theaccess_key
parameter orAWS_ACCESS_KEY_ID
environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - Support for the
EC2_REGION
environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use theregion
parameter orAWS_REGION
environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - Support for the
EC2_SECRET_KEY
environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use thesecret_key
parameter orAWS_SECRET_ACCESS_KEY
environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - Support for the
EC2_SECURITY_TOKEN
environment variable has been deprecated and will be removed in a release after 2024-12-01. Please use thesession_token
parameter orAWS_SESSION_TOKEN
environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - Support for the
EC2_URL
andS3_URL
environment variables has been deprecated and will be removed in a release after 2024-12-01. Please use theendpoint_url
parameter orAWS_ENDPOINT_URL
environment variable instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
access_token
alias for thesession_token
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use thesession_token
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
access_token
alias for thesession_token
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use thesession_token
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
aws_security_token
alias for thesession_token
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use thesession_token
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
ec2_access_key
alias for theaccess_key
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use theaccess_key
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
ec2_region
alias for theregion
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use theregion
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
ec2_secret_key
alias for thesecret_key
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use thesecret_key
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).amazon.aws collection - The
security_token
alias for thesession_token
parameter has been deprecated and will be removed in a release after 2024-12-01. Please use thesession_token
name instead (https://github.com/ansible-collections/amazon.aws/pull/1172).ec2_security_group - support for passing nested lists to
cidr_ip
andcidr_ipv6
has been deprecated. Nested lists can be passed through theflatten
filter insteadcidr_ip: '{{ my_cidrs | flatten }}'
(https://github.com/ansible-collections/amazon.aws/pull/1213).module_utils.url -
ansible_collections.amazon.aws.module_utils.urls
is believed to be unused and has been deprecated and will be removed in release 7.0.0.
Security Fixes
ec2_instance - fixes leak of password into logs when using
tower_callback.windows=True
andtower_callback.set_password
(https://github.com/ansible-collections/amazon.aws/pull/1199).
Bugfixes
ec2_instance - fixes
Invalid type for parameter TagSpecifications, value None
error when tags aren’t specified (https://github.com/ansible-collections/amazon.aws/issues/1148).module_utils.transformations - ensure that
map_complex_type
still returns transformed items if items exists that are not in the type_map (https://github.com/ansible-collections/amazon.aws/pull/1163).
v5.0.2
Bugfixes
ec2_metadata_facts - fixed
AttributeError
(https://github.com/ansible-collections/amazon.aws/issues/1134).
v5.0.1
Bugfixes
ec2_vpc_net_info - fix KeyError (https://github.com/ansible-collections/amazon.aws/pull/1109).
ec2_vpc_net_info - remove hardcoded
ClassicLinkEnabled
parameter when request forClassicLinkDnsSupported
failed (https://github.com/ansible-collections/amazon.aws/pull/1109).s3_object - be more defensive when checking the results of
s3.get_bucket_ownership_controls
(https://github.com/ansible-collections/amazon.aws/issues/1115).
v5.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 (https://github.com/ansible-collections/amazon.aws/pull/998).
Remove the empty __init__.py file from the distribution, they were not required anymore (https://github.com/ansible-collections/amazon.aws/pull/1018).
amazon.aws modules - the
ec2_url
parameter has been renamed toendpoint_url
for consistency,ec2_url
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/992).aws_caller_info - minor linting fixes (https://github.com/ansible-collections/amazon.aws/pull/968).
aws_ec2 - introduce the
allow_duplicated_hosts
configuration key (https://github.com/ansible-collections/amazon.aws/pull/1026).cloudformation - avoid catching
Exception
, catch more specific errors instead (https://github.com/ansible-collections/amazon.aws/pull/968).cloudwatch_metric_alarm_info - Added a new module that describes the cloudwatch metric alarms (https://github.com/ansible-collections/amazon.aws/pull/988).
ec2_group - The
ec2_group
module has been renamed toec2_security_group
,ec2_group
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/897).ec2_group_info - The
ec2_group_info
module has been renamed toec2_security_group_info
,ec2_group_info
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/897).ec2_instance - Add hibernation_options and volumes->ebs->encrypted keys to support stop-hibernate instance (https://github.com/ansible-collections/amazon.aws/pull/972).
ec2_instance - expanded the use of the automatic retries to
InsuffienctInstanceCapacity
(https://github.com/ansible-collections/amazon.aws/issues/1038).ec2_metadata_facts - avoid catching
Exception
, catch more specific errors instead (https://github.com/ansible-collections/amazon.aws/pull/968).ec2_security_group - minor linting fixes (https://github.com/ansible-collections/amazon.aws/pull/968).
ec2_vpc_endpoint - avoid catching
Exception
, catch more specific errors instead (https://github.com/ansible-collections/amazon.aws/pull/968).ec2_vpc_nat_gateway - minor linting fixes (https://github.com/ansible-collections/amazon.aws/pull/968).
ec2_vpc_net_info - handle classic link check for shared VPCs by throwing a warning instead of an error (https://github.com/ansible-collections/amazon.aws/pull/984).
module_utils/acm - Move to jittered backoff (https://github.com/ansible-collections/amazon.aws/pull/946).
module_utils/elbv2 - ensures that
ip_address_type
is set on creation rather than re-setting it after creation (https://github.com/ansible-collections/amazon.aws/pull/940).module_utils/elbv2 - uses new waiters with retries for temporary failures (https://github.com/ansible-collections/amazon.aws/pull/940).
module_utils/waf - Move to jittered backoff (https://github.com/ansible-collections/amazon.aws/pull/946).
module_utils/waiters - Add waiters to manage eks_nodegroup module (https://github.com/ansible-collections/community.aws/pull/1415).
s3_bucket -
rgw
was added as an alias for theceph
parameter for consistency with thes3_object
module (https://github.com/ansible-collections/amazon.aws/pull/994).s3_bucket - the
s3_url
parameter was merged into theendpoint_url
parameter,s3_url
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/994).s3_object - added the
sig_v4
paramater, enbling the user to opt in to signature version 4 for download/get operations. (https://github.com/ansible-collections/amazon.aws/pull/1014)s3_object - minor linting fixes (https://github.com/ansible-collections/amazon.aws/pull/968).
s3_object - the
rgw
parameter was renamed toceph
for consistency with thes3_bucket
module,rgw
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/994).s3_object - the
s3_url
parameter was merged into theendpoint_url
parameter,s3_url
remains as an alias (https://github.com/ansible-collections/amazon.aws/pull/994).s3_object - updated module to add support for handling file upload to a bucket with ACL disabled (https://github.com/ansible-collections/amazon.aws/pull/921).
s3_object_info - Added a new module that describes S3 Objects (https://github.com/ansible-collections/amazon.aws/pull/977).
Breaking Changes / Porting Guide
amazon.aws collection - Support for ansible-core < 2.11 has been dropped (https://github.com/ansible-collections/amazon.aws/pull/1087).
amazon.aws collection - The amazon.aws collection has dropped support for
botocore<1.21.0
andboto3<1.18.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 (https://github.com/ansible-collections/amazon.aws/pull/934).doc_fragments - remove minimum collection requirements from doc_fragments/aws.py and allow pulling those from doc_fragments/aws_boto3.py instead (https://github.com/ansible-collections/amazon.aws/pull/985).
ec2_ami - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).ec2_ami - the parameter aliases
DeviceName
,VirtualName
andNoDevice
were previously deprecated and have been removed, please usedevice_name
,virtual_name
andno_device
instead (https://github.com/ansible-collections/amazon.aws/pull/913).ec2_eni_info - the mutual exclusivity of the
eni_id
andfilters
parameters is now enforced, previouslyfilters
would be ignored ifeni_id
was set (https://github.com/ansible-collections/amazon.aws/pull/954).ec2_instance - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).ec2_key - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).ec2_vol - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).ec2_vpc_dhcp_option_info - the parameter aliases
DhcpOptionIds
andDryRun
were previously deprecated and have been removed, please usedhcp_options_ids
andno_device
instead (https://github.com/ansible-collections/amazon.aws/pull/913).ec2_vpc_endpoint - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).ec2_vpc_net - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).ec2_vpc_route_table - the default value for
purge_tags
has been changed fromFalse
toTrue
(https://github.com/ansible-collections/amazon.aws/pull/916).s3_bucket - the previously deprecated alias
S3_URL
for thes3_url
parameter has been removed. Playbooks shuold be updated to uses3_url
(https://github.com/ansible-collections/amazon.aws/pull/908).s3_object - the previously deprecated alias
S3_URL
for thes3_url
parameter has been removed. Playbooks should be updated to uses3_url
(https://github.com/ansible-collections/amazon.aws/pull/908).
Deprecated Features
amazon.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection has been deprecated and will be removed in a release after 2023-05-31 (https://github.com/ansible-collections/amazon.aws/pull/935).
inventory/aws_ec2 - the
include_extra_api_calls
is now deprecated, its value is silently ignored (https://github.com/ansible-collections/amazon.aws/pull/1097).
Bugfixes
aws_ec2 - address a regression introduced in 4.1.0 (https://github.com/ansible-collections/amazon.aws/pull/862) that cause the presnse of duplicated hosts in the inventory.
cloudtrail - Fix key error TagList to TagsList (https://github.com/ansible-collections/amazon.aws/issues/1088).
ec2_instance - Only show the deprecation warning for the default value of
instance_type
whencount
orexact_count
are specified (https://github.com//issues/980).ec2_metadata_facts - fix
'NoneType' object is not callable
exception when using Ansible 2.13+ (https://github.com/ansible-collections/amazon.aws/issues/942).module_utils/botocore - fix
object has no attribute 'fail'
error in error handling (https://github.com/ansible-collections/amazon.aws/pull/1045).module_utils/elbv2 - fixes
KeyError
when usingUseExistingClientSecret
rather thanClientSecret
(https://github.com/ansible-collections/amazon.aws/pull/940).module_utils/elbv2 - improvements to idempotency when comparing listeners (https://github.com/ansible-collections/community.aws/issues/604).
s3_object - also use
ignore_nonexistent_bucket
when listing a bucket (https://github.com/ansible-collections/amazon.aws/issues/966).
New Modules
cloudtrail_info - Gather information about trails in AWS Cloud Trail.
cloudwatch_metric_alarm_info - Gather information about the alarms for the specified metric
s3_object_info - Gather information about objects in S3
v4.3.0
Release Summary
The amazon.aws 4.3.0 release includes a number of minor bug fixes and improvements. Following the release of amazon.aws 5.0.0, backports to the 4.x series will be limited to security issues and bugfixes.
Minor Changes
ec2_instance - expanded the use of the automatic retries to
InsuffienctInstanceCapacity
(https://github.com/ansible-collections/amazon.aws/issues/1038).
Bugfixes
ec2_metadata_facts - fix
'NoneType' object is not callable
exception when using Ansible 2.13+ (https://github.com/ansible-collections/amazon.aws/issues/942).module_utils/cloud - Fix
ValueError: ansible_collections.amazon.aws.plugins.module_utils.core.__spec__ is None
error on Ansible 2.9 (https://github.com/ansible-collections/amazon.aws/issues/1083).
v4.2.0
Minor Changes
ec2_security_group - set type as
list
for rules->group_name as it can accept bothstr
andlist
(https://github.com/ansible-collections/amazon.aws/pull/971).various modules - linting fixups (https://github.com/ansible-collections/amazon.aws/pull/953).
Deprecated Features
module_utils.cloud - removal of the
CloudRetry.backoff
has been delayed until release 6.0.0. It is recommended to update custom modules to usejittered_backoff
orexponential_backoff
instead (https://github.com/ansible-collections/amazon.aws/pull/951).
v4.1.0
Minor Changes
ec2_instance - expanded the use of the automatic retries on temporary failures (https://github.com/ansible-collections/amazon.aws/issues/927).
s3_bucket - updated module to enable support for setting S3 Bucket Keys for SSE-KMS (https://github.com/ansible-collections/amazon.aws/pull/882).
Deprecated Features
amazon.aws collection - due to the AWS SDKs announcing the end of support for Python less than 3.7 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/) support for Python less than 3.7 by this collection has been deprecated and will be removed in a release after 2023-05-31 (https://github.com/ansible-collections/amazon.aws/pull/935).
Bugfixes
aws_ec2 - ensure the correct number of hosts are returned when tags as hostnames are used (https://github.com/ansible-collections/amazon.aws/pull/862).
elb_application_lb - fix
KeyError
when balancing across two Target Groups (https://github.com/ansible-collections/community.aws/issues/1089).elb_classic_lb - fix
'NoneType' object has no attribute
bug when creating a new ELB in check mode with a health check (https://github.com/ansible-collections/amazon.aws/pull/915).elb_classic_lb - fix
'NoneType' object has no attribute
bug when creating a new ELB using security group names (https://github.com/ansible-collections/amazon.aws/issues/914).
v4.0.0
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 (https://github.com/ansible-collections/amazon.aws/pull/574).
Minor Changes
aws_s3 - Add
validate_bucket_name
option, to control bucket name validation (https://github.com/ansible-collections/amazon.aws/pull/615).aws_s3 - The
aws_s3
module has been renamed tos3_object
(https://github.com/ansible-collections/amazon.aws/pull/869).aws_s3 -
resource_tags
has been added as an alias for thetags
parameter (https://github.com/ansible-collections/amazon.aws/pull/845).ec2_eni - Change parameter
device_index
data type to string when passing todescribe_network_inter
api call (https://github.com/ansible-collections/amazon.aws/pull/877).ec2_eni -
resource_tags
has been added as an alias for thetags
parameter (https://github.com/ansible-collections/amazon.aws/pull/845).ec2_group - add
egress_rules
as an alias forrules_egress
(https://github.com/ansible-collections/amazon.aws/pull/878).ec2_group - add
purge_egress_rules
as an alias forpurge_rules_egress
(https://github.com/ansible-collections/amazon.aws/pull/878).ec2_instance - Add missing
metadata_options
parameters (https://github.com/ansible-collections/amazon.aws/pull/715).ec2_key -
resource_tags
has been added as an alias for thetags
parameter (https://github.com/ansible-collections/amazon.aws/pull/845).ec2_vpc_net - add support for managing VPCs by ID (https://github.com/ansible-collections/amazon.aws/pull/848).
ec2_vpc_subnet - add support for OutpostArn param (https://github.com/ansible-collections/amazon.aws/pull/598).
elb_classic_lb -
resource_tags
has been added as an alias for thetags
parameter (https://github.com/ansible-collections/amazon.aws/pull/845).s3_bucket - Add
validate_bucket_name
option, to control bucket name validation (https://github.com/ansible-collections/amazon.aws/pull/615).s3_bucket -
resource_tags
has been added as an alias for thetags
parameter (https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/issues/817).amazon.aws collection - the
profile
parameter is now mutually exclusive with theaws_access_key
,aws_secret_key
andsecurity_token
parameters (https://github.com/ansible-collections/amazon.aws/pull/834).aws_az_info - the module alias
aws_az_facts
was deprecated in Ansible 2.9 and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/832).aws_s3 - the default value for
ensure overwrite
has been changed todifferent
instead ofalways
so that the module is idempotent by default (https://github.com/ansible-collections/amazon.aws/issues/811).aws_ssm - on_denied and on_missing now both default to error, for consistency with both aws_secret and the base Lookup class (https://github.com/ansible-collections/amazon.aws/issues/617).
ec2 - The
ec2
module has been removed in release 4.0.0 and replaced by theec2_instance
module (https://github.com/ansible-collections/amazon.aws/pull/630).ec2_vpc_igw_info - The default value for
convert_tags
has been changed toTrue
(https://github.com/ansible-collections/amazon.aws/pull/835).elb_classic_lb - the
ec2_elb
fact has been removed (https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/community.aws/pull/795).ec2_ami - The
DeviceName
alias for the device_name option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795).ec2_ami - The
NoDevice
alias for the no_device option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795).ec2_ami - The
VirtualName
alias for the virtual_name option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/795).ec2_ami - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/pull/587).ec2_instance - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(https://github.com/ansible-collections/amazon.aws/pull/849).ec2_key - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(https://github.com/ansible-collections/amazon.aws/pull/846).ec2_vol - the current default value of
False
forpurge_tags
has been deprecated and will be updated in release 5.0.0 toTrue
(https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/community.aws/pull/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 (https://github.com/ansible-collections/community.aws/pull/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
(https://github.com/ansible-collections/amazon.aws/pull/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
(https://github.com/ansible-collections/amazon.aws/pull/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
(https://github.com/ansible-collections/amazon.aws/pull/846).s3_bucket - The
S3_URL
alias for the s3_url option has been deprecated and will be removed in release 5.0.0 (https://github.com/ansible-collections/community.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/pull/869).
Removed Features (previously deprecated)
cloudformation - the
template_format
option has been removed. It has been ignored by the module since Ansible 2.3 (https://github.com/ansible-collections/amazon.aws/pull/833).ec2_key - the
wait_timeout
option had no effect, was deprecated in release 1.0.0, and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/830).ec2_key - the
wait
option had no effect, was deprecated in release 1.0.0, and has now been removed (https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/pull/829).ec2_vol - the previously deprecated state
list
has been removed. To list volumes theec2_vol_info
module can be used (https://github.com/ansible-collections/amazon.aws/pull/828).module_utils.batch - the class
ansible_collections.amazon.aws.plugins.module_utils.batch.AWSConnection
has been removed. Please useAnsibleAWSModule.client()
instead (https://github.com/ansible-collections/amazon.aws/pull/831).
Bugfixes
ec2_group - fix uncaught exception when running with
--diff
and--check
to create a new security group (https://github.com/ansible-collections/amazon.aws/issues/440).ec2_instance - Add a condition to handle default
`instance_type`
value for fix breaking on instance creation with launch template (https://github.com/ansible-collections/amazon.aws/pull/587).ec2_instance - raise an error when missing permission to stop instance when
state
is set torebooted`
(https://github.com/ansible-collections/amazon.aws/pull/671).ec2_vpc_igw - use gateway_id rather than filters to paginate if possible to fix ‘NoneType’ object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/766).
ec2_vpc_net - fix a bug where CIDR configuration would be updated in check mode (https://github.com/ansible/ansible/issues/62678).
ec2_vpc_net - fix a bug where the module would get stuck if DNS options were updated in check mode (https://github.com/ansible/ansible/issues/62677).
elb_classic_lb - modify the return value of _format_listeners method to resolve a failure creating https listeners (https://github.com/ansible-collections/amazon.aws/pull/860).
v3.5.0
Release Summary
Following the release of amazon.aws 5.0.0, 3.5.0 is a bugfix release and the final planned release for the 3.x series.
Minor Changes
ec2_security_group - set type as
list
for rules->group_name as it can accept bothstr
andlist
(https://github.com/ansible-collections/amazon.aws/pull/971).
Bugfixes
ec2_metadata_facts - fix
'NoneType' object is not callable
exception when using Ansible 2.13+ (https://github.com/ansible-collections/amazon.aws/issues/942).
v3.4.0
Minor Changes
ec2_instance - expanded the use of the automatic retries on temporary failures (https://github.com/ansible-collections/amazon.aws/issues/927).
Bugfixes
elb_application_lb - fix
KeyError
when balancing across two Target Groups (https://github.com/ansible-collections/community.aws/issues/1089).elb_classic_lb - fix
'NoneType' object has no attribute
bug when creating a new ELB in check mode with a health check (https://github.com/ansible-collections/amazon.aws/pull/915).elb_classic_lb - fix
'NoneType' object has no attribute
bug when creating a new ELB using security group names (https://github.com/ansible-collections/amazon.aws/issues/914).
v3.3.1
v3.3.0
Minor Changes
aws_ec2 inventory - Allow for literal strings in hostname that don’t match filter parameters in ec2 describe-instances (https://github.com/ansible-collections/amazon.aws/pull/826).
aws_ssm - Add support for
endpoint
parameter (https://github.com/ansible-collections/amazon.aws/pull/837).module.utils.rds - add retry_codes to get_rds_method_attribute return data to use in call_method and add unit tests (https://github.com/ansible-collections/amazon.aws/pull/776).
module.utils.rds - refactor to utilize get_rds_method_attribute return data (https://github.com/ansible-collections/amazon.aws/pull/776).
module_utils - add new aliases
aws_session_token
andsession_token
to thesecurity_token
parameter to be more in-line with the boto SDK (https://github.com/ansible-collections/amazon.aws/pull/631).module_utils.rds - Add support and unit tests for addition/removal of IAM roles to/from a db instance in module_utils.rds with waiters (https://github.com/ansible-collections/amazon.aws/pull/714).
Bugfixes
Include
PSF-license.txt
file forplugins/module_utils/_version.py
.aws_account_attribute lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
aws_ec2 inventory plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
aws_rds inventory plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
aws_resource_actions callback plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
aws_secret lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
aws_service_ip_ranges lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
aws_ssm - Fix environment variables for client configuration (e.g., AWS_PROFILE, AWS_ACCESS_KEY_ID) (https://github.com/ansible-collections/amazon.aws/pull/837).
aws_ssm lookup plugin - fix linting errors in documentation data (https://github.com/ansible-collections/amazon.aws/pull/701).
ec2_instance - ec2_instance module broken in Python 3.8 - dict keys modified during iteration (https://github.com/ansible-collections/amazon.aws/issues/709).
module.utils.rds - Add waiter for promoting read replica to fix idempotency issue (https://github.com/ansible-collections/amazon.aws/pull/714).
module.utils.rds - Catch InvalidDBSecurityGroupStateFault when modifying a db instance (https://github.com/ansible-collections/amazon.aws/pull/776).
module.utils.s3 - Update validate_bucket_name minimum length to 3 (https://github.com/ansible-collections/amazon.aws/pull/802).
v3.2.0
Minor Changes
aws_secret - add pagination for
bypath
functionality (https://github.com/ansible-collections/amazon.aws/pull/591).ec2_instance - Fix scope of deprecation warning to not show warning when
state
inabsent
(https://github.com/ansible-collections/amazon.aws/pull/719).ec2_vpc_route_table - support associating internet gateways (https://github.com/ansible-collections/amazon.aws/pull/690).
module_utils.elbv2 - Add support for alb specific attributes and compare_elb_attributes method to support check_mode in module_utils.elbv2 (https://github.com/ansible-collections/amazon.aws/pull/696).
s3_bucket - Add support for enforced bucket owner object ownership (https://github.com/ansible-collections/amazon.aws/pull/694).
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. (https://github.com/ansible-collections/amazon.aws/issues/566).
ec2_vol - changing a volume from a type that does not support IOPS (like
standard
) to a type that does (likegp3
) fails (https://github.com/ansible-collections/amazon.aws/issues/626).ec2_vpc_igw - fix ‘NoneType’ object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691).
ec2_vpc_igw - use paginator for describe internet gateways and add retry to fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695).
ec2_vpc_net - In check mode, ensure the module does not change the configuration. Handle case when Amazon-provided ipv6 block is enabled, then disabled, then enabled again. Do not disable IPv6 CIDR association (using Amazon pool) if ipv6_cidr property is not present in the task. If the VPC already exists and ipv6_cidr property, retain the current config (https://github.com/ansible-collections/amazon.aws/pull/631).
v3.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.
v3.1.0
Minor Changes
add new parameters hostvars_prefix and hostvars_suffix for inventory plugins aws_ec2 and aws_rds (https://github.com/ansible-collections/amazon.aws/issues/535).
aws_s3 - Add
validate_bucket_name
option, to control bucket name validation (https://github.com/ansible-collections/amazon.aws/pull/615).aws_s3 - add latest choice on
overwrite
parameter to get latest object on S3 (https://github.com/ansible-collections/amazon.aws/pull/595).ec2_vol - add support for OutpostArn param (https://github.com/ansible-collections/amazon.aws/pull/597).
ec2_vol - tag volume on creation (https://github.com/ansible-collections/amazon.aws/pull/603).
ec2_vpc_route_table - add support for IPv6 in creating route tables (https://github.com/ansible-collections/amazon.aws/pull/601).
s3_bucket - Add
validate_bucket_name
option, to control bucket name validation (https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/pull/587).
Bugfixes
Various modules and plugins - use vendored version of
distutils.version
instead of the deprecated Python standard librarydistutils
(https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/issues/602).
ec2_instance - Add a condition to handle default
`instance_type`
value for fix breaking on instance creation with launch template (https://github.com/ansible-collections/amazon.aws/pull/587).ec2_key - add support for ED25519 key type (https://github.com/ansible-collections/amazon.aws/issues/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. (https://github.com/ansible-collections/amazon.aws/pull/606)
elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592).
s3_bucket - Enable the management of bucket-level ACLs (https://github.com/ansible-collections/amazon.aws/issues/573).
v3.0.0
Major Changes
amazon.aws collection - The amazon.aws collection has dropped support for
botocore<1.19.0
andboto3<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 (https://github.com/ansible-collections/amazon.aws/pull/574).
Minor Changes
ec2_instance - add count parameter support (https://github.com/ansible-collections/amazon.aws/pull/539).
Breaking Changes / Porting Guide
aws_caller_facts - Remove deprecated
aws_caller_facts
alias. Please useaws_caller_info
instead.cloudformation_facts - Remove deprecated
cloudformation_facts
alias. Please usecloudformation_info
instead.ec2_ami_facts - Remove deprecated
ec2_ami_facts
alias. Please useec2_ami_info
instead.ec2_eni_facts - Remove deprecated
ec2_eni_facts
alias. Please useec2_eni_info
instead.ec2_group_facts - Remove deprecated
ec2_group_facts
alias. Please useec2_group_info
instead.ec2_instance_facts - Remove deprecated
ec2_instance_facts
alias. Please useec2_instance_info
instead.ec2_snapshot_facts - Remove deprecated
ec2_snapshot_facts
alias. Please useec2_snapshot_info
instead.ec2_vol_facts - Remove deprecated
ec2_vol_facts
alias. Please useec2_vol_info
instead.ec2_vpc_dhcp_option_facts - Remove deprecated
ec2_vpc_dhcp_option_facts
alias. Please useec2_vpc_dhcp_option_info
instead.ec2_vpc_endpoint_facts - Remove deprecated
ec2_vpc_endpoint_facts
alias. Please useec2_vpc_endpoint_info
instead.ec2_vpc_igw_facts - Remove deprecated
ec2_vpc_igw_facts
alias. Please useec2_vpc_igw_info
instead.ec2_vpc_nat_gateway_facts - Remove deprecated
ec2_vpc_nat_gateway_facts
alias. Please useec2_vpc_nat_gateway_info
instead.ec2_vpc_net_facts - Remove deprecated
ec2_vpc_net_facts
alias. Please useec2_vpc_net_info
instead.ec2_vpc_route_table_facts - Remove deprecated
ec2_vpc_route_table_facts
alias. Please useec2_vpc_route_table_info
instead.ec2_vpc_subnet_facts - Remove deprecated
ec2_vpc_subnet_facts
alias. Please useec2_vpc_subnet_info
instead.
Deprecated Features
module_utils - support for the original AWS SDK
boto
has been deprecated in favour of theboto3
/botocore
SDK. Allboto
based modules have either been deprecated or migrated tobotocore
, 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 theboto
library will need to be migrated to theboto3
/botocore
libraries (https://github.com/ansible-collections/amazon.aws/pull/575).
v2.2.0
Minor Changes
ec2_instance - add count parameter support (https://github.com/ansible-collections/amazon.aws/pull/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. (https://github.com/ansible-collections/amazon.aws/issues/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. (https://github.com/ansible-collections/amazon.aws/pull/606)
ec2_vol - changing a volume from a type that does not support IOPS (like
standard
) to a type that does (likegp3
) fails (https://github.com/ansible-collections/amazon.aws/issues/626).ec2_vpc_igw - fix ‘NoneType’ object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/691).
ec2_vpc_igw - use paginator for describe internet gateways and add retry to fix NoneType object is not subscriptable error (https://github.com/ansible-collections/amazon.aws/pull/695).
elb_classic_lb - handle security_group_ids when providing security_group_names and fix broken tasks in integration test (https://github.com/ansible-collections/amazon.aws/pull/592).
v2.1.0
Minor Changes
aws_service_ip_ranges - add new option
ipv6_prefixes
to get only IPV6 addresses and prefixes for Amazon services (https://github.com/ansible-collections/amazon.aws/pull/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 (https://github.com/ansible-collections/amazon.aws/pull/507).
ec2_ami - add check_mode support (https://github.com/ansible-collections/amazon.aws/pull/516).
ec2_ami - use module_util helper for tagging AMIs (https://github.com/ansible-collections/amazon.aws/pull/520).
ec2_ami - when creating an AMI from an instance pass the tagging options at creation time (https://github.com/ansible-collections/amazon.aws/pull/551).
ec2_elb_lb - module renamed to
elb_classic_lb
(https://github.com/ansible-collections/amazon.aws/pull/377).ec2_eni - add check mode support (https://github.com/ansible-collections/amazon.aws/pull/534).
ec2_eni - use module_util helper for tagging ENIs (https://github.com/ansible-collections/amazon.aws/pull/522).
ec2_instance - use module_util helpers for tagging (https://github.com/ansible-collections/amazon.aws/pull/527).
ec2_key - add support for tagging key pairs (https://github.com/ansible-collections/amazon.aws/pull/548).
ec2_snapshot - add check_mode support (https://github.com/ansible-collections/amazon.aws/pull/512).
ec2_vol - add check_mode support (https://github.com/ansible-collections/amazon.aws/pull/509).
ec2_vpc_dhcp_option - use module_util helpers for tagging (https://github.com/ansible-collections/amazon.aws/pull/531).
ec2_vpc_endpoint - added
vpc_endpoint_security_groups
parameter to support defining the security group attached to an interface endpoint (https://github.com/ansible-collections/amazon.aws/pull/544).ec2_vpc_endpoint - added
vpc_endpoint_subnets
parameter to support defining the subnet attached to an interface or gateway endpoint (https://github.com/ansible-collections/amazon.aws/pull/544).ec2_vpc_endpoint - use module_util helper for tagging (https://github.com/ansible-collections/amazon.aws/pull/525).
ec2_vpc_endpoint - use module_util helpers for tagging (https://github.com/ansible-collections/amazon.aws/pull/531).
ec2_vpc_igw - use module_util helper for tagging (https://github.com/ansible-collections/amazon.aws/pull/523).
ec2_vpc_igw - use module_util helpers for tagging (https://github.com/ansible-collections/amazon.aws/pull/531).
ec2_vpc_nat_gateway - use module_util helper for tagging (https://github.com/ansible-collections/amazon.aws/pull/524).
ec2_vpc_nat_gateway - use module_util helpers for tagging (https://github.com/ansible-collections/amazon.aws/pull/531).
elb_classic_lb - added retries on common AWS temporary API failures (https://github.com/ansible-collections/amazon.aws/pull/377).
elb_classic_lb - added support for check_mode (https://github.com/ansible-collections/amazon.aws/pull/377).
elb_classic_lb - added support for wait during creation (https://github.com/ansible-collections/amazon.aws/pull/377).
elb_classic_lb - added support for wait during instance addition and removal (https://github.com/ansible-collections/amazon.aws/pull/377).
elb_classic_lb - migrated to boto3 SDK (https://github.com/ansible-collections/amazon.aws/pull/377).
elb_classic_lb - various error messages changed due to refactor (https://github.com/ansible-collections/amazon.aws/pull/377).
module_utils.ec2 - moved generic tagging helpers into module_utils.tagging (https://github.com/ansible-collections/amazon.aws/pull/527).
module_utils.tagging - add new helper to generate TagSpecification lists (https://github.com/ansible-collections/amazon.aws/pull/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 returnselb
which can be accessed using the register keyword (https://github.com/ansible-collections/amazon.aws/pull/552).
Bugfixes
AWS action group - added missing
ec2_instance_facts
entry (https://github.com/ansible-collections/amazon.aws/issues/557)ec2_ami - fix problem when creating an AMI from an instance with ephemeral volumes (https://github.com/ansible-collections/amazon.aws/issues/511).
ec2_instance - ensure that ec2_instance falls back to the tag(Name) parameter when no filter and no name parameter is passed (https://github.com/ansible-collections/amazon.aws/issues/526).
s3_bucket - update error handling to better support DigitalOcean Space (https://github.com/ansible-collections/amazon.aws/issues/508).
v2.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+ (https://github.com/ansible-collections/amazon.aws/pull/298).
amazon.aws collection - The amazon.aws collection has dropped support for
botocore<1.18.0
andboto3<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 (https://github.com/ansible-collections/amazon.aws/pull/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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.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 useamazon.aws.ec2_vpc_route_table_info
.
Minor Changes
aws_ec2 - use a generator rather than list comprehension (https://github.com/ansible-collections/amazon.aws/pull/465).
aws_s3 - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
aws_s3 - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
aws_s3 - add
tags
andpurge_tags
features for an S3 object (https://github.com/ansible-collections/amazon.aws/pull/335)aws_s3 - new mode to copy existing on another bucket (https://github.com/ansible-collections/amazon.aws/pull/359).
aws_secret - added support for gracefully handling deleted secrets (https://github.com/ansible-collections/amazon.aws/pull/455).
aws_ssm - add “on_missing” and “on_denied” option (https://github.com/ansible-collections/amazon.aws/pull/370).
cloudformation - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
cloudformation - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_ami - ensure tags are propagated to the snapshot(s) when creating an AMI (https://github.com/ansible-collections/amazon.aws/pull/437).
ec2_eni - fix idempotency when
security_groups
attribute is specified (https://github.com/ansible-collections/amazon.aws/pull/337).ec2_eni - timeout increased when waiting for ENIs to finish detaching (https://github.com/ansible-collections/amazon.aws/pull/501).
ec2_group - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_group - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_group - use a generator rather than list comprehension (https://github.com/ansible-collections/amazon.aws/pull/465).
ec2_group - use system ipaddress module, available with Python >= 3.3, instead of vendored copy (https://github.com/ansible-collections/amazon.aws/pull/461).
ec2_instance - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_instance - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_instance - add
throughput
parameter for gp3 volume types (https://github.com/ansible-collections/amazon.aws/pull/433).ec2_instance - add support for controlling metadata options (https://github.com/ansible-collections/amazon.aws/pull/414).
ec2_instance - remove unnecessary raise when exiting with a failure (https://github.com/ansible-collections/amazon.aws/pull/460).
ec2_instance_info - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_instance_info - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_snapshot - migrated to use the boto3 python library (https://github.com/ansible-collections/amazon.aws/pull/356).
ec2_spot_instance_info - Added a new module that describes the specified Spot Instance requests (https://github.com/ansible-collections/amazon.aws/pull/487).
ec2_vol - add parameter
multi_attach
to support Multi-Attach on volume creation/update (https://github.com/ansible-collections/amazon.aws/pull/362).ec2_vol - relax the boto3/botocore requirements and only require botocore 1.19.27 for modifying the
throughput
parameter (https://github.com/ansible-collections/amazon.aws/pull/346).ec2_vpc_dhcp_option - Now also returns a boto3-style resource description in the
dhcp_options
result key. This includes any tags for thedhcp_options_id
and has the same format as the current return value ofec2_vpc_dhcp_option_info
. (https://github.com/ansible-collections/amazon.aws/pull/252)ec2_vpc_dhcp_option_info - Now also returns a user-friendly
dhcp_config
key that matches the historicalnew_config
key from ec2_vpc_dhcp_option, and alleviates the need to useitems2dict(key_name='key', value_name='values')
when parsing the output of the module. (https://github.com/ansible-collections/amazon.aws/pull/252)ec2_vpc_subnet - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
ec2_vpc_subnet - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
integration tests - remove dependency with collection
community.general
(https://github.com/ansible-collections/amazon.aws/pull/361).module_utils/waiter - add RDS cluster
cluster_available
waiter (https://github.com/ansible-collections/amazon.aws/pull/464).module_utils/waiter - add RDS cluster
cluster_deleted
waiter (https://github.com/ansible-collections/amazon.aws/pull/464).module_utils/waiter - add Route53
resource_record_sets_changed
waiter (https://github.com/ansible-collections/amazon.aws/pull/350).s3_bucket - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
s3_bucket - Tests for compatibility with older versions of the AWS SDKs have been removed (https://github.com/ansible-collections/amazon.aws/pull/442).
s3_bucket - add new option
object_ownership
to configure object ownership (https://github.com/ansible-collections/amazon.aws/pull/311)s3_bucket - updated to use HeadBucket instead of ListBucket when testing for bucket existence (https://github.com/ansible-collections/amazon.aws/pull/357).
Breaking Changes / Porting Guide
ec2_instance - instance wait for state behaviour has changed. If plays require the old behavior of waiting for the instance monitoring status to become
OK
when launching a new instance, the action will need to specifystate: started
(https://github.com/ansible-collections/amazon.aws/pull/481).ec2_snapshot - support for waiting indefinitely has been dropped, new default is 10 minutes (https://github.com/ansible-collections/amazon.aws/pull/356).
ec2_vol_info - return
attachment_set
is now a list of attachments with Multi-Attach support on disk. (https://github.com/ansible-collections/amazon.aws/pull/362).ec2_vpc_dhcp_option - The module has been refactored to use boto3. Keys and value types returned by the module are now consistent, which is a change from the previous behaviour. A
purge_tags
option has been added, which defaults toTrue
. (https://github.com/ansible-collections/amazon.aws/pull/252)ec2_vpc_dhcp_option_info - Now preserves case for tag keys in return value. (https://github.com/ansible-collections/amazon.aws/pull/252)
module_utils.core - The boto3 switch has been removed from the region parameter (https://github.com/ansible-collections/amazon.aws/pull/287).
module_utils/compat - vendored copy of ipaddress removed (https://github.com/ansible-collections/amazon.aws/pull/461).
module_utils/core - updated the
scrub_none_parameters
function so thatdescend_into_lists
is set toTrue
by default (https://github.com/ansible-collections/amazon.aws/pull/297).
Deprecated Features
ec2 - the boto based
ec2
module has been deprecated in favour of the boto3 basedec2_instance
module. Theec2
module will be removed in release 4.0.0 (https://github.com/ansible-collections/amazon.aws/pull/424).ec2_vpc_dhcp_option - The
new_config
return key has been deprecated and will be removed in a future release. It will be replaced bydhcp_config
. Both values are returned in the interim. (https://github.com/ansible-collections/amazon.aws/pull/252)
Bugfixes
aws_s3 - Fix upload permission when an S3 bucket ACL policy requires a particular canned ACL (https://github.com/ansible-collections/amazon.aws/pull/318)
ec2_ami - Fix ami issue when creating an ami with no_device parameter (https://github.com/ansible-collections/amazon.aws/pull/386)
ec2_instance -
ec2_instance
was waiting on EC2 instance monitoring status to beOK
when launching a new instance. This could cause a play to wait multiple minutes for AWS’s monitoring to complete status checks (https://github.com/ansible-collections/amazon.aws/pull/481).ec2_snapshot - Fix snapshot issue when capturing a snapshot of a volume without tags (https://github.com/ansible-collections/amazon.aws/pull/383)
ec2_vol - Fixes
changed
status whenmodify_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.). (https://github.com/ansible-collections/amazon.aws/issues/482).ec2_vol - fix iops setting and enforce iops/throughput parameters usage (https://github.com/ansible-collections/amazon.aws/pull/334)
inventory -
include_filters
won’t be ignored anymore iffilters
is not set (https://github.com/ansible-collections/amazon.aws/issues/457).s3_bucket - Fix error handling when attempting to set a feature that is not implemented (https://github.com/ansible-collections/amazon.aws/pull/391).
s3_bucket - Gracefully handle
NotImplemented
exceptions when fetching encryption settings (https://github.com/ansible-collections/amazon.aws/issues/390).
New Modules
ec2_spot_instance - request, stop, reboot or cancel spot instance
ec2_spot_instance_info - Gather information about ec2 spot instance requests
v1.5.0
Minor Changes
AWS inventory plugins - use shared HAS_BOTO3 helper rather than copying code (https://github.com/ansible-collections/amazon.aws/pull/288).
AWS lookup plugins - use shared HAS_BOTO3 helper rather than copying code (https://github.com/ansible-collections/amazon.aws/pull/288).
aws_account_attribute - add retries on common AWS failures (https://github.com/ansible-collections/amazon.aws/pull/295).
aws_ec2 inventory - expose a new configuration key
use_contrib_script_compatible_ec2_tag_keys
to reproduce a behavior of the oldec2.py
inventory script. With this option enabled, each tag is exposed using aec2_tag_TAGNAME
key (https://github.com/ansible-collections/amazon.aws/pull/331).aws_ec2 inventory - expose to new keys called
include_filters
andexclude_filters
to give the user the ability to compose an inventory with multiple queries (https://github.com/ansible-collections/amazon.aws/pull/328).aws_ec2 inventory plugin - Added support for using Jinja2 templates in the authentication fields (https://github.com/ansible-collections/amazon.aws/pull/57).
cloudformation - added support for StackPolicyDuringUpdateBody (https://github.com/ansible-collections/amazon.aws/pull/155).
ec2_metadata_facts - add support for IMDSv2 (https://github.com/ansible-collections/amazon.aws/pull/43).
ec2_snapshot_info - add the
max_results
along withnext_token_id
option (https://github.com/ansible-collections/amazon.aws/pull/321).ec2_tag - use common code for tagging resources (https://github.com/ansible-collections/amazon.aws/pull/309).
ec2_tag_info - use common code for tagging resources (https://github.com/ansible-collections/amazon.aws/pull/309).
ec2_vol - add the
purge_tags
option (https://github.com/ansible-collections/amazon.aws/pull/242).ec2_vol - use common code for tagging resources (https://github.com/ansible-collections/amazon.aws/pull/309).
ec2_vpc_net - use a custom waiter which can handle API rate limiting (https://github.com/ansible-collections/amazon.aws/pull/270).
ec2_vpc_subnet - use AWSRetry decorator to more consistently handle API rate limiting (https://github.com/ansible-collections/amazon.aws/pull/270).
ec2_vpc_subnet - use common code for tagging resources (https://github.com/ansible-collections/amazon.aws/pull/309).
module_utils.cloudfront_facts - linting cleanup (https://github.com/ansible-collections/amazon.aws/pull/291).
module_utils.ec2 - linting cleanup (https://github.com/ansible-collections/amazon.aws/pull/291).
module_utils/core - add a helper function
normalize_boto3_result
(https://github.com/ansible-collections/amazon.aws/pull/271).module_utils/core - add parameter
descend_into_lists
toscrub_none_parameters
helper function (https://github.com/ansible-collections/amazon.aws/pull/262).module_utils/ec2 - added additional helper functions for tagging EC2 resources (https://github.com/ansible-collections/amazon.aws/pull/309).
sanity tests - add ignore.txt for 2.12 (https://github.com/ansible-collections/amazon.aws/pull/315).
Bugfixes
ec2_vol - create or update now preserves the existing tags, including Name (https://github.com/ansible-collections/amazon.aws/issues/229)
ec2_vol - fix exception when platform information isn’t available (https://github.com/ansible-collections/amazon.aws/issues/305).
v1.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. (https://github.com/ansible-collections/amazon.aws/issues/273)-
v1.4.0
Minor Changes
aws_ec2 - Add hostname options concatenation
aws_ec2 inventory plugin - avoid a superfluous import of
ansible.utils.display.Display
(https://github.com/ansible-collections/amazon.aws/pull/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. (https://github.com/ansible-collections/amazon.aws/pull/237)
aws_secret - add
bypath
functionality (https://github.com/ansible-collections/amazon.aws/pull/192).ec2_key - add AWSRetry decorator to automatically retry on common temporary failures (https://github.com/ansible-collections/amazon.aws/pull/213).
ec2_vol - Add support for gp3 volumes and support for modifying existing volumes (https://github.com/ansible-collections/amazon.aws/issues/55).
module_utils/elbv2 - add logic to compare_rules to suit Values list nested within dicts unique to each field type. Fixes issue (https://github.com/ansible-collections/amazon.aws/issues/187)
various AWS plugins and module_utils - Cleanup unused imports (https://github.com/ansible-collections/amazon.aws/pull/217).
Bugfixes
ec2_vol - a creation or update now returns a structure with an up to date list of tags (https://github.com/ansible-collections/amazon.aws/pull/241).
v1.3.0
Minor Changes
aws_caller_info - add AWSRetry decorator to automatically retry on common temporary failures (https://github.com/ansible-collections/amazon.aws/pull/208)
aws_s3 - Add support for uploading templated content (https://github.com/ansible-collections/amazon.aws/pull/20).
aws_secret - add “on_missing” and “on_denied” option (https://github.com/ansible-collections/amazon.aws/pull/122).
ec2_ami - Add retries for ratelimiting related errors (https://github.com/ansible-collections/amazon.aws/pull/195).
ec2_ami - fixed and streamlined
max_attempts
logic when waiting for AMI creation to finish (https://github.com/ansible-collections/amazon.aws/pull/194).ec2_ami - increased default
wait_timeout
to 1200 seconds (https://github.com/ansible-collections/amazon.aws/pull/194).ec2_ami_info - Add retries for ratelimiting related errors (https://github.com/ansible-collections/amazon.aws/pull/195).
ec2_eni - Improve reliability of the module by adding waiters and performing lookups by ENI ID rather than repeated searches (https://github.com/ansible-collections/amazon.aws/pull/180).
ec2_eni_info - Improve reliability of the module by adding waiters and performing lookups by ENI ID rather than repeated searches (https://github.com/ansible-collections/amazon.aws/pull/180).
ec2_group - add AWSRetry decorator to automatically retry on common temporary failures (https://github.com/ansible-collections/amazon.aws/pull/207)
ec2_group_info - add AWSRetry decorator to automatically retry on common temporary failures (https://github.com/ansible-collections/amazon.aws/pull/207)
ec2_snapshot_info - add AWSRetry decorator to automatically retry on common temporary failures (https://github.com/ansible-collections/amazon.aws/pull/208)
ec2_vol - Add automatic retries on AWS rate limit errors (https://github.com/ansible-collections/amazon.aws/pull/199).
ec2_vol - ported ec2_vol to use boto3 (https://github.com/ansible-collections/amazon.aws/pull/53).
ec2_vpc_dhcp_option_info - add AWSRetry decorator to automatically retry on common temporary failures (https://github.com/ansible-collections/amazon.aws/pull/208)
module_utils/core - add helper function
scrub_none_parameters
to remove params set toNone
(https://github.com/ansible-collections/community.aws/issues/251).module_utils/waiters - Add retries to our waiters for the same failure codes that we retry with AWSRetry (https://github.com/ansible-collections/amazon.aws/pull/185)
s3_bucket - Add support for managing the
public_access
settings (https://github.com/ansible-collections/amazon.aws/pull/171).
Bugfixes
ec2 - Code fix so module can create ec2 instances with
ec2_volume_iops
option (https://github.com/ansible-collections/amazon.aws/pull/177).ec2 - ignore terminated instances and instances that are shutting down when starting and stopping (https://github.com/ansible-collections/amazon.aws/issues/146).
ec2_group - Fixes error handling during tagging failures (https://github.com/ansible-collections/amazon.aws/issues/210).
ec2_group_info - Code fix so module works with Python 3.8 (make dict immutable in loop) (https://github.com/ansible-collections/amazon.aws/pull/181)
v1.2.1
Minor Changes
ec2_eni - Add support for tagging.
ec2_eni - Port ec2_eni module to boto3 and add an integration test suite.
ec2_eni_info - Add retries on transient AWS failures.
ec2_eni_info - Add support for providing an ENI ID.
v1.2.0
Minor Changes
ec2 module_utils - Update
ec2_connect
(boto2) behaviour so thatec2_url
overridesregion
.module_utils.core - Support passing arbitrary extra keys to fail_json_aws, matching capabilities of fail_json.
Deprecated Features
All AWS Modules -
aws_access_key
,aws_secret_key
andsecurity_token
will be made mutually exclusive withprofile
after 2022-06-01.
Bugfixes
ec2 module_utils - Ensure boto3 verify parameter isn’t overridden by setting a profile (https://github.com/ansible-collections/amazon.aws/issues/129)
s3_bucket - Ceph compatibility: treat error code NoSuchTagSetError used by Ceph synonymously to NoSuchTagSet used by AWS
v1.1.0
Major Changes
ec2 module_utils - The
AWSRetry
decorator no longer catchesNotFound
exceptions by default.NotFound
exceptions need to be explicitly added usingcatch_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
andendpoint_url
aliases to improve AWS module parameter naming consistency.Add support for
aws_ca_bundle
to boto3 based AWS modulesAdd support for configuring boto3 profiles using
AWS_PROFILE
andAWS_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 (https://github.com/ansible/ansible/issues/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-01cloudformation - 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-01ec2 - in a later release, the
group
andgroup_id
options will become mutually exclusive. Currentlygroup_id
is ignored if you pass both.ec2_ami - The
no_device
aliasNoDevice
has been deprecated and will be removed after 2022-06-01ec2_ami - The
virtual_name
aliasVirtualName
has been deprecated and will be removed after 2022-06-01ec2_eip - The
wait_timeout
option had no effect and will be removed after 2022-06-01ec2_key - The
wait_timeout
option had no effect and will be removed after 2022-06-01ec2_key - The
wait
option had no effect and will be removed after 2022-06-01ec2_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-01ec2_tag - deprecate the
list
option in favor of ec2_tag_infoec2_tag - support for
list
as a state has been deprecated and will be removed in a later release. Theec2_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 (https://github.com/ansible/ansible/issues/61907)
ec2_vol - fix filtering bug
s3_bucket - Accept XNotImplemented response to support NetApp StorageGRID.