Merge pull request #26502 from MashaMSFT/202303_pitrpics

updated screenshots

Author: v-regandowner

azure-sql/managed-instance/long-term-backup-retention-configure.md

@@ -4,7 +4,7 @@ description: Learn how to store and restore automated backups on separate Azure
 author: SudhirRaparla
 ms.author: nvraparl
 ms.reviewer: mathoma
-ms.date: 09/12/2021
+ms.date: 03/25/2023
 ms.service: sql-managed-instance
 ms.subservice: backup-restore
 ms.topic: how-to
@@ -43,7 +43,7 @@ Prepare your environment for PowerShell.
 For **Get-AzSqlInstanceDatabaseLongTermRetentionBackup** and **Restore-AzSqlInstanceDatabase**, you will need to have one of the following roles:
 
 - Subscription Owner role or
-- Managed Instance Contributor role or
+- SQL Managed Instance Contributor role or
 - Custom role with the following permissions:
   - `Microsoft.Sql/locations/longTermRetentionManagedInstanceBackups/read`
   - `Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionManagedInstanceBackups/read`
@@ -56,7 +56,7 @@ For **Remove-AzSqlInstanceDatabaseLongTermRetentionBackup**, you will need to ha
   - `Microsoft.Sql/locations/longTermRetentionManagedInstances/longTermRetentionDatabases/longTermRetentionManagedInstanceBackups/delete`
 
 > [!NOTE]
-> The Managed Instance Contributor role does not have permission to delete LTR backups.
+> The SQL Managed Instance Contributor role does not have permission to delete LTR backups.
 
 Azure RBAC permissions could be granted in either *subscription* or *resource group* scope. However, to access LTR backups that belong to a dropped instance, the permission must be granted in the *subscription* scope of that instance.
 
