amazon.aws 发行说明

v9.0.0

版本摘要

此主要版本带来了一组新的受支持模块，这些模块已从 community.aws 提升，以及一些错误修复、次要更改和已弃用的功能。我们还停止支持 botocore<1.31.0 和 boto3<1.28.0。由于 AWS SDK 宣布结束对低于 3.8 的 Python 的支持（https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/），此版本已弃用此集合对低于 3.8 的 Python 的支持，并将在 10.0.0 版本中删除。

主要变更

• autoscaling_instance_refresh - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.autoscaling_instance_refresh (https://github.com/ansible-collections/amazon.aws/pull/2338)。

• autoscaling_instance_refresh_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.autoscaling_instance_refresh_info (https://github.com/ansible-collections/amazon.aws/pull/2338)。

• ec2_launch_template - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_launch_template (https://github.com/ansible-collections/amazon.aws/pull/2348)。

• ec2_placement_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_placement_group。

• ec2_placement_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_placement_group_info。

• ec2_transit_gateway - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_transit_gateway。

• ec2_transit_gateway_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_transit_gateway_info。

• ec2_transit_gateway_vpc_attachment - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_transit_gateway_vpc_attachment。

• ec2_transit_gateway_vpc_attachment_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_transit_gateway_vpc_attachment_info。

• ec2_vpc_egress_igw - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_egress_igw (https://api.github.com/repos/ansible-collections/amazon.aws/pulls/2327)。

• ec2_vpc_nacl - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_nacl (https://github.com/ansible-collections/amazon.aws/pull/2339)。

• ec2_vpc_nacl_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_nacl_info (https://github.com/ansible-collections/amazon.aws/pull/2339)。

• ec2_vpc_peer - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_peer。

• ec2_vpc_peering_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_peering_info。

• ec2_vpc_vgw - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_vgw。

• ec2_vpc_vgw_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_vgw_info。

• ec2_vpc_vpn - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_vpn。

• ec2_vpc_vpn_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.ec2_vpc_vpn_info。

• elb_classic_lb_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的剧本应更新为使用 amazon.aws.elb_classic_lb_info。

次要更改

• 添加对传输网关 VPC 附件模块的支持 (https://github.com/ansible-collections/amazon.aws/pull/2314)。

• 将 ansible-lint 的版本提升到最低 24.7.0 (https://github.com/ansible-collections/amazon.aws/pull/2201)。

• 将函数 determine_iam_role 从模块 ec2_instance 移动到 module_utils/ec2，以便 community.aws.ec2_launch_template 模块可以使用 (https://github.com/ansible-collections/amazon.aws/pull/2319)。

• aws_az_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2163)。 - aws_region_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2163)。

• backup_vault - 更新代码以删除作为 None 返回的不必要的返回值 (https://github.com/ansible-collections/amazon.aws/pull/2105)。

• cloudwatchlogs_log_group_metric_filter - 添加对 unit 和 dimensions 选项的支持 (https://github.com/ansible-collections/amazon.aws/pull/2286)

• ec2_ami - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2164)。

• ec2_ami_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2164)。

• ec2_eip - 添加对更新 EIP 的反向 DNS 记录的支持 (https://github.com/ansible-collections/amazon.aws/pull/2292)。

• ec2_eip - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2165)。 - ec2_eip_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2165)。

• ec2_eni - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2166)。

• ec2_eni_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2166)。

• ec2_import_image - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2167)。

• ec2_import_image_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2167)。

• ec2_instance - 将变量 client 和 module 作为函数参数传递，而不是全局变量 (https://github.com/ansible-collections/amazon.aws/pull/2192)。

• ec2_instance - 添加升级/降级现有 ec2 实例类型的可能性 (https://github.com/ansible-collections/amazon.aws/issues/469)。

• ec2_instance - 重构代码以使用 AnsibleEC2Error 并从 module_utils.ec2 共享代码 (https://github.com/ansible-collections/amazon.aws/pull/2192)。

• ec2_instance_info - 将对已弃用函数 datetime.utcnow() 的调用替换为 datetime.now(timezone.utc) (https://github.com/ansible-collections/amazon.aws/pull/2192)。

• ec2_instance_info - 重构代码以使用 AnsibleEC2Error 并从 module_utils.ec2 共享代码 (https://github.com/ansible-collections/amazon.aws/pull/2192)。

• ec2_key - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2168)。

• ec2_key_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2168)。

• ec2_security_group - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2169)。

• ec2_security_group_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2169)。

• ec2_snapshot - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_snapshot_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_spot_instance - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_spot_instance_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_vol - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2170)。

• ec2_vol_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2170)。

• ec2_vpc_dhcp_option - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097)。

• ec2_vpc_dhcp_option_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097)。

• ec2_vpc_endpoint - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097)。

• ec2_vpc_endpoint_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097)。

• ec2_vpc_endpoint_service_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2097)。

• ec2_vpc_igw - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_vpc_igw_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_vpc_nat_gateway - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_vpc_nat_gateway_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2099)。

• ec2_vpc_net - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2158)。

• ec2_vpc_net_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2158)。

• ec2_vpc_route_table - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2159)。

• ec2_vpc_route_table - 更新 ec2_vpc_route_table 路由参数以支持传输网关 ID (https://github.com/ansible-collections/amazon.aws/pull/2291)。

• ec2_vpc_route_table_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2159)。

• ec2_vpc_subnet - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2160)。

