edit pass: azure-database-for-postgresql-backup

Author: ShawnJackson

articles/backup/backup-azure-data-protection-use-rest-api-backup-postgresql.md

@@ -1,6 +1,6 @@
 ---
-title: Back up Azure PostgreSQL databases using Azure data protection REST API
-description: In this article, learn how to configure, initiate, and manage backup operations of Azure PostgreSQL databases using REST API.
+title: Back Up PostgreSQL Databases by Using the Azure Data Protection REST API
+description: In this article, learn how to configure, initiate, and manage backup operations of PostgreSQL databases in Azure Database for PostgreSQL by using the REST API.
 ms.topic: how-to
 ms.date: 02/09/2025
 ms.service: azure-backup
@@ -9,11 +9,11 @@ author: jyothisuri
 ms.author: jsuri
 ---
 
-# Back up Azure PostgreSQL databases using Azure data protection via REST API
+# Back up PostgreSQL databases by using the Azure data protection REST API
 
-This article describes how to manage backups for Azure PostgreSQL databases via REST API.
+This article describes how to manage backups for PostgreSQL databases in Azure Database for PostgreSQL by using the REST API.
 
-For information on the Azure PostgreSQL database backup supported scenarios, limitations, and authentication mechanisms, see the [overview](backup-azure-database-postgresql-overview.md) document.
+For information on the supported scenarios, limitations, and authentication mechanisms for PostgreSQL database backup in Azure Database for PostgreSQL, see the [overview](backup-azure-database-postgresql-overview.md) document.
 
 ## Prerequisites
 
@@ -23,7 +23,7 @@ For information on the Azure PostgreSQL database backup supported scenarios, lim
 
 ## Configure backup
 
-Once the vault and policy are created, there're three critical points that you need to consider to protect an Azure PostgreSQL database.
+Once the vault and policy are created, there're three critical points that you need to consider to protect a PostgreSQL database.
 
 ### Key entities involved
 
@@ -51,7 +51,7 @@ You need to grant permissions to back up vault's MSI on the PostgreSQL server an
 
 ### Prepare the request to configure backup
 
-After you set the relevant permissions to the vault and PostgreSQL database, and configure the vault and policy, prepare the request to configure backup. See the following request body to configure backup for an Azure PostgreSQL database. The Azure Resource Manager ID (ARM ID) of the Azure PostgreSQL database and its details are present in the _datasourceinfo_ section. The policy information is present in the _policyinfo_ section.
+After you set the relevant permissions to the vault and PostgreSQL database, and configure the vault and policy, prepare the request to configure backup. See the following request body to configure backup for a PostgreSQL database. The Azure Resource Manager ID (ARM ID) of the PostgreSQL database and its details are present in the _datasourceinfo_ section. The policy information is present in the _policyinfo_ section.
 
 ```json
 {
@@ -99,7 +99,7 @@ For example, this API translates to:
 POST https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxx/resourceGroups/TestBkpVaultRG/providers/Microsoft.DataProtection/backupVaults/testBkpVault/validateForBackup?api-version=2021-01-01
 ```
 