@@ -85,7 +85,7 @@ You can configure SQL Managed Instance to [retain automated backups](../database
 
 # [Azure CLI](#tab/azure-cli)
 
-1. Run the [az sql midb show](/cli/azure/sql/midb#az-sql-midb-show) command to get the details for the Managed Instance database.
+1. Run the [az sql midb show](/cli/azure/sql/midb#az-sql-midb-show) command to get the details for the SQL Managed Instance database.
 
     ```azurecli
     az sql midb show /
@@ -159,29 +159,42 @@ Set-AzSqlInstanceDatabaseBackupLongTermRetentionPolicy @LTRPolicy
 
 # [Portal](#tab/portal)
 
-View the backups that are retained for a specific database with an LTR policy, and restore from those backups.
 
-1. In the Azure portal, select your managed instance and then click **Backups**. On the **Available backups** tab, select the database for which you want to see available backups. Click **Manage**.
+To view available long-term backups from the Azure portal, follow these steps: 
+
+1. In the Azure portal, select your managed instance and then select **Backups**. On the **Available backups** tab, select the database for which you want to see available backups. Select **Manage**.
 
    ![select database](./media/long-term-backup-retention-configure/ltr-available-backups-select-database.png)
 
 1. In the **Manage backups** pane, review the available backups.
 
    ![view backups](./media/long-term-backup-retention-configure/ltr-available-backups.png)
 
-1. Select the backup from which you want to restore, click **Restore**, then on the restore page specify the new database name. The backup and source will be pre-populated on this page. 
+You can also restore from this page by choosing the backup and selecting **Restore**. 
+
+Alternatively, to restore a backup from long-term retention by using the Azure portal, follow these steps: 
+
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. Go to the target SQL Managed Instance where you plan to restore your database to. 
+1. On the **Overview** page, choose **+ New database** to open the **Create Azure SQL Managed Database** page. 
+
+   :::image type="content" source="media/point-in-time-restore/choose-database-to-restore.png" alt-text="Screenshot that shows the SQL Managed Instance overview pane in the Azure portal, with adding a new database selected. ":::
+
+1. On the **Basics** tab of the **Create Azure SQL Managed Database page**, provide subscription and resource group details under **Project details**. Then, under **Database details** provide the new name of the database you plan to restore. Confirm the correct managed instance is listed in the drop down. Then select **Next: Data source >**
+
+    :::image type="content" source="./media/point-in-time-restore/create-database-page.png" alt-text="Screenshot of the Azure portal that shows the Basics tab of the Create Azure SQL Managed Database page.":::
+
+1. On the **Data source** tab, choose **Point-in-time restore** under **Use existing data**. Provide the subscription, resource group and managed instance that contains the source database. From the **Managed database** drop-down, choose the database you want to restore, and then choose the point in time you want to restore the database from. The source and target instance can be the same, or two different instances. Select **Next : Additional settings >**
 
-   ![select backup for restore](./media/long-term-backup-retention-configure/ltr-available-backups-restore.png)
-   
-   ![restore](./media/long-term-backup-retention-configure/ltr-restore.png)
+    :::image type="content" source="./media/long-term-backup-retention-configure/restore-long-term-backup.png" alt-text="Screenshot of the Azure portal that shows the data source tab of the Create Azure SQL Managed Database page, with long-term retention selected.":::
 
-1. Click **Review + Create** to review your Restore details. Then click **Create** to restore your database from the chosen backup.
+1. On the **Additional settings** tab, you can check the box to inherit the retention policy from the source database, or, alternatively, you can select **Configure retention** to open the **Configure policies** page, and set your desired retention policies for your restored database. When finished, select **Review + create**. 
 
-1. On the toolbar, click the notification icon to view the status of the restore job.
+    :::image type="content" source="./media/point-in-time-restore/additional-settings-page.png" alt-text="Screenshot of the Azure portal that shows the additional settings tab of the Create Azure SQL Managed Database page.":::
 
-   ![restore job progress](./media/long-term-backup-retention-configure/restore-job-progress-long-term.png)
+1. On **Review + create**, when validation is successful, select **Create** to restore your database.
 
-1. When the restore job is completed, open the **Managed Instance Overview** page to view the newly restored database.
+This action starts the restore process, which creates a new database and populates it with data from the original database at the specified point in time. For more information about the recovery process, see [Recovery time](../database/recovery-using-backups.md#recovery-time).
 
 > [!NOTE]
 > From here, you can connect to the restored database using SQL Server Management Studio to perform needed tasks, such as to [extract a bit of data from the restored database to copy into the existing database or to delete the existing database and rename the restored database to the existing database name](../database/recovery-using-backups.md#point-in-time-restore).

azure-sql/managed-instance/media/long-term-backup-retention-configure/restore-long-term-backup.png

@@ -5,7 +5,7 @@ description: Learn how to restore a database to an earlier point in time for Azu
 author: MilanMSFT
 ms.author: mlazic
 ms.reviewer: mathoma, nvraparl
-ms.date: 03/01/2023
+ms.date: 03/25/2023
 ms.service: sql-managed-instance
 ms.subservice: backup-restore
 ms.topic: how-to
@@ -95,36 +95,32 @@ If you restore to a different subscription, the [Create or Update v5.0.2022](/re
 
 # [Portal](#tab/azure-portal)
 
-1. Sign in to the [Azure portal](https://portal.azure.com).
-1. In SQL Managed Instance, go to your source managed instance.
-1. In **Managed Instance databases**, select the database to restore.
+To restore an existing database, you can do so by going to the database page in the Azure portal, and selecting **Restore**. 
+
+Alternatively to restore your database, you can follow these steps: 
 
-   :::image type="content" source="media/point-in-time-restore/choose-database-to-restore.png" alt-text="Screenshot that shows the SQL Managed Instance overview pane in the Azure portal, with a database selected. ":::
+1. Sign in to the [Azure portal](https://portal.azure.com).
+1. Go to the target SQL Managed Instance where you plan to restore your database to. 
+1. On the **Overview** page, choose **+ New database** to open the **Create Azure SQL Managed Database** page. 
 
-1. In the command bar, select **Restore**.
+   :::image type="content" source="media/point-in-time-restore/choose-database-to-restore.png" alt-text="Screenshot that shows the SQL Managed Instance overview pane in the Azure portal, with adding a new database selected. ":::
 
-    :::image type="content" source="./media/point-in-time-restore/restore-database-to-mi.png" alt-text="Screenshot that shows a database overview pane in the Azure portal, with the Restore button highlighted.":::
+1. On the **Basics** tab of the **Create Azure SQL Managed Database page**, provide subscription and resource group details under **Project details**. Then, under **Database details** provide the new name of the database you plan to restore. Confirm the correct managed instance is listed in the drop down. Then select **Next: Data source >**
 
-1. In **Create Azure SQL Managed Database** on the **Basics** tab:
+    :::image type="content" source="./media/point-in-time-restore/create-database-page.png" alt-text="Screenshot of the Azure portal that shows the Basics tab of the Create Azure SQL Managed Database page.":::
 
-    1. Under **Project details**, select the target destination subscription and resource group that contain the managed instance to restore the database to.
-    1. Under **Database details**, enter a new name for your restored database and the target managed instance to restore the database to.
-    1. Select the **Data source** tab.
+1. On the **Data source** tab, choose **Point-in-time restore** under **Use existing data**. Provide the subscription, resource group and managed instance that contains the source database. From the **Managed database** drop-down, choose the database you want to restore, and then choose the point in time you want to restore the database from. The source and target instance can be the same, or two different instances. Select **Next : Additional settings >**
 
-1. In **Data source**:
+    :::image type="content" source="./media/point-in-time-restore/database-data-source.png" alt-text="Screenshot of the Azure portal that shows the data source tab of the Create Azure SQL Managed Database page, with point-in-time restore selected.":::
 
-   1. Select **Continuous backup**. Select the subscription and resource group for the source database to restore.
-   1. In **Managed Database**, select the database to restore. Select the point-in-time restore point to restore the database from.
-   1. Select the **Additional settings** tab.
+1. On the **Additional settings** tab, you can check the box to inherit the retention policy from the source database, or, alternatively, you can select **Configure retention** to open the **Configure policies** page, and set your desired retention policies for your restored database.  When finished, select **Review + create**. 
 
-1. In **Additional settings**:
+    :::image type="content" source="./media/point-in-time-restore/additional-settings-page.png" alt-text="Screenshot of the Azure portal that shows the additional settings tab of the Create Azure SQL Managed Database page.":::
 
-   1. Either select or clear the option for your restored database to inherit the retention settings of the source database. If you don't use this option, select **Configure retention** to set a new retention policy.
-   1. Select the **Review + create** tab to validate your database restore settings.
 
-1. In **Review + create**, when validation is successful, select **Create** to restore your database.
+1. On **Review + create**, when validation is successful, select **Create** to restore your database.
 
-   This action starts the restore process, which creates a new database and populates it with data from the original database at the specified point in time. For more information about the recovery process, see [Recovery time](../database/recovery-using-backups.md#recovery-time).
+This action starts the restore process, which creates a new database and populates it with data from the original database at the specified point in time. For more information about the recovery process, see [Recovery time](../database/recovery-using-backups.md#recovery-time).
 
 # [PowerShell](#tab/azure-powershell)
 
@@ -285,7 +281,7 @@ Restore-AzSqlinstanceDatabase -FromPointInTimeBackup -Name $deletedDatabase.Name
                               -TargetInstanceName $targetInstanceName 
 ```
 
-To restore the database to another subscription, set the context to the the target subscription (`Set-AzContext`) and be sure to provide values for the required parameters `-TargetSubscriptionID`, and `-DeleteDate`: 
+To restore the database to another subscription, set the context to the target subscription (`Set-AzContext`) and be sure to provide values for the required parameters `-TargetSubscriptionID`, and `-DeleteDate`: 
 
 ```powershell-interactive
 Set-AzContext -SubscriptionID "targetSubscriptionID"

azure-sql/managed-instance/media/point-in-time-restore/additional-settings-page.png

@@ -5,7 +5,7 @@ description: Learn about point-in-time restore, which enables you to roll back a
 author: MilanMSFT
 ms.author: mlazic
 ms.reviewer: wiassaf, mathoma, danil
-ms.date: 11/16/2022
+ms.date: 03/25/2023
 ms.service: sql-managed-instance
 ms.subservice: backup-restore
 ms.topic: how-to
@@ -95,11 +95,15 @@ You generally restore a database to an earlier point for recovery purposes. You
 
 ### [Azure portal](#tab/azure-portal)
 
-To recover a database in SQL Managed Instance to a point in time by using the Azure portal, open the source database overview page, and select **Restore** on the toolbar. Provide target managed instance details on the **Basics** tab, and source managed instance details on the **Data source** tab. Configure retention settings on the **Additional settings** tab. 
+To recover a database in SQL Managed Instance to a point in time by using the Azure portal, you can go to the database in the portal and choose **Restore**. Alternatively, you can open the target SQL Managed Instance overview page, and select **+ New database** on the toolbar to open the **Create Azure SQL Managed Database** page. 
 
-:::image type="content" source="media/point-in-time-restore/choose-database-to-restore.png" alt-text="Screenshot of the Azure portal, SQL Managed Instance overview blade, with a database selected. ":::
+:::image type="content" source="media/point-in-time-restore/choose-database-to-restore.png" alt-text="Screenshot that shows the SQL Managed Instance overview pane in the Azure portal, with adding a new database selected. ":::
 
-:::image type="content" source="./media/point-in-time-restore/restore-database-to-mi.png" alt-text="Screenshot of the Azure portal, database overview page, Restore is highlighted.":::
+Provide target managed instance details on the **Basics** tab, and choose a type of backup from the **Data source** tab. 
+
+:::image type="content" source="./media/point-in-time-restore/database-data-source.png" alt-text="Screenshot of the Azure portal that shows the data source tab of the Create Azure SQL Managed Database page, with point-in-time restore selected.":::
+
+For greater details, review the [Point in time restore](point-in-time-restore.md#restore-an-existing-database) article. 
 
 ### [Azure CLI](#tab/azure-cli)