• ec2_vpc_subnet_info - 重构代码以使用 AnsibleEC2Error 并将共享代码移动到 module_utils.ec2 (https://github.com/ansible-collections/amazon.aws/pull/2160)。

• module_utils.botocore - 为了保持一致性，将 botocore.Session 的使用替换为 boto3.Session (https://github.com/ansible-collections/amazon.aws/pull/2157)。

• module_utils.botocore - boto3_conn 方法现在捕获 BotoCoreError，而不是不完整的子类列表 (https://github.com/ansible-collections/amazon.aws/pull/2157)。

• module_utils/autoscaling - 创建用于处理 autoscaling 客户端的 AWS 调用的实用程序 (https://github.com/ansible-collections/amazon.aws/pull/2301)。

• module_utils/ec2 - 为启动模板 AWS API 调用添加一些共享代码 (https://github.com/ansible-collections/amazon.aws/pull/2319)。

• module_utils/ec2 - 为 ec2_placement_group* 模块添加实用程序 (https://github.com/ansible-collections/amazon.aws/pull/2322)。

• module_utils/ec2 - 为 ec2_transit_gateway_* 模块添加实用程序 (https://github.com/ansible-collections/amazon.aws/pull/2325)。

• module_utils/ec2 - 为 ec2_vpc_peer* 模块添加实用程序 (https://github.com/ansible-collections/amazon.aws/pull/2303)。

• module_utils/ec2 - 为 ec2_vpc_vgw_* 模块添加实用程序 (https://github.com/ansible-collections/amazon.aws/pull/2331)。

• module_utils/ec2 - 为 ec2_vpc_vpn* 模块添加实用程序 (https://github.com/ansible-collections/amazon.aws/pull/2312)。

• module_utils/ec2 - 移动 ec2 客户端的共享代码 (https://github.com/ansible-collections/amazon.aws/pull/2302)。

• module_utils/elbv2 - 重构监听器和规则比较逻辑 (https://github.com/ansible-collections/amazon.aws/issues/1981)。

• module_utils/rds.py - 添加来自 rds 快照模块的共享功能 (https://github.com/ansible-collections/amazon.aws/pull/2138)。

• module_utils/rds.py - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2119)。

• plugin_utils.botocore - boto3_conn 方法现在捕获 BotoCoreError，而不是不完整的子类列表 (https://github.com/ansible-collections/amazon.aws/pull/2157)。

• rds_cluster_snapshot - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2138)。

• rds_instance - 添加对多租户 CDB 数据库的支持 (https://github.com/ansible-collections/amazon.aws/pull/2275)。

• rds_instance - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2119)。

• rds_instance - 删除添加到 module_utils/rds.py 的共享功能 (https://github.com/ansible-collections/amazon.aws/pull/2138)。

• rds_instance_info - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2119)。

• rds_instance_info - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2138)。

• rds_instance_snapshot - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2138)。

• rds_snapshot_info - 重构共享 boto3 客户端功能，添加类型提示和函数文档字符串 (https://github.com/ansible-collections/amazon.aws/pull/2138)。

• s3_object_info - 添加对 max_keys 和 marker 参数的支持 (https://github.com/ansible-collections/amazon.aws/pull/2328)。

重大变更/移植指南

• amazon.aws 集合已停止支持 botocore<1.31.0 和 boto3<1.28.0。大多数模块将继续使用旧版本的 AWS SDK。但是，不保证与旧版本 SDK 的兼容性，也不会进行测试。当使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/2161)。

• aws_ec2 - 参数 include_extra_api_calls 之前已弃用，现已删除 (https://github.com/ansible-collections/amazon.aws/pull/2320)。

• iam_policy - policies 返回键之前已弃用，现已删除，请改用 policy_names (https://github.com/ansible-collections/amazon.aws/pull/2320)。

• module_utils.botocore - boto3_conn 的 conn_type 参数现在是强制性的 (https://github.com/ansible-collections/amazon.aws/pull/2157)。

已弃用的功能

• amazon.aws 集合 - 由于 AWS SDK 宣布停止支持低于 3.8 的 Python 版本 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)，此集合已弃用对低于 3.8 的 Python 版本的支持，并将在 10.0.0 版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/2161)。

• ec2_vpc_peer - ec2_vpc_peer 模块已重命名为 ec2_vpc_peering。模块的使用方式没有改变。ec2_vpc_peer 别名将在 13.0.0 版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/2356)。

• ec2_vpc_peering_info - result 返回键已弃用，并将在 11.0.0 版本中删除。请改用 vpc_peering_connections 返回键 (https://github.com/ansible-collections/amazon.aws/pull/2359)。

• s3_object - 对 mode=list 的支持已弃用。应改用 amazon.aws.s3_object_info (https://github.com/ansible-collections/amazon.aws/pull/2328)。

Bug修复

• aws_ec2 - 修复多个（> 40）主机的 SSM 清单收集问题 (https://github.com/ansible-collections/amazon.aws/pull/2227)。

• ec2_vol - 当卷以检查模式存在时输出卷信息 (https://github.com/ansible-collections/amazon.aws/pull/2133)。

• s3_bucket - 修复由于添加类型信息而导致的 Python 3.7 编译问题 (https://github.com/ansible-collections/amazon.aws/issues/2287)。

• s3_object - 修复了 max_keys 未生效的问题 (https://github.com/ansible-collections/amazon.aws/pull/2328)。

新模块

• autoscaling_instance - 管理与 AWS AutoScaling Groups (ASG) 关联的实例

• autoscaling_instance_info - 描述与 AWS AutoScaling Groups (ASG) 关联的实例

• ec2_launch_template_info - 收集有关启动模板和版本的信息

• ec2_vpc_egress_igw_info - 收集有关 AWS VPC 仅出口互联网网关的信息

v8.2.1

发布摘要

这是 iam_role 模块的 bug 修复版本，解决了当 create_instance_profile 设置为 false 时创建 IAM 实例配置文件的问题，并解决了当实例配置文件已存在时出现的 EntityAlreadyExists 异常。

Bug修复

• iam_role - 修复了当 create_instance_profile 设置为 false 且实例配置文件已存在时出现的 EntityAlreadyExists 异常 (https://github.com/ansible-collections/amazon.aws/issues/2102)。

• iam_role - 修复了当 create_instance_profile 设置为 false 时，仍会创建 IAM 实例配置文件的问题 ( https://github.com/ansible-collections/amazon.aws/issues/2281 )。

v8.2.0

版本摘要

amazon.aws 8.2.0 版本包含许多错误修复、一些新功能和改进。此版本还引入了对 amazon.aws.iam_role 模块的弃用，其中使用 create_instance_profile 和 delete_instance_profile 选项创建和删除 IAM 实例配置文件的支持已被弃用，并将在 2026-05-01 之后的版本中删除。

次要更改

• cloudwatch_metric_alarm - 添加对 evaluate_low_sample_count_percentile 参数的支持。

• cloudwatch_metric_alarm - 支持 DatapointsToAlarm 配置 (https://github.com/ansible-collections/amazon.aws/pull/2196)。

• ec2_ami - 添加对 uefi-preferred 启动模式的支持 (https://github.com/ansible-collections/amazon.aws/pull/2253)。

• ec2_instance - 添加对 network_interfaces 和 network_interfaces_ids 选项的支持，替换已弃用的选项 network (https://github.com/ansible-collections/amazon.aws/pull/2123)。

• ec2_instance - network.source_dest_check 选项已被弃用，并被新选项 source_dest_check 替换 (https://github.com/ansible-collections/amazon.aws/pull/2123)。

• ec2_instance - 添加了创建具有多个网络接口的实例的可能性 (https://github.com/ansible-collections/amazon.aws/pull/2123)。

• ec2_metadata_facts - 添加参数 metadata_token_ttl_seconds (https://github.com/ansible-collections/amazon.aws/pull/2209)。

• rds_cluster - 为 aurora 集群添加对 I/O 优化存储配置的支持 (https://github.com/ansible-collections/amazon.aws/pull/2063)。

• rds_instance - 参数 performance_insights_kms_key_id 的蛇形命名法根据 boto 文档是不正确的 (https://github.com/ansible-collections/amazon.aws/pull/2163)。

• s3_bucket - 添加对存储桶清单的支持 (https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html)

• s3_object - 添加对 expected_bucket_owner 选项的支持 (https://github.com/ansible-collections/amazon.aws/issues/2114)。

• ssm 参数查找 - 添加新选项 droppath，以从 ssm 参数查找结果中删除分层搜索路径 (https://github.com/ansible-collections/amazon.aws/pull/1756)。

已弃用功能

• iam_role - 使用 create_instance_profile 和 delete_instance_profile 选项创建和删除 IAM 实例配置文件的支持已被弃用，并将在 2026-05-01 之后的版本中删除。要管理 IAM 实例配置文件，可以使用 amazon.aws.iam_instance_profile 模块代替 (https://github.com/ansible-collections/amazon.aws/pull/2221)。

错误修复

• cloudwatch_metric_alarm - 修复在未指定维度的情况下创建 cloudwatch 指标告警时的幂等性问题 (https://github.com/ansible-collections/amazon.aws/pull/1865)。

• ec2_instance - 修复使用 exact_count 时状态处理的问题 (https://github.com/ansible-collections/amazon.aws/pull/1659)。

• rds_cluster - 当使用 started 或 stopped 状态时，限制发送到 API 调用的参数为 DBClusterIdentifier (https://github.com/ansible-collections/amazon.aws/issues/2197)。

• route53 - 修改返回值，仅当 module._diff 设置为 true 时才返回差异 (https://github.com/ansible-collections/amazon.aws/pull/2136)。

• s3_bucket - 在不支持的区域中调用 API GetBucketAccelerationConfig 时捕获 UnsupportedArgument (https://github.com/ansible-collections/amazon.aws/issues/2180)。

• s3_bucket - 更改新选项 accelerate_enabled 的默认行为，仅在显式传递时才更新配置 (https://github.com/ansible-collections/amazon.aws/issues/2220)。

• s3_bucket - 修复了在不支持传输加速的区域中获取传输加速状态导致的 MethodNotAllowed 异常 (https://github.com/ansible-collections/amazon.aws/issues/2266)。

• s3_bucket - 修复了与存储桶版本控制、策略、标签或加密相关的 TypeError: cannot unpack non-iterable NoneType object 错误 (https://github.com/ansible-collections/amazon.aws/pull/2228)。

v8.1.0

版本摘要

此版本包括多个文档改进和 s3_bucket 模块的两个新功能。

次要更改

• s3_bucket - 添加 object_lock_default_retention 以设置 S3 存储桶的对象锁定默认保留配置 (https://github.com/ansible-collections/amazon.aws/pull/2062)。

• s3_bucket - 添加通过设置 accelerate_enabled 选项来启用 Amazon S3 传输加速的支持 (https://github.com/ansible-collections/amazon.aws/pull/2046)。

v8.0.1

版本摘要

此版本包括对 s3_object、ec2_instance 和 backup_plan_info 模块的一些错误修复。

错误修复

• backup_plan_info - 修复了启用获取所有备份计划信息的问题 (https://github.com/ansible-collections/amazon.aws/pull/2083)。

• ec2_instance - 当指定单个网络接口时，不忽略 IPv6 地址 (https://github.com/ansible-collections/amazon.aws/pull/1979)。

• s3_object - 修复了下载大型文件时导致 MemoryError 异常的问题 (https://github.com/ansible-collections/amazon.aws/issues/2107)。

v8.0.0

版本摘要

此主要版本带来了多个新功能、错误修复和已弃用的功能。它还包括删除了以前已弃用的 iam_role, iam_role_info 和 module_utils.policy 的一些功能。我们还删除了对 ansible-core<2.15 的支持。

次要更改

• autoscaling_group - 删除了未使用的代码 (https://github.com/ansible-collections/amazon.aws/pull/1996)。

• cloudformation - 在不使用过滤器分页浏览堆栈事件时应用自动重试 (https://github.com/ansible-collections/amazon.aws/pull/2049)。

• cloudtrail - 删除了未使用的代码 (https://github.com/ansible-collections/amazon.aws/pull/1996)。

• ec2_instance - 删除了未使用的代码 (https://github.com/ansible-collections/amazon.aws/pull/1996)。

• ec2_vol - 确保在尝试删除卷时，卷状态不是 deleted 或 deleting 之一，以保证幂等性 (https://github.com/ansible-collections/amazon.aws/pull/2052)。

• ec2_vol - 删除了未使用的代码 (https://github.com/ansible-collections/amazon.aws/pull/1996)。

• elb_classic_lb - 删除了未使用的代码 (https://github.com/ansible-collections/amazon.aws/pull/1996)。

• kms_key - 删除了未使用的代码 (https://github.com/ansible-collections/amazon.aws/pull/1996)。

• lambda_event - 添加了对设置 maximum_batching_window_in_seconds 选项的支持 (https://github.com/ansible-collections/amazon.aws/pull/2025)。

• module_uils/botocore - 支持将错误集合和元组以及列表作为列表 (https://github.com/ansible-collections/amazon.aws/pull/1829)。

• module_utils/elbv2 - 在创建 ALB 期间添加支持，以添加具有多个证书的监听器。允许 elb_application_elb 模块处理上述用例。（https://github.com/ansible-collections/amazon.aws/pull/1950）。

• module_utils/elbv2 - 添加更新 TLS 监听器的 SslPolicy、Certificates 和 AlpnPolicy 的可能性。（https://github.com/ansible-collections/amazon.aws/issues/1198）。

• rds_instance - 允许将空列表传递给 enable_cloudwatch_logs_exports 以删除所有现有导出。（https://github.com/ansible-collections/amazon.aws/pull/1917）。

• s3_bucket - 重构 s3_bucket 模块代码，以提高可读性和可维护性。（https://github.com/ansible-collections/amazon.aws/pull/2057）。

• s3_object - 删除未使用的代码。（https://github.com/ansible-collections/amazon.aws/pull/1996）。

重大变更 / 移植指南

• amazon.aws 集合 - 已放弃对 ansible-core < 2.15 的支持。（https://github.com/ansible-collections/amazon.aws/pull/2093）。

• iam_role - iam_role.assume_role_policy_document 不再从驼峰式转换为蛇形命名法。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• iam_role_info - iam_role.assume_role_policy_document 不再从驼峰式转换为蛇形命名法。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• kms_key - policies 返回值已重命名为 key_policies，内容未更改。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• kms_key_info - policies 返回值已重命名为 key_policies，内容未更改。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• lambda_event - | batch_size 不再默认为 100。根据 boto3 API (https://boto3.amazonaws.com/v1/documentation/api/1.26.78/reference/services/lambda.html#Lambda.Client.create_event_source_mapping)，batch_size 对于 sqs 源默认为 10，对于流源默认为 100。（https://github.com/ansible-collections/amazon.aws/pull/2025）。

已弃用的功能

• aws_ec2 清单插件 - 之前已弃用的 include_extra_api_calls 选项的删除已分配给 9.0.0 版本。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• cloudformation - template 参数已被弃用，将在 2026-05-01 之后的版本中删除。 template_body 参数可以与 lookup 插件结合使用。（https://github.com/ansible-collections/amazon.aws/pull/2048）。

• iam_policy - 之前已弃用的 policies 返回键的删除已分配给 9.0.0 版本。请改用 policy_names 返回键。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• module_utils.botocore - get_aws_connection_info() 的 boto3 参数将在 2025-05-01 之后的版本中删除。自 4.0.0 版本以来，boto3 参数已被忽略。（https://github.com/ansible-collections/amazon.aws/pull/2047）。

• module_utils.botocore - get_aws_region() 的 boto3 参数将在 2025-05-01 之后的版本中删除。自 4.0.0 版本以来，boto3 参数已被忽略。（https://github.com/ansible-collections/amazon.aws/pull/2047）。

• module_utils.ec2 - get_ec2_security_group_ids_from_names() 的 boto3 参数将在 2025-05-01 之后的版本中删除。自 4.0.0 版本以来，boto3 参数已被忽略。（https://github.com/ansible-collections/amazon.aws/pull/2047）。

• rds_param_group - rds_param_group 模块已重命名为 rds_instance_param_group。模块的使用方式没有改变。 rds_param_group 别名将在 10.0.0 版本中删除。（https://github.com/ansible-collections/amazon.aws/pull/2058）。

已删除的功能（之前已弃用）

• iam_role - iam_role.assume_role_policy_document_raw 返回值已弃用。iam_role.assume_role_policy_document 现在返回与 iam_role.assume_role_policy_document_raw 相同的格式。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• iam_role_info - iam_role.assume_role_policy_document_raw 返回值已弃用。iam_role.assume_role_policy_document 现在返回与 iam_role.assume_role_policy_document_raw 相同的格式。（https://github.com/ansible-collections/amazon.aws/pull/2040）。

• module_utils.policy - 之前已弃用的 sort_json_policy_dict() 函数已删除，请考虑改用 compare_policies()。（https://github.com/ansible-collections/amazon.aws/pull/2052）。

Bug 修复

• elb_classic_lb - 修复了未设置 proxy_protocol 或将其设置为 None 可能导致意外行为或错误的错误。（https://github.com/ansible-collections/amazon.aws/pull/2049）。

• lambda_event - 修复了当 batch_size 大于 10 时的问题，通过启用对设置 maximum_batching_window_in_seconds 的支持。（https://github.com/ansible-collections/amazon.aws/pull/2025）。

• lambda_event - 使用 AWS API (get_function) 检索函数 ARN，而不是使用 AWS 账户信息构建它。（https://github.com/ansible-collections/amazon.aws/issues/1859）。

v7.6.1

发布摘要

此版本包含对 ec2_instance 和 backup_plan_info 模块的一些错误修复。

Bug 修复

• backup_plan_info - 修复了启用获取所有备份计划信息的问题 (https://github.com/ansible-collections/amazon.aws/pull/2083)。

• ec2_instance - 当指定单个网络接口时，不忽略 IPv6 地址 (https://github.com/ansible-collections/amazon.aws/pull/1979)。

v7.6.0

发布摘要

此版本带来了几个错误修复、小的更改和一些新的 rds 模块（rds_cluster_param_group、rds_cluster_param_group_info 和 rds_engine_versions_info）。它还引入了对 cloudformation 模块的弃用。

小的更改

• ec2_instance - 在 placement.tenancy 中添加对 host 选项的支持。（https://github.com/ansible-collections/amazon.aws/pull/2026）。

• ec2_vol - 确保在尝试删除卷时，卷状态不是 deleted 或 deleting 之一，以保证幂等性 (https://github.com/ansible-collections/amazon.aws/pull/2052)。

已弃用的功能

• cloudformation - template 参数已被弃用，将在 2026-05-01 之后的版本中删除。 template_body 参数可以与 lookup 插件结合使用。（https://github.com/ansible-collections/amazon.aws/pull/2048）。

• module_utils.botocore - get_aws_connection_info() 的 boto3 参数将在 2025-05-01 之后的版本中删除。自 4.0.0 版本以来，boto3 参数已被忽略。（https://github.com/ansible-collections/amazon.aws/pull/2047）。

• module_utils.botocore - get_aws_region() 的 boto3 参数将在 2025-05-01 之后的版本中删除。自 4.0.0 版本以来，boto3 参数已被忽略。（https://github.com/ansible-collections/amazon.aws/pull/2047）。

• module_utils.ec2 - get_ec2_security_group_ids_from_names() 的 boto3 参数将在 2025-05-01 之后的版本中删除。自 4.0.0 版本以来，boto3 参数已被忽略。（https://github.com/ansible-collections/amazon.aws/pull/2047）。

Bug 修复

• iam_managed_policy - 修复了尝试删除附加到角色或用户的策略时导致 ParamValidationError 的错误。（https://github.com/ansible-collections/amazon.aws/issues/2067）。

• iam_role_info - 修复了处理缺少 / 前缀和/或后缀的路径的错误。（https://github.com/ansible-collections/amazon.aws/issues/2065）。

• s3_object - 修复了复制使用多部分上传上传的对象时的幂等性问题。（https://github.com/ansible-collections/amazon.aws/issues/2016）。

新模块

• rds_cluster_param_group - 管理 RDS 集群参数组

• rds_cluster_param_group_info - 描述特定 RDS 集群参数组的属性。

• rds_engine_versions_info - 描述特定数据库引擎版本的属性。

v7.5.0

发布摘要

此版本包括 iam_user_info 模块的新功能，cloudwatchlogs_log_group_info 和 s3_object 模块以及清单插件的错误修复，以及对 module_utils 的一些内部重构。

小的更改

• iam_user_info - 添加 login_profile 以返回从用户获取的信息，从而了解他们是否可以从 AWS 控制台登录（https://github.com/ansible-collections/amazon.aws/pull/2012）。

• module_utils.iam - 重构了规范化函数，以使用 boto3_resource_to_ansible_dict() 和 boto3_resource_list_to_ansible_dict() （https://github.com/ansible-collections/amazon.aws/pull/2006）。

• module_utils.transformations - 添加 boto3_resource_to_ansible_dict() 和 boto3_resource_list_to_ansible_dict() 辅助函数（https://github.com/ansible-collections/amazon.aws/pull/2006）。

Bugfixes

• cloudwatchlogs_log_group_info - 在进行 API 调用时实现指数退避，以防止出现限制异常（https://github.com/ansible-collections/amazon.aws/issues/2011）。

• plugin_utils.inventory - 确保查找插件中的模板化选项被转换（https://github.com/ansible-collections/amazon.aws/issues/1955）。

• s3_object - 修复复制对象时覆盖元数据的问题。（https://github.com/ansible-collections/amazon.aws/issues/1991）。

v7.4.0

发布摘要

此版本带来了一些错误修复和小的更改。它还引入了对 iam_role_info 插件的弃用。

小的更改

• AnsibeAWSModule - 添加了 fail_json_aws_error() 作为 fail_json() 和 fail_json_aws() 的包装器，当传递 AnsibleAWSError 异常时（https://github.com/ansible-collections/amazon.aws/pull/1997）。

• iam_access_key - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_access_key_info - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_group - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_instance_profile - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_instance_profile_info - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_managed_policy - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_mfa_device_info - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_role - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_role_info - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_user - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

• iam_user_info - 重构了代码以使用 AnsibleIAMError 和 IAMErrorHandler，并将共享代码移动到 module_utils.iam 中（https://github.com/ansible-collections/amazon.aws/pull/1998）。

已弃用的功能

• iam_role_info - 在 2026-05-01 之后的版本中，路径必须以 / 开头和结尾（https://github.com/ansible-collections/amazon.aws/pull/1998）。

Bugfixes

• cloudwatchevent_rule - 修复了避免为提供的 input_template 向 JSON 输入添加引号的问题（https://github.com/ansible-collections/amazon.aws/pull/1883）。

• lookup/secretsmanager_secret - 修复了当嵌套的 secret 丢失且 on_missing 设置为警告时，查找会引发错误而不是警告消息的问题（https://github.com/ansible-collections/amazon.aws/issues/1781）。

• module_utils/elbv2 - 修复了当使用 ClientSecret 参数和 UseExistingClientSecret=true 创建或修改负载均衡器规则类型 authenticate-oidc 时出现的问题（https://github.com/ansible-collections/amazon.aws/issues/1877）。

v7.3.0

发布摘要

amazon.aws 7.3.0 版本包含许多小的错误修复、一些新功能和改进。

小的更改

• backup_plan - 允许用户在使用 botocore >= 1.31.36 时为备份计划规则设置 schedule_expression_timezone（https://github.com/ansible-collections/amazon.aws/issues/1952）。

• iam_user - 重构了错误处理以使用装饰器（https://github.com/ansible-collections/amazon.aws/pull/1951）。

• lambda - 添加了对为函数使用 ECR 镜像的支持（https://github.com/ansible-collections/amazon.aws/pull/1939）。

• module_utils.errors - 添加了一个基本的错误处理程序装饰器（https://github.com/ansible-collections/amazon.aws/pull/1951）。

• rds_cluster - 添加了对 ServerlessV2ScalingConfiguration 的支持，以创建和修改集群操作（https://github.com/ansible-collections/amazon.aws/pull/1839）。

• s3_bucket_info - 添加了参数 bucket_versioning 以返回存储桶的版本控制状态（https://github.com/ansible-collections/amazon.aws/pull/1919）。

• s3_object_info - 修复了从空存储桶列出对象时引发的异常（https://github.com/ansible-collections/amazon.aws/pull/1919）。

Bugfixes

• backup_plan - 修复了当使用 botocore >= 1.31.36 时的幂等性问题（https://github.com/ansible-collections/amazon.aws/issues/1952）。

• plugins/inventory/aws_ec2 - 修复了当使用 use_ssm_inventory 获取超过 40 个实例的信息时失败的问题（https://github.com/ansible-collections/amazon.aws/issues/1713）。

v7.2.0

发布摘要

此版本包含新功能和一个错误修复。

小的更改

• ec2_instance - 添加了对修改现有实例的元数据选项的支持（https://github.com/ansible-collections/amazon.aws/pull/1918）。

• iam_group - 添加了对 name 和 path 的基本测试，以改进错误消息（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_group - 为了与其他 IAM 模块保持一致，添加了 group_name 作为 name 的别名（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_instance_profile - 添加了对 name 和 path 的基本测试，以改进错误消息（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_instance_profile - 添加了对 name 和 path 的基本测试，以改进错误消息（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_instance_profile - 尝试更改现有配置文件的 path 现在将生成警告，以前这会被静默忽略（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_instance_profile - 为了与其他 IAM 模块保持一致，prefix 参数已重命名为 path，prefix 仍然作为别名。不需要更改 playbook（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_instance_profile - 删除了 path 的默认值。新创建的实例仍将使用默认路径 /。无需更改 playbook（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_managed_policy - 添加了对 name 和 path 的基本测试，以改进错误消息（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_managed_policy - 尝试更新 description 现在会产生警告，以前会被直接忽略（https://github.com/ansible-collections/amazon.aws/pull/1936）。

• iam_managed_policy - policy 不再是必需参数（https://github.com/ansible-collections/amazon.aws/pull/1936）。

• iam_managed_policy - 添加了对托管策略进行标签的支持（https://github.com/ansible-collections/amazon.aws/pull/1936）。

• iam_managed_policy - 在速率限制错误时更一致地执行重试（https://github.com/ansible-collections/amazon.aws/pull/1936）。

• iam_managed_policy - 支持设置 path（https://github.com/ansible-collections/amazon.aws/pull/1936）。

• iam_managed_policy - 为了与其他 IAM 模块保持一致，policy_description 参数已重命名为 description，policy_description 仍然保留为别名。无需更改 playbook（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_managed_policy - 为了与其他 IAM 模块保持一致，policy_name 参数已重命名为 name，policy_name 仍然保留为别名。无需更改 playbook（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role - 添加了对 name 和 path 的基本测试，以改进错误消息（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role - 为了与其他 IAM 模块保持一致，添加了 prefix 和 path_prefix 作为 path 的别名（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role - 为了与其他 IAM 模块保持一致，添加了 role_name 作为 name 的别名（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role - 尝试更改现有配置文件的 path 现在将生成警告，以前会被静默忽略（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role - 删除了 path 的默认值。新创建的角色仍将使用默认路径 /。无需更改 playbook（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role_info - 为了与其他 IAM 模块保持一致，添加了 path 和 prefix 作为 path_prefix 的别名（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_user - 添加了对 name 和 path 的基本测试，以改进错误消息（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_user - 为了与其他 IAM 模块保持一致，添加了 user_name 作为 name 的别名（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_user - 添加了 boundary 参数，以支持管理用户的边界策略（https://github.com/ansible-collections/amazon.aws/pull/1912）。

• iam_user - 添加了 path 参数，以支持管理用户路径（https://github.com/ansible-collections/amazon.aws/pull/1912）。

• iam_user - 添加了 attached_policies 到返回值中（https://github.com/ansible-collections/amazon.aws/pull/1912）。

• iam_user - 重构了代码以降低复杂性（https://github.com/ansible-collections/amazon.aws/pull/1912）。

• iam_user_info - 为了与其他 IAM 模块保持一致，添加了 prefix 作为 path_prefix 的别名（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_user_info - 为了与其他 IAM 模块保持一致，path 参数已重命名为 path_prefix，path 仍然保留为别名。无需更改 playbook（https://github.com/ansible-collections/amazon.aws/pull/1933）。

错误修复

• iam_managed_policy - 修复了只返回部分结果的问题（https://github.com/ansible-collections/amazon.aws/pull/1936）。

v7.1.0

发布摘要

此版本带来了一些新功能和多个错误修复。

次要更改

• autoscaling_group - 修复了小的 PEP8 空格问题（https://github.com/ansible-collections/amazon.aws/pull/1846）。

• ec2_ami_info - 简化 get_image_attribute 的参数，只传递镜像的 ID（https://github.com/ansible-collections/amazon.aws/pull/1846）。

• ec2_eip - 使用 ResourceTags 在创建时设置初始标签（https://github.com/ansible-collections/amazon.aws/issues/1843）。

• ec2_instance - 添加了在创建实例时支持 AdditionalInfo 选项的功能（https://github.com/ansible-collections/amazon.aws/pull/1828）。

• ec2_security_group - 使用 ResourceTags 在创建时设置初始标签（https://github.com/ansible-collections/amazon.aws/pull/1844）。

• ec2_vpc_igw - 使用 ResourceTags 在创建时设置初始标签（https://github.com/ansible-collections/amazon.aws/issues/1843）。

• ec2_vpc_route_table - 使用 ResourceTags 在创建时设置初始标签（https://github.com/ansible-collections/amazon.aws/issues/1843）。

• ec2_vpc_subnet - tags 的默认值已从 {} 更改为 None，要从子网删除标签，必须将空映射显式传递给模块（https://github.com/ansible-collections/amazon.aws/pull/1876）。

• ec2_vpc_subnet - 使用 ResourceTags 在创建时设置初始标签（https://github.com/ansible-collections/amazon.aws/issues/1843）。

• ec2_vpc_subnet - 使用 wait_timeout 来控制等待子网初始创建的最大时间（https://github.com/ansible-collections/amazon.aws/pull/1848）。

• iam_group - 添加了设置组路径的支持（https://github.com/ansible-collections/amazon.aws/pull/1892）。

• iam_group - 添加了 attached_policies 返回值（https://github.com/ansible-collections/amazon.aws/pull/1892）。

• iam_group - 重构了代码以避免单个长函数（https://github.com/ansible-collections/amazon.aws/pull/1892）。

• rds_instance_snapshot - 修复了小的 PEP8 空格问题（https://github.com/ansible-collections/amazon.aws/pull/1846）。

错误修复

• ec2_vpc_subnet - 清理了在子网未及时创建时处理失败的情况（https://github.com/ansible-collections/amazon.aws/pull/1848）。

• s3_object - 修复了当设置 overwrite=latest 时导致虚假弃用警告的拼写错误（https://github.com/ansible-collections/amazon.aws/pull/1847）。

• s3_object - 在执行 put 操作并指定元数据中的 Content-Type 时，此模块（自 6.0.0 起）错误地将 Content-Type 设置为 None，导致 put 操作失败。修复程序现在可以正确识别指定的 Content-Type（https://github.com/ansible-collections/amazon.aws/issues/1881）。

v7.0.0

发布摘要

此主要版本带来了一组新的受支持模块，这些模块已从 community.aws 提升而来，同时修复了一些错误，进行了细微更改，并弃用了一些功能。我们还停止支持 botocore<1.29.0 和 boto3<1.26.0。由于 AWS SDK 宣布停止支持 Python 3.7 以下的版本（https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/），此集合在 6.0.0 版本中已弃用对 Python 3.7 以下版本的支持，并在此版本中删除。

主要变更

• aws_region_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.aws_region_info。

• aws_s3_bucket_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.aws_s3_bucket_info。

• iam_access_key - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_access_key。

• iam_access_key_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_access_key_info。

• iam_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_group (https://github.com/ansible-collections/amazon.aws/pull/1755)。

• iam_managed_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_managed_policy (https://github.com/ansible-collections/amazon.aws/pull/1762)。

• iam_mfa_device_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_mfa_device_info (https://github.com/ansible-collections/amazon.aws/pull/1761)。

• iam_password_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_password_policy。

• iam_role - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_role (https://github.com/ansible-collections/amazon.aws/pull/1760)。

• iam_role_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_role_info (https://github.com/ansible-collections/amazon.aws/pull/1760)。

• s3_bucket_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.s3_bucket_info。

• sts_assume_role - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.sts_assume_role。

细微更改

• amazon.aws 集合 - 应用 isort 代码格式化以确保代码格式一致 (https://github.com/ansible-collections/amazon.aws/pull/1771)。

• ec2_instance - 在运行实例规范中添加对其他 placement 选项和 license_specifications 的支持 (https://github.com/ansible-collections/amazon.aws/issues/1824)。

• ec2_instance_info - 添加新参数 include_attributes 来描述实例属性 (https://github.com/ansible-collections/amazon.aws/pull/1577)。

• ec2_metadata_facts - 在适当的地方使用 fstrings (https://github.com/ansible-collections/amazon.aws/pull/1802)。

• ec2_vpc_igw - 添加将 VPC 连接/断开连接到/从 Internet 网关的功能 (https://github.com/ansible-collections/amazon.aws/pull/1786)。

• ec2_vpc_igw - 添加更改连接到 Internet 网关的 VPC 的功能 (https://github.com/ansible-collections/amazon.aws/pull/1786)。

• ec2_vpc_igw - 添加创建不连接 VPC 的 Internet 网关的功能 (https://github.com/ansible-collections/amazon.aws/pull/1786)。

• ec2_vpc_igw - 添加使用网关 ID 删除 VPC Internet 网关的功能 (https://github.com/ansible-collections/amazon.aws/pull/1786)。

• elb_application_lb_info - 添加新参数 include_attributes、include_listeners 和 include_listener_rules，以便通过减少获取的信息来选择性地加速模块 (https://github.com/ansible-collections/amazon.aws/pull/1778)。

• module_utils.botocore - 从 LooseVersion 的供应商副本迁移到 packaging.version.Version (https://github.com/ansible-collections/amazon.aws/pull/1587)。

• rds_cluster - 添加从全局数据库中删除集群的支持 (https://github.com/ansible-collections/amazon.aws/pull/1705)。

• rds_cluster - 添加对另一个名为 started 的 state 选择的支持。这将启动 rds 集群 (https://github.com/ansible-collections/amazon.aws/pull/1647/files)。

• rds_cluster - 添加对另一个名为 stopped 的 state 选择的支持。这将停止 rds 集群 (https://github.com/ansible-collections/amazon.aws/pull/1647/files)。

• route53 - 在完成更改时添加一个 wait_id 返回值 (https://github.com/ansible-collections/amazon.aws/pull/1683)。

• route53_health_check - 添加对名为 child_health_checks 的字符串列表参数的支持，以指定计算的运行状况检查必须正常的运行状况检查 (https://github.com/ansible-collections/amazon.aws/pull/1631)。

• route53_health_check - 添加对名为 health_threshold 的整数参数的支持，以指定计算的运行状况检查必须正常的最小运行状况检查数 (https://github.com/ansible-collections/amazon.aws/pull/1631)。

• route53_health_check - 添加对另一个名为 CALCULATED 的 type 选择的支持 (https://github.com/ansible-collections/amazon.aws/pull/1631)。

• s3_object - 允许递归复制 S3 存储桶中的对象 (https://github.com/ansible-collections/amazon.aws/issues/1379)。

• s3_object - 在适当的地方使用 fstrings (https://github.com/ansible-collections/amazon.aws/pull/1802)。

重大更改/移植指南

• amazon.aws 集合已停止支持 botocore<1.29.0 和 boto3<1.26.0。大多数模块将继续使用较旧版本的 AWS SDK，但是不保证与较旧版本的 SDK 的兼容性，并且不会对其进行测试。使用较旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/1763)。

• amazon.aws 集合 - 由于 AWS SDK 宣布停止支持 Python 3.7 以下版本（https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/），此集合在 6.0.0 版本中已弃用对 Python 3.7 以下版本的支持，并在 7.0.0 版本中删除。(https://github.com/ansible-collections/amazon.aws/pull/1763)。

• module_utils - module_utils.urls 以前已弃用，现在已删除 (https://github.com/ansible-collections/amazon.aws/pull/1540)。

• module_utils._version - distutils.version 的供应商副本已删除 (https://github.com/ansible-collections/amazon.aws/pull/1587)。

已弃用功能

• ec2_instance - 弃用 tenancy 和 placement_group，转而使用 placement 属性 (https://github.com/ansible-collections/amazon.aws/pull/1825)。

Bug 修复

• aws_ec2 清单插件 - 修复当未提供区域且未指定区域时出现的 NoRegionError 错误 (https://github.com/ansible-collections/amazon.aws/issues/1551)。

• ec2_instance - 如果收到 InvalidInstanceID.NotFound 错误，则重试 API 调用 (https://github.com/ansible-collections/amazon.aws/pull/1650)。

• ec2_vpc_route_table_info - 将默认过滤器设置为空字典 (https://github.com/ansible-collections/amazon.aws/issues/1668)。

• s3_bucket - 修复删除具有未版本化对象的存储桶时出现的问题 (https://github.com/ansible-collections/amazon.aws/issues/1533)。

• s3_object - 修复当 S3 端点不支持标签时出现的 NoSuchTagSet 错误 (https://github.com/ansible-collections/amazon.aws/issues/1607)。

• s3_object - 修复与以 / 开头的对象相关的回归问题 (https://github.com/ansible-collections/amazon.aws/issues/1548)。

新模块

• ec2_import_image - 管理 AWS EC2 导入镜像任务

• ec2_import_image_info - 收集关于导入虚拟机任务的信息

• rds_global_cluster_info - 获取关于 Aurora 全球数据库集群的信息

v6.5.4

发布摘要

此版本包括对 cloudwatchlogs_log_group_info 模块和清单插件的错误修复。

错误修复

• cloudwatchlogs_log_group_info - 在进行 API 调用时实现指数退避，以防止出现限制异常（https://github.com/ansible-collections/amazon.aws/issues/2011）。

• plugin_utils.inventory - 确保查找插件中的模板化选项被转换（https://github.com/ansible-collections/amazon.aws/issues/1955）。

v6.5.3

发布摘要

此版本包括对 ``cloudwatchevent_rule`` 模块和 secretsmanager_secret 查询插件的错误修复。

错误修复

• cloudwatchevent_rule - 修复了避免为提供的 input_template 向 JSON 输入添加引号的问题（https://github.com/ansible-collections/amazon.aws/pull/1883）。

• lookup/secretsmanager_secret - 修复了当嵌套的 secret 丢失且 on_missing 设置为警告时，查找会引发错误而不是警告消息的问题（https://github.com/ansible-collections/amazon.aws/issues/1781）。

v6.5.2

发布摘要

此版本包括对 amazon.aws.aws_ec2 清单插件的错误修复，该修复是在使用 use_ssm_inventory 检索超过 40 个实例的信息时出现的。

错误修复

• plugins/inventory/aws_ec2 - 修复了当使用 use_ssm_inventory 获取超过 40 个实例的信息时失败的问题（https://github.com/ansible-collections/amazon.aws/issues/1713）。

v6.5.1

发布摘要

此版本包括多个错误修复。

次要更改

• ec2_vpc_subnet - 使用 wait_timeout 来控制等待子网初始创建的最大时间（https://github.com/ansible-collections/amazon.aws/pull/1848）。

错误修复

• ec2_instance - 如果收到 InvalidInstanceID.NotFound 错误，则重试 API 调用 (https://github.com/ansible-collections/amazon.aws/pull/1650)。

• ec2_vpc_subnet - 清理了在子网未及时创建时处理失败的情况（https://github.com/ansible-collections/amazon.aws/pull/1848）。

• s3_object - 修复了当设置 overwrite=latest 时导致虚假弃用警告的拼写错误（https://github.com/ansible-collections/amazon.aws/pull/1847）。

• s3_object - 修复当 S3 端点不支持标签时出现的 NoSuchTagSet 错误 (https://github.com/ansible-collections/amazon.aws/issues/1607)。

• s3_object - 在执行 put 操作并指定元数据中的 Content-Type 时，此模块（自 6.0.0 起）错误地将 Content-Type 设置为 None，导致 put 操作失败。修复程序现在可以正确识别指定的 Content-Type（https://github.com/ansible-collections/amazon.aws/issues/1881）。

v6.5.0

发布摘要

此版本是计划在 7.0.0 版本发布之前 amazon.aws 的最后一个次要版本。它包括文档修复，以及对 ec2_ami 和 elb_application_lb_info 模块的次要更改和错误修复。

次要更改

• ec2_ami - 在启动权限中添加对 org_arns 和 org_unit_arns 的支持 (https://github.com/ansible-collections/amazon.aws/pull/1690)。

• elb_application_lb_info - 删除获取 ip_address_type 的冗余 describe_load_balancers 调用 (https://github.com/ansible-collections/amazon.aws/pull/1768)。

错误修复

• elb_application_lb_info - 确保所有 API 查询都使用重试装饰器 (https://github.com/ansible-collections/amazon.aws/issues/1767)。

v6.4.0

发布摘要

此版本带来一个名为 amazon.aws.ec2_key_info 的新模块、一些文档改进、新功能和错误修复。

次要更改

• cloudformation - 添加对在更新堆栈操作时使用 disable_rollback 的支持 (https://github.com/ansible-collections/amazon.aws/issues/1681)。

• ec2_key - 添加对新参数 file_name 的支持，以便在 AWS 创建新密钥时保存私钥。当提供此选项时，生成的私钥将从模块返回中删除 (https://github.com/ansible-collections/amazon.aws/pull/1704)。

错误修复

• backup_selection - 确保更新现有选择时，如果以前没有任何 Conditions，则会添加新的 Conditions (https://github.com/ansible-collections/amazon.aws/pull/1701)。

新模块

• ec2_key_info - 收集关于 AWS 中 EC2 密钥对的信息

v6.3.0

发布摘要

此版本带来了一些新功能和多个错误修复。

次要更改

• rds_cluster - 添加对另一个名为 started 的 state 选择的支持。这将启动 rds 集群 (https://github.com/ansible-collections/amazon.aws/pull/1647/files)。

• rds_cluster - 添加对另一个名为 stopped 的 state 选择的支持。这将停止 rds 集群 (https://github.com/ansible-collections/amazon.aws/pull/1647/files)。

• route53 - 在完成更改时添加一个 wait_id 返回值 (https://github.com/ansible-collections/amazon.aws/pull/1683)。

• route53_health_check - 添加对名为 child_health_checks 的字符串列表参数的支持，以指定计算的运行状况检查必须正常的运行状况检查 (https://github.com/ansible-collections/amazon.aws/pull/1631)。

• route53_health_check - 添加对名为 health_threshold 的整数参数的支持，以指定计算的运行状况检查必须正常的最小运行状况检查数 (https://github.com/ansible-collections/amazon.aws/pull/1631)。

• route53_health_check - 添加对另一个名为 CALCULATED 的 type 选择的支持 (https://github.com/ansible-collections/amazon.aws/pull/1631)。

错误修复

• ec2_vpc_route_table_info - 将默认过滤器设置为空字典 (https://github.com/ansible-collections/amazon.aws/issues/1668)。

• rds_cluster - 将 AllocatedStorage、DBClusterInstanceClass、StorageType、Iops 和 EngineMode 添加到创建或修改多可用区 RDS 集群时可以传递的参数列表中 (https://github.com/ansible-collections/amazon.aws/pull/1657)。

• rds_cluster - 允许在创建时将 GlobalClusterIdentifier 传递给 rds 集群 (https://github.com/ansible-collections/amazon.aws/pull/1663)。

v6.2.0

发布摘要

此版本带来了一些新模块、新功能和多个错误修复。

次要更改

• backup_selection - 为所有条件子选项添加验证和文档 (https://github.com/ansible-collections/amazon.aws/pull/1633)。

• ec2_instance - 重构 ARN 验证处理 (https://github.com/ansible-collections/amazon.aws/pull/1619)。

• iam_user - 重构 ARN 验证处理 (https://github.com/ansible-collections/amazon.aws/pull/1619)。

• module_utils.arn - 将 resource_id 和 resource_type 添加到 parse_aws_arn 返回值中 (https://github.com/ansible-collections/amazon.aws/pull/1619)。

• module_utils.arn - 添加了 validate_aws_arn 函数，用于处理 ARN 的常见模式匹配 (https://github.com/ansible-collections/amazon.aws/pull/1619)。

错误修复

• backup_plan - 使用 module_utils 中现有的 scrub_none_values 函数从提供的参数中的嵌套字典中删除 None 值。嵌套的 None 值被保留，并在发送到 boto3 客户端操作时导致错误 (https://github.com/ansible-collections/amazon.aws/pull/1611)。

• backup_vault - 通过使用正确的 boto3 客户端方法标记和取消标记备份资源来修复更新备份保管库上的标签时出现的错误 (https://github.com/ansible-collections/amazon.aws/pull/1610)。

• cloudwatchevent_rule - 修复当未进行任何更改时，更改状态报告为 False 的问题。该模块错误地总是报告有更改。(https://github.com/ansible-collections/amazon.aws/pull/1589)

• ec2_vpc_nat_gateway - 添加一个名为 default_create 的布尔参数，允许用户选择是否要在找不到 EIP 地址时显示错误消息或创建 NAT 网关。如果 EIP 不存在，该模块 (ec2_vpc_nat_gateway) 会错误地静默失败 (https://github.com/ansible-collections/amazon.aws/issues/1295)。

• ec2_vpc_nat_gateway - 修复 NAT 网关，以便当用户创建私有 NAT 网关时，不应分配弹性 IP 地址。该模块错误地在创建私有 NAT 网关时总是分配弹性 IP 地址 (https://github.com/ansible-collections/amazon.aws/pull/1632)。

• lambda_execute - 修复堆栈跟踪输出中的问题，即它在每个字符之间不包含空格。该模块错误地总是在每个字符之间输出额外的空格。(https://github.com/ansible-collections/amazon.aws/pull/1615)

• module_utils.backup - get_selection_details 修复当存在多个备份选择时返回空列表的问题 (https://github.com/ansible-collections/amazon.aws/pull/1633)。

新模块

• iam_instance_profile - 管理 IAM 实例配置文件

• iam_instance_profile_info - 收集关于 IAM 实例配置文件的信息

v6.1.0

发布摘要

此版本带来了一些新功能、多个错误修复，并且还包括已弃用的功能。

次要更改

• ec2_snapshot - 添加修改 createVolumePermission 的支持 (https://github.com/ansible-collections/amazon.aws/pull/1464)。

• ec2_snapshot_info - 将 createVolumePermission 添加到输出结果中 (https://github.com/ansible-collections/amazon.aws/pull/1464)。

已弃用功能

• s3_object - 已弃用支持传递带有前导 / 的对象键，并将在 2025-12-01 之后的版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/1549)。

Bug 修复

• autoscaling_group - 修复描述附加了超过 20 个目标组的自动伸缩组时出现的 ValidationError，方法是将请求分解为块 (https://github.com/ansible-collections/amazon.aws/pull/1593)。

• autoscaling_group_info - 修复描述附加了超过 20 个目标组的自动伸缩组时出现的 ValidationError，方法是将请求分解为块 (https://github.com/ansible-collections/amazon.aws/pull/1593)。

• ec2_instance - 修复添加网络接口时 check_mode 的问题 (https://github.com/ansible-collections/amazon.aws/issues/1403)。

• ec2_metadata_facts - 处理当 EC2 实例用户数据使用 gzip 压缩时的解压缩。ansible.module_utils.urls 中的 fetch_url 方法不会解压缩用户数据，除非标头明确包含 Content-Encoding: gzip (https://github.com/ansible-collections/amazon.aws/pull/1575)。

• elb_application_lb - 修复创建 ALB 时缺少属性的问题。create_or_update_alb() 在更新现有 ALB 时会包含 ALB 特定的属性，但在创建新的 ALB 时不会包含 (https://github.com/ansible-collections/amazon.aws/issues/1510)。

• module_utils.acm - 修复 list_certificates 只返回 RSA_2048 证书的问题 (https://github.com/ansible-collections/amazon.aws/issues/1567)。

• rds_instance - 添加对 CACertificateIdentifier 的支持，以便创建/更新 rds 实例 (https://github.com/ansible-collections/amazon.aws/pull/1459)。

v6.0.1

版本摘要

这是一个补丁版本，其中包含对 aws_ec2 清单插件以及 s3_bucket 和 s3_object 模块的一些错误修复。

Bug 修复

• aws_ec2 清单插件 - 修复当未提供区域且未指定区域时出现的 NoRegionError 错误 (https://github.com/ansible-collections/amazon.aws/issues/1551)。

• s3_bucket - 修复删除具有未版本化对象的存储桶时出现的问题 (https://github.com/ansible-collections/amazon.aws/issues/1533)。

• s3_object - 修复与以 / 开头的对象相关的回归问题 (https://github.com/ansible-collections/amazon.aws/issues/1548)。

v6.0.0

版本摘要

此版本带来了一些新的插件和功能。还包括一些错误修复、重大更改和已弃用的功能。amazon.aws 集合已放弃对 botocore<1.25.0 和 boto3<1.22.0 的支持。也已放弃对 Python 3.6 的支持。

次要更改

• 添加 github actions 以运行单元测试和健全性测试。( https://github.com/ansible-collections/amazon.aws/pull/1393)。

• AnsibleAWSModule - 添加对 client 和 resource 方法的支持，以覆盖默认参数 (https://github.com/ansible-collections/amazon.aws/pull/1303)。

• CONTRIBUTING.md - 重构并添加到贡献者文档中 (https://github.com/ansible-collections/amazon.aws/issues/924)

• 重构清单插件并添加 aws_rds 清单单元测试 (https://github.com/ansible-collections/amazon.aws/pull/1218)。

• 重构 module_utils/cloudfront_facts.py 并添加单元测试 (https://github.com/ansible-collections/amazon.aws/pull/1265)。

• 已在集合中运行 black 代码格式化程序，以提高代码一致性 (https://github.com/ansible-collections/amazon.aws/pull/1465)。

• amazon.aws 清单插件 - 对清单插件连接处理的额外重构 (https://github.com/ansible-collections/amazon.aws/pull/1271)。

• amazon.aws 查找插件 - 为了模块和插件之间的一致性，aws_access_key 已重命名为 access_key，aws_access_key 仍然作为别名存在。此更改对模块/插件文档之外的用户应该没有可观察到的影响 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• amazon.aws 查找插件 - 为了模块和插件之间的一致性，aws_profile 已重命名为 profile，aws_profile 仍然作为别名存在。此更改对模块/插件文档之外的用户应该没有可观察到的影响 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• amazon.aws 查找插件 - 为了模块和插件之间的一致性，aws_secret_key 已重命名为 secret_key，aws_secret_key 仍然作为别名存在。此更改对模块/插件文档之外的用户应该没有可观察到的影响 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• amazon.aws 查找插件 - 为了模块和插件之间的一致性，aws_security_token 已重命名为 session_token，aws_security_token 仍然作为别名存在。此更改对模块/插件文档之外的用户应该没有可观察到的影响 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• amazon.aws 模块 - 在各种重构之后批量更新 import 语句 (https://github.com/ansible-collections/amazon.aws/pull/1310)。

• autoscaling_group - 次要 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• aws_account_attribute - 已重构 aws_account_attribute 查找插件以使用 AWSLookupBase 作为其基类 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• aws_ec2 清单 - 次要 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• aws_secret - 已重构 aws_secret 查找插件以使用 AWSLookupBase 作为其基类 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• aws_secret - aws_secret 查找插件已重命名为 secretsmanager_secret，aws_secret 仍然作为别名存在 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• aws_ssm - 已重构 aws_ssm 查找插件以使用 AWSLookupBase 作为其基类 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• aws_ssm - aws_ssm 查找插件已重命名为 ssm_parameter，aws_ssm 仍然作为别名存在 (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• backup - 为 backup_selection* 模块添加逻辑 (https://github.com/ansible-collections/amazon.aws/pull/1530)。

• 批量迁移 % 和 .format() 到 fstrings (https://github.com/ansible-collections/amazon.aws/pull/1483)。

• cloud module_utils - 次要 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• cloudtrail_info - 次要 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• cloudwatchlogs_log_group - 次要 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• docs_fragments - amazon.aws.boto3 片段现在从 module_utils.botocore 中提取 botocore 版本要求 (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• docs_fragments - 模块和插件的常用参数已同步并移动到 amazon.aws.common.modules 和 amazon.aws.common.plugins (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• docs_fragments - 模块和插件的区域参数已同步并移动到 amazon.aws.region.modules 和 amazon.aws.region.plugins (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• ec2_ami - 扩展了模块的单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1159)。

• ec2_ami - 允许在找不到镜像时 ImageAvailable 等待器重试 (https://github.com/ansible-collections/amazon.aws/pull/1321)。

• ec2_ami_info - 添加单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1252)。

• ec2_eip - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• ec2_eni_info - 添加单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1236)。

• ec2_instance - 避免更改 module.params (https://github.com/ansible-collections/amazon.aws/pull/1187)。

• ec2_instance - 更新为避免操作 module.params (https://github.com/ansible-collections/amazon.aws/pull/1337)。

• ec2_security_group - 向参数规范添加了规则选项，以改进输入处理 (https://github.com/ansible-collections/amazon.aws/pull/1214)。

• ec2_security_group - 重构 get_target_from_rule() (https://github.com/ansible-collections/amazon.aws/pull/1221)。

• ec2_security_group - 重构规则扩展并添加单元测试 (https://github.com/ansible-collections/amazon.aws/pull/1261)。

• ec2_snapshot - 重新启用集成测试 (https://github.com/ansible-collections/amazon.aws/pull/1235)。

• ec2_snapshot_info - 添加单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1211)。

• ec2_vpc_route_table - 添加对运营商网关条目的支持 (https://github.com/ansible-collections/amazon.aws/pull/926)。

• ec2_vpc_subnet - 如果第一次尝试失败，则在创建后重试获取子网详细信息 (https://github.com/ansible-collections/amazon.aws/pull/1526)。

• inventory aws ec2 - 添加参数 use_ssm_inventory，允许查询已配置的 EC2 实例的 ssm 清单信息并填充主机变量 (https://github.com/ansible-collections/amazon.aws/issues/704)。

• inventory plugins - 重构缓存处理 (https://github.com/ansible-collections/amazon.aws/pull/1285)。

• inventory plugins - 重构文件验证处理 (https://github.com/ansible-collections/amazon.aws/pull/1285)。

• inventory_aws_ec2 integration tests - 将本地模块 test_get_ssm_inventory 替换为 community.aws.ssm_inventory_info (https://github.com/ansible-collections/amazon.aws/pull/1416)。

• kms_key_info - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• lambda - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• lambda - 使用通用的 get_aws_account_info 助手，而不是重新实现 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• lambda_alias - 重构为避免传递复杂的 module 资源 (https://github.com/ansible-collections/amazon.aws/pull/1336)。

• lambda_alias - 更新为避免操作 module.params (https://github.com/ansible-collections/amazon.aws/pull/1336)。

• lambda_execute - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• lambda_info - 更新为避免操作 module.params (https://github.com/ansible-collections/amazon.aws/pull/1336)。

• lambda_layer_info - 添加对参数 version_number 的支持，以检索特定图层版本的详细信息 (https://github.com/ansible-collections/amazon.aws/pull/1293)。

• module_utils - 将 RetryingBotoClientWrapper 移动到 module_utils.retries 中，以便与其他插件类型重用 (https://github.com/ansible-collections/amazon.aws/pull/1230)。

• module_utils - 将异常移动到专用的 Python 模块 (https://github.com/ansible-collections/amazon.aws/pull/1246)。

• module_utils - 重构 botocore 版本验证到 module_utils.botocore 中，以便将来重用 (https://github.com/ansible-collections/amazon.aws/pull/1227)。

• module_utils.acm - 重构 ACMServiceManager 类并添加单元测试 (https://github.com/ansible-collections/amazon.aws/pull/1273)。

• module_utils.botocore - 添加 Ansible AWS 用户代理标识 (https://github.com/ansible-collections/amazon.aws/pull/1306)。

• module_utils.botocore - 重构 get_aws_region, get_aws_connection_info，以便代码可以被非模块插件重用 (https://github.com/ansible-collections/amazon.aws/pull/1231)。

• module_utils.policy - 对代码进行少量重构，以降低复杂性并提高测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1136)。

• module_utils.s3 - 将 get_s3_connection 重构为 S3 模块的 module_utils，并扩展 module_utils.s3 单元测试 (https://github.com/ansible-collections/amazon.aws/pull/1139)。

• module_utils/botocore - 为传递配置字典的 _boto3_conn 添加了支持 (https://github.com/ansible-collections/amazon.aws/pull/1307)。

• plugin_utils - 添加了 AWSConnectionBase 以支持重构连接插件 (https://github.com/ansible-collections/amazon.aws/pull/1340)。

• rds - AWS 正在逐步淘汰 aurora1。集成测试默认使用 aurora2 (aurora-mysql) (https://github.com/ansible-collections/amazon.aws/pull/1233)。

• rds_cluster - 将功能测试拆分为更小的目标 (https://github.com/ansible-collections/amazon.aws/pull/1175)。

• rds_cluster_snapshot - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• rds_instance - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• rds_instance_info - 添加单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1132)。

• rds_instance_snapshot - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• rds_param_group - 删除 Python2 导入回退 (https://github.com/ansible-collections/amazon.aws/pull/1513)。

• route53_health_check - 删除弃用警告 (https://github.com/ansible-collections/community.aws/pull/1335)。

• route53_health_check - 在更新 Route53 运行状况检查时，对返回运行状况检查信息的次要修复 (https://github.com/ansible-collections/amazon.aws/pull/1200)。

• route53_health_check - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• route53_info - 删除未使用的导入 (https://github.com/ansible-collections/amazon.aws/pull/1462)。

• s3_bucket - 添加对 S3 双堆栈端点的支持 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

• s3_bucket - 尽可能更优雅地处理缺少读取权限的情况 (https://github.com/ansible-collections/amazon.aws/pull/1406)。

• s3_bucket - 重构 S3 连接代码 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

• s3_object - 重构 S3 连接代码 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

• s3_object - 重构 main 以降低复杂性 (https://github.com/ansible-collections/amazon.aws/pull/1193)。

• s3_object_info - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• s3_object_info - 重构 S3 连接代码 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

重大更改/移植指南

• amazon.aws 集合已放弃对 botocore<1.25.0 和 boto3<1.22.0 的支持。大多数模块将继续使用旧版本的 AWS SDK，但是不保证与旧版本的 SDK 兼容，并且不会对其进行测试。使用旧版本的 SDK 时，Ansible 会发出警告 (https://github.com/ansible-collections/amazon.aws/pull/1342)。

• amazon.aws - 已移除对 Python < 3.6 的兼容性代码 (https://github.com/ansible-collections/amazon.aws/pull/1257)。

• ec2_eip - 之前已弃用的 instance_id 参数的别名已移除，请改用 device_id 参数名称 (https://github.com/ansible-collections/amazon.aws/issues/1176)。

• ec2_instance - instance_type 的默认值已被删除。启动新实例时，必须指定 instance_type 或 launch_template 中的至少一个 (https://github.com/ansible-collections/amazon.aws/pull/1315)。

• ec2_vpc_dhcp_options - new_options 返回值在重命名为 dhcp_config 后已被弃用。请使用 dhcp_config 或 dhcp_options 返回值 (https://github.com/ansible-collections/amazon.aws/pull/1327)。

• ec2_vpc_endpoint - policy_file 参数已被删除。可以使用带文件查找的 I(policy) 代替 (https://github.com/ansible-collections/amazon.aws/issues/1178)。

• ec2_vpc_net - classic_link_enabled 返回值已被删除。AWS 已停止对 EC2 Classic 联网的支持 (https://github.com/ansible-collections/amazon.aws/pull/1374)。

• ec2_vpc_net_info - classic_link_dns_status 返回值已被删除。AWS 已停止对 EC2 Classic 联网的支持 (https://github.com/ansible-collections/amazon.aws/pull/1374)。

• ec2_vpc_net_info - classic_link_enabled 返回值已被删除。AWS 已停止对 EC2 Classic 联网的支持 (https://github.com/ansible-collections/amazon.aws/pull/1374)。

• module_utils.cloud - 之前已弃用的 CloudRetry.backoff 已被删除。请改用 CloudRetry.exponential_backoff 或 CloudRetry.jittered_backoff (https://github.com/ansible-collections/amazon.aws/issues/1110)。

已弃用功能

• amazon.aws 集合 - 由于 AWS SDK 的 Python 支持策略 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)，预计此集合将在 2024-12-01 之后的版本中移除对 Python 3.8 以下版本的支持 (https://github.com/ansible-collections/amazon.aws/pull/1342)。

• amazon.aws 集合 - 由于 AWS SDK 宣布结束对 Python 3.7 以下版本的支持 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)，此集合已弃用对 Python 3.7 以下版本的支持，并将在 7.0.0 版本中删除。 (https://github.com/ansible-collections/amazon.aws/pull/1342)。

• amazon.aws 查找插件 - boto3_profile 选项的别名 profile 已被弃用，请改用 profile (https://github.com/ansible-collections/amazon.aws/pull/1225)。

• docs_fragments - amazon.aws.aws_credentials 文档片段已被弃用，请改用 amazon.aws.common.plugins (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• docs_fragments - amazon.aws.aws_region 文档片段已被弃用，请改用 amazon.aws.region.plugins (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• docs_fragments - amazon.aws.aws 文档片段已被弃用，请改用 amazon.aws.common.modules (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• docs_fragments - amazon.aws.ec2 文档片段已被弃用，请改用 amazon.aws.region.modules (https://github.com/ansible-collections/amazon.aws/pull/1248)。

• module_utils.policy - ansible_collections.amazon.aws.module_utils.policy.sort_json_policy_dict 已被弃用，请考虑改用 ansible_collections.amazon.aws.module_utils.poilcies.compare_policies (https://github.com/ansible-collections/amazon.aws/pull/1136)。

• s3_object - 已弃用同时传递 dualstack 和 endpoint_url 的支持，当传递 endpoint_url 时，dualstack 参数将被忽略。该支持将在 2024-12-01 之后的版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

• s3_object - 已弃用传递除 always、never、different 或 last 之外的 overwrite 值的支持。布尔值应替换为字符串 always 或 never。该支持将在 2024-12-01 之后的版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

• s3_object_info - 已弃用同时传递 dualstack 和 endpoint_url 的支持，当传递 endpoint_url 时，dualstack 参数将被忽略。该支持将在 2024-12-01 之后的版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/1305)。

已删除功能（之前已弃用）

• ec2_vpc_endpoint_info - 已删除对 query 参数的支持。amazon.aws.ec2_vpc_endpoint_info 模块现在仅查询端点。可以使用 amazon.aws.ec2_vpc_endpoint_service_info 模块查询服务 (https://github.com/ansible-collections/amazon.aws/pull/1308)。

• s3_object - 已删除使用 s3_object 模块创建和删除存储桶的支持。可以使用 amazon.aws.s3_bucket 模块创建和删除 S3 存储桶 (https://github.com/ansible-collections/amazon.aws/issues/1112)。

Bug修复

• ec2_security_group - 文件包含无法访问的代码。现在的修复通过删除不合适的逻辑来移除无法访问的代码 (https://github.com/ansible-collections/amazon.aws/pull/1348)。

• ec2_vpc_dhcp_option - 当引发 InvalidDhcpOptionID.NotFound 时，在创建后重试 describe_dhcp_options (https://github.com/ansible-collections/amazon.aws/pull/1320)。

• lambda_execute - 修复传递 function_arn 而不是名称时的等待器错误 (https://github.com/ansible-collections/amazon.aws/issues/1268)。

• module_utils - 修复当将位置参数传递给 AnsibleAWSModule.client 包装的函数时出现的 TypeError: deciding_wrapper() got multiple values for argument 'aws_retry' (https://github.com/ansible-collections/amazon.aws/pull/1230)。

• rds_param_group - 在尝试更改 DB 参数组系列时，添加检查以使修改/更新 rds_param_group 的任务失败。 (https://github.com/ansible-collections/amazon.aws/pull/1169)。

• route53_health_check - 修复使用 use_unique_names 和 tags 设置创建 health_check 时 Name 标签键删除的幂等性问题 (https://github.com/ansible-collections/amazon.aws/pull/1253)。

• s3_bucket - 处理禁用 acl 时设置权限的问题。(https://github.com/ansible-collections/amazon.aws/pull/1168)。

新插件

查找

• aws_collection_constants - 公开各种与集合相关的常量

新模块

• backup_plan - 管理 AWS Backup 计划

• backup_plan_info - 描述 AWS Backup 计划

• backup_restore_job_info - 列出有关备份还原作业的信息

• backup_selection - 创建、删除和修改 AWS Backup 选择

• backup_selection_info - 描述 AWS Backup 选择

• backup_tag - 管理备份计划、备份库、恢复点的标签

• backup_tag_info - 列出 AWS Backup 资源上的标签

• backup_vault - 管理 AWS Backup 库

• backup_vault_info - 描述 AWS Backup 库

v5.5.3

发布摘要

此版本包含 rds_cluster 的一些错误修复。

错误修复

• rds_cluster - 将 AllocatedStorage、DBClusterInstanceClass、StorageType、Iops 和 EngineMode 添加到创建或修改多可用区 RDS 集群时可以传递的参数列表中 (https://github.com/ansible-collections/amazon.aws/pull/1657)。

• rds_cluster - 允许在创建时将 GlobalClusterIdentifier 传递给 rds 集群 (https://github.com/ansible-collections/amazon.aws/pull/1663)。

v5.5.2

错误修复

• cloudwatchevent_rule - 修复当未进行任何更改时，更改状态报告为 False 的问题。该模块错误地总是报告有更改。(https://github.com/ansible-collections/amazon.aws/pull/1589)

• ec2_vpc_nat_gateway - 修复 NAT 网关，以便当用户创建私有 NAT 网关时，不应分配弹性 IP 地址。该模块错误地在创建私有 NAT 网关时总是分配弹性 IP 地址 (https://github.com/ansible-collections/amazon.aws/pull/1632)。

• lambda_execute - 修复堆栈跟踪输出中的问题，即它在每个字符之间不包含空格。该模块错误地总是在每个字符之间输出额外的空格。(https://github.com/ansible-collections/amazon.aws/pull/1615)

v5.5.1

发布摘要

此版本带来了一些错误修复。

错误修复

• autoscaling_group - 修复描述附加了超过 20 个目标组的自动伸缩组时出现的 ValidationError，方法是将请求分解为块 (https://github.com/ansible-collections/amazon.aws/pull/1593)。

• autoscaling_group_info - 修复描述附加了超过 20 个目标组的自动伸缩组时出现的 ValidationError，方法是将请求分解为块 (https://github.com/ansible-collections/amazon.aws/pull/1593)。

• aws_account_attribute - 抛出正确的 AnsibleLookupError 而不是 AnsibleError (https://github.com/ansible-collections/amazon.aws/issues/1528)。

• aws_secret - 抛出正确的 AnsibleLookupError 而不是 AnsibleError (https://github.com/ansible-collections/amazon.aws/issues/1528)。

• aws_service_ip_ranges 抛出正确的 AnsibleLookupError 而不是 AnsibleError (https://github.com/ansible-collections/amazon.aws/issues/1528)。

• aws_ssm - 抛出正确的 AnsibleLookupError 而不是 AnsibleError (https://github.com/ansible-collections/amazon.aws/issues/1528)。

• ec2_instance - 修复添加网络接口时 check_mode 的问题 (https://github.com/ansible-collections/amazon.aws/issues/1403)。

• elb_application_lb - 修复创建 ALB 时缺少属性的问题。create_or_update_alb() 在更新现有 ALB 时会包含 ALB 特定的属性，但在创建新的 ALB 时不会包含 (https://github.com/ansible-collections/amazon.aws/issues/1510)。

v5.5.0

发布摘要

此版本包含许多错误修复、新功能和新模块。 这是计划在版本 6.0.0 发布之前的最后一个次要版本。

次要更改

• 将 connectivity_type 添加到 ec2_vpc_nat_gateway 模块 (https://github.com/ansible-collections/amazon.aws/pull/1267)。

• cloudwatch - 将指标和 extended_statistic 键添加到 cloudwatch 模块 (https://github.com/ansible-collections/amazon.aws/pull/1133)。

• ec2_ami - 添加对 BootMode、TpmSupport、UefiData 参数的支持 (https://github.com/ansible-collections/amazon.aws/pull/1037)。

• ec2_metadata_facts - 添加了在元数据中查询实例标签的支持 (https://github.com/ansible-collections/amazon.aws/pull/1186)。

• kms_key - 将 multi_region 选项添加到 create_key (https://github.com/ansible-collections/amazon.aws/pull/1290)。

• lambda - 在创建或更新 lambda 函数时添加对函数层的支持 (https://github.com/ansible-collections/amazon.aws/pull/1118)。

• lambda_event - 添加了在创建 lambda 事件源映射时设置 FunctionResponseTypes 的支持 (https://github.com/ansible-collections/amazon.aws/pull/1209)。

• module_utils/elbv2 - 删除了 botocore < 1.10.30 的兼容性代码 (https://github.com/ansible-collections/amazon.aws/pull/1477)。

• rds_cluster - 新的 engine_mode 参数 (https://github.com/ansible-collections/amazon.aws/pull/941)。

• rds_cluster - 添加新选项（例如，db_cluster_instance_class、allocated_storage、storage_type、iops）(https://github.com/ansible-collections/amazon.aws/pull/1191)。

• rds_cluster - 使用 mysql 和 postgres 更新支持的引擎列表 (https://github.com/ansible-collections/amazon.aws/pull/1191)。

• s3_bucket - 确保在更新策略之前配置 public_access (https://github.com/ansible-collections/amazon.aws/pull/1511)。

错误修复

• cloudwatch_metric_alarm - 不要在更改检测中考虑 StateTransitionedTimestamp。 (https://github.com/ansible-collections/amazon.aws/pull/1440)。

• ec2_instance - 选择 app_callback -> set_password 而不是 app_callback -> set_passwd (https://github.com/ansible-collections/amazon.aws/issues/1449)。

• lambda_info - 在查询 lambda 配置时不要将环境变量转换为 snake_case。 (https://github.com/ansible-collections/amazon.aws/pull/1457)。

• rds_instance - 修复传递给 API 的 promotion_tier 类型 (https://github.com/ansible-collections/amazon.aws/pull/1475)。

新模块

• lambda_layer - 创建 AWS Lambda 层或删除 AWS Lambda 层版本

• lambda_layer_info - 列出 lambda 层或 lambda 层版本

v5.4.0

发布摘要

此次要版本带来错误修复和次要新功能。

次要更改

• ec2_spot_instance - 添加参数 terminate_instances 以支持终止与竞价请求关联的实例。 (https://github.com/ansible-collections/amazon.aws/pull/1402)。

• route53_health_check - 添加了对在创建 Route53 健康检查期间启用延迟图（MeasureLatency）的支持。 (https://github.com/ansible-collections/amazon.aws/pull/1201)。

错误修复

• ec2_metadata_facts - 修复在 Python 2 管理的节点上运行 ec2_metadata_facts 模块时的 AttributeError (https://github.com/ansible-collections/amazon.aws/issues/1358)。

• ec2_vol - 处理关联实例已存在时的 ec2_vol.tags (https://github.com/ansible-collections/amazon.aws/pull/1071)。

• rds_instance - 修复使用存储类型 gp3 标记 RDS DB 时的 TypeError (https://github.com/ansible-collections/amazon.aws/pull/1437)。

• route53_info - 为健康检查操作添加新的返回键 health_check_observations (https://github.com/ansible-collections/amazon.aws/pull/1419)。

• route53_info - 修复获取健康检查的状态或 failure_reason 时的 Key Error (https://github.com/ansible-collections/amazon.aws/pull/1419)。

v5.3.0

发布摘要

此版本带来了一些次要更改、错误修复和已弃用的功能。

次要更改

• ec2_instance - 更一致地返回 instances 信息 (https://github.com/ansible-collections/amazon.aws/pull/964)。

• ec2_instance - 删除未使用的导入 (https://github.com/ansible-collections/amazon.aws/pull/1350)。

• ec2_key - 添加单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1288)。

• ec2_vpc_nat_gateway - 确保在潜在访问之前定义 allocation_id (https://github.com/ansible-collections/amazon.aws/pull/1350)。

• route53_zone - 添加了对将多个 VPC 关联到 route53 托管区域的支持 (https://github.com/ansible-collections/amazon.aws/pull/1300)。

• s3_bucket - 添加支持创建启用对象锁定的存储桶的选项 (https://github.com/ansible-collections/amazon.aws/pull/1372)。

已弃用的功能

• 已弃用通过混合使用环境变量和参数传递配置文件和安全令牌的支持，此支持将在 6.0.0 版本中移除。在 6.0.0 版本之后，无论使用哪种传递机制，都只能传递配置文件或安全令牌。要显式阻止来自环境变量的参数，请将空字符串作为参数值传递。最初在 1.2.0 版本中已弃用同时传递配置文件和安全令牌的支持，但在 5.0.0 版本中仅部分实现（https://github.com/ansible-collections/amazon.aws/pull/1355）。

Bug修复

• cloudtrail - 支持使用 kms_key_id 禁用加密（https://github.com/ansible-collections/amazon.aws/pull/1384）。

• ec2_key - 修复了尝试使用相同密钥材料更新现有密钥对时的问题（https://github.com/ansible-collections/amazon.aws/pull/1383）。

• module_utils/elbv2 - 通过在 authenticate-oidc 规则中为 Scope 和 SessionTimeout 参数添加默认值来修复更改检测（https://github.com/ansible-collections/amazon.aws/pull/1270）。

• module_utils/elbv2 - 尊重 authenticate-oidc 规则中的 UseExistingClientSecret 参数（https://github.com/ansible-collections/amazon.aws/pull/1270）。

• 回滚了在 5.2.0 版本中引入的，通过混合使用环境变量和参数传递凭据时的重大更改（https://github.com/ansible-collections/amazon.aws/issues/1353）。

• s3_bucket - 空存储桶策略抛出 JSONDecodeError - 改为优雅地处理它（https://github.com/ansible-collections/amazon.aws/pull/1368）

v5.2.0

版本摘要

一个包含 ec2_eni_info 模块和 aws_rds 清单插件的 bug 修复的小版本，以及对 rds_instance 模块的改进。

次要更改

• amazon.aws 集合 - 代码重构，以便在回退到环境变量获取安全凭据和 AWS 连接详细信息时使用参数规范 fallback（https://github.com/ansible-collections/amazon.aws/pull/1174）。

• rds_instance - 将集成测试套件拆分为一系列较小的测试（https://github.com/ansible-collections/amazon.aws/pull/1185）。

• rds_instance - 添加对 gp3 存储类型的支持（https://github.com/ansible-collections/amazon.aws/pull/1266）。

Bug修复

• aws_rds - 修复了 RDS 清单插件中忽略配置文件的错误（https://github.com/ansible-collections/amazon.aws/issues/1304）。

• lambda - 修复了假设帐户中没有其他 lambda 的不稳定的集成测试（https://github.com/ansible-collections/amazon.aws/issues/1277）

v5.1.0

版本摘要

此版本带来了一些次要更改、bug修复、安全修复和已弃用的功能。

次要更改

• amazon.aws 集合 - aws_access_key 参数已重命名为 access_key，access_key 之前是此参数的别名，aws_access_key 仍然是别名。此更改对模块/插件文档之外的用户应无明显影响。（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - aws_secret_key 参数已重命名为 secret_key，secret_key 之前是此参数的别名，aws_secret_key 仍然是别名。此更改对模块/插件文档之外的用户应无明显影响。（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - security_token 参数已重命名为 session_token，security_token 之前是此参数的别名，security_token 仍然是别名。此更改对模块/插件文档之外的用户应无明显影响。（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• aws_account_attribute 查找插件 - 当 boto3/botocore 不可用时，使用 missing_required_lib 以获得更一致的错误消息（https://github.com/ansible-collections/amazon.aws/pull/1152）。

• aws_ec2 清单 - 次要 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

• aws_ec2 清单插件 - 当 boto3/botocore 不可用时，使用 missing_required_lib 以获得更一致的错误消息（https://github.com/ansible-collections/amazon.aws/pull/1152）。

• aws_rds 清单插件 - 当 boto3/botocore 不可用时，使用 missing_required_lib 以获得更一致的错误消息（https://github.com/ansible-collections/amazon.aws/pull/1152）。

• aws_secret 查找插件 - 当 boto3/botocore 不可用时，使用 missing_required_lib 以获得更一致的错误消息（https://github.com/ansible-collections/amazon.aws/pull/1152）。

• aws_ssm 查找插件 - 当 boto3/botocore 不可用时，使用 missing_required_lib 以获得更一致的错误消息（https://github.com/ansible-collections/amazon.aws/pull/1152）。

• ec2_instance - 当未提供 vpc_subnet_id 时，修复在指定可用区中启动实例的次要问题（https://github.com/ansible-collections/amazon.aws/pull/1150）。

• ec2_instance - 重构 tower_callback 代码，以处理作为参数规范一部分的参数验证（https://github.com/ansible-collections/amazon.aws/pull/1199）。

• ec2_instance - instance_role 参数已重命名为 iam_instance_profile，以更好地反映其含义，instance_role 仍然是别名（https://github.com/ansible-collections/amazon.aws/pull/1151）。

• ec2_instance - tower_callback 参数已重命名为 aap_callback，tower_callback 仍然是别名。此更改对模块文档之外的用户应无明显影响（https://github.com/ansible-collections/amazon.aws/pull/1199）。

• s3_object_info - 次要的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181)。

已弃用的功能

• amazon.aws 集合 - 已弃用对 EC2_ACCESS_KEY 环境变量的支持，并将在 2024-12-01 之后的版本中移除。请改用 access_key 参数或 AWS_ACCESS_KEY_ID 环境变量（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - 已弃用对 EC2_REGION 环境变量的支持，并将在 2024-12-01 之后的版本中移除。请改用 region 参数或 AWS_REGION 环境变量（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - 已弃用对 EC2_SECRET_KEY 环境变量的支持，并将在 2024-12-01 之后的版本中移除。请改用 secret_key 参数或 AWS_SECRET_ACCESS_KEY 环境变量（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - 已弃用对 EC2_SECURITY_TOKEN 环境变量的支持，并将在 2024-12-01 之后的版本中移除。请改用 session_token 参数或 AWS_SESSION_TOKEN 环境变量（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - 已弃用对 EC2_URL 和 S3_URL 环境变量的支持，并将在 2024-12-01 之后的版本中移除。请改用 endpoint_url 参数或 AWS_ENDPOINT_URL 环境变量（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - session_token 参数的 access_token 别名已弃用，并将在 2024-12-01 之后的版本中移除。请改用 session_token 名称（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - session_token 参数的 access_token 别名已弃用，并将在 2024-12-01 之后的版本中移除。请改用 session_token 名称（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - session_token 参数的 aws_security_token 别名已弃用，并将在 2024-12-01 之后的版本中移除。请改用 session_token 名称（https://github.com/ansible-collections/amazon.aws/pull/1172）。

• amazon.aws 集合 - ec2_access_key 参数别名已弃用，并将在 2024-12-01 之后的版本中删除。请改用 access_key 名称 (https://github.com/ansible-collections/amazon.aws/pull/1172)。

• amazon.aws 集合 - ec2_region 参数别名已弃用，并将在 2024-12-01 之后的版本中删除。请改用 region 名称 (https://github.com/ansible-collections/amazon.aws/pull/1172)。

• amazon.aws 集合 - ec2_secret_key 参数别名已弃用，并将在 2024-12-01 之后的版本中删除。请改用 secret_key 名称 (https://github.com/ansible-collections/amazon.aws/pull/1172)。

• amazon.aws 集合 - security_token 参数别名已弃用，并将在 2024-12-01 之后的版本中删除。请改用 session_token 名称 (https://github.com/ansible-collections/amazon.aws/pull/1172)。

• ec2_security_group - 传递嵌套列表到 cidr_ip 和 cidr_ipv6 的支持已弃用。可以通过 flatten 过滤器传递嵌套列表，例如 cidr_ip: '{{ my_cidrs | flatten }}' (https://github.com/ansible-collections/amazon.aws/pull/1213)。

• module_utils.url - ansible_collections.amazon.aws.module_utils.urls 被认为未使用，已被弃用，并将在 7.0.0 版本中删除。

安全修复

• ec2_instance - 修复了当使用 tower_callback.windows=True 和 tower_callback.set_password 时密码泄漏到日志中的问题 (https://github.com/ansible-collections/amazon.aws/pull/1199)。

Bug修复

• ec2_instance - 修复了当未指定标签时出现的 Invalid type for parameter TagSpecifications, value None 错误 (https://github.com/ansible-collections/amazon.aws/issues/1148)。

• module_utils.transformations - 确保当存在不在 type_map 中的项目时，map_complex_type 仍然返回转换后的项目 (https://github.com/ansible-collections/amazon.aws/pull/1163)。

v5.0.2

Bug修复

• ec2_metadata_facts - 修复了 AttributeError (https://github.com/ansible-collections/amazon.aws/issues/1134)。

v5.0.1

Bug修复

• ec2_vpc_net_info - 修复了 KeyError (https://github.com/ansible-collections/amazon.aws/pull/1109)。

• ec2_vpc_net_info - 当请求 ClassicLinkDnsSupported 失败时，删除硬编码的 ClassicLinkEnabled 参数 (https://github.com/ansible-collections/amazon.aws/pull/1109)。

• s3_object - 在检查 s3.get_bucket_ownership_controls 的结果时，更加具有防御性 (https://github.com/ansible-collections/amazon.aws/issues/1115)。

v5.0.0

版本摘要

在此版本中，我们将许多社区模块提升为 Red Hat 支持状态。这些模块已从 commuity.aws 移动到 amazon.aws 集合。此版本还带来了一些新功能、bug 修复、重大更改和已弃用的功能。amazon.aws 集合已放弃对 botocore<1.21.0 和 boto3<1.18.0 的支持。同时，也放弃了对 ansible-core<2.11 的支持。

重大更改

• autoscaling_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.autoscaling_group。

• autoscaling_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.autoscaling_group_info。

• cloudtrail - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudtrail。

• cloudwatch_metric_alarm - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudwatch_metric_alarm。

• cloudwatchevent_rule - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudwatchevent_rule。

• cloudwatchlogs_log_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group。

• cloudwatchlogs_log_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group_info。

• cloudwatchlogs_log_group_metric_filter - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.cloudwatchlogs_log_group_metric_filter。

• ec2_eip - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.ec2_eip。

• ec2_eip_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.ec2_eip_info。

• elb_application_lb - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.elb_application_lb。

• elb_application_lb_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.elb_application_lb_info。

• execute_lambda - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.execute_lambda。

• iam_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.iam_policy。

• iam_policy_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 playbook 应更新为使用 amazon.aws.iam_policy_info。

• iam_user - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_user。

• iam_user_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.iam_user_info。

• kms_key - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.kms_key。

• kms_key_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.kms_key_info。

• lambda - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.lambda。

• lambda_alias - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.lambda_alias。

• lambda_event - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.lambda_event。

• lambda_execute - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.lambda_execute。

• lambda_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.lambda_info。

• lambda_policy - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.lambda_policy。

• rds_cluster - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_cluster。

• rds_cluster_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_cluster_info。

• rds_cluster_snapshot - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_cluster_snapshot。

• rds_instance - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_instance。

• rds_instance_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_instance_info。

• rds_instance_snapshot - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_instance_snapshot。

• rds_option_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_option_group。

• rds_option_group_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_option_group_info。

• rds_param_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_param_group。

• rds_snapshot_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_snapshot_info。

• rds_subnet_group - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.rds_subnet_group。

• route53 - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.route53。

• route53_health_check - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.route53_health_check。

• route53_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.route53_info。

• route53_zone - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.route53_zone。

小的更改

• 能够记录和重放模块的 API 交互以进行测试。展示该功能的一个示例 (https://github.com/ansible-collections/amazon.aws/pull/998)。

• 从发行版中删除空的 __init__.py 文件，它们不再需要了 (https://github.com/ansible-collections/amazon.aws/pull/1018)。

• amazon.aws 模块 - 为了保持一致性，ec2_url 参数已重命名为 endpoint_url，ec2_url 仍然作为别名存在 (https://github.com/ansible-collections/amazon.aws/pull/992)。

• aws_caller_info - 小的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• aws_ec2 - 引入 allow_duplicated_hosts 配置键 (https://github.com/ansible-collections/amazon.aws/pull/1026)。

• cloudformation - 避免捕获 Exception，而是捕获更具体的错误 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• cloudwatch_metric_alarm_info - 添加了一个新模块，用于描述 cloudwatch 指标警报 (https://github.com/ansible-collections/amazon.aws/pull/988)。

• ec2_group - ec2_group 模块已重命名为 ec2_security_group，ec2_group 仍然作为别名存在 (https://github.com/ansible-collections/amazon.aws/pull/897)。

• ec2_group_info - ec2_group_info 模块已重命名为 ec2_security_group_info，ec2_group_info 仍然作为别名存在 (https://github.com/ansible-collections/amazon.aws/pull/897)。

• ec2_instance - 添加 hibernation_options 和 volumes->ebs->encrypted 键以支持停止-休眠实例 (https://github.com/ansible-collections/amazon.aws/pull/972)。

• ec2_instance - 扩大了自动重试的使用范围，使其能够处理 InsuffienctInstanceCapacity (https://github.com/ansible-collections/amazon.aws/issues/1038)。

• ec2_metadata_facts - 避免捕获 Exception，而是捕获更具体的错误 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• ec2_security_group - 小的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• ec2_vpc_endpoint - 避免捕获 Exception，而是捕获更具体的错误 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• ec2_vpc_nat_gateway - 小的 linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• ec2_vpc_net_info - 通过抛出警告而不是错误来处理共享 VPC 的经典链接检查 (https://github.com/ansible-collections/amazon.aws/pull/984)。

• module_utils/acm - 移动到抖动回退 (https://github.com/ansible-collections/amazon.aws/pull/946)。

• module_utils/elbv2 - 确保在创建时设置 ip_address_type，而不是在创建后重新设置 (https://github.com/ansible-collections/amazon.aws/pull/940)。

• module_utils/elbv2 - 使用新的具有临时故障重试的等待器 (https://github.com/ansible-collections/amazon.aws/pull/940)。

• module_utils/waf - 移动到抖动回退 (https://github.com/ansible-collections/amazon.aws/pull/946)。

• module_utils/waiters - 添加等待器来管理 eks_nodegroup 模块 (https://github.com/ansible-collections/community.aws/pull/1415)。

• s3_bucket - 为了与 s3_object 模块保持一致，将 rgw 添加为 ceph 参数的别名 (https://github.com/ansible-collections/amazon.aws/pull/994)。

• s3_bucket - s3_url 参数已合并到 endpoint_url 参数中，s3_url 仍保留为别名 (https://github.com/ansible-collections/amazon.aws/pull/994)。

• s3_object - 添加了 sig_v4 参数，允许用户选择使用签名版本 4 进行下载/获取操作。( https://github.com/ansible-collections/amazon.aws/pull/1014)

• s3_object - 修复了一些小的代码风格问题 (https://github.com/ansible-collections/amazon.aws/pull/968)。

• s3_object - 为了与 s3_bucket 模块保持一致，rgw 参数已重命名为 ceph，rgw 仍保留为别名 (https://github.com/ansible-collections/amazon.aws/pull/994)。

• s3_object - s3_url 参数已合并到 endpoint_url 参数中，s3_url 仍保留为别名 (https://github.com/ansible-collections/amazon.aws/pull/994)。

• s3_object - 更新了模块，以增加对将文件上传到禁用 ACL 的存储桶的支持 (https://github.com/ansible-collections/amazon.aws/pull/921)。

• s3_object_info - 添加了一个新模块，用于描述 S3 对象 (https://github.com/ansible-collections/amazon.aws/pull/977)。

重大更改 / 移植指南

• amazon.aws 集合 - 已删除对 ansible-core < 2.11 的支持 (https://github.com/ansible-collections/amazon.aws/pull/1087)。

• amazon.aws 集合 - amazon.aws 集合已删除对 botocore<1.21.0 和 boto3<1.18.0 的支持。大多数模块将继续与旧版本的 AWS SDK 一起使用，但是不保证与旧版本的 SDK 的兼容性，也不会进行测试。使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/934)。

• doc_fragments - 从 doc_fragments/aws.py 中删除最低集合要求，并允许从 doc_fragments/aws_boto3.py 中提取这些要求 (https://github.com/ansible-collections/amazon.aws/pull/985)。

• ec2_ami - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• ec2_ami - 参数别名 DeviceName、VirtualName 和 NoDevice 先前已弃用，现已删除，请改用 device_name、virtual_name 和 no_device (https://github.com/ansible-collections/amazon.aws/pull/913)。

• ec2_eni_info - 现在强制执行 eni_id 和 filters 参数的互斥性，以前如果设置了 eni_id，则会忽略 filters (https://github.com/ansible-collections/amazon.aws/pull/954)。

• ec2_instance - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• ec2_key - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• ec2_vol - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• ec2_vpc_dhcp_option_info - 参数别名 DhcpOptionIds 和 DryRun 先前已弃用，现已删除，请改用 dhcp_options_ids 和 no_device (https://github.com/ansible-collections/amazon.aws/pull/913)。

• ec2_vpc_endpoint - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• ec2_vpc_net - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• ec2_vpc_route_table - purge_tags 的默认值已从 False 更改为 True (https://github.com/ansible-collections/amazon.aws/pull/916)。

• s3_bucket - 先前已弃用的 s3_url 参数的别名 S3_URL 已被删除。Playbook 应更新为使用 s3_url (https://github.com/ansible-collections/amazon.aws/pull/908)。

• s3_object - 先前已弃用的 s3_url 参数的别名 S3_URL 已被删除。Playbook 应更新为使用 s3_url (https://github.com/ansible-collections/amazon.aws/pull/908)。

已弃用的功能

• amazon.aws 集合 - 由于 AWS SDK 宣布停止支持低于 3.7 的 Python 版本 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)，此集合已弃用对低于 3.7 的 Python 版本的支持，并且将在 2023-05-31 之后的版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/935)。

• inventory/aws_ec2 - include_extra_api_calls 现在已弃用，其值将被静默忽略 (https://github.com/ansible-collections/amazon.aws/pull/1097)。

错误修复

• aws_ec2 - 解决 4.1.0 版本中引入的回退问题 (https://github.com/ansible-collections/amazon.aws/pull/862)，该问题导致清单中出现重复的主机。

• cloudtrail - 修复了将 TagList 键错误地识别为 TagsList 的问题 (https://github.com/ansible-collections/amazon.aws/issues/1088)。

• ec2_instance - 仅当指定 count 或 exact_count 时，才显示 instance_type 默认值的弃用警告 (https://github.com//issues/980)。

• ec2_metadata_facts - 修复了当使用 Ansible 2.13+ 时出现的 'NoneType' object is not callable 异常 (https://github.com/ansible-collections/amazon.aws/issues/942)。

• module_utils/botocore - 修复了错误处理中的 object has no attribute 'fail' 错误 (https://github.com/ansible-collections/amazon.aws/pull/1045)。

• module_utils/elbv2 - 修复了当使用 UseExistingClientSecret 而不是 ClientSecret 时出现的 KeyError (https://github.com/ansible-collections/amazon.aws/pull/940)。

• module_utils/elbv2 - 改进了比较侦听器时的幂等性 (https://github.com/ansible-collections/community.aws/issues/604)。

• s3_object - 在列出存储桶时也使用 ignore_nonexistent_bucket (https://github.com/ansible-collections/amazon.aws/issues/966)。

新模块

• cloudtrail_info - 收集有关 AWS Cloud Trail 中跟踪的信息。

• cloudwatch_metric_alarm_info - 收集有关指定指标的警报信息

• s3_object_info - 收集有关 S3 中对象的信息

v4.5.0

版本摘要

此版本包含 ec2_vol 模块的一个小错误修复，对 ec2_key 模块的一些小改动以及各种文档修复。这是 4.x 系列的最后计划版本。

次要更改

• ec2_key - 次要重构和改进的单元测试覆盖率 (https://github.com/ansible-collections/amazon.aws/pull/1288)。

错误修复

• ec2_vol - 处理关联实例已存在时的 ec2_vol.tags (https://github.com/ansible-collections/amazon.aws/pull/1071)。

v4.4.0

版本摘要

amazon.aws 4.4.0 版本包含许多安全和次要错误修复。

次要更改

• ec2_instance - 重构 tower_callback 代码，以处理作为参数规范一部分的参数验证（https://github.com/ansible-collections/amazon.aws/pull/1199）。

• ec2_instance - tower_callback 参数已重命名为 aap_callback，tower_callback 仍然是别名。此更改对模块文档之外的用户应无明显影响（https://github.com/ansible-collections/amazon.aws/pull/1199）。

安全修复

• ec2_instance - 修复了当使用 tower_callback.windows=True 和 tower_callback.set_password 时密码泄漏到日志中的问题 (https://github.com/ansible-collections/amazon.aws/pull/1199)。

v4.3.0

版本摘要

amazon.aws 4.3.0 版本包含许多次要错误修复和改进。在 amazon.aws 5.0.0 发布之后，对 4.x 系列的反向移植将仅限于安全问题和错误修复。

次要更改

• ec2_instance - 扩大了自动重试的使用范围，使其能够处理 InsuffienctInstanceCapacity (https://github.com/ansible-collections/amazon.aws/issues/1038)。

错误修复

• ec2_metadata_facts - 修复了当使用 Ansible 2.13+ 时出现的 'NoneType' object is not callable 异常 (https://github.com/ansible-collections/amazon.aws/issues/942)。

• module_utils/cloud - 修复 Ansible 2.9 上的 ValueError: ansible_collections.amazon.aws.plugins.module_utils.core.__spec__ is None 错误 (https://github.com/ansible-collections/amazon.aws/issues/1083)。

v4.2.0

次要更改

• ec2_security_group - 将规则 -> group_name 的类型设置为 list，因为它既可以接受 str 也可以接受 list (https://github.com/ansible-collections/amazon.aws/pull/971)。

• 各种模块 - linting 修复 (https://github.com/ansible-collections/amazon.aws/pull/953)。

已弃用功能

• module_utils.cloud - CloudRetry.backoff 的删除已延迟到 6.0.0 版本。建议更新自定义模块以使用 jittered_backoff 或 exponential_backoff 代替 (https://github.com/ansible-collections/amazon.aws/pull/951)。

v4.1.0

次要更改

• ec2_instance - 扩大了在临时故障时自动重试的使用范围 (https://github.com/ansible-collections/amazon.aws/issues/927)。

• s3_bucket - 更新模块以支持为 SSE-KMS 设置 S3 Bucket Keys (https://github.com/ansible-collections/amazon.aws/pull/882)。

已弃用功能

• amazon.aws 集合 - 由于 AWS SDK 宣布停止支持低于 3.7 的 Python 版本 (https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/)，此集合已弃用对低于 3.7 的 Python 版本的支持，并且将在 2023-05-31 之后的版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/935)。

错误修复

• aws_ec2 - 确保在使用标签作为主机名时返回正确的主机数 (https://github.com/ansible-collections/amazon.aws/pull/862)。

• elb_application_lb - 修复在两个目标组之间进行负载均衡时的 KeyError (https://github.com/ansible-collections/community.aws/issues/1089)。

• elb_classic_lb - 修复在使用运行状况检查在检查模式下创建新 ELB 时的 'NoneType' object has no attribute 错误 (https://github.com/ansible-collections/amazon.aws/pull/915)。

• elb_classic_lb - 修复在使用安全组名称创建新 ELB 时的 'NoneType' object has no attribute 错误 (https://github.com/ansible-collections/amazon.aws/issues/914)。

v4.0.0

主要更改

• amazon.aws 集合 - amazon.aws 集合已放弃对 botocore<1.20.0 和 boto3<1.17.0 的支持。大多数模块将继续使用旧版本的 AWS SDK，但是不保证与旧版本的 SDK 的兼容性，并且不会进行测试。使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/574)。

次要更改

• aws_s3 - 添加 validate_bucket_name 选项以控制存储桶名称验证 (https://github.com/ansible-collections/amazon.aws/pull/615)。

• aws_s3 - aws_s3 模块已重命名为 s3_object (https://github.com/ansible-collections/amazon.aws/pull/869)。

• aws_s3 - resource_tags 已添加为 tags 参数的别名 (https://github.com/ansible-collections/amazon.aws/pull/845)。

• ec2_eni - 将传递给 describe_network_inter API 调用时的参数 device_index 数据类型更改为字符串 (https://github.com/ansible-collections/amazon.aws/pull/877)。

• ec2_eni - resource_tags 已添加为 tags 参数的别名 (https://github.com/ansible-collections/amazon.aws/pull/845)。

• ec2_group - 添加 egress_rules 作为 rules_egress 的别名 (https://github.com/ansible-collections/amazon.aws/pull/878)。

• ec2_group - 添加 purge_egress_rules 作为 purge_rules_egress 的别名 (https://github.com/ansible-collections/amazon.aws/pull/878)。

• ec2_instance - 添加缺失的 metadata_options 参数 (https://github.com/ansible-collections/amazon.aws/pull/715)。

• ec2_key - resource_tags 已添加为 tags 参数的别名 (https://github.com/ansible-collections/amazon.aws/pull/845)。

• ec2_vpc_net - 添加按 ID 管理 VPC 的支持 (https://github.com/ansible-collections/amazon.aws/pull/848)。

• ec2_vpc_subnet - 添加对 OutpostArn 参数的支持 (https://github.com/ansible-collections/amazon.aws/pull/598)。

• elb_classic_lb - resource_tags 已添加为 tags 参数的别名 (https://github.com/ansible-collections/amazon.aws/pull/845)。

• s3_bucket - 添加 validate_bucket_name 选项以控制存储桶名称验证 (https://github.com/ansible-collections/amazon.aws/pull/615)。

• s3_bucket - resource_tags 已添加为 tags 参数的别名 (https://github.com/ansible-collections/amazon.aws/pull/845)。

重大更改/移植指南

• 在清除标签时，以 aws: 开头的标签将不会被删除，这些标签由 Amazon 保留，可能无法更新或删除 (https://github.com/ansible-collections/amazon.aws/issues/817)。

• amazon.aws 集合 - profile 参数现在与 aws_access_key、aws_secret_key 和 security_token 参数互斥 (https://github.com/ansible-collections/amazon.aws/pull/834)。

• aws_az_info - 模块别名 aws_az_facts 在 Ansible 2.9 中已弃用，现在已删除 (https://github.com/ansible-collections/amazon.aws/pull/832)。

• aws_s3 - ensure overwrite 的默认值已更改为 different，而不是 always，以便该模块默认情况下是幂等的 (https://github.com/ansible-collections/amazon.aws/issues/811)。

• aws_ssm - on_denied 和 on_missing 现在都默认为 error，以与 aws_secret 和基本查找类保持一致 (https://github.com/ansible-collections/amazon.aws/issues/617)。

• ec2 - ec2 模块已在 4.0.0 版本中删除，并被 ec2_instance 模块取代 (https://github.com/ansible-collections/amazon.aws/pull/630)。

• ec2_vpc_igw_info - convert_tags 的默认值已更改为 True (https://github.com/ansible-collections/amazon.aws/pull/835)。

• elb_classic_lb - ec2_elb 事实已被移除 (https://github.com/ansible-collections/amazon.aws/pull/827)。

• module_utils - 对原始 AWS SDK（也称为 boto）的支持已被移除，包括所有相关的辅助函数。所有模块现在都应该使用 boto3/botocore AWS SDK (https://github.com/ansible-collections/amazon.aws/pull/630)

已弃用功能

• aws_s3 - s3_url 选项的 S3_URL 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_ami - device_name 选项的 DeviceName 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_ami - no_device 选项的 NoDevice 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_ami - virtual_name 选项的 VirtualName 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_ami - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/846)。

• ec2_instance - `instance_type` 的默认值已被弃用，在未来版本中，您必须设置 instance_type 或启动模板 (https://github.com/ansible-collections/amazon.aws/pull/587)。

• ec2_instance - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/849)。

• ec2_key - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/846)。

• ec2_vol - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/846)。

• ec2_vpc_dhcp_option_info - dhcp_option_ids 选项的 DhcpOptionIds 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_vpc_dhcp_option_info - dry_run 选项的 DryRun 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_vpc_endpoint - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/846)。

• ec2_vpc_net - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/848)。

• ec2_vpc_route_table - purge_tags 的当前默认值 False 已被弃用，将在 5.0.0 版本中更新为 True (https://github.com/ansible-collections/amazon.aws/pull/846)。

• s3_bucket - s3_url 选项的 S3_URL 别名已被弃用，将在 5.0.0 版本中移除 (https://github.com/ansible-collections/community.aws/pull/795)。

• s3_object - 对 S3 存储桶的创建和删除的支持已被弃用。请使用 amazon.aws.s3_bucket 模块来创建和删除存储桶 (https://github.com/ansible-collections/amazon.aws/pull/869)。

已移除的功能（之前已弃用）

• cloudformation - template_format 选项已被移除。自 Ansible 2.3 以来，该选项已被模块忽略 (https://github.com/ansible-collections/amazon.aws/pull/833)。

• ec2_key - wait_timeout 选项不起作用，在 1.0.0 版本中已弃用，现在已被移除 (https://github.com/ansible-collections/amazon.aws/pull/830)。

• ec2_key - wait 选项不起作用，在 1.0.0 版本中已弃用，现在已被移除 (https://github.com/ansible-collections/amazon.aws/pull/830)。

• ec2_tag - 之前已弃用的状态 list 已被移除。要列出 EC2 资源上的标签，可以使用 ec2_tag_info 模块 (https://github.com/ansible-collections/amazon.aws/pull/829)。

• ec2_vol - 之前已弃用的状态 list 已被移除。要列出卷，可以使用 ec2_vol_info 模块 (https://github.com/ansible-collections/amazon.aws/pull/828)。

• module_utils.batch - 类 ansible_collections.amazon.aws.plugins.module_utils.batch.AWSConnection 已被移除。请改用 AnsibleAWSModule.client() (https://github.com/ansible-collections/amazon.aws/pull/831)。

Bugfixes

• ec2_group - 修复了在使用 --diff 和 --check 创建新安全组时出现的未捕获异常 (https://github.com/ansible-collections/amazon.aws/issues/440)。

• ec2_instance - 添加一个条件来处理默认的 `instance_type` 值，以修复使用启动模板创建实例时发生的中断问题 (https://github.com/ansible-collections/amazon.aws/pull/587)。

• ec2_instance - 当 state 设置为 rebooted` 时，如果缺少停止实例的权限，则引发错误 (https://github.com/ansible-collections/amazon.aws/pull/671)。

• ec2_vpc_igw - 如果可能，使用 gateway_id 而不是过滤器进行分页，以修复“NoneType”对象不可下标错误 (https://github.com/ansible-collections/amazon.aws/pull/766)。

• ec2_vpc_net - 修复了在检查模式下会更新 CIDR 配置的错误 (https://github.com/ansible/ansible/issues/62678)。

• ec2_vpc_net - 修复了在检查模式下更新 DNS 选项时模块会卡住的错误 (https://github.com/ansible/ansible/issues/62677)。

• elb_classic_lb - 修改 _format_listeners 方法的返回值，以解决创建 https 侦听器失败的问题 (https://github.com/ansible-collections/amazon.aws/pull/860)。

v3.5.1

版本摘要

3.5.1 是一个安全漏洞修复版本。

次要更改

• ec2_instance - 重构 tower_callback 代码，以处理作为参数规范一部分的参数验证（https://github.com/ansible-collections/amazon.aws/pull/1199）。

• ec2_instance - tower_callback 参数已重命名为 aap_callback，tower_callback 仍然是别名。此更改对模块文档之外的用户应无明显影响（https://github.com/ansible-collections/amazon.aws/pull/1199）。

安全修复

• ec2_instance - 修复了当使用 tower_callback.windows=True 和 tower_callback.set_password 时密码泄漏到日志中的问题 (https://github.com/ansible-collections/amazon.aws/pull/1199)。

v3.5.0

版本摘要

在 amazon.aws 5.0.0 发布之后，3.5.0 是一个错误修复版本，也是 3.x 系列的最终计划版本。

次要更改

• ec2_security_group - 将规则 -> group_name 的类型设置为 list，因为它既可以接受 str 也可以接受 list (https://github.com/ansible-collections/amazon.aws/pull/971)。

Bugfixes

• ec2_metadata_facts - 修复了当使用 Ansible 2.13+ 时出现的 'NoneType' object is not callable 异常 (https://github.com/ansible-collections/amazon.aws/issues/942)。

v3.4.0

次要更改

• ec2_instance - 扩大了在临时故障时自动重试的使用范围 (https://github.com/ansible-collections/amazon.aws/issues/927)。

Bugfixes

• elb_application_lb - 修复在两个目标组之间进行负载均衡时的 KeyError (https://github.com/ansible-collections/community.aws/issues/1089)。

• elb_classic_lb - 修复在使用运行状况检查在检查模式下创建新 ELB 时的 'NoneType' object has no attribute 错误 (https://github.com/ansible-collections/amazon.aws/pull/915)。

• elb_classic_lb - 修复在使用安全组名称创建新 ELB 时的 'NoneType' object has no attribute 错误 (https://github.com/ansible-collections/amazon.aws/issues/914)。

v3.3.1

版本摘要

各种次要文档修复。

v3.3.0

次要更改

• aws_ec2 inventory - 允许主机名中使用与 ec2 describe-instances 中筛选参数不匹配的文字字符串 (https://github.com/ansible-collections/amazon.aws/pull/826)。

• aws_ssm - 添加对 endpoint 参数的支持 (https://github.com/ansible-collections/amazon.aws/pull/837)。

• module.utils.rds - 将 retry_codes 添加到 get_rds_method_attribute 返回数据中，以便在 call_method 中使用，并添加单元测试 (https://github.com/ansible-collections/amazon.aws/pull/776)。

• module.utils.rds - 重构以利用 get_rds_method_attribute 返回数据 (https://github.com/ansible-collections/amazon.aws/pull/776)。

• module_utils - 将新的别名 aws_session_token 和 session_token 添加到 security_token 参数，使其更符合 boto SDK 的规范 (https://github.com/ansible-collections/amazon.aws/pull/631)。

• module_utils.rds - 在 module_utils.rds 中添加对使用等待器向/从数据库实例添加/删除 IAM 角色的支持和单元测试 (https://github.com/ansible-collections/amazon.aws/pull/714)。

Bugfixes

• 为 plugins/module_utils/_version.py 包含 PSF-license.txt 文件。

• aws_account_attribute 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_ec2 清单插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_rds 清单插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_resource_actions 回调插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_secret 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_service_ip_ranges 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_ssm - 修复客户端配置（例如，AWS_PROFILE，AWS_ACCESS_KEY_ID）的环境变量 (https://github.com/ansible-collections/amazon.aws/pull/837)。

• aws_ssm 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• ec2_instance - ec2_instance 模块在 Python 3.8 中中断 - 迭代期间修改字典键 (https://github.com/ansible-collections/amazon.aws/issues/709)。

• module.utils.rds - 添加等待器以提升只读副本，以修复幂等性问题 (https://github.com/ansible-collections/amazon.aws/pull/714)。

• module.utils.rds - 在修改数据库实例时捕获 InvalidDBSecurityGroupStateFault (https://github.com/ansible-collections/amazon.aws/pull/776)。

• module.utils.s3 - 将 validate_bucket_name 的最小长度更新为 3 (https://github.com/ansible-collections/amazon.aws/pull/802)。

v3.2.0

小改动

• aws_secret - 为 bypath 功能添加分页 (https://github.com/ansible-collections/amazon.aws/pull/591)。

• ec2_instance - 修复弃用警告的范围，以便在 absent 中 state 时不显示警告 (https://github.com/ansible-collections/amazon.aws/pull/719)。

• ec2_vpc_route_table - 支持关联互联网网关 (https://github.com/ansible-collections/amazon.aws/pull/690)。

• module_utils.elbv2 - 添加对 alb 特定属性的支持，并添加 compare_elb_attributes 方法以支持 module_utils.elbv2 中的 check_mode (https://github.com/ansible-collections/amazon.aws/pull/696)。

• s3_bucket - 添加对强制存储桶所有者对象所有权的支持 (https://github.com/ansible-collections/amazon.aws/pull/694)。

Bugfixes

• aws_ec2 清单 - 如果未设置 regions 配置并且提供的 AWS 凭据没有足够的权限执行 DescribeRegions 操作，则使用 iam_role_arn 配置参数在尝试调用 DescribeRegions 之前承担角色。( https://github.com/ansible-collections/amazon.aws/issues/566)。

• ec2_vol - 将卷从不支持 IOPS 的类型（例如 standard）更改为支持 IOPS 的类型（例如 gp3）失败 (https://github.com/ansible-collections/amazon.aws/issues/626)。

• ec2_vpc_igw - 修复“NoneType”对象不可订阅错误 (https://github.com/ansible-collections/amazon.aws/pull/691)。

• ec2_vpc_igw - 使用分页器描述互联网网关，并添加重试以修复 NoneType 对象不可订阅错误 (https://github.com/ansible-collections/amazon.aws/pull/695)。

• ec2_vpc_net - 在 check 模式下，确保模块不更改配置。处理启用 Amazon 提供的 ipv6 块，然后禁用，然后再次启用的情况。如果任务中不存在 ipv6_cidr 属性，则不要禁用 IPv6 CIDR 关联（使用 Amazon 池）。如果 VPC 已存在并且存在 ipv6_cidr 属性，则保留当前配置 (https://github.com/ansible-collections/amazon.aws/pull/631)。

v3.1.1

小改动

• 由于上传到 Galaxy 时出现错误，因此将 amazon.aws 集合的版本从 3.1.0 提升到 3.1.1。

v3.1.0

小改动

• 为清单插件 aws_ec2 和 aws_rds 添加新的参数 hostvars_prefix 和 hostvars_suffix (https://github.com/ansible-collections/amazon.aws/issues/535)。

• aws_s3 - 添加 validate_bucket_name 选项以控制存储桶名称验证 (https://github.com/ansible-collections/amazon.aws/pull/615)。

• aws_s3 - 在 overwrite 参数上添加最新选择，以获取 S3 上的最新对象 (https://github.com/ansible-collections/amazon.aws/pull/595)。

• ec2_vol - 添加对 OutpostArn 参数的支持 (https://github.com/ansible-collections/amazon.aws/pull/597)。

• ec2_vol - 在创建时标记卷 (https://github.com/ansible-collections/amazon.aws/pull/603)。

• ec2_vpc_route_table - 在创建路由表时添加对 IPv6 的支持 (https://github.com/ansible-collections/amazon.aws/pull/601)。

• s3_bucket - 添加 validate_bucket_name 选项以控制存储桶名称验证 (https://github.com/ansible-collections/amazon.aws/pull/615)。

弃用的功能

• ec2_instance - `instance_type` 的默认值已被弃用，在未来版本中，您必须设置 instance_type 或启动模板 (https://github.com/ansible-collections/amazon.aws/pull/587)。

Bugfixes

• 各种模块和插件 - 使用供应商版本的 distutils.version，而不是已弃用的 Python 标准库 distutils (https://github.com/ansible-collections/amazon.aws/pull/599)。

• aws_acm - 在检索 ACM 证书时不再引发 ResourceNotFound 异常。

• aws_s3 - 修复当使用模块从源复制到目标并且源中缺少密钥时引发的异常 (https://github.com/ansible-collections/amazon.aws/issues/602)。

• ec2_instance - 添加一个条件来处理默认的 `instance_type` 值，以修复使用启动模板创建实例时发生的中断问题 (https://github.com/ansible-collections/amazon.aws/pull/587)。

• ec2_key - 添加对 ED25519 密钥类型的支持 (https://github.com/ansible-collections/amazon.aws/issues/572)。

• ec2_vol - 即使 iops 值没有更改，也在 req_obj 中设置 Iops 值，以允许修改需要将 iops 值传递给 boto 的卷类型。( https://github.com/ansible-collections/amazon.aws/pull/606)

• elb_classic_lb - 在提供 security_group_names 时处理 security_group_ids，并修复集成测试中中断的任务 (https://github.com/ansible-collections/amazon.aws/pull/592)。

• s3_bucket - 启用存储桶级 ACL 的管理 (https://github.com/ansible-collections/amazon.aws/issues/573)。

v3.0.0

重大变更

• amazon.aws 集合 - amazon.aws 集合已删除对 botocore<1.19.0 和 boto3<1.16.0 的支持。大多数模块将继续使用旧版本的 AWS SDK 工作，但是不保证与旧版本的 SDK 的兼容性，也不会对其进行测试。当使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/574)。

小改动

• ec2_instance - 添加 count 参数支持 (https://github.com/ansible-collections/amazon.aws/pull/539)。

破坏性变更/移植指南

• aws_caller_facts - 删除已弃用的 aws_caller_facts 别名。请改用 aws_caller_info。

• cloudformation_facts - 删除已弃用的 cloudformation_facts 别名。请改用 cloudformation_info。

• ec2_ami_facts - 删除已弃用的 ec2_ami_facts 别名。请改用 ec2_ami_info。

• ec2_eni_facts - 移除已弃用的 ec2_eni_facts 别名。请改用 ec2_eni_info。

• ec2_group_facts - 移除已弃用的 ec2_group_facts 别名。请改用 ec2_group_info。

• ec2_instance_facts - 移除已弃用的 ec2_instance_facts 别名。请改用 ec2_instance_info。

• ec2_snapshot_facts - 移除已弃用的 ec2_snapshot_facts 别名。请改用 ec2_snapshot_info。

• ec2_vol_facts - 移除已弃用的 ec2_vol_facts 别名。请改用 ec2_vol_info。

• ec2_vpc_dhcp_option_facts - 移除已弃用的 ec2_vpc_dhcp_option_facts 别名。请改用 ec2_vpc_dhcp_option_info。

• ec2_vpc_endpoint_facts - 移除已弃用的 ec2_vpc_endpoint_facts 别名。请改用 ec2_vpc_endpoint_info。

• ec2_vpc_igw_facts - 移除已弃用的 ec2_vpc_igw_facts 别名。请改用 ec2_vpc_igw_info。

• ec2_vpc_nat_gateway_facts - 移除已弃用的 ec2_vpc_nat_gateway_facts 别名。请改用 ec2_vpc_nat_gateway_info。

• ec2_vpc_net_facts - 移除已弃用的 ec2_vpc_net_facts 别名。请改用 ec2_vpc_net_info。

• ec2_vpc_route_table_facts - 移除已弃用的 ec2_vpc_route_table_facts 别名。请改用 ec2_vpc_route_table_info。

• ec2_vpc_subnet_facts - 移除已弃用的 ec2_vpc_subnet_facts 别名。请改用 ec2_vpc_subnet_info。

已弃用功能

• module_utils - 对原始 AWS SDK boto 的支持已被弃用，转而支持 boto3/botocore SDK。所有基于 boto 的模块都已弃用或迁移到 botocore，并且 module_utils 中剩余的支持代码将在 amazon.aws 合集 4.0.0 版本中删除。任何基于 boto 库的 amazon.aws 和 community.aws 合集之外的模块都需要迁移到 boto3/botocore 库 (https://github.com/ansible-collections/amazon.aws/pull/575)。

v2.3.0

Bug 修复

• aws_account_attribute 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_ec2 清单插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_rds 清单插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_resource_actions 回调插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_secret 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_service_ip_ranges 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• aws_ssm 查找插件 - 修复文档数据中的 lint 错误 (https://github.com/ansible-collections/amazon.aws/pull/701)。

• ec2_instance - ec2_instance 模块在 Python 3.8 中中断 - 迭代期间修改字典键 (https://github.com/ansible-collections/amazon.aws/issues/709)。

• module.utils.s3 - 将 validate_bucket_name 的最小长度更新为 3 (https://github.com/ansible-collections/amazon.aws/pull/802)。

v2.2.0

小改动

• ec2_instance - 添加 count 参数支持 (https://github.com/ansible-collections/amazon.aws/pull/539)。

Bug 修复

• aws_ec2 清单 - 如果未设置 regions 配置并且提供的 AWS 凭据没有足够的权限执行 DescribeRegions 操作，则使用 iam_role_arn 配置参数在尝试调用 DescribeRegions 之前承担角色。( https://github.com/ansible-collections/amazon.aws/issues/566)。

• ec2_vol - 即使 iops 值没有更改，也在 req_obj 中设置 Iops 值，以允许修改需要将 iops 值传递给 boto 的卷类型。( https://github.com/ansible-collections/amazon.aws/pull/606)

• ec2_vol - 将卷从不支持 IOPS 的类型（例如 standard）更改为支持 IOPS 的类型（例如 gp3）失败 (https://github.com/ansible-collections/amazon.aws/issues/626)。

• ec2_vpc_igw - 修复“NoneType”对象不可订阅错误 (https://github.com/ansible-collections/amazon.aws/pull/691)。

• ec2_vpc_igw - 使用分页器描述互联网网关，并添加重试以修复 NoneType 对象不可订阅错误 (https://github.com/ansible-collections/amazon.aws/pull/695)。

• elb_classic_lb - 在提供 security_group_names 时处理 security_group_ids，并修复集成测试中中断的任务 (https://github.com/ansible-collections/amazon.aws/pull/592)。

v2.1.0

小改动

• aws_service_ip_ranges - 添加新选项 ipv6_prefixes 以仅获取 Amazon 服务的 IPV6 地址和前缀 (https://github.com/ansible-collections/amazon.aws/pull/430)

• cloudformation - 修复没有更改时的检测问题。有时，当没有更改时，更改集的状态将为 FAILED，StatusReason 为 No updates are to be performed (https://github.com/ansible-collections/amazon.aws/pull/507)。

• ec2_ami - 添加 check_mode 支持 (https://github.com/ansible-collections/amazon.aws/pull/516)。

• ec2_ami - 使用 module_util 助手标记 AMI (https://github.com/ansible-collections/amazon.aws/pull/520)。

• ec2_ami - 在从实例创建 AMI 时，在创建时传递标记选项 (https://github.com/ansible-collections/amazon.aws/pull/551)。

• ec2_elb_lb - 模块重命名为 elb_classic_lb (https://github.com/ansible-collections/amazon.aws/pull/377)。

• ec2_eni - 添加 check mode 支持 (https://github.com/ansible-collections/amazon.aws/pull/534)。

• ec2_eni - 使用 module_util 助手标记 ENI (https://github.com/ansible-collections/amazon.aws/pull/522)。

• ec2_instance - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/527)。

• ec2_key - 添加对标记密钥对的支持 (https://github.com/ansible-collections/amazon.aws/pull/548)。

• ec2_snapshot - 添加 check_mode 支持 (https://github.com/ansible-collections/amazon.aws/pull/512)。

• ec2_vol - 添加 check_mode 支持 (https://github.com/ansible-collections/amazon.aws/pull/509)。

• ec2_vpc_dhcp_option - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/531)。

• ec2_vpc_endpoint - 添加 vpc_endpoint_security_groups 参数，以支持定义附加到接口终端节点的安全组 (https://github.com/ansible-collections/amazon.aws/pull/544)。

• ec2_vpc_endpoint - 添加 vpc_endpoint_subnets 参数，以支持定义附加到接口或网关终端节点的子网 (https://github.com/ansible-collections/amazon.aws/pull/544)。

• ec2_vpc_endpoint - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/525)。

• ec2_vpc_endpoint - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/531)。

• ec2_vpc_igw - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/523)。

• ec2_vpc_igw - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/531)。

• ec2_vpc_nat_gateway - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/524)。

• ec2_vpc_nat_gateway - 使用 module_util 助手进行标记 (https://github.com/ansible-collections/amazon.aws/pull/531)。

• elb_classic_lb - 在常见的 AWS 临时 API 故障上添加重试 (https://github.com/ansible-collections/amazon.aws/pull/377)。

• elb_classic_lb - 添加对 check_mode 的支持 (https://github.com/ansible-collections/amazon.aws/pull/377)。

• elb_classic_lb - 添加对创建期间等待的支持 (https://github.com/ansible-collections/amazon.aws/pull/377)。

• elb_classic_lb - 添加对实例添加和删除期间等待的支持 (https://github.com/ansible-collections/amazon.aws/pull/377)。

• elb_classic_lb - 迁移到 boto3 SDK (https://github.com/ansible-collections/amazon.aws/pull/377)。

• elb_classic_lb - 由于重构，各种错误消息已更改 (https://github.com/ansible-collections/amazon.aws/pull/377)。

• module_utils.ec2 - 将通用标记助手移到 module_utils.tagging 中 (https://github.com/ansible-collections/amazon.aws/pull/527)。

• module_utils.tagging - 添加新助手以生成 TagSpecification 列表 (https://github.com/ansible-collections/amazon.aws/pull/527)。

已弃用功能

• ec2_classic_lb - 设置 ec2_elb 事实已被弃用，并将在合集 4.0.0 版本中删除。该模块现在返回可以使用 register 关键字访问的 elb (https://github.com/ansible-collections/amazon.aws/pull/552)。

Bug 修复

• AWS 操作组 - 添加了缺少的 ec2_instance_facts 条目 (https://github.com/ansible-collections/amazon.aws/issues/557)

• ec2_ami - 修复了从具有临时卷的实例创建 AMI 时出现的问题 (https://github.com/ansible-collections/amazon.aws/issues/511)。

• ec2_instance - 确保在未传递任何筛选器且未传递任何名称参数时，ec2_instance 回退到 tag(Name) 参数 (https://github.com/ansible-collections/amazon.aws/issues/526)。

• s3_bucket - 更新错误处理以更好地支持 DigitalOcean Space (https://github.com/ansible-collections/amazon.aws/issues/508)。

v2.0.0

重大更改

• amazon.aws 合集 - 由于 AWS SDK 宣布结束对低于 3.6 的 Python 版本的支持 (https://boto3.amazonaws.com/v1/documentation/api/1.17.64/guide/migrationpy3.html)，此合集现在需要 Python 3.6+ (https://github.com/ansible-collections/amazon.aws/pull/298)。

• amazon.aws 合集 - amazon.aws 合集已停止支持 botocore<1.18.0 和 boto3<1.15.0。大多数模块将继续使用旧版本的 AWS SDK，但是不能保证与旧版本的 SDK 的兼容性，并且不会对其进行测试。当使用旧版本的 SDK 时，Ansible 将发出警告 (https://github.com/ansible-collections/amazon.aws/pull/502)。

• ec2_instance - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_instance。

• ec2_instance_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_instance_info。

• ec2_vpc_endpoint - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_endpoint。

• ec2_vpc_endpoint_facts - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_endpoint_info。

• ec2_vpc_endpoint_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_endpoint_info。

• ec2_vpc_endpoint_service_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_endpoint_service_info。

• ec2_vpc_igw - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_igw。

• ec2_vpc_igw_facts - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_igw_facts。

• ec2_vpc_igw_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_igw_info。

• ec2_vpc_nat_gateway - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_nat_gateway。

• ec2_vpc_nat_gateway_facts - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_nat_gateway_info。

• ec2_vpc_nat_gateway_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_nat_gateway_info。

• ec2_vpc_route_table - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_route_table。

• ec2_vpc_route_table_facts - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_route_table_facts。

• ec2_vpc_route_table_info - 该模块已从 community.aws 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_route_table_info。

小的改动

• aws_ec2 - 使用生成器而不是列表推导式 (https://github.com/ansible-collections/amazon.aws/pull/465)。

• aws_s3 - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• aws_s3 - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• aws_s3 - 为 S3 对象添加 tags 和 purge_tags 功能 (https://github.com/ansible-collections/amazon.aws/pull/335)

• aws_s3 - 将现有对象复制到另一个存储桶的新模式 (https://github.com/ansible-collections/amazon.aws/pull/359)。

• aws_secret - 增加了对优雅处理已删除的密钥的支持 (https://github.com/ansible-collections/amazon.aws/pull/455)。

• aws_ssm - 添加 on_missing 和 on_denied 选项 (https://github.com/ansible-collections/amazon.aws/pull/370)。

• cloudformation - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• cloudformation - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_ami - 确保在创建 AMI 时将标签传播到快照 (https://github.com/ansible-collections/amazon.aws/pull/437)。

• ec2_eni - 修复指定 security_groups 属性时的幂等性问题 (https://github.com/ansible-collections/amazon.aws/pull/337)。

• ec2_eni - 增加等待 ENI 完成分离的超时时间 (https://github.com/ansible-collections/amazon.aws/pull/501)。

• ec2_group - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_group - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_group - 使用生成器而不是列表推导式 (https://github.com/ansible-collections/amazon.aws/pull/465)。

• ec2_group - 使用系统 ipaddress 模块（Python >= 3.3 可用），而不是 vendor 副本 (https://github.com/ansible-collections/amazon.aws/pull/461)。

• ec2_instance - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_instance - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_instance - 为 gp3 卷类型添加 throughput 参数 (https://github.com/ansible-collections/amazon.aws/pull/433)。

• ec2_instance - 添加对控制元数据选项的支持 (https://github.com/ansible-collections/amazon.aws/pull/414)。

• ec2_instance - 删除在失败时退出时不必要的 raise (https://github.com/ansible-collections/amazon.aws/pull/460)。

• ec2_instance_info - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_instance_info - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_snapshot - 迁移为使用 boto3 python 库 (https://github.com/ansible-collections/amazon.aws/pull/356)。

• ec2_spot_instance_info - 添加了一个新模块，用于描述指定的 Spot 实例请求 (https://github.com/ansible-collections/amazon.aws/pull/487)。

• ec2_vol - 添加参数 multi_attach 以支持在卷创建/更新时的多重附加 (https://github.com/ansible-collections/amazon.aws/pull/362)。

• ec2_vol - 放宽 boto3/botocore 要求，仅要求 botocore 1.19.27 用于修改 throughput 参数 (https://github.com/ansible-collections/amazon.aws/pull/346)。

• ec2_vpc_dhcp_option - 现在还在 dhcp_options 结果键中返回 boto3 风格的资源描述。这包括 dhcp_options_id 的任何标签，并且具有与 ec2_vpc_dhcp_option_info 的当前返回值相同的格式。( https://github.com/ansible-collections/amazon.aws/pull/252)

• ec2_vpc_dhcp_option_info - 现在还返回一个用户友好的 dhcp_config 键，该键与 ec2_vpc_dhcp_option 的历史 new_config 键匹配，并减轻了在解析模块输出时使用 items2dict(key_name='key', value_name='values') 的需要。( https://github.com/ansible-collections/amazon.aws/pull/252)

• ec2_vpc_subnet - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• ec2_vpc_subnet - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• 集成测试 - 删除与集合 community.general 的依赖关系 (https://github.com/ansible-collections/amazon.aws/pull/361)。

• module_utils/waiter - 添加 RDS 集群 cluster_available 等待器 (https://github.com/ansible-collections/amazon.aws/pull/464)。

• module_utils/waiter - 添加 RDS 集群 cluster_deleted 等待器 (https://github.com/ansible-collections/amazon.aws/pull/464)。

• module_utils/waiter - 添加 Route53 resource_record_sets_changed 等待器 (https://github.com/ansible-collections/amazon.aws/pull/350)。

• s3_bucket - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• s3_bucket - 已删除与旧版本 AWS SDK 兼容性的测试 (https://github.com/ansible-collections/amazon.aws/pull/442)。

• s3_bucket - 添加新选项 object_ownership 以配置对象所有权 (https://github.com/ansible-collections/amazon.aws/pull/311)

• s3_bucket - 更新为在测试存储桶是否存在时使用 HeadBucket 而不是 ListBucket (https://github.com/ansible-collections/amazon.aws/pull/357)。

重大更改/移植指南

• ec2_instance - 实例等待状态的行为已更改。如果剧本要求在启动新实例时，等待实例监控状态变为 OK 的旧行为，则操作需要指定 state: started (https://github.com/ansible-collections/amazon.aws/pull/481)。

• ec2_snapshot - 已删除无限期等待的支持，新的默认值为 10 分钟 (https://github.com/ansible-collections/amazon.aws/pull/356)。

• ec2_vol_info - 返回 attachment_set 现在是磁盘上支持多重连接的附件列表。 (https://github.com/ansible-collections/amazon.aws/pull/362)。

• ec2_vpc_dhcp_option - 该模块已重构为使用 boto3。模块返回的键和值类型现在是一致的，这与之前的行为有所不同。添加了 purge_tags 选项，默认值为 True。 (https://github.com/ansible-collections/amazon.aws/pull/252)

• ec2_vpc_dhcp_option_info - 现在保留返回值的标签键的大小写。 (https://github.com/ansible-collections/amazon.aws/pull/252)

• module_utils.core - 已从区域参数中删除 boto3 开关 (https://github.com/ansible-collections/amazon.aws/pull/287)。

• module_utils/compat - 已删除 ipaddress 的供应商副本 (https://github.com/ansible-collections/amazon.aws/pull/461)。

• module_utils/core - 更新了 scrub_none_parameters 函数，以便默认情况下将 descend_into_lists 设置为 True (https://github.com/ansible-collections/amazon.aws/pull/297)。

已弃用的功能

• ec2 - 基于 boto 的 ec2 模块已弃用，取而代之的是基于 boto3 的 ec2_instance 模块。ec2 模块将在 4.0.0 版本中删除 (https://github.com/ansible-collections/amazon.aws/pull/424)。

• ec2_vpc_dhcp_option - new_config 返回键已弃用，将在未来的版本中删除。它将被 dhcp_config 替换。这两个值在过渡期间都会返回。 (https://github.com/ansible-collections/amazon.aws/pull/252)

Bug 修复

• aws_s3 - 修复当 S3 存储桶 ACL 策略需要特定的预设 ACL 时上传权限的问题 (https://github.com/ansible-collections/amazon.aws/pull/318)

• ec2_ami - 修复当使用 no_device 参数创建 ami 时出现的 ami 问题 (https://github.com/ansible-collections/amazon.aws/pull/386)

• ec2_instance - 当启动新实例时，ec2_instance 正在等待 EC2 实例监控状态变为 OK。这可能会导致剧本等待数分钟才能完成 AWS 的监控状态检查 (https://github.com/ansible-collections/amazon.aws/pull/481)。

• ec2_snapshot - 修复当捕获没有标签的卷的快照时出现的快照问题 (https://github.com/ansible-collections/amazon.aws/pull/383)

• ec2_vol - 修复当使用 modify_volume 但没有附加新磁盘时 changed 状态的问题。即使磁盘已修改（iops、吞吐量、类型等），该模块也会错误地报告没有发生更改。 (https://github.com/ansible-collections/amazon.aws/issues/482)。

• ec2_vol - 修复 iops 设置并强制执行 iops/吞吐量参数的使用 (https://github.com/ansible-collections/amazon.aws/pull/334)

• inventory - 如果未设置 filters，则不再忽略 include_filters (https://github.com/ansible-collections/amazon.aws/issues/457)。

• s3_bucket - 修复尝试设置未实现的功能时出现的错误处理问题 (https://github.com/ansible-collections/amazon.aws/pull/391)。

• s3_bucket - 在获取加密设置时优雅地处理 NotImplemented 异常 (https://github.com/ansible-collections/amazon.aws/issues/390)。

新模块

• ec2_spot_instance - 请求、停止、重启或取消竞价型实例

• ec2_spot_instance_info - 收集有关 ec2 竞价型实例请求的信息

v1.5.1

次要更改

• ec2_instance - 删除在失败时退出时不必要的 raise (https://github.com/ansible-collections/amazon.aws/pull/460)。

Bug 修复

• ec2_vol - 修复当使用 modify_volume 但没有附加新磁盘时 changed 状态的问题。即使磁盘已修改（iops、吞吐量、类型等），该模块也会错误地报告没有发生更改。 (https://github.com/ansible-collections/amazon.aws/issues/482)。

• ec2_vol - 修复 iops 设置并强制执行 iops/吞吐量参数的使用 (https://github.com/ansible-collections/amazon.aws/pull/334)

v1.5.0

次要更改

• AWS 清单插件 - 使用共享的 HAS_BOTO3 助手，而不是复制代码 (https://github.com/ansible-collections/amazon.aws/pull/288)。

• AWS 查找插件 - 使用共享的 HAS_BOTO3 助手，而不是复制代码 (https://github.com/ansible-collections/amazon.aws/pull/288)。

• aws_account_attribute - 在常见的 AWS 故障上添加重试 (https://github.com/ansible-collections/amazon.aws/pull/295)。

• aws_ec2 清单 - 公开一个新的配置键 use_contrib_script_compatible_ec2_tag_keys，以重现旧的 ec2.py 清单脚本的行为。启用此选项后，每个标签都使用 ec2_tag_TAGNAME 键公开 (https://github.com/ansible-collections/amazon.aws/pull/331)。

• aws_ec2 清单 - 公开名为 include_filters 和 exclude_filters 的新键，使用户能够使用多个查询来组成清单 (https://github.com/ansible-collections/amazon.aws/pull/328)。

• aws_ec2 清单插件 - 添加了在身份验证字段中使用 Jinja2 模板的支持 (https://github.com/ansible-collections/amazon.aws/pull/57)。

• cloudformation - 添加了对 StackPolicyDuringUpdateBody 的支持 (https://github.com/ansible-collections/amazon.aws/pull/155)。

• ec2_metadata_facts - 添加了对 IMDSv2 的支持 (https://github.com/ansible-collections/amazon.aws/pull/43)。

• ec2_snapshot_info - 添加了 max_results 以及 next_token_id 选项 (https://github.com/ansible-collections/amazon.aws/pull/321)。

• ec2_tag - 使用通用代码来标记资源 (https://github.com/ansible-collections/amazon.aws/pull/309)。

• ec2_tag_info - 使用通用代码来标记资源 (https://github.com/ansible-collections/amazon.aws/pull/309)。

• ec2_vol - 添加了 purge_tags 选项 (https://github.com/ansible-collections/amazon.aws/pull/242)。

• ec2_vol - 使用通用代码来标记资源 (https://github.com/ansible-collections/amazon.aws/pull/309)。

• ec2_vpc_net - 使用可以处理 API 速率限制的自定义等待器 (https://github.com/ansible-collections/amazon.aws/pull/270)。

• ec2_vpc_subnet - 使用 AWSRetry 装饰器更一致地处理 API 速率限制 (https://github.com/ansible-collections/amazon.aws/pull/270)。

• ec2_vpc_subnet - 使用通用代码来标记资源 (https://github.com/ansible-collections/amazon.aws/pull/309)。

• module_utils.cloudfront_facts - 代码检查清理 (https://github.com/ansible-collections/amazon.aws/pull/291)。

• module_utils.ec2 - 代码检查清理 (https://github.com/ansible-collections/amazon.aws/pull/291)。

• module_utils/core - 添加一个助手函数 normalize_boto3_result (https://github.com/ansible-collections/amazon.aws/pull/271)。

• module_utils/core - 将参数 descend_into_lists 添加到 scrub_none_parameters 助手函数 (https://github.com/ansible-collections/amazon.aws/pull/262)。

• module_utils/ec2 - 为标记 EC2 资源添加了其他助手函数 (https://github.com/ansible-collections/amazon.aws/pull/309)。

• sanity tests - 为 2.12 添加 ignore.txt (https://github.com/ansible-collections/amazon.aws/pull/315)。

Bug 修复

• ec2_vol - 创建或更新现在会保留现有标签，包括名称 (https://github.com/ansible-collections/amazon.aws/issues/229)

• ec2_vol - 修复当平台信息不可用时出现的异常 (https://github.com/ansible-collections/amazon.aws/issues/305)。

v1.4.1

次要更改

• module_utils - ipaddress 模块实用程序已添加到此集合中。这消除了集合对 ansible.netcommon 的依赖（后者在其 2.0 版本中删除了该库）。ipaddress 库仅供此集合内部使用。 (https://github.com/ansible-collections/amazon.aws/issues/273)-

v1.4.0

次要更改

• aws_ec2 - 添加主机名选项连接

• aws_ec2 清单插件 - 避免不必要的导入 ansible.utils.display.Display (https://github.com/ansible-collections/amazon.aws/pull/226).

• aws_ec2 模块 - 替换 aws 实例状态名称反向过滤器 !terminated, !shutting-down，改为使用正向过滤器 pending, running, stopping, stopped。问题 235. (https://github.com/ansible-collections/amazon.aws/pull/237)

• aws_secret - 添加 bypath 功能 (https://github.com/ansible-collections/amazon.aws/pull/192).

• ec2_key - 添加 AWSRetry 装饰器，以便在常见的临时故障时自动重试 (https://github.com/ansible-collections/amazon.aws/pull/213).

• ec2_vol - 添加对 gp3 卷的支持，并支持修改现有卷 (https://github.com/ansible-collections/amazon.aws/issues/55).

• module_utils/elbv2 - 添加比较规则的逻辑，以适应每个字段类型特有的字典中嵌套的值列表。修复问题 (https://github.com/ansible-collections/amazon.aws/issues/187)

• 各种 AWS 插件和 module_utils - 清理未使用的导入 (https://github.com/ansible-collections/amazon.aws/pull/217).

错误修复

• ec2_vol - 创建或更新现在返回一个包含最新标签列表的结构 (https://github.com/ansible-collections/amazon.aws/pull/241).

v1.3.0

次要更改

• aws_caller_info - 添加 AWSRetry 装饰器，以便在常见的临时故障时自动重试 (https://github.com/ansible-collections/amazon.aws/pull/208)

• aws_s3 - 添加对上传模板内容的支持 (https://github.com/ansible-collections/amazon.aws/pull/20).

• aws_secret - 添加 on_missing 和 on_denied 选项 (https://github.com/ansible-collections/amazon.aws/pull/122).

• ec2_ami - 为与速率限制相关的错误添加重试 (https://github.com/ansible-collections/amazon.aws/pull/195).

• ec2_ami - 修复并简化了等待 AMI 创建完成时的 max_attempts 逻辑 (https://github.com/ansible-collections/amazon.aws/pull/194).

• ec2_ami - 将默认 wait_timeout 增加到 1200 秒 (https://github.com/ansible-collections/amazon.aws/pull/194).

• ec2_ami_info - 为与速率限制相关的错误添加重试 (https://github.com/ansible-collections/amazon.aws/pull/195).

• ec2_eni - 通过添加等待器并执行 ENI ID 查找而不是重复搜索，来提高模块的可靠性 (https://github.com/ansible-collections/amazon.aws/pull/180).

• ec2_eni_info - 通过添加等待器并执行 ENI ID 查找而不是重复搜索，来提高模块的可靠性 (https://github.com/ansible-collections/amazon.aws/pull/180).

• ec2_group - 添加 AWSRetry 装饰器，以便在常见的临时故障时自动重试 (https://github.com/ansible-collections/amazon.aws/pull/207)

• ec2_group_info - 添加 AWSRetry 装饰器，以便在常见的临时故障时自动重试 (https://github.com/ansible-collections/amazon.aws/pull/207)

• ec2_snapshot_info - 添加 AWSRetry 装饰器，以便在常见的临时故障时自动重试 (https://github.com/ansible-collections/amazon.aws/pull/208)

• ec2_vol - 在 AWS 速率限制错误时添加自动重试 (https://github.com/ansible-collections/amazon.aws/pull/199).

• ec2_vol - 将 ec2_vol 移植为使用 boto3 (https://github.com/ansible-collections/amazon.aws/pull/53).

• ec2_vpc_dhcp_option_info - 添加 AWSRetry 装饰器，以便在常见的临时故障时自动重试 (https://github.com/ansible-collections/amazon.aws/pull/208)

• module_utils/core - 添加帮助函数 scrub_none_parameters 以删除设置为 None 的参数 (https://github.com/ansible-collections/community.aws/issues/251).

• module_utils/waiters - 为我们的等待器添加重试，以处理与 AWSRetry 重试相同的失败代码 (https://github.com/ansible-collections/amazon.aws/pull/185)

• s3_bucket - 添加对管理 public_access 设置的支持 (https://github.com/ansible-collections/amazon.aws/pull/171).

错误修复

• ec2 - 代码修复，以便模块可以使用 ec2_volume_iops 选项创建 ec2 实例 (https://github.com/ansible-collections/amazon.aws/pull/177).

• ec2 - 在启动和停止时忽略已终止的实例和正在关闭的实例 (https://github.com/ansible-collections/amazon.aws/issues/146).

• ec2_group - 修复标记失败期间的错误处理 (https://github.com/ansible-collections/amazon.aws/issues/210).

• ec2_group_info - 代码修复，使模块可以在 Python 3.8 中工作（在循环中使字典不可变） (https://github.com/ansible-collections/amazon.aws/pull/181)

v1.2.1

次要更改

• ec2_eni - 添加对标记的支持。

• ec2_eni - 将 ec2_eni 模块移植到 boto3 并添加一个集成测试套件。

• ec2_eni_info - 为临时 AWS 故障添加重试。

• ec2_eni_info - 添加对提供 ENI ID 的支持。

v1.2.0

次要更改

• ec2 module_utils - 更新 ec2_connect (boto2) 的行为，以便 ec2_url 覆盖 region。

• module_utils.core - 支持将任意额外的键传递给 fail_json_aws，以匹配 fail_json 的功能。

已弃用功能

• 所有 AWS 模块 - aws_access_key, aws_secret_key 和 security_token 将在 2022-06-01 之后与 profile 互斥。

错误修复

• ec2 module_utils - 确保 boto3 验证参数不会被设置配置文件覆盖 (https://github.com/ansible-collections/amazon.aws/issues/129)

• s3_bucket - Ceph 兼容性：将 Ceph 使用的错误代码 NoSuchTagSetError 与 AWS 使用的 NoSuchTagSet 视为同义词

v1.1.0

重大更改

• ec2 module_utils - AWSRetry 装饰器默认不再捕获 NotFound 异常。需要使用 catch_extra_error_codes 显式添加 NotFound 异常。由于 AWS 的最终一致性模型，一些 AWS 模块可能会出现更多瞬时故障。

次要更改

• 添加 aws_security_token, aws_endpoint_url 和 endpoint_url 别名，以提高 AWS 模块参数命名的一致性。

• 添加对基于 boto3 的 AWS 模块的 aws_ca_bundle 的支持

• 添加使用 AWS_PROFILE 和 AWS_DEFAULT_PROFILE 配置 boto3 配置文件的支持

• 为 aws_az_info 添加 check_mode 支持

• 为 ec2_eni_info 添加 check_mode 支持

• 为 ec2_snapshot_info 添加 check_mode 支持

• ansible_dict_to_boto3_filter_list - 在过滤器中使用整数和布尔值之前，将它们转换为字符串。

• aws_direct_connect_virtual_interface - 添加 direct_connect_gateway_id 参数。此字段仅适用于私有 VIF 案例（public=False），并且与 virtual_gateway_id 互斥。

• cloudformation - 如果创建了更改集，则在 cloudformation 输出中返回 change_set_id。

• ec2 - 弃用允许同时使用组和 group_id - 目前，如果同时传递两者，我们将忽略 group_id。

• ec2_ami_info - 允许使用整数和布尔值来过滤图像 (https://github.com/ansible/ansible/issues/43570).

• ec2_asg - 添加对最大实例生命周期的支持

• ec2_asg - 添加在启动模板驱动的自动伸缩组中使用 mixed_instance_policy 的能力

• ec2_asg - 迁移到 AnsibleAWSModule

• ec2_placement_group - 使 name 成为必填字段。

• ec2_vol_info - 代码清理和使用 AWSRetry 装饰器来提高稳定性

• ec2_vpc_net - 启用 IPv6 CIDR 分配

重大更改/移植指南

• aws_s3 - 现在即使版本控制存储桶不为空也可以删除它们 - 将模式设置为 delete 以删除版本控制存储桶及其中的所有内容。

已弃用功能

• cloudformation - template_format 选项自 Ansible 2.3 以来不起作用，将在 2022-06-01 之后删除

• cloudformation - template_format 选项已被弃用，将在以后的版本中删除。自 Ansible 2.3 以来，该模块已忽略它。

• data_pipeline - version 选项不起作用，将在 2022-06-01 之后删除

• ec2 - 在以后的版本中，group 和 group_id 选项将变为互斥。目前，如果您同时传递两者，则 group_id 将被忽略。

• ec2_ami - no_device 别名 NoDevice 已弃用，将于 2022-06-01 之后移除。

• ec2_ami - virtual_name 别名 VirtualName 已弃用，将于 2022-06-01 之后移除。

• ec2_eip - wait_timeout 选项无效，将于 2022-06-01 之后移除。

• ec2_key - wait_timeout 选项无效，将于 2022-06-01 之后移除。

• ec2_key - wait 选项无效，将于 2022-06-01 之后移除。

• ec2_key - wait_timeout 选项已弃用，将在以后的版本中移除。自 Ansible 2.5 以来，它没有任何作用。

• ec2_key - wait 选项已弃用，将在以后的版本中移除。自 Ansible 2.5 以来，它没有任何作用。

• ec2_lc - associate_public_ip_address 选项无效，将于 2022-06-01 之后移除。

• ec2_tag - 弃用 list 选项，推荐使用 ec2_tag_info。

• ec2_tag - 作为状态的 list 的支持已弃用，将在以后的版本中移除。可以使用 ec2_tag_info 来获取 EC2 资源上的标签。

Bugfixes

• aws_ec2 - 修复管理标签时的幂等性问题。

• aws_ec2 - 修复启用指标时的幂等性问题。

• aws_s3 - 删除对象和删除标记，以便可以移除版本化的存储桶。

• aws_s3 - 尝试等待存储桶存在，然后再设置访问控制列表。

• cloudformation_info - 修复返回有关堆栈信息的 KeyError。

• ec2_asg - 确保在替换操作期间遵守 wait。

• ec2_launch_template - 更新输出以包含 latest_version 和 default_version，与文档保持一致。

• ec2_transit_gateway - 在描述传输网关时，在处理 ClientError 之前使用 AWSRetry。

• ec2_transit_gateway - 修复了 auto_attach 设置为 yes 时未生效的问题 (https://github.com/ansible/ansible/issues/61907)

• ec2_vol - 修复过滤错误。

• s3_bucket - 接受 XNotImplemented 响应以支持 NetApp StorageGRID。