From 39458bcbd4ec00c329f90bf6c001395ccd34029e Mon Sep 17 00:00:00 2001 From: Gabriel Ovie Date: Tue, 7 Oct 2025 20:08:55 +0000 Subject: [PATCH] docs(rds): add example + note for blue_green_update block on aws_db_instance (#44488) Signed-off-by: Gabriel Ovie --- website/docs/r/db_instance.html.markdown | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/website/docs/r/db_instance.html.markdown b/website/docs/r/db_instance.html.markdown index d5e59113dff7..0f63093b0fe6 100644 --- a/website/docs/r/db_instance.html.markdown +++ b/website/docs/r/db_instance.html.markdown @@ -474,6 +474,29 @@ This will not recreate the resource if the S3 object changes in some way. It's * `enabled` - (Optional) Enables [low-downtime updates](#low-downtime-updates) when `true`. Default is `false`. +#### Example + +```hcl +resource "aws_db_instance" "example" { + identifier = "example" + engine = "postgres" + engine_version = "15" + instance_class = "db.t3.micro" + allocated_storage = 20 + username = "admin" + password = "example-password" + skip_final_snapshot = true + + # Blue/Green updates are set with a BLOCK (not an argument). + blue_green_update { + enabled = true + } +} +``` +> **Note:** `blue_green_update` is a **block**, not an argument. +> Using `blue_green_update = { ... }` will cause an error like: +> *"An argument named `blue_green_update` is not expected here. Did you mean to define a block of type `blue_green_update`?"* + [instance-replication]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Overview.Replication.html