Merge pull request #210827 from cephalin/main

basic/ASE preview

Author: prmerger-automator[bot]

articles/app-service/manage-backup.md

@@ -3,7 +3,7 @@ title: Back up an app
 description: Learn how to restore backups of your apps in Azure App Service or configure custom backups. Customize backups by including the linked database.
 ms.assetid: 6223b6bd-84ec-48df-943f-461d84605694
 ms.topic: article
-ms.date: 06/17/2022 
+ms.date: 09/09/2022 
 ms.custom: seodec18
 
 ---
@@ -14,6 +14,13 @@ In [Azure App Service](overview.md), you can easily restore app backups. You can
 
 Back up and restore **Standard**, **Premium**, **Isolated**. For more information about scaling your App Service plan to use a higher tier, see [Scale up an app in Azure](manage-scale-up.md).
 
+> [!NOTE]
+> Support for custom and automatic backups in **Basic** tier (production slot only) and in App Service environments (ASE) V2 and V3 is in preview. For App Service environments:
+> 
+> - Backups can be restored to a target app within the ASE itself, not in another ASE.
+> - Backups can be restored to a target app in another App Service plan in the ASE.
+> - Backups can be restored to target app of the same OS platform as the source app.
+
 ## Automatic vs custom backups
 
 There are two types of backups in App Service. Automatic backups made for your app regularly as long as it's in a supported pricing tier. Custom backups require initial configuration, and can be made on-demand or on a schedule. The following table shows the differences between the two types.
@@ -43,7 +50,7 @@ There are two types of backups in App Service. Automatic backups made for your a
 
     :::image type="content" source="./media/manage-backup/open-backups-page.png" alt-text="Screenshot that shows how to open the backups page.":::
 
-1. Select the backup to restore by clicking its **Restore** link.
+1. Select the automatic backup or custom backup to restore by clicking its **Restore** link.
 
     :::image type="content" source="./media/manage-backup/click-restore-link.png" alt-text="Screenshot that shows how to select the restore link.":::
 
@@ -59,11 +66,7 @@ There are two types of backups in App Service. Automatic backups made for your a
 
 # [Azure CLI](#tab/cli)
 
-<!-- # [Automatic backups](#tab/auto)
- -->
-
-> [!NOTE]
-> These CLI steps apply to automatic backups only.
+<!-- # [Automatic backups](#tab/cli/auto) -->
 
 1. List the automatic backups for your app. In the command output, copy the `time` property of the backup you want to restore.
 
@@ -85,7 +88,7 @@ There are two types of backups in App Service. Automatic backups made for your a
 
     To restore app content only and not the app configuration, use the `--restore-content-only` parameter. For more information, see [az webapp config snapshot restore](/cli/azure/webapp/config/snapshot#az-webapp-config-snapshot-restore).
 
-<!-- # [Custom backups](#tab/custom)
+<!-- # [Custom backups](#tab/cli/custom)
 
 1. List the custom backups for your app and copy the `namePropertiesName` and `storageAccountUrl` properties of the backup you want to restore.
 
@@ -148,11 +151,26 @@ There are two types of backups in App Service. Automatic backups made for your a
 
 1. Configure the backup schedule as desired and select **Configure**.
 
+#### Back up and restore a linked database
+
+Custom backups can include linked databases. To make sure your backup includes a linked database, do the following:
+
+1. Make sure the linked database is [supported](#automatic-vs-custom-backups).
+1. Create a connection string that points to your database. A database is considered "linked" to your app when there's a valid connection string for it in your app's configuration.
+1. Follow the steps in [Create a custom backup](#create-a-custom-backup) to select the linked database in the **Advanced** tab.
+
+To restore a database that's included in a custom backup:
+
+1. Follow the steps in [Restore a backup](#restore-a-backup).
+1. In **Advanced options**, select **Include database**.
+
+For troubleshooting information, see [Why is my linked database not backed up](#why-is-my-linked-database-not-backed-up).
+
 <a name="partialbackups"></a>
 
 ## Configure partial backups
 
-Partial backups are supported for custom backups. Sometimes you don't want to back up everything on your app. Here are a few examples:
+Partial backups are supported for custom backups (not for automatic backups). Sometimes you don't want to back up everything on your app. Here are a few examples:
 
 * You [set up weekly backups](#configure-custom-scheduled-backups) of your app that contains static content that never changes, such as old blog posts or images.
 * Your app has over 10 GB of content (that's the max amount you can back up at a time).
@@ -234,7 +252,8 @@ For samples, see:
 - [Why is my linked database not backed up?](#why-is-my-linked-database-not-backed-up)
 - [What happens if the backup size exceeds the allowable maximum?](#what-happens-if-the-backup-size-exceeds-the-allowable-maximum)
 - [Can I use a storage account that has security features enabled?](#can-i-use-a-storage-account-that-has-security-features-enabled)
-- [## How do I restore to an app in a different subscription?](#how-do-i-restore-to-an-app-in-a-different-subscription)
+- [How do I restore to an app in a different subscription?](#how-do-i-restore-to-an-app-in-a-different-subscription)
+- [How do I restore to an app in the same subscription but in a different region?](#how-do-i-restore-to-an-app-in-the-same-subscription-but-in-a-different-region)
 
 #### Are the backups incremental updates or complete backups?
 
@@ -252,7 +271,7 @@ The following table shows which content is backed up in an automatic backup:
 |-|-|
 | **Windows apps**: All app content under `%HOME%` directory<br/>**Linux apps**: All app content under `/home` directory<br/>**Custom containers (Windows and Linux)**: Content in [persistent storage](configure-custom-container.md?pivots=container-linux#use-persistent-shared-storage)| Yes |
 | Content of the [run-from-ZIP package](deploy-run-package.md)| No |
-| Content from any [custom mounted Azure storage](configure-connect-to-azure-storage.md?pivots=container-windows)| No |
+| Content from any [custom mounted Azure storage](configure-connect-to-azure-storage.md?pivots=container-windows), such as from an Azure Files share. | No |
 
 The following table shows which app configuration is restored when you choose to restore app configuration:
 
@@ -307,6 +326,10 @@ The following security features in Azure storage aren't supported for custom bac
 1. In Name, select **Browse** and select the downloaded ZIP file.
 1. Configure the rest of the sections like in [Restore a backup](#restore-a-backup).
 
+#### How do I restore to an app in the same subscription but in a different region?
+
+The steps are the same as in [How do I restore to an app in a different subscription](#how-do-i-restore-to-an-app-in-a-different-subscription).
+
 <a name="nextsteps"></a>
 
 ## Next Steps