azurerm_postgresql_* - deprecate PostgreSQL Single Server and its sub resources (hashicorp#29805)

* azurerm_postgresql_* - deprecate PostgreSQL Single Server and its sub resources

* deprecate its sub resources

* update deprecation messsage

* update md file for deprecation message

Author: neil-yechenwei

internal/services/postgres/postgresql_active_directory_administrator_resource.go

@@ -38,6 +38,8 @@ func resourcePostgreSQLAdministrator() *pluginsdk.Resource {
 			Delete: pluginsdk.DefaultTimeout(30 * time.Minute),
 		},
 
+		DeprecationMessage: "The `azurerm_postgresql_active_directory_administrator` resource is deprecated and will be removed in v5.0 of the AzureRM Provider. Azure Database for PostgreSQL Single Server and its sub resources have been retired as of 2025-03-28, please use the `azurerm_postgresql_flexible_server_active_directory_administrator` resource instead. For more information, see https://techcommunity.microsoft.com/blog/adforpostgresql/retiring-azure-database-for-postgresql-single-server-in-2025/3783783.",
+
 		SchemaVersion: 1,
 		StateUpgraders: pluginsdk.StateUpgrades(map[int]pluginsdk.StateUpgrade{
 			0: migration.PostgresqlAADAdministratorV0ToV1{},

internal/services/postgres/postgresql_active_directory_administrator_resource_test.go

@@ -12,13 +12,18 @@ import (
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance/check"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/clients"
+	"github.com/hashicorp/terraform-provider-azurerm/internal/features"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/tf/pluginsdk"
 	"github.com/hashicorp/terraform-provider-azurerm/utils"
 )
 
 type PostgreSqlAdministratorResource struct{}
 
 func TestAccPostgreSqlAdministrator_basic(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_active_directory_administrator` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_active_directory_administrator", "test")
 	r := PostgreSqlAdministratorResource{}
 
@@ -42,6 +47,10 @@ func TestAccPostgreSqlAdministrator_basic(t *testing.T) {
 }
 
 func TestAccPostgreSqlAdministrator_requiresImport(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_active_directory_administrator` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_active_directory_administrator", "test")
 	r := PostgreSqlAdministratorResource{}
 
@@ -61,6 +70,10 @@ func TestAccPostgreSqlAdministrator_requiresImport(t *testing.T) {
 }
 
 func TestAccPostgreSqlAdministrator_disappears(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_active_directory_administrator` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_active_directory_administrator", "test")
 	r := PostgreSqlAdministratorResource{}
 

internal/services/postgres/postgresql_configuration_resource.go

@@ -35,6 +35,8 @@ func resourcePostgreSQLConfiguration() *pluginsdk.Resource {
 			Delete: pluginsdk.DefaultTimeout(30 * time.Minute),
 		},
 
+		DeprecationMessage: "The `azurerm_postgresql_configuration` resource is deprecated and will be removed in v5.0 of the AzureRM Provider. Azure Database for PostgreSQL Single Server and its sub resources have been retired as of 2025-03-28, please use the `azurerm_postgresql_flexible_server_configuration` resource instead. For more information, see https://techcommunity.microsoft.com/blog/adforpostgresql/retiring-azure-database-for-postgresql-single-server-in-2025/3783783.",
+
 		Schema: map[string]*pluginsdk.Schema{
 			"name": {
 				Type:     pluginsdk.TypeString,

internal/services/postgres/postgresql_configuration_resource_test.go

@@ -14,13 +14,18 @@ import (
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance/check"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/clients"
+	"github.com/hashicorp/terraform-provider-azurerm/internal/features"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/tf/pluginsdk"
 	"github.com/hashicorp/terraform-provider-azurerm/utils"
 )
 
 type PostgreSQLConfigurationResource struct{}
 
 func TestAccPostgreSQLConfiguration_backslashQuote(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_configuration` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_configuration", "test")
 	r := PostgreSQLConfigurationResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -42,6 +47,10 @@ func TestAccPostgreSQLConfiguration_backslashQuote(t *testing.T) {
 }
 
 func TestAccPostgreSQLConfiguration_clientMinMessages(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_configuration` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_configuration", "test")
 	r := PostgreSQLConfigurationResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -63,6 +72,10 @@ func TestAccPostgreSQLConfiguration_clientMinMessages(t *testing.T) {
 }
 
 func TestAccPostgreSQLConfiguration_deadlockTimeout(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_configuration` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_configuration", "test")
 	r := PostgreSQLConfigurationResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -84,6 +97,10 @@ func TestAccPostgreSQLConfiguration_deadlockTimeout(t *testing.T) {
 }
 
 func TestAccPostgreSQLConfiguration_multiplePostgreSQLConfigurations(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_configuration` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_configuration", "test")
 	r := PostgreSQLConfigurationResource{}
 

internal/services/postgres/postgresql_database_resource.go

@@ -37,6 +37,8 @@ func resourcePostgreSQLDatabase() *pluginsdk.Resource {
 			Delete: pluginsdk.DefaultTimeout(60 * time.Minute),
 		},
 
+		DeprecationMessage: "The `azurerm_postgresql_database` resource is deprecated and will be removed in v5.0 of the AzureRM Provider. Azure Database for PostgreSQL Single Server and its sub resources have been retired as of 2025-03-28, please use the `azurerm_postgresql_flexible_server_database` resource instead. For more information, see https://techcommunity.microsoft.com/blog/adforpostgresql/retiring-azure-database-for-postgresql-single-server-in-2025/3783783.",
+
 		SchemaVersion: 1,
 		StateUpgraders: pluginsdk.StateUpgrades(map[int]pluginsdk.StateUpgrade{
 			0: migration.PostgresqlDatabaseV0ToV1{},

internal/services/postgres/postgresql_database_resource_test.go

@@ -12,13 +12,18 @@ import (
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance/check"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/clients"
+	"github.com/hashicorp/terraform-provider-azurerm/internal/features"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/tf/pluginsdk"
 	"github.com/hashicorp/terraform-provider-azurerm/utils"
 )
 
 type PostgreSQLDatabaseResource struct{}
 
 func TestAccPostgreSQLDatabase_basic(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_database` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_database", "test")
 	r := PostgreSQLDatabaseResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -34,6 +39,10 @@ func TestAccPostgreSQLDatabase_basic(t *testing.T) {
 }
 
 func TestAccPostgreSQLDatabase_requiresImport(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_database` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_database", "test")
 	r := PostgreSQLDatabaseResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -50,6 +59,10 @@ func TestAccPostgreSQLDatabase_requiresImport(t *testing.T) {
 }
 
 func TestAccPostgreSQLDatabase_collationWithHyphen(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_database` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_database", "test")
 	r := PostgreSQLDatabaseResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -65,6 +78,10 @@ func TestAccPostgreSQLDatabase_collationWithHyphen(t *testing.T) {
 }
 
 func TestAccPostgreSQLDatabase_charsetLowercase(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_database` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_database", "test")
 	r := PostgreSQLDatabaseResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -80,6 +97,10 @@ func TestAccPostgreSQLDatabase_charsetLowercase(t *testing.T) {
 }
 
 func TestAccPostgreSQLDatabase_charsetMixedcase(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_database` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_database", "test")
 	r := PostgreSQLDatabaseResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{

internal/services/postgres/postgresql_firewall_rule_resource.go

@@ -36,6 +36,8 @@ func resourcePostgreSQLFirewallRule() *pluginsdk.Resource {
 			Delete: pluginsdk.DefaultTimeout(30 * time.Minute),
 		},
 
+		DeprecationMessage: "The `azurerm_postgresql_firewall_rule` resource is deprecated and will be removed in v5.0 of the AzureRM Provider. Azure Database for PostgreSQL Single Server and its sub resources have been retired as of 2025-03-28, please use the `azurerm_postgresql_flexible_server_firewall_rule` resource instead. For more information, see https://techcommunity.microsoft.com/blog/adforpostgresql/retiring-azure-database-for-postgresql-single-server-in-2025/3783783.",
+
 		Schema: map[string]*pluginsdk.Schema{
 			"name": {
 				Type:     pluginsdk.TypeString,

internal/services/postgres/postgresql_firewall_rule_resource_test.go

@@ -12,13 +12,18 @@ import (
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance/check"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/clients"
+	"github.com/hashicorp/terraform-provider-azurerm/internal/features"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/tf/pluginsdk"
 	"github.com/hashicorp/terraform-provider-azurerm/utils"
 )
 
 type PostgreSQLFirewallRuleResource struct{}
 
 func TestAccPostgreSQLFirewallRule_basic(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_firewall_rule` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_firewall_rule", "test")
 	r := PostgreSQLFirewallRuleResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{
@@ -35,6 +40,10 @@ func TestAccPostgreSQLFirewallRule_basic(t *testing.T) {
 }
 
 func TestAccPostgreSQLFirewallRule_requiresImport(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_firewall_rule` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "azurerm_postgresql_firewall_rule", "test")
 	r := PostgreSQLFirewallRuleResource{}
 	data.ResourceTest(t, r, []acceptance.TestStep{

internal/services/postgres/postgresql_server_data_source.go

@@ -27,6 +27,8 @@ func dataSourcePostgreSqlServer() *pluginsdk.Resource {
 			Read: pluginsdk.DefaultTimeout(10 * time.Minute),
 		},
 
+		DeprecationMessage: "The `azurerm_postgresql_server` data source is deprecated and will be removed in v5.0 of the AzureRM Provider. Azure Database for PostgreSQL Single Server and its sub resources have been retired as of 2025-03-28, please use the `azurerm_postgresql_flexible_server` data source instead. For more information, see https://techcommunity.microsoft.com/blog/adforpostgresql/retiring-azure-database-for-postgresql-single-server-in-2025/3783783.",
+
 		Schema: map[string]*pluginsdk.Schema{
 			"name": {
 				Type:     pluginsdk.TypeString,

internal/services/postgres/postgresql_server_data_source_test.go

@@ -9,11 +9,16 @@ import (
 
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance"
 	"github.com/hashicorp/terraform-provider-azurerm/internal/acceptance/check"
+	"github.com/hashicorp/terraform-provider-azurerm/internal/features"
 )
 
 type PostgreSQLServerDataSource struct{}
 
 func TestAccDataSourcePostgreSqlServer_basic(t *testing.T) {
+	if features.FivePointOh() {
+		t.Skipf("Skipping since `azurerm_postgresql_server` is deprecated and will be removed in 5.0")
+	}
+
 	data := acceptance.BuildTestData(t, "data.azurerm_postgresql_server", "test")
 	r := PostgreSQLServerDataSource{}
 	version := "9.5"