From 53efcac57ea5dd1a7e51111812232bdf3b9e91ac Mon Sep 17 00:00:00 2001 From: 22skyy <77733479+22skyy@users.noreply.github.com> Date: Sun, 15 Mar 2026 16:39:32 +0900 Subject: [PATCH 1/2] docs/rds_cluster: clarify availability_zones requirement for Multi-AZ DB clusters Multi-AZ DB clusters require exactly 3 Availability Zones in the DB subnet group, while Aurora DB clusters can operate with fewer AZs. This distinction was not documented, causing user confusion (#37252). --- website/docs/r/rds_cluster.html.markdown | 2 ++ 1 file changed, 2 insertions(+) diff --git a/website/docs/r/rds_cluster.html.markdown b/website/docs/r/rds_cluster.html.markdown index 79a6302c1753..cebc0a500a5a 100644 --- a/website/docs/r/rds_cluster.html.markdown +++ b/website/docs/r/rds_cluster.html.markdown @@ -206,6 +206,8 @@ This resource supports the following arguments: RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next Terraform apply. We recommend specifying 3 AZs or using [the `lifecycle` configuration block `ignore_changes` argument](https://www.terraform.io/docs/configuration/meta-arguments/lifecycle.html#ignore_changes) if necessary. A maximum of 3 AZs can be configured. + + ~> **Note:** [Multi-AZ DB clusters](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) require exactly 3 Availability Zones in the DB subnet group. Aurora DB clusters can operate with fewer AZs, but RDS will still automatically assign 3 AZs as described above. * `backtrack_window` - (Optional) Target backtrack window, in seconds. Only available for `aurora` and `aurora-mysql` engines currently. To disable backtracking, set this value to `0`. Defaults to `0`. Must be between `0` and `259200` (72 hours) * `backup_retention_period` - (Optional) Days to retain backups for. Default `1` * `ca_certificate_identifier` - (Optional) The CA certificate identifier to use for the DB cluster's server certificate. From 14827f64b6d76e1a3b0c3775b0aad0e26bfd673f Mon Sep 17 00:00:00 2001 From: 22skyy <77733479+22skyy@users.noreply.github.com> Date: Mon, 16 Mar 2026 22:12:40 +0900 Subject: [PATCH 2/2] docs/rds_cluster: fix tfproviderdocs check failure Remove blank line and ~> admonition syntax from the Note to keep it within the availability_zones list item, preventing the argument parser from losing track of the arguments section. --- website/docs/r/rds_cluster.html.markdown | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/website/docs/r/rds_cluster.html.markdown b/website/docs/r/rds_cluster.html.markdown index cebc0a500a5a..ae42ad6fe785 100644 --- a/website/docs/r/rds_cluster.html.markdown +++ b/website/docs/r/rds_cluster.html.markdown @@ -206,8 +206,7 @@ This resource supports the following arguments: RDS automatically assigns 3 AZs if less than 3 AZs are configured, which will show as a difference requiring resource recreation next Terraform apply. We recommend specifying 3 AZs or using [the `lifecycle` configuration block `ignore_changes` argument](https://www.terraform.io/docs/configuration/meta-arguments/lifecycle.html#ignore_changes) if necessary. A maximum of 3 AZs can be configured. - - ~> **Note:** [Multi-AZ DB clusters](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) require exactly 3 Availability Zones in the DB subnet group. Aurora DB clusters can operate with fewer AZs, but RDS will still automatically assign 3 AZs as described above. + **Note:** [Multi-AZ DB clusters](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) require exactly 3 Availability Zones in the DB subnet group. Aurora DB clusters can operate with fewer AZs, but RDS will still automatically assign 3 AZs as described above. * `backtrack_window` - (Optional) Target backtrack window, in seconds. Only available for `aurora` and `aurora-mysql` engines currently. To disable backtracking, set this value to `0`. Defaults to `0`. Must be between `0` and `259200` (72 hours) * `backup_retention_period` - (Optional) Days to retain backups for. Default `1` * `ca_certificate_identifier` - (Optional) The CA certificate identifier to use for the DB cluster's server certificate.