terraform-provider-aws 6.16.0 版本深度解读Transcribe Action、Transfer Web App、ODB 数据源与框架层修复全解析【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws本篇文章以 .changes/6.x/6.16.0.md 变更记录为核心结合 terraform-provider-aws 仓库源码系统解读 6.16.0 版本的三大类变更新增的 9 个功能含 1 个 Action、2 个新资源系列与 6 个数据源、5 项资源增强以及覆盖 Provider 核心与多个服务的缺陷修复。读完本文你将掌握这批新资源的参数用法、底层实现原理以及框架层身份Identity修复对 Plugin Framework 资源的影响边界。一、版本概览与变更结构6.16.0 发布于 2025 年 10 月 9 日属于 6.x 主版本线的常规功能迭代。本仓库当前代码版本为 6.64.1见 version/VERSION6.16.0 作为更早的历史版本其变更记录完整保存在 .changes/6.x/6.16.0.md 中遵循该仓库的 changelog-process 规范按FEATURES、ENHANCEMENTS、BUG FIXES三类组织。本版本变更覆盖面广概括如下类别数量涉及服务FEATURES新功能9 项Transcribe、ODB、PrometheusAMP、TransferENHANCEMENTS增强5 项CodeBuild、EMR Serverless、Lambda、SSM Contacts、VPC LatticeBUG FIXES修复13 项Provider 核心、DataZone、DynamoDB、IVS Chat、Launch Template、Service Catalog二、FEATURES新增 Action、资源与数据源1. 全新 Actionaws_transcribe_start_transcription_job这是 6.16.0 中最具代表性的新能力——Terraform Plugin Framework 的Action类型。与 Resource/Data Source 不同Action 用于执行一次性操作而不维护持久状态适合提交任务、等待完成的场景。其核心实现位于 internal/service/transcribe/start_transcription_job_action.go通过Action(aws_transcribe_start_transcription_job, nameStart Transcription Job)注解注册到 Provider。从源码模型可确认以下参数参数类型必填说明transcription_job_nameString是账户内唯一的转录任务名称media_file_uriString是待转录媒体文件的 S3 位置如s3://bucket-name/file.mp3language_codeString 枚举否媒体文件语言代码当identify_language与identify_multiple_languages均为 false 时必填identify_languageBool否单语言文件自动语言识别不能与identify_multiple_languages同时使用identify_multiple_languagesBool否多语言文件自动语言识别media_formatString 枚举否媒体格式media_sample_rate_hertzInt64否媒体采样率output_bucket_nameString否输出结果 S3 桶output_keyString否输出对象键timeoutInt64否任务超时控制源码还定义了轮询节奏常量transcriptionJobPollInterval 5 * time.Second普通轮询间隔与transcriptionJobProgressInterval 30 * time.Second进度上报间隔配合 internal/actionwait 实现任务完成的等待逻辑对应测试见 internal/service/transcribe/start_transcription_job_action_test.go。2. AWS Transfer 三连aws_transfer_web_app、aws_transfer_web_app_customization、aws_transfer_host_key本版本为 AWS Transfer Family 一次性新增三个资源实现在internal/service/transfer目录下。aws_transfer_web_app源码 internal/service/transfer/web_app.go基于FrameworkResource注解注册核心 schema 包括access_endpoint可选长度 1–1024与endpoint_details下的vpc块互斥ConflictsWithweb_app_endpoint_policy枚举类型配置后触发RequiresReplace重建web_app_units嵌套对象列表最多 1 个endpoint_details.vpcVPC 接入详情块其中subnet_ids与vpc_id为必填security_group_ids可选vpc_endpoint_id由系统计算支持标准tags体系identifierAttributearn。aws_transfer_web_app_customization源码 internal/service/transfer/web_app_customization.go用于定制 Web App 界面外观确认存在favicon_file长度 1–20960与logo_file长度 1–51200两个可选计算属性。源码注释特别说明调用 UpdateWebAppCustomization API 时若未指定faviconFile现有图标保持不变因此这两个字段被标记为Optional Computed并使用UseStateForUnknown。aws_transfer_host_key源码 internal/service/transfer/host_key.go管理服务器主机密钥值得关注的是其写专用WriteOnly属性设计host_key_body敏感字符串长度 0–4096带RequiresReplacehost_key_body_wo同样的敏感字段但标记为WriteOnly: true并通过PreferWriteOnlyAttribute校验器与host_key_body构成二选一ExactlyOneOf这是仓库 internal/framework/planmodifiers/stringplanmodifier 中RequiresReplaceWO机制的典型应用description长度 0–200host_key_fingerprint计算属性用于校验密钥指纹server_id必填变更触发重建。3. 新资源aws_prometheus_resource_policy为 Amazon Managed PrometheusAMP新增的资源策略管理能力实现在 internal/service/amp/resource_policy.go配套测试见 internal/service/amp/resource_policy_test.go。它允许以 Terraform 方式声明工作区的资源策略将权限策略纳入 IaC 版本管理。4. ODB 数据源五连发aws_odb_*ODBOracle DatabaseAWS服务在本版本集中补齐了 5 个列表型数据源均位于 internal/service/odb 目录aws_odb_cloud_autonomous_vm_clusterscloud_autonomous_vm_clusters_data_source.goaws_odb_cloud_exadata_infrastructurescloud_exadata_infrastructures_data_source.goaws_odb_cloud_vm_clusterscloud_vm_clusters_data_source.goaws_odb_network_peering_connectionsnetwork_peering_connections_data_source.goaws_odb_networksnetworks_data_source.go以aws_odb_cloud_autonomous_vm_clusters为例数据源只实现Read方法内部调用ListCloudAutonomousVmClusters并通过 SDK 分页器NewListCloudAutonomousVmClustersPaginator聚合所有页数据返回cloud_autonomous_vm_clusters列表属性。单个摘要对象包含arn、id、cloud_exadata_infrastructure_id、odb_network_id、oci_resource_anchor_name、oci_url、ocid、display_name等字段可与已存在的单例数据源如 cloud_autonomous_vm_cluster_data_source.go配合使用先查列表再定位具体资源。三、ENHANCEMENTS五项资源能力增强1.aws_codebuild_project新增auto_retry_limit为 CodeBuild 项目增加自动重试上限参数#40035允许用户在构建失败场景下配置自动重试次数减少手工重新触发构建的运维负担。2.aws_emrserverless_application新增scheduler_configuration为 EMR Serverless 应用引入调度配置块#44589使应用可以按预定计划执行任务扩展了 Serverless 作业的自动化能力。3.aws_lambda_event_source_mapping新增schema_registry_config在amazon_managed_kafka_event_source_config与self_managed_kafka_event_source_config两个块内新增schema_registry_config配置块#44540让 MSK / 自管理 Kafka 事件源可以绑定 Schema Registry支撑 Avro 等带 Schema 的消息格式处理。4.aws_ssmcontacts_contact资源身份支持为 SSM Contacts 联系人资源补齐resource identity能力#44548 与 docs/add-resource-identity-support.md核心思路是以规范化 Identity 替代传统 ID 字符串为import、状态校验与一致性检查提供统一入口。5.aws_vpclattice_resource_gateway新增ipv4_addresses_per_eni为 VPC Lattice 资源网关增加ipv4_addresses_per_eni参数#44560用于控制每个弹性网络接口ENI上分配的 IPv4 地址数量细化网关的 IP 资源配置。四、BUG FIXESProvider 核心与多服务修复1. Provider 核心修复本版本最重要的修复集中在 Provider 层AWS 欧洲主权云区域 ARN 校验#44573 与 docs/arn.md如存在中的区域扩展说明。修复 Plugin Framework 资源的Missing Resource Identity After Update#44518 的身份处理机制直接相关。修复Unexpected Identity Change#44518当 state 中全空fully-null的 identity 值被更新为合法值时不再误报意外身份变更。这两个修复对大量基于 Plugin Framework 的存量资源都有正面影响升级后若曾受此类报错困扰可重点回归验证相关资源的 update 流程。2. DataZone 环境与项目修复针对aws_datazone_environment与aws_datazone_project的修复多达 8 条#44491aws_datazone_environment正确更新glossary_terms可选参数account_identifier、account_region未指定时不再报unknown value更新时不再报错删除时不再偶发unexpected state创建时正确传递blueprint_identifier导入时正确设置user_parameters的值user_parameters中的值不再允许被更新只读语义修正。aws_datazone_project删除时不再忽略错误资源已在删除中时不再重复报错。这批修复说明 6.16.0 对 DataZone 资源的创建、导入、更新、删除全生命周期做了系统性打磨使用 DataZone 的团队升级后应重点验证现有 environment/project 的terraform plan与apply行为是否与预期一致。3. 其他资源修复aws_dynamodb_table#44576不再对LimitExceededException进行重试避免在限流错误上做无效的指数退避等待aws_ivschat_room#44572将maximum_message_rate_per_second的校验上限修正为100与此前实际 API 约束对齐aws_launch_template#44505kms_key_id校验放宽为同时接受 Key ID、别名、别名 ARN 以及 Key ARN 四种形式与 KMS 参数的常见传值习惯保持一致aws_servicecatalog_portfolio_share#24730 等基础设施支撑。五、升级建议与影响评估综合以上变更升级到 6.16.0 时可参考以下要点新功能开箱即用Transcribe Action、Transfer 三件套与 ODB 数据源均为新增能力不改变既有资源配置可安全引入Transfer 的host_key_body_wo展示了本仓库对 WriteOnly 敏感属性的推荐用法新增资源建议直接采用该模式。框架层修复收益面广Missing Resource Identity After Update与Unexpected Identity Change两个 Provider 级修复影响所有 Plugin Framework 资源若此前升级过程中遇到过上述报错6.16.0 是值得优先验证的版本。行为变更需回归DataZone 的user_parameters只读语义修正、DynamoDB 表对LimitExceededException停止重试、Launch Template 的kms_key_id校验放宽均可能改变既有配置的 plan 结果或运行行为建议在升级环境中先行回归。并发与限流优化Service Catalog Portfolio Share 的全局锁与 DynamoDB 的重试策略调整面向的都是真实场景中的限流/并发问题对大规模账户运营场景尤为相关。如需继续深入可阅读仓库内的 docs/changelog-process.md 了解变更记录维护规范、docs/breaking-changes.md 评估破坏性变更边界或直接查阅上文列出的各资源源码与测试文件掌握每个新增参数的精确约束与实现细节。【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
terraform-provider-aws 6.16.0 版本深度解读：Transcribe Action、Transfer Web App、ODB 数据源与框架层修复全解析
terraform-provider-aws 6.16.0 版本深度解读Transcribe Action、Transfer Web App、ODB 数据源与框架层修复全解析【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws本篇文章以 .changes/6.x/6.16.0.md 变更记录为核心结合 terraform-provider-aws 仓库源码系统解读 6.16.0 版本的三大类变更新增的 9 个功能含 1 个 Action、2 个新资源系列与 6 个数据源、5 项资源增强以及覆盖 Provider 核心与多个服务的缺陷修复。读完本文你将掌握这批新资源的参数用法、底层实现原理以及框架层身份Identity修复对 Plugin Framework 资源的影响边界。一、版本概览与变更结构6.16.0 发布于 2025 年 10 月 9 日属于 6.x 主版本线的常规功能迭代。本仓库当前代码版本为 6.64.1见 version/VERSION6.16.0 作为更早的历史版本其变更记录完整保存在 .changes/6.x/6.16.0.md 中遵循该仓库的 changelog-process 规范按FEATURES、ENHANCEMENTS、BUG FIXES三类组织。本版本变更覆盖面广概括如下类别数量涉及服务FEATURES新功能9 项Transcribe、ODB、PrometheusAMP、TransferENHANCEMENTS增强5 项CodeBuild、EMR Serverless、Lambda、SSM Contacts、VPC LatticeBUG FIXES修复13 项Provider 核心、DataZone、DynamoDB、IVS Chat、Launch Template、Service Catalog二、FEATURES新增 Action、资源与数据源1. 全新 Actionaws_transcribe_start_transcription_job这是 6.16.0 中最具代表性的新能力——Terraform Plugin Framework 的Action类型。与 Resource/Data Source 不同Action 用于执行一次性操作而不维护持久状态适合提交任务、等待完成的场景。其核心实现位于 internal/service/transcribe/start_transcription_job_action.go通过Action(aws_transcribe_start_transcription_job, nameStart Transcription Job)注解注册到 Provider。从源码模型可确认以下参数参数类型必填说明transcription_job_nameString是账户内唯一的转录任务名称media_file_uriString是待转录媒体文件的 S3 位置如s3://bucket-name/file.mp3language_codeString 枚举否媒体文件语言代码当identify_language与identify_multiple_languages均为 false 时必填identify_languageBool否单语言文件自动语言识别不能与identify_multiple_languages同时使用identify_multiple_languagesBool否多语言文件自动语言识别media_formatString 枚举否媒体格式media_sample_rate_hertzInt64否媒体采样率output_bucket_nameString否输出结果 S3 桶output_keyString否输出对象键timeoutInt64否任务超时控制源码还定义了轮询节奏常量transcriptionJobPollInterval 5 * time.Second普通轮询间隔与transcriptionJobProgressInterval 30 * time.Second进度上报间隔配合 internal/actionwait 实现任务完成的等待逻辑对应测试见 internal/service/transcribe/start_transcription_job_action_test.go。2. AWS Transfer 三连aws_transfer_web_app、aws_transfer_web_app_customization、aws_transfer_host_key本版本为 AWS Transfer Family 一次性新增三个资源实现在internal/service/transfer目录下。aws_transfer_web_app源码 internal/service/transfer/web_app.go基于FrameworkResource注解注册核心 schema 包括access_endpoint可选长度 1–1024与endpoint_details下的vpc块互斥ConflictsWithweb_app_endpoint_policy枚举类型配置后触发RequiresReplace重建web_app_units嵌套对象列表最多 1 个endpoint_details.vpcVPC 接入详情块其中subnet_ids与vpc_id为必填security_group_ids可选vpc_endpoint_id由系统计算支持标准tags体系identifierAttributearn。aws_transfer_web_app_customization源码 internal/service/transfer/web_app_customization.go用于定制 Web App 界面外观确认存在favicon_file长度 1–20960与logo_file长度 1–51200两个可选计算属性。源码注释特别说明调用 UpdateWebAppCustomization API 时若未指定faviconFile现有图标保持不变因此这两个字段被标记为Optional Computed并使用UseStateForUnknown。aws_transfer_host_key源码 internal/service/transfer/host_key.go管理服务器主机密钥值得关注的是其写专用WriteOnly属性设计host_key_body敏感字符串长度 0–4096带RequiresReplacehost_key_body_wo同样的敏感字段但标记为WriteOnly: true并通过PreferWriteOnlyAttribute校验器与host_key_body构成二选一ExactlyOneOf这是仓库 internal/framework/planmodifiers/stringplanmodifier 中RequiresReplaceWO机制的典型应用description长度 0–200host_key_fingerprint计算属性用于校验密钥指纹server_id必填变更触发重建。3. 新资源aws_prometheus_resource_policy为 Amazon Managed PrometheusAMP新增的资源策略管理能力实现在 internal/service/amp/resource_policy.go配套测试见 internal/service/amp/resource_policy_test.go。它允许以 Terraform 方式声明工作区的资源策略将权限策略纳入 IaC 版本管理。4. ODB 数据源五连发aws_odb_*ODBOracle DatabaseAWS服务在本版本集中补齐了 5 个列表型数据源均位于 internal/service/odb 目录aws_odb_cloud_autonomous_vm_clusterscloud_autonomous_vm_clusters_data_source.goaws_odb_cloud_exadata_infrastructurescloud_exadata_infrastructures_data_source.goaws_odb_cloud_vm_clusterscloud_vm_clusters_data_source.goaws_odb_network_peering_connectionsnetwork_peering_connections_data_source.goaws_odb_networksnetworks_data_source.go以aws_odb_cloud_autonomous_vm_clusters为例数据源只实现Read方法内部调用ListCloudAutonomousVmClusters并通过 SDK 分页器NewListCloudAutonomousVmClustersPaginator聚合所有页数据返回cloud_autonomous_vm_clusters列表属性。单个摘要对象包含arn、id、cloud_exadata_infrastructure_id、odb_network_id、oci_resource_anchor_name、oci_url、ocid、display_name等字段可与已存在的单例数据源如 cloud_autonomous_vm_cluster_data_source.go配合使用先查列表再定位具体资源。三、ENHANCEMENTS五项资源能力增强1.aws_codebuild_project新增auto_retry_limit为 CodeBuild 项目增加自动重试上限参数#40035允许用户在构建失败场景下配置自动重试次数减少手工重新触发构建的运维负担。2.aws_emrserverless_application新增scheduler_configuration为 EMR Serverless 应用引入调度配置块#44589使应用可以按预定计划执行任务扩展了 Serverless 作业的自动化能力。3.aws_lambda_event_source_mapping新增schema_registry_config在amazon_managed_kafka_event_source_config与self_managed_kafka_event_source_config两个块内新增schema_registry_config配置块#44540让 MSK / 自管理 Kafka 事件源可以绑定 Schema Registry支撑 Avro 等带 Schema 的消息格式处理。4.aws_ssmcontacts_contact资源身份支持为 SSM Contacts 联系人资源补齐resource identity能力#44548 与 docs/add-resource-identity-support.md核心思路是以规范化 Identity 替代传统 ID 字符串为import、状态校验与一致性检查提供统一入口。5.aws_vpclattice_resource_gateway新增ipv4_addresses_per_eni为 VPC Lattice 资源网关增加ipv4_addresses_per_eni参数#44560用于控制每个弹性网络接口ENI上分配的 IPv4 地址数量细化网关的 IP 资源配置。四、BUG FIXESProvider 核心与多服务修复1. Provider 核心修复本版本最重要的修复集中在 Provider 层AWS 欧洲主权云区域 ARN 校验#44573 与 docs/arn.md如存在中的区域扩展说明。修复 Plugin Framework 资源的Missing Resource Identity After Update#44518 的身份处理机制直接相关。修复Unexpected Identity Change#44518当 state 中全空fully-null的 identity 值被更新为合法值时不再误报意外身份变更。这两个修复对大量基于 Plugin Framework 的存量资源都有正面影响升级后若曾受此类报错困扰可重点回归验证相关资源的 update 流程。2. DataZone 环境与项目修复针对aws_datazone_environment与aws_datazone_project的修复多达 8 条#44491aws_datazone_environment正确更新glossary_terms可选参数account_identifier、account_region未指定时不再报unknown value更新时不再报错删除时不再偶发unexpected state创建时正确传递blueprint_identifier导入时正确设置user_parameters的值user_parameters中的值不再允许被更新只读语义修正。aws_datazone_project删除时不再忽略错误资源已在删除中时不再重复报错。这批修复说明 6.16.0 对 DataZone 资源的创建、导入、更新、删除全生命周期做了系统性打磨使用 DataZone 的团队升级后应重点验证现有 environment/project 的terraform plan与apply行为是否与预期一致。3. 其他资源修复aws_dynamodb_table#44576不再对LimitExceededException进行重试避免在限流错误上做无效的指数退避等待aws_ivschat_room#44572将maximum_message_rate_per_second的校验上限修正为100与此前实际 API 约束对齐aws_launch_template#44505kms_key_id校验放宽为同时接受 Key ID、别名、别名 ARN 以及 Key ARN 四种形式与 KMS 参数的常见传值习惯保持一致aws_servicecatalog_portfolio_share#24730 等基础设施支撑。五、升级建议与影响评估综合以上变更升级到 6.16.0 时可参考以下要点新功能开箱即用Transcribe Action、Transfer 三件套与 ODB 数据源均为新增能力不改变既有资源配置可安全引入Transfer 的host_key_body_wo展示了本仓库对 WriteOnly 敏感属性的推荐用法新增资源建议直接采用该模式。框架层修复收益面广Missing Resource Identity After Update与Unexpected Identity Change两个 Provider 级修复影响所有 Plugin Framework 资源若此前升级过程中遇到过上述报错6.16.0 是值得优先验证的版本。行为变更需回归DataZone 的user_parameters只读语义修正、DynamoDB 表对LimitExceededException停止重试、Launch Template 的kms_key_id校验放宽均可能改变既有配置的 plan 结果或运行行为建议在升级环境中先行回归。并发与限流优化Service Catalog Portfolio Share 的全局锁与 DynamoDB 的重试策略调整面向的都是真实场景中的限流/并发问题对大规模账户运营场景尤为相关。如需继续深入可阅读仓库内的 docs/changelog-process.md 了解变更记录维护规范、docs/breaking-changes.md 评估破坏性变更边界或直接查阅上文列出的各资源源码与测试文件掌握每个新增参数的精确约束与实现细节。【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
