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 集合迁移。使用此模块的完全限定集合名称的 Playbook 应更新为使用 amazon.aws.ec2_vpc_vpn_info。

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

细微更改

• 添加对 transit gateway vpc attachment 模块的支持 (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 routes 参数以支持 transit gateway 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 - 为 Launch template 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).

错误修复

• 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 自动伸缩组 (ASG) 关联的实例

• autoscaling_instance_info - 描述与 AWS 自动伸缩组 (ASG) 关联的实例

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

• ec2_vpc_egress_igw_info - 收集有关 AWS VPC 专用互联网网关的信息

v8.2.1

发行摘要

这是一个针对 iam_role 模块的错误修复版本，它解决了当 create_instance_profile 设置为 false 时创建 IAM 实例配置文件的问题，并解决了当实例配置文件已存在时的 EntityAlreadyExists 异常。

错误修复

• 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 - 根据 boto 文档，参数 performance_insights_kms_key_id 的蛇形命名法不正确 (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 不再从 CamelCase 转换为 snake_case (https://github.com/ansible-collections/amazon.aws/pull/2040)。

• iam_role_info - iam_role.assume_role_policy_document 不再从 CamelCase 转换为 snake_case (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 inventory 插件 - 已删除先前已弃用的 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)。

错误修复

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

• lambda_event - 通过启用对设置 maximum_batching_window_in_seconds 的支持，修复了 batch_size 大于 10 时的错误 (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 模块的错误修复。

错误修复

• 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)。

错误修复

• 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）。

错误修复

• 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）。

错误修复

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

• lookup/secretsmanager_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）。

错误修复

• 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 - 添加 group_name 作为 name 的别名，以与其他 IAM 模块保持一致（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 - 添加 prefix 和 path_prefix 作为 path 的别名，以与其他 IAM 模块保持一致（https://github.com/ansible-collections/amazon.aws/pull/1933）。

• iam_role - 添加 role_name 作为 name 的别名，以与其他 IAM 模块保持一致（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 - 添加 path 和 prefix 作为 path_prefix 的别名，以与其他 IAM 模块保持一致（https://github.com/ansible-collections/amazon.aws/pull/1933）。

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

• iam_user - 添加 user_name 作为 name 的别名，以与其他 IAM 模块保持一致（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 - 添加 prefix 作为 path_prefix 的别名，以与其他 IAM 模块保持一致（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 宣布终止对低于 3.7 的 Python 版本的支持（https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/），因此此集合对低于 3.7 的 Python 版本的支持已在 6.0.0 版本中弃用，并在本版本中移除。

主要更改

• 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 - 在适当的地方使用 f-string（https://github.com/ansible-collections/amazon.aws/pull/1802）。

• ec2_vpc_igw - 添加了将 VPC 附加到/从互联网网关分离的能力（https://github.com/ansible-collections/amazon.aws/pull/1786）。

• ec2_vpc_igw - 添加了更改附加到互联网网关的 VPC 的能力（https://github.com/ansible-collections/amazon.aws/pull/1786）。

• ec2_vpc_igw - 添加了在不附加 VPC 的情况下创建互联网网关的能力（https://github.com/ansible-collections/amazon.aws/pull/1786）。

• ec2_vpc_igw - 添加了使用网关 ID 删除 VPC 互联网网关的能力（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 宣布终止对低于 3.7 的 Python 版本的支持（https://aws.amazon.com/blogs/developer/python-support-policy-updates-for-aws-sdks-and-tools/），此集合对低于 3.7 的 Python 版本的支持已在 6.0.0 版本中弃用，并在 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）。

错误修复

• 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 - 修复了嵌套密钥丢失且 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 - 在 launch_permissions 中添加对 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 模块 - 在创建或修改多可用区 RDS 集群时，添加 AllocatedStorage、DBClusterInstanceClass、StorageType、Iops 和 EngineMode 到可传递的参数列表中 (https://github.com/ansible-collections/amazon.aws/pull/1657)。

• rds_cluster 模块 - 允许在创建 RDS 集群时传递 GlobalClusterIdentifier 参数 (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 模块 - 向 parse_aws_arn 返回值添加 resource_id 和 resource_type (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 网关。该模块 (ec2_vpc_nat_gateway) 在 EIP 不存在时错误地静默失败 (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)。

错误修复

• 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 模块 - 修复了添加网络接口时的检查模式问题 (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 时缺少属性的问题。在更新现有 ALB 时，create_or_update_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 模块 - 添加了对在创建/更新 RDS 实例时使用 CACertificateIdentifier 的支持 (https://github.com/ansible-collections/amazon.aws/pull/1459)。

v6.0.1

发行概要

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

错误修复

• 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 模块 - 在多次重构之后，对导入语句进行了批量更新 (https://github.com/ansible-collections/amazon.aws/pull/1310).

• autoscaling_group - 细微的代码风格修复 (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 inventory - 细微的代码风格修复 (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_selection* 模块添加逻辑 (https://github.com/ansible-collections/amazon.aws/pull/1530).

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

• cloud module_utils - 细微的代码风格修复 (https://github.com/ansible-collections/amazon.aws/pull/1181).

• cloudtrail_info - 细微的代码风格修复 (https://github.com/ansible-collections/amazon.aws/pull/1181).

• cloudwatchlogs_log_group - 细微的代码风格修复 (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 - 细微的代码风格修复 (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 库存信息并填充 hostvars (https://github.com/ansible-collections/amazon.aws/issues/704).

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

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

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

• kms_key_info - 细微的代码风格修复 (https://github.com/ansible-collections/amazon.aws/pull/1181).

• lambda - 细微的代码风格修复 (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 - 细微的代码风格修复 (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 - 轻微的 lint 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181).

• rds_instance - 轻微的 lint 修复 (https://github.com/ansible-collections/amazon.aws/pull/1181).

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

• rds_instance_snapshot - 轻微的 lint 修复 (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 - 轻微的 lint 修复 (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 - 重构主函数以降低复杂性 (https://github.com/ansible-collections/amazon.aws/pull/1193).

• s3_object_info - 轻微的 lint 修复 (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 参数的别名）。请改用 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 - 在重命名为 dhcp_config 后，new_options 返回值已弃用。请使用 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 lookup 插件 - 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 - 对传递 overwrite 值（非 always、never、different 或 last）的支持已弃用。布尔值应替换为字符串 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).

错误修复

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

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

• lambda_execute - 修复传递function_arn而不是name时的等待器错误(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_plan_info - 描述AWS备份计划

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

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

• backup_selection_info - 描述AWS备份选择

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

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

• backup_vault - 管理AWS备份库

• backup_vault_info - 描述AWS备份库

v5.5.3

发行摘要

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

错误修复

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

• rds_cluster 模块 - 允许在创建 RDS 集群时传递 GlobalClusterIdentifier 参数 (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 模块 - 修复了添加网络接口时的检查模式问题 (https://github.com/ansible-collections/amazon.aws/issues/1403)。

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

v5.5.0

发行摘要

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

次要更改

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

• cloudwatch - 向cloudwatch模块添加metrics和extended_statistic键 (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 - 向create_key添加multi_region选项 (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数据库时的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 - 修复了获取健康检查状态或失败原因时出现的 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).

错误修复

• 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 库存插件的错误修复，以及对 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).

错误修复

• 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

发行摘要

此版本带来了一些小的更改、错误修复、安全修复和弃用的功能。

次要更改

• 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 lookup 插件 - 使用 missing_required_lib 以在 boto3/botocore 不可用时获得更一致的错误消息 (https://github.com/ansible-collections/amazon.aws/pull/1152).

• aws_ec2 inventory - 细微的代码风格修复 (https://github.com/ansible-collections/amazon.aws/pull/1181).

• aws_ec2 库存插件 - 使用 missing_required_lib 以在 boto3/botocore 不可用时获得更一致的错误消息 (https://github.com/ansible-collections/amazon.aws/pull/1152).

• aws_rds 库存插件 - 使用 missing_required_lib 以在 boto3/botocore 不可用时获得更一致的错误消息 (https://github.com/ansible-collections/amazon.aws/pull/1152).

• aws_secret lookup 插件 - 使用 missing_required_lib 以在 boto3/botocore 不可用时获得更一致的错误消息 (https://github.com/ansible-collections/amazon.aws/pull/1152).

• aws_ssm lookup 插件 - 使用 missing_required_lib 以在 boto3/botocore 不可用时获得更一致的错误消息 (https://github.com/ansible-collections/amazon.aws/pull/1152).

• ec2_instance - 在未提供 vpc_subnet_id 时，用于在指定 AZ 中启动实例的小修复 (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 - 轻微的 lint 修复 (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 集合 - access_key 参数的 ec2_access_key 别名已弃用，并将在 2024-12-01 之后的一个版本中移除。请改用 access_key 名称 (https://github.com/ansible-collections/amazon.aws/pull/1172)。

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

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

• amazon.aws 集合 - session_token 参数的 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)。

错误修复

• 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

错误修复

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

v5.0.1

错误修复

• 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 支持状态。这些模块已从 community.aws 集合移动到 amazon.aws 集合。此版本还带来了一些新功能、错误修复、重大更改和弃用功能。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 - 轻微的 lint 修复 (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 - 轻微的 lint 修复 (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 - 轻微的 lint 修复 (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 - 将rules->group_name的类型设置为list，因为它可以同时接受str和list (https://github.com/ansible-collections/amazon.aws/pull/971).

• 多个模块 - 代码风格修复 (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 密钥的支持 (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:开头的标签在清除标签时不会被删除，这些标签由亚马逊保留，可能无法更新或删除 (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 的默认值已从 always 更改为 different，以便模块默认情况下具有幂等性 ( https://github.com/ansible-collections/amazon.aws/issues/811)。

• aws_ssm - 为了与 aws_secret 和基础 Lookup 类保持一致，on_denied 和 on_missing 现在都默认设置为 error ( 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 - DeviceName（device_name 选项的别名）已弃用，将在 5.0.0 版本中移除 ( https://github.com/ansible-collections/community.aws/pull/795)。

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

• ec2_ami - VirtualName（virtual_name 选项的别名）已弃用，将在 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 或 launch_template ( 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 - DhcpOptionIds（dhcp_option_ids 选项的别名）已弃用，将在 5.0.0 版本中移除 ( https://github.com/ansible-collections/community.aws/pull/795)。

• ec2_vpc_dhcp_option_info - DryRun（dry_run 选项的别名）已弃用，将在 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)。

错误修正

• 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 而不是 filters 进行分页，以修复 “‘NoneType’ object is not subscriptable” 错误 (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 - 将rules->group_name的类型设置为list，因为它可以同时接受str和list (https://github.com/ansible-collections/amazon.aws/pull/971).

错误修复

• 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).

错误修复

• 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 模块 - 为 security_token 参数添加新的别名 aws_session_token 和 session_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).

错误修复

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

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

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

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

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

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

• aws_service_ip_ranges lookup 插件 - 修复文档数据中的 linting 错误 (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 lookup 插件 - 修复文档数据中的 linting 错误 (https://github.com/ansible-collections/amazon.aws/pull/701).

• ec2_instance 模块 - Python 3.8 中 ec2_instance 模块损坏 - 在迭代期间修改字典键 (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 模块 - 将弃用警告的范围修正为：当 state 为 absent 时不显示警告 (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 中的检查模式 (https://github.com/ansible-collections/amazon.aws/pull/696).

• s3_bucket 模块 - 添加对强制存储桶所有者对象所有权的支持 (https://github.com/ansible-collections/amazon.aws/pull/694).

错误修复

• aws_ec2 inventory 插件 - 如果未设置 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’ object is not subscriptable” 错误 (https://github.com/ansible-collections/amazon.aws/pull/691).

• ec2_vpc_igw 模块 - 使用分页器描述互联网网关并添加重试以修复 “NoneType” object is not subscriptable 错误 (https://github.com/ansible-collections/amazon.aws/pull/695).

• ec2_vpc_net 模块 - 在检查模式下，确保模块不会更改配置。处理启用、禁用、然后再次启用 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 inventory 插件添加新的参数 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 或 launch_template ( https://github.com/ansible-collections/amazon.aws/pull/587)。

错误修复

• 各种模块和插件 - 使用 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 - 添加计数参数支持（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

错误修复

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

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

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

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

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

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

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

• ec2_instance 模块 - Python 3.8 中 ec2_instance 模块损坏 - 在迭代期间修改字典键 (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 - 添加计数参数支持（https://github.com/ansible-collections/amazon.aws/pull/539）。

错误修复

• aws_ec2 inventory 插件 - 如果未设置 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’ object is not subscriptable” 错误 (https://github.com/ansible-collections/amazon.aws/pull/691).

• ec2_vpc_igw 模块 - 使用分页器描述互联网网关并添加重试以修复 “NoneType” object is not subscriptable 错误 (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 为“无需执行任何更新”（https://github.com/ansible-collections/amazon.aws/pull/507）。

• ec2_ami - 添加检查模式支持（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 - 添加检查模式支持（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 - 添加检查模式支持（https://github.com/ansible-collections/amazon.aws/pull/512）。

• ec2_vol - 添加检查模式支持（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 - 添加对检查模式的支持（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 版本中删除。该模块现在返回 elb，可以使用 register 关键字访问它 (https://github.com/ansible-collections/amazon.aws/pull/552)。

错误修复

• 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 - 使用 Python >= 3.3 可用的系统 ipaddress 模块，而不是复制的版本 (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 - 已从 region 参数中删除 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)

错误修复

• 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/throughput 参数 (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 - 请求、停止、重启或取消 Spot 实例

• ec2_spot_instance_info - 收集有关 ec2 Spot 实例请求的信息

v1.5.1

次要更改

• ec2_instance - 删除了在以失败退出时不必要的 raise (https://github.com/ansible-collections/amazon.aws/pull/460)。

错误修复

• ec2_vol - 修复使用 modify_volume 但没有附加新磁盘时的 changed 状态。即使磁盘已被修改（iops、吞吐量、类型等），模块也错误地报告没有发生更改。(https://github.com/ansible-collections/amazon.aws/issues/482).

• ec2_vol - 修复 iops 设置并强制使用 iops/throughput 参数 (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 - 向scrub_none_parameters辅助函数添加参数descend_into_lists（https://github.com/ansible-collections/amazon.aws/pull/262）。

• module_utils/ec2 - 添加了用于标记EC2资源的其他辅助函数（https://github.com/ansible-collections/amazon.aws/pull/309）。

• 完整性测试 - 为2.12添加ignore.txt（https://github.com/ansible-collections/amazon.aws/pull/315）。

错误修复

• 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 - 添加逻辑到compare_rules以适应每个字段类型中嵌套在dicts内的Values列表。修复问题（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 verify参数不会被设置配置文件覆盖(https://github.com/ansible-collections/amazon.aws/issues/129)

• s3_bucket - Ceph兼容性：将Ceph使用的错误代码NoSuchTagSetError与AWS使用的NoSuchTagSet同义处理。

v1.1.0

主要更改

• ec2 module_utils - AWSRetry装饰器不再默认捕获NotFound异常。NotFound异常需要使用catch_extra_error_codes显式添加。由于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和group_id - 目前如果同时传递，我们将忽略group_id。

• ec2_ami_info - 允许使用整数和布尔值过滤镜像(https://github.com/ansible/ansible/issues/43570)。

• ec2_asg - 添加对Max Instance Lifetime的支持。

• 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资源上的标签。

错误修复

• 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。