-The [request body](#prepare-the-request-to-configure-backup) that we prepared earlier will be used to provide details of the Azure PostgreSQL database to be protected.
+The [request body](#prepare-the-request-to-configure-backup) that we prepared earlier will be used to provide details of the PostgreSQL database to be protected.
 
 #### Example request body
 
@@ -292,7 +292,7 @@ GET https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx
 
 ### Configure backup request
 
-Once the request is validated, you can submit the same to the [create backup instance API](/rest/api/dataprotection/backup-instances/create-or-update). One of the Azure Backup data protection services protects the Backup instance within the Backup vault. Here, the Azure PostgreSQL database is the backup instance. Use the above-validated request body with minor additions.
+Once the request is validated, you can submit the same to the [create backup instance API](/rest/api/dataprotection/backup-instances/create-or-update). One of the Azure Backup data protection services protects the Backup instance within the Backup vault. Here, the PostgreSQL database is the backup instance. Use the above-validated request body with minor additions.
 
 Use a unique name for the backup instance. So, we recommend you use a combination of the resource name and a unique identifier. For example, in the following operation, we'll use _testpostgresql-empdb11-957d23b1-c679-4c94-ade6-c4d34635e149_ and mark it as the backup instance name.
 
@@ -446,7 +446,7 @@ Once the operation completes, it returns 200 (OK) with the success message in th
 
 ### Stop protection and delete data
 
-To remove the protection on an Azure PostgreSQL database and delete the backup data as well, perform a [delete operation](/rest/api/dataprotection/backup-instances/delete).
+To remove the protection on a PostgreSQL database and delete the backup data as well, perform a [delete operation](/rest/api/dataprotection/backup-instances/delete).
 
 Stopping protection and deleting data is a *DELETE* operation.
 
@@ -508,12 +508,9 @@ GET "https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxx
 }
 ```
 
-## Next steps
-
-[Restore data from an Azure PostGreSQL database backup](restore-postgresql-database-use-rest-api.md)
-
-For more information on the Azure Backup REST APIs, see the following articles:
+## Related content
 
+- [Restore data from a PostGreSQL database backup](restore-postgresql-database-use-rest-api.md)
 - [Get started with Azure Data Protection Provider REST API](/rest/api/dataprotection/)
 - [Get started with Azure REST API](/rest/api/azure/)
 - [Manage backup jobs using REST API](backup-azure-arm-userestapi-managejobs.md).

articles/backup/backup-azure-data-protection-use-rest-api-create-update-postgresql-policy.md

@@ -1,16 +1,16 @@
 ---
-title: Create backup policies for Azure PostgreSQL databases using data protection REST API
-description: In this article, you'll learn how to create and manage backup policies for Azure PostgreSQL databases using REST API.
+title: Create Backup Policies for PostgreSQL Databases by Using the Data Protection REST API
+description: In this article, you learn how to create and manage backup policies for PostgreSQL databases in Azure Database for PostgreSQL by using the REST API.
 ms.topic: how-to
 ms.date: 02/09/2025
 ms.assetid: 759ee63f-148b-464c-bfc4-c9e640b7da6b
 author: jyothisuri
 ms.author: jsuri
 ---
 
-# Create Azure Data Protection backup policies for Azure PostgreSQL databases using REST API
+# Create Azure Data Protection backup policies for PostgreSQL databases by using the REST API
 
-A backup policy governs the retention and schedule of your backups. Azure PostgreSQL database Backup offers long-term retention and supports a backup per day.
+A backup policy governs the retention and schedule of your PostgreSQL database backups in Azure Database for PostgreSQL. Azure Database for PostgreSQL database backup offers long-term retention and supports a backup per day.
 
 You can reuse an existing backup policy to configure backup for PostgreSQL databases to a vault, or [create a backup policy for an Azure Recovery Services vault using REST API](/rest/api/dataprotection/backup-policies/create-or-update).
 

articles/backup/backup-azure-database-postgresql-overview.md

@@ -50,7 +50,7 @@ You can restore PostgreSQL single-server databases by using **Restore as Files**
 
 ## Backup process
 
-1. As a backup admin, you can specify the Azure PostgreSQL databases that you intend to back up. You can also specify the details of Azure Key Vault, which stores the credentials needed to connect to the specified databases. The database admin securely seeds these credentials in Key Vault.
+1. As a backup admin, you can specify the PostgreSQL databases that you intend to back up. You can also specify the details of Azure Key Vault, which stores the credentials needed to connect to the specified databases. The database admin securely seeds these credentials in Key Vault.
 
 1. The Azure Backup service validates that it has [appropriate permissions to authenticate](#azure-backup-authentication-with-the-azure-database-for-postgresql-server) with the specified Azure Database for PostgreSQL server and to back up its databases.
 
@@ -74,7 +74,7 @@ The workload admin is responsible for managing and rotating credentials. Azure B
 
 :::image type="content" source="./media/backup-azure-database-postgresql-overview/key-vault-based-authentication-model.png" alt-text="Diagram that shows the workload or database flow.":::
 
-#### Permissions needed for Azure PostgreSQL database backup
+#### Permissions needed for PostgreSQL database backup
 
 1. Grant the following access permissions to the Azure Backup vault's managed service identity (MSI):
 
@@ -91,7 +91,7 @@ The workload admin is responsible for managing and rotating credentials. Azure B
 > [!NOTE]
 > You can grant these permissions within the [configure backup](backup-azure-database-postgresql.md##configure-a-backup-on-azure-postgresql-databases) flow with a single click if you, as the backup admin, have write access on the intended resources. If you don't have the required permissions (when multiple personas are involved), use an Azure Resource Manager template.
 
-#### Permissions needed for Azure PostgreSQL database restore
+#### Permissions needed for PostgreSQL database restore
 
 Permissions for restore are similar to the ones that you need for backup. You need to [manually grant the permissions on the target Azure Database for PostgreSQL server and the corresponding key vault](#steps-for-manually-granting-access-on-the-azure-database-for-postgresql-server-and-on-key-vault). Unlike in the [configure backup](backup-azure-database-postgresql.md##configure-a-backup-on-azure-postgresql-databases) flow, the experience to grant these permissions inline is currently not available.
 

articles/backup/backup-azure-database-postgresql.md

@@ -1,18 +1,18 @@
 ---
-title: Back up Azure Database for PostgreSQL 
-description: Learn about Azure Database for PostgreSQL backup with long-term retention.
+title: Back Up Azure Database for PostgreSQL by Using the Azure Portal
+description: Learn how to back up Azure Database for PostgreSQL by using the Azure portal.
 ms.topic: how-to
 ms.date: 03/18/2025
 ms.service: azure-backup
 author: jyothisuri
 ms.author: jsuri
 ---
 
-# Back up Azure Database for PostgreSQL with long-term retention
+# Back up Azure Database for PostgreSQL by using the Azure portal
 
 This article describes how to back up an Azure Database for PostgreSQL server. Before you begin, review the [supported configurations, feature considerations, and known limitations](./backup-azure-database-postgresql-support-matrix.md), along with [frequently asked questions](/azure/backup/backup-azure-database-postgresql-server-faq).
 
-## Configure a backup on Azure PostgreSQL databases
+## Configure a backup on PostgreSQL databases
 
 You can configure a backup on multiple databases across multiple Azure Database for PostgreSQL servers. To configure this kind of backup by using Azure Backup, follow these steps:
 
@@ -32,7 +32,7 @@ You can configure a backup on multiple databases across multiple Azure Database
 
 1. On the **Datasources** tab, select **Add/Edit**.
 
-   :::image type="content" source="./media/backup-azure-database-postgresql/select-azure-postgresql-databases-to-back-up-inline.png" alt-text="Screenshot that shows the button for adding or editing an Azure PostgreSQL database." lightbox="./media/backup-azure-database-postgresql/select-azure-postgresql-databases-to-back-up-expanded.png":::
+   :::image type="content" source="./media/backup-azure-database-postgresql/select-azure-postgresql-databases-to-back-up-inline.png" alt-text="Screenshot that shows the button for adding or editing a PostgreSQL database." lightbox="./media/backup-azure-database-postgresql/select-azure-postgresql-databases-to-back-up-expanded.png":::
 
 1. On the **Select resources to backup** pane, choose one of the Azure Database for PostgreSQL servers across subscriptions if they're in the same region as that of the vault. Select the arrow to show the list of databases within a server.
 

articles/backup/backup-postgresql-cli.md

@@ -1,6 +1,6 @@
 ---
-title: Back up Azure Database for PostgreSQL with long-term-retention using Azure CLI
-description: Learn how to back up Azure Database for PostgreSQL using Azure CLI.
+title: Back Up a PostgreSQL Databases by Using the Azure CLI
+description: Learn how to back up PostgreSQL databases in Azure Database for PostgreSQL by using the Azure CLI.
 ms.topic: how-to
 ms.date: 03/18/2025
 ms.custom: devx-track-azurecli
@@ -9,11 +9,11 @@ author: jyothisuri
 ms.author: jsuri
 ---
 
-# Back up Azure PostgreSQL databases using Azure CLI
+# Back up PostgreSQL databases by using the Azure CLI
 
-This article explains how to back up [Azure PostgreSQL database](/azure/postgresql/overview#azure-database-for-postgresql---single-server) using Azure CLI.
+This article explains how to back up PostgreSQL databases in [Azure Database for PostgreSQL](/azure/postgresql/overview#azure-database-for-postgresql---single-server) by using the Azure CLI.
 
-Learn more about the [supported scenarios](backup-azure-database-postgresql-support-matrix.md) and  [frequently asked questions](/azure/backup/backup-azure-database-postgresql-server-faq) to back up Azure Database for PostgreSQL Database.
+Learn more about the [supported scenarios](backup-azure-database-postgresql-support-matrix.md) and  [frequently asked questions](/azure/backup/backup-azure-database-postgresql-server-faq) to back up PostgreSQL databases in Azure Database for PostgreSQL.
 
 ## Create a Backup vault
 
@@ -52,7 +52,7 @@ az dataprotection backup-vault create -g testBkpVaultRG --vault-name TestBkpVaul
 }
 ```
 
-After the vault is created, let's create a Backup policy to protect Azure PostgreSQL databases.
+After the vault is created, let's create a Backup policy to protect PostgreSQL databases.
 
 ## Create a Backup policy
 
@@ -94,7 +94,7 @@ The resultant PowerShell object is as follows:
 
 ### Retrieve the policy template
 
-To understand the inner components of a Backup policy for Azure PostgreSQL database backup, retrieve the policy template using the [`az dataprotection backup-policy get-default-policy-template`](/cli/azure/dataprotection/backup-policy#az-dataprotection-backup-policy-get-default-policy-template) command. This command returns a default policy template for a given datasource type. Use this policy template to create a new policy.
+To understand the inner components of a Backup policy for PostgreSQL database backup, retrieve the policy template using the [`az dataprotection backup-policy get-default-policy-template`](/cli/azure/dataprotection/backup-policy#az-dataprotection-backup-policy-get-default-policy-template) command. This command returns a default policy template for a given datasource type. Use this policy template to create a new policy.
 
 ```azurecli-interactive
 az dataprotection backup-policy get-default-policy-template --datasource-type AzureDatabaseForPostgreSQL
@@ -158,7 +158,7 @@ az dataprotection backup-policy get-default-policy-template --datasource-type Az
 }
 ```
 
-The policy template consists of a trigger (which decides what triggers the backup) and a lifecycle (which decides when to delete/copy/move the backup). In Azure PostgreSQL database backup, the default value for trigger is a scheduled Weekly trigger (one backup every seven days) and to retain each backup for three months.
+The policy template consists of a trigger (which decides what triggers the backup) and a lifecycle (which decides when to delete/copy/move the backup). In PostgreSQL database backup, the default value for trigger is a scheduled Weekly trigger (one backup every seven days) and to retain each backup for three months.
 
 **Scheduled trigger:**
 
@@ -264,7 +264,7 @@ az dataprotection backup-policy create --backup-policy-name FinalOSSPolicy --pol
 
 ## Configure backup
 
-Once the vault and policy are created, there are three critical points that you need to consider to protect an Azure PostgreSQL database.
+Once the vault and policy are created, there are three critical points that you need to consider to protect a PostgreSQL database.
 
 ### Key entities involved
 
@@ -438,6 +438,6 @@ You can also use _Az.ResourceGraph_ to track all jobs across all Backup vaults.
 az dataprotection job list-from-resourcegraph --datasource-type AzureDatabaseForPostgreSQL --status Completed
 ```
 
-## Next steps
+## Related content
 
-- [Restore Azure PostgreSQL database using Azure CLI](restore-postgresql-database-cli.md)
+- [Restore PostgreSQL databases by using the Azure CLI](restore-postgresql-database-cli.md)