Merge pull request #1205 from MicrosoftDocs/main

1/9/2025 AM Publish

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

@@ -1945,6 +1945,16 @@
         "redirect_url": "/azure/postgresql/flexible-server/how-to-configure-server-logs",
         "redirect_document_id": false
     },
+    {
+        "source_path_from_root": "/articles/postgresql/flexible-server/how-to-perform-on-demand-backup-portal.md",
+        "redirect_url": "/azure/postgresql/flexible-server/how-to-operate-on-demand-backups",
+        "redirect_document_id": false
+    },
+    {
+        "source_path_from_root": "/articles/postgresql/flexible-server/how-to-perform-on-demand-backup-cli.md",
+        "redirect_url": "/azure/postgresql/flexible-server/how-to-operate-on-demand-backups",
+        "redirect_document_id": false
+    },
     {
         "source_path_from_root": "/articles/postgresql/flexible-server/how-to-maintenance-portal.md",
         "redirect_url": "/azure/postgresql/flexible-server/how-to-configure-scheduled-maintenance",

articles/postgresql/TOC.yml

@@ -411,6 +411,8 @@
         href: flexible-server/how-to-configure-high-availability.md
       - name: Download server logs
         href: flexible-server/how-to-configure-server-logs.md
+      - name:  On-demand backups
+        href: flexible-server/how-to-operate-on-demand-backups.md
       - name: Scale a server
         items:
         - name: Azure portal
@@ -425,12 +427,6 @@
           href: flexible-server/how-to-restore-to-different-subscription-or-resource-group.md
         - name: Azure REST API
           href: flexible-server/how-to-restore-different-subscription-resource-group-api.md 
-      - name:  On-demand-backup 
-        items:
-        - name: Azure portal
-          href: flexible-server/how-to-perform-on-demand-backup-portal.md
-        - name: Azure CLI
-          href: flexible-server/how-to-perform-on-demand-backup-cli.md
       - name: Restore a server
         items:
         - name: Azure portal

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

@@ -183,8 +183,7 @@ Azure Database for PostgreSQL Flexible Server automatically generates storage vo
 
 On-demand backups can be taken in addition to scheduled automatic backups. These backups are retained according to your backup retention window. You can delete these on-demand backups at any time if they are no longer needed. To initiate an on-demand backup, simply select the database instance you wish to back up and specify a backup name. These backups are stored alongside automated backups, but only on-demand backups can be deleted by users, as automated backups are managed and retained by the Flexible Server service to meet backup retention requirements.
 
- For more information about performing an on-demand backup, visit the [how-to guide](how-to-perform-on-demand-backup-portal.md).
-
+ For more information, see [On-demand backups](how-to-operate-on-demand-backups.md).
 
 #### Limitations
 

articles/postgresql/flexible-server/how-to-operate-on-demand-backups.md

@@ -0,0 +1,152 @@
+---
+title: On-demand backups (preview)
+description: This article describes how to perform, list, and delete on-demand backups of an Azure Database for PostgreSQL flexible server.
+author: kabharati
+ms.author: kabharati
+ms.reviewer: maghan
+ms.date: 01/09/2025
+ms.service: azure-database-postgresql
+ms.subservice: flexible-server
+ms.topic: how-to
+# customer intent: As a user, I want to learn how can I operate full backups of my Azure Database for PostgreSQL flexible server, including how to perform a backup, how to list, and how to delete existing backups.
+---
+
+# On-demand backups (Preview)
+
+[!INCLUDE [applies-to-postgresql-flexible-server](~/reusable-content/ce-skilling/azure/includes/postgresql/includes/applies-to-postgresql-flexible-server.md)]
+
+This article provides step-by-step instructions to operate with on-demand backups of an Azure Database for PostgreSQL flexible server.
+
+> [!IMPORTANT]
+> On-demand backups are automatically deleted, according to your configured backup retention period. However, you can manually delete them earlier if they’re no longer needed.
+
+## Perform on-demand backups
+
+### [Portal](#tab/portal-perform-on-demand-backups)
+
+Using the [Azure portal](https://portal.azure.com/):
+
+1. Select your Azure Database for PostgreSQL flexible server.
+
+2. In the resource menu, under the **Settings** section, select **Backup and restore**.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/backup-and-restore.png" alt-text="Screenshot showing the Backup and restore page." lightbox="./media/how-to-on-demand-backup/backup-and-restore.png":::
+
+3. Select **Backup now**.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/backup-now.png" alt-text="Screenshot showing the Backup now button in the Backup and restore page." lightbox="./media/how-to-on-demand-backup/backup-now.png":::
+
+4.  In the **Take backup** pane, the **Backup name** text box is prefilled with a unique name automatically generated for your backup. Feel free to change that name to any name of your preference.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/backup-name.png" alt-text="Screenshot showing the Take backup pane and highlighting the text box in which you have to provide the backup name." lightbox="./media/how-to-on-demand-backup/backup-name.png":::
+
+5. Select **Trigger**.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/trigger.png" alt-text="Screenshot showing the Trigger button." lightbox="./media/how-to-on-demand-backup/trigger.png":::
+
+6.  A notification informs you that the on-demand backup is initiated.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/notification-initiated.png" alt-text="Screenshot showing the notification informing that on-demand backup is initiated." lightbox="./media/how-to-on-demand-backup/notification-initiated.png":::
+
+7.  Upon successful completion, a notification informs you that the on-demand backup is completed.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/notification-completed.png" alt-text="Screenshot showing the notification informing that on-demand backup is completed." lightbox="./media/how-to-on-demand-backup/notification-completed.png":::
+
+### [CLI](#tab/cli-perform-on-demand-backups)
+
+You can initiate an on-demand backup of a server via the [az postgres flexible-server backup create](/cli/azure/postgres/flexible-server/backup#az-postgres-flexible-server-backup-create) command.
+
+```azurecli-interactive
+az postgres flexible-server backup create --resource-group <resource_group> --name <server> --backup-name <backup>
+```
+
+---
+
+> [!NOTE]
+> Under any of the following circumstances, you receive an InternalServerError:
+> - If another on-demand backup with the same name already exists in that server.
+> - If another on-demand backup is being taken, and isn't completed yet.
+
+## List on-demand backups
+
+### [Portal](#tab/portal-list-on-demand-backups)
+
+Using the [Azure portal](https://portal.azure.com/):
+
+1. Select your Azure Database for PostgreSQL flexible server.
+
+2. In the resource menu, under the **Settings** section, select **Backup and restore**.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/backup-and-restore-with-backups.png" alt-text="Screenshot showing the Backup and restore page with some automatic and on-demand backups available." lightbox="./media/how-to-on-demand-backup/backup-and-restore-with-backups.png":::
+
+3. In **Backup types**, select **On-Demand backup** if you want to only see the on-demand backups which are still available to be restored.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/list-on-demand-backups.png" alt-text="Screenshot showing how to filter the list of backups to only display on-demand backups." lightbox="./media/how-to-on-demand-backup/list-on-demand-backups.png":::
+
+### [CLI](#tab/cli-list-on-demand-backups)
+
+You can list currently available on-demand backups of a server via the [az postgres flexible-server backup list](/cli/azure/postgres/flexible-server/backup#az-postgres-flexible-server-backup-list) command.
+
+```azurecli-interactive
+az postgres flexible-server backup list --resource-group <resource_group> --name <server> --query "[?backupType=='Customer On-Demand']" --output table
+```
+
+---
+
+## Delete on-demand backups
+
+### [Portal](#tab/portal-delete-on-demand-backups)
+
+Using the [Azure portal](https://portal.azure.com/):
+
+1. Select your Azure Database for PostgreSQL flexible server.
+
+2. In the resource menu, under the **Settings** section, select **Backup and restore**.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/backup-and-restore-with-backups.png" alt-text="Screenshot showing the Backup and restore page with some automatic and on-demand backups available." lightbox="./media/how-to-on-demand-backup/backup-and-restore-with-backups.png":::
+
+3. In **Backup types**, select **On-Demand backup** if you want to only see the on-demand backups which are still available to be restored.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/list-on-demand-backups.png" alt-text="Screenshot showing how to filter the list of backups to only display on-demand backups." lightbox="./media/how-to-on-demand-backup/list-on-demand-backups.png":::
+
+4. Identify the on-demand backup that you want to delete. Then, under the **Actions** column, select **Delete** to initiate the deletion of that particular on-demand backup.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/delete-on-demand-backup.png" alt-text="Screenshot showing how to delete an on-demand backup." lightbox="./media/how-to-on-demand-backup/delete-on-demand-backup.png":::
+
+5.  A notification informs you that the on-demand backup is being deleted.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/notification-backup-deleting.png" alt-text="Screenshot showing the notification informing that on-demand backup is being deleted." lightbox="./media/how-to-on-demand-backup/notification-backup-deleting.png":::
+
+6.  Upon successful completion, a notification informs you that the on-demand backup is deleted.
+
+    :::image type="content" source="./media/how-to-on-demand-backup/notification-backup-deleted.png" alt-text="Screenshot showing the notification informing that on-demand backup is deleted." lightbox="./media/how-to-on-demand-backup/notification-backup-deleted.png":::
+
+### [CLI](#tab/cli-delete-on-demand-backups)
+
+You can delete any of the currently available on-demand backups of a server via the [az postgres flexible-server backup delete](/cli/azure/postgres/flexible-server/backup#az-postgres-flexible-server-backup-delete) command.
+
+```azurecli-interactive
+az postgres flexible-server backup delete --resource-group <resource_group> --name <server> --backup-name <backup>
+```
+
+If you run the previous command, it requires you to explicitly confirm, responding with a `y` (yes):
+
+```output
+Are you sure you want to delete the backup '<backup>' in server '<server>'
+```
+
+If you want to run the command without needing the user interaction, you can add the `--yes` parameter like this:
+
+```azurecli-interactive
+az postgres flexible-server backup delete --resource-group <resource_group> --name <server> --backup-name <backup> --yes
+```
+
+> [!NOTE]
+> If you provide the name that doesn't match any of the available on-demand backups, the command doesn't report any error.
+
+---
+
+## Related content
+
+- [Overview of business continuity with Azure Database for PostgreSQL - Flexible Server](concepts-business-continuity.md).
+- [Backup and restore in Azure Database for PostgreSQL - Flexible Server](concepts-backup-restore.md).

articles/postgresql/flexible-server/how-to-perform-major-version-upgrade.md

@@ -43,7 +43,7 @@ Using the [Azure portal](https://portal.azure.com/):
 
    :::image type="content" source="media/how-to-perform-major-version-upgrade/deployment-success.png" alt-text="Diagram of successful deployment of for Major Version Upgrade." lightbox="media/how-to-perform-major-version-upgrade/deployment-success.png":::
 
-6. Observer that the name of the server remains unchanged, and PostgreSQL version is upgraded to the desired target major version. The minor version corresponds to the most recent minor version supported by Azure Database for PostgreSQL - Flexible Server at the time of the upgrade.
+6. Observe that the name of the server remains unchanged, and PostgreSQL version is upgraded to the desired target major version. The minor version corresponds to the most recent minor version supported by Azure Database for PostgreSQL - Flexible Server at the time of the upgrade.
 
    :::image type="content" source="media/how-to-perform-major-version-upgrade/upgrade-verification.png" alt-text="Diagram of upgraded version to Azure Database for PostgreSQL flexible server, after major version upgrade." lightbox="media/how-to-perform-major-version-upgrade/upgrade-verification.png":::
 

articles/postgresql/flexible-server/how-to-use-pg-azure-storage.md

@@ -789,7 +789,11 @@ When executing any of the functions that interact with Azure Storage (`azure_sto
 
 ### ERROR: azure_storage: internal error while connecting
 
-When the System Assigned Managed Identity is not enabled in the instance of Flexible Server.
+When the instance of flexible server cannot reach the target storage account. That could happen in the following cases:
+- The storage account doesn't exist.
+- Networking configuration doesn't allow traffic originated from the instance of flexible server to reach the storage account. For example, when the instance of flexible server is deployed with public access networking, and the storage account is only accessible via private endpoints.
+
+When the System Assigned Managed Identity is not enabled in the instance of flexible server.
 
 ### ERROR: azure_storage: storage credentials invalid format