【产品变更】Terraform2.0.0版本升级通知
Jul 21, 2026
影响时间
2026-10-12 10:00:00 升级
变更内容和影响
阿里云计划于 2026 年 10 月 12 日 正式发布 Terraform Provider v2.0.0 。此次版本升级将同步依赖的 Terraform Plugin SDK 从 v1 升级至 v2 ，带来更好的扩展能力和长期维护支持。
为确保正式版本的稳定性，我们将于 2026 年 7 月 27 日 发布 v2.0.0 Beta 版本，并开启为期 11 周 的公测。公测结束后，Beta 版本中的功能与修复将合并至正式版本。
如果您计划升级至 AliCloud Terraform Provider v2.0.0，请关注以下事项：
为确保正式版本的稳定性，我们将于 2026 年 7 月 27 日 发布 v2.0.0 Beta 版本，并开启为期 11 周 的公测。公测结束后，Beta 版本中的功能与修复将合并至正式版本。
升级内容
- 支持 Write-Only（只写）属性 ，提升敏感信息（如密码、密钥等）的管理能力。
- 支持 Diagnostics（诊断机制），提供更加准确、友好的错误提示和诊断信息，帮助快速定位配置问题。
- 提升 Provider 对属性值状态的识别能力，可准确区分属性处于 Null（未配置） 或 已设置（包括零值）等不同状态。
升级影响
由于Terraform Plugin SDK v2 引入了更严格的类型约束，AliCloud Terraform Provider v2.0.0 将不再支持包含多个子元素的 Map 类型。因此，本次升级涉及部分资源（Resource）、数据源（Data Source）及官方 Module 的兼容性调整。（查看受影响的 Resource、Data Source 和 Module 列表）如果您计划升级至 AliCloud Terraform Provider v2.0.0，请关注以下事项：
1.资源（Resource）和数据源（Data Source）适配
- 如果您的 Terraform 配置使用了受影响的 Resource 或 Data Source，需要根据升级指南调整相关属性的定义方式及引用方式，以确保配置能够正常运行。
2.官方 Module 升级
- 如果您使用了阿里云官方 rds 或 multi-zone-infrastructure-with-ots Module，请同步升级至兼容 AliCloud Terraform Provider v2 的对应Module的4.0.0 版本。
- Module v4.0.0 将于 2026 年 10 月 12 日 与 AliCloud Terraform Provider v2.0.0 正式版同步发布。
操作说明
1. HCL代码修改：全局搜索您的Terraform代码中是否包含本次变更的Resource,DataSource，若包含且使用了变更字段，则参考如下示例修改代码：
除了全局搜索代码，您还可以先执行命令（terraform plan），通过运行日志找到要修改的位置：
- 参数定义报错：无法识别参数（Error: Unsupported argument + 具体错误信息）
- 参数引用报错：报错引用异常（Error: Invalid index + 具体错误位置）
2. Module版本号调整：全局搜索您的Terraform代码是否引用以下Module，若引用则修改版本号（在2026-10-12正式版发布后修改为新Module版本4.0.0）
a. 主Module rds中的子 Module调用需要调整（主 Module：terraform-alicloud-modules/rds/alicloud不受影响）
b. 主 Module multi-zone-infrastructure-with-ots的调用需要调整
应对建议
应对此次升级，我们提供了专属服务群，您可以进群反馈。
如您有任何问题，可随时通过工单 或者服务热线与我们联系。