Merge pull request #1925 from nachoalonsoportillo/revamp-read-replicas

Refactor read replicas articles

Author: JillGrant615

articles/postgresql/.openpublishing.redirection.postgresql.json

@@ -2059,6 +2059,16 @@
         "source_path_from_root": "/articles/postgresql/flexible-server/how-to-restore-server.md",
         "redirect_url": "/azure/postgresql/flexible-server/how-to-restore-latest-restore-point",
         "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/flexible-server/how-to-read-replicas-portal.md",
+        "redirect_url": "/azure/postgresql/flexible-server/how-to-create-read-replica",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/flexible-server/how-to-read-replicas-virtual-endpoints-terraform.md",
+        "redirect_url": "/azure/postgresql/flexible-server/how-to-create-read-replica",
+        "redirect_document_id": false
     }
 ]
 }

articles/postgresql/TOC.yml

@@ -573,12 +573,24 @@
         href: flexible-server/how-to-scale-storage-performance.md
       - name: Configure storage autogrow
         href: flexible-server/how-to-auto-grow-storage.md
-      - name: Replication
+      - name: Read replicas
         items:
-        - name: Azure portal, CLI, REST API
-          href: flexible-server/how-to-read-replicas-portal.md
-        - name: Read replica with Terraform
-          href: flexible-server/how-to-read-replicas-virtual-endpoints-terraform.md
+        - name: Create read replica
+          href: flexible-server/how-to-create-read-replica.md
+        - name: Create virtual endpoints
+          href: flexible-server/how-to-create-virtual-endpoints.md
+        - name: Update virtual endpoints
+          href: flexible-server/how-to-update-virtual-endpoints.md
+        - name: Show virtual endpoints
+          href: flexible-server/how-to-show-virtual-endpoints.md
+        - name: Delete virtual endpoints
+          href: flexible-server/how-to-delete-virtual-endpoints.md
+        - name: Switch over replica to primary
+          href: flexible-server/how-to-switch-over-replica-to-primary.md
+        - name: Promote replica to standalone server
+          href: flexible-server/how-to-promote-replica-to-standalone.md
+        - name: Delete read replica
+          href: flexible-server/how-to-delete-read-replica.md
     - name: Backup and restore
       items:
         - name: Backup

articles/postgresql/flexible-server/concepts-backup-restore.md

@@ -178,7 +178,7 @@ After you restore the server, you can perform the following tasks to get your us
 
 - If the source server from which you restored was configured with high availability, and you want to configure the restored server with high availability, you can then follow [these steps](how-to-configure-high-availability.md).
 
-- If the source server from which you restored was configured with read replicas, and you want to configure read replicas on the restored server, you can then follow [these steps](how-to-read-replicas-portal.md).
+- If the source server from which you restored was configured with read replicas, and you want to configure read replicas on the restored server, you can then follow the instructions in [Create a read replica](how-to-create-read-replica.md).
 
 ## On-demand Backups (preview)
 

articles/postgresql/flexible-server/concepts-read-replicas-geo.md

@@ -75,5 +75,5 @@ In that case, this is the only viable option. After promoting the server, you'll
 - [Read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas.md).
 - [Promote read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas-promote.md).
 - [Virtual endpoints for read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas-virtual-endpoints.md).
-- [Create and manage read replicas in Azure Database for PostgreSQL flexible server](how-to-read-replicas-portal.md).
+- [Create a read replica](how-to-create-read-replica.md).
 - [Replication across Azure regions and virtual networks with private networking](concepts-networking-private.md#replication-across-azure-regions-and-virtual-networks-with-private-networking).

articles/postgresql/flexible-server/concepts-read-replicas-virtual-endpoints.md

@@ -81,5 +81,5 @@ This section explains how to use Virtual Endpoints in Azure Database for Postgre
 - [Read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas.md).
 - [Geo-replication in Azure Database for PostgreSQL flexible server](concepts-read-replicas-geo.md).
 - [Promote read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas-promote.md).
-- [Create and manage read replicas in Azure Database for PostgreSQL flexible server](how-to-read-replicas-portal.md).
+- [Create a read replica](how-to-create-read-replica.md).
 - [Replication across Azure regions and virtual networks with private networking](concepts-networking-private.md#replication-across-azure-regions-and-virtual-networks-with-private-networking).

articles/postgresql/flexible-server/concepts-read-replicas.md

@@ -20,7 +20,7 @@ The read replica feature allows you to replicate data from an Azure Database for
 
 Replicas are new servers you manage similar to regular Azure Database for PostgreSQL flexible server instances. For each read replica, you're billed for the provisioned compute in vCores and storage in GB/ month.
 
-Learn how to [create and manage replicas](how-to-read-replicas-portal.md).
+Learn how to [create a read replica](how-to-create-read-replica.md).
 
 ## When to use a read replica
 
@@ -54,7 +54,7 @@ To achieve a successful create operation, avoid making replicas during times of
 > [!IMPORTANT]  
 > When performing replica creation, deletion, and promotion operations, the primary server will enter an **updating state**. During this time, server management operations such as modifying server parameters, changing high availability options, or adding or removing firewalls will be unavailable. It's important to note that the updating state only affects server management operations and does not affect [data plane](/azure/azure-resource-manager/management/control-plane-and-data-plane#data-plane) operations. This means that your database server will remain fully functional and able to accept connections, as well as serve read and write traffic.
 
-Learn how to [create a read replica in the Azure portal](how-to-read-replicas-portal.md).
+Learn how to [Create a read replica](how-to-create-read-replica.md).
 
 ### Configuration management
 
@@ -253,5 +253,5 @@ For storage scaling:
 - [Geo-replication in Azure Database for PostgreSQL flexible server](concepts-read-replicas-geo.md).
 - [Promote read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas-promote.md).
 - [Virtual endpoints for read replicas in Azure Database for PostgreSQL flexible server](concepts-read-replicas-virtual-endpoints.md).
-- [Create and manage read replicas in Azure Database for PostgreSQL flexible server](how-to-read-replicas-portal.md).
+- [Creata read replica](how-to-create-read-replica.md).
 - [Replication across Azure regions and virtual networks with private networking](concepts-networking-private.md#replication-across-azure-regions-and-virtual-networks-with-private-networking).