Skip to content

Commit f0aa60e

Browse files
abhims14rwestMSFT
authored andcommitted
updated data action -4
Updated the note regarding Storage Blob Data Reader access for migration to clarify that it applies to both Azure SQL Managed Instance and Azure SQL Virtual Machine. Update permission for SQL MI and SQL VM
1 parent d728df5 commit f0aa60e

4 files changed

Lines changed: 27 additions & 15 deletions

File tree

data-migration/sql-server/managed-instance/custom-roles.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,9 @@ Use the `AssignableScopes` section of the role definition JSON string to control
6262
"Microsoft.DataMigration/SqlMigrationServices/tasks/delete"
6363
],
6464
"notActions": [],
65-
"dataActions": [],
65+
"dataActions": [
66+
"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read"
67+
],
6668
"notDataActions": []
6769
}
6870
]
@@ -75,7 +77,7 @@ You can use either the Azure portal, Azure PowerShell, Azure CLI, or Azure REST
7577
For more information, see [Create or update Azure custom roles using the Azure portal](/azure/role-based-access-control/custom-roles-portal) and [Azure custom roles](/azure/role-based-access-control/custom-roles).
7678

7779
> [!NOTE]
78-
> When migrating to SQL Managed Instance via **Azure portal** using **Managed Identity**, make sure the signed in user has **Storage Blob Data Reader** access on the storage account. This permission is needed to list folders and files in the blob container during migration setup via Azure portal. For more information, see [DMS - Support for Managed Identity for Azure SQL Managed Instance migration](https://techcommunity.microsoft.com/blog/microsoftdatamigration/dms---support-for-managed-identity-for-azure-sql-managed-instance-migration/4411274).
80+
> When migrating to Azure SQL Managed Instance or Azure SQL Virtual Machine via **Azure portal**, make sure the signed in user has **Storage Blob Data Reader** access on the storage account. This permission is needed to list folders and files in the blob container during migration setup via Azure portal only.
7981
8082
## Description of permissions needed to migrate to Azure SQL Managed Instance
8183

data-migration/sql-server/managed-instance/database-migration-service.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to migrate on-premises SQL Server to Azure SQL Managed In
55
author: abhims14
66
ms.author: abhishekum
77
ms.reviewer: randolphwest
8-
ms.date: 10/08/2025
8+
ms.date: 10/09/2025
99
ms.service: azure-database-migration-service
1010
ms.topic: tutorial
1111
ms.collection:
@@ -71,6 +71,9 @@ To complete this tutorial, you need to:
7171

7272
- Have an Azure account that's assigned to one of the following built-in roles:
7373

74+
> [!IMPORTANT]
75+
> An Azure account is required only when you configure the migration steps. An Azure account isn't required for the assessment or to view Azure recommendations in the migration wizard in Azure Data Studio.
76+
7477
- *Contributor* for the target instance of Azure SQL Managed Instance and for the storage account where you upload your database backup files from a Server Message Block (SMB) network share, and *Reader* role for the Azure resource groups that contain the target instance of Azure SQL Managed Instance or your Azure storage account.
7578

7679
- *Owner* or *Contributor* role for the Azure subscription (required if you create a new Database Migration Service instance).
@@ -87,13 +90,12 @@ To complete this tutorial, you need to:
8790

8891
1. In the Azure portal, go to **Storage account** (used for the migration for keeping backup files), and navigate to **IAM roles** > **Assign role**, and assign Storage Blob Data Reader to the associated managed identity.
8992

90-
> [!NOTE]
91-
> When migrating to SQL Managed Instance via **Azure portal** using **Managed Identity**, make sure the signed in user has **Storage Blob Data Reader** access on the storage account. This permission is needed to list folders and files in the blob container during migration setup via Azure portal. For more information, see [DMS - Support for Managed Identity for Azure SQL Managed Instance migration](https://techcommunity.microsoft.com/blog/microsoftdatamigration/dms---support-for-managed-identity-for-azure-sql-managed-instance-migration/4411274).
93+
For more information, see [DMS - Support for Managed Identity for Azure SQL Managed Instance migration](https://techcommunity.microsoft.com/blog/microsoftdatamigration/dms---support-for-managed-identity-for-azure-sql-managed-instance-migration/4411274).
9294

93-
As an alternative to using one of these built-in roles, you can [assign custom roles](custom-roles.md).
95+
- As an alternative to using one of these built-in roles, you can [assign custom roles](custom-roles.md).
9496

95-
> [!IMPORTANT]
96-
> An Azure account is required only when you configure the migration steps. An Azure account isn't required for the assessment or to view Azure recommendations in the migration wizard in Azure Data Studio.
97+
> [!NOTE]
98+
> When migrating to Azure SQL Managed Instance or Azure SQL Virtual Machine via **Azure portal**, make sure the signed in user has **Storage Blob Data Reader** access on the storage account. This permission is needed to list folders and files in the blob container during migration setup via Azure portal only.
9799
98100
- Create a target instance of [Azure SQL Managed Instance](/azure/azure-sql/managed-instance/instance-create-quickstart).
99101

data-migration/sql-server/virtual-machines/custom-roles.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: "Custom roles: Online SQL Server to Azure Virtual Machines migrations with ADS"
2+
title: "Custom Roles: Online SQL Server to Azure Virtual Machines Migrations with ADS"
33
titleSuffix: Azure Database Migration Service
44
description: Learn to use the custom roles for SQL Server to Azure VM's migrations.
55
author: rwestMSFT
66
ms.author: randolphwest
7-
ms.date: 06/11/2025
7+
ms.date: 10/09/2025
88
ms.service: azure-database-migration-service
99
ms.topic: conceptual
1010
ms.collection:
@@ -59,7 +59,9 @@ Use the `AssignableScopes` section of the role definition JSON string to control
5959
"Microsoft.DataMigration/SqlMigrationServices/tasks/delete"
6060
],
6161
"notActions": [],
62-
"dataActions": [],
62+
"dataActions": [
63+
"Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read"
64+
],
6365
"notDataActions": []
6466
}
6567
]
@@ -71,6 +73,9 @@ You can use either the Azure portal, Azure PowerShell, Azure CLI, or Azure REST
7173

7274
For more information, see [Create or update Azure custom roles using the Azure portal](/azure/role-based-access-control/custom-roles-portal) and [Azure custom roles](/azure/role-based-access-control/custom-roles).
7375

76+
> [!NOTE]
77+
> When migrating to Azure SQL Managed Instance or Azure SQL Virtual Machine via **Azure portal**, make sure the signed in user has **Storage Blob Data Reader** access on the storage account. This permission is needed to list folders and files in the blob container during migration setup via Azure portal only.
78+
7479
## Description of permissions needed to migrate to a virtual machine
7580

7681
| Permission Action | Description |

data-migration/sql-server/virtual-machines/database-migration-service.md

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how to migrate on-premises SQL Server to SQL Server on Azure
55
author: abhims14
66
ms.author: abhishekum
77
ms.reviewer: cawrites, randolphwest
8-
ms.date: 10/06/2025
8+
ms.date: 10/09/2025
99
ms.service: azure-database-migration-service
1010
ms.topic: tutorial
1111
ms.collection:
@@ -43,16 +43,19 @@ Before you begin the tutorial:
4343
- [Install the Azure SQL migration extension](/azure-data-studio/extensions/azure-sql-migration-extension) from Azure Data Studio Marketplace.
4444
- Have an Azure account that's assigned to one of the following built-in roles:
4545

46+
> [!IMPORTANT]
47+
> An Azure account is required only when you configure the migration steps. An Azure account isn't required for the assessment or to view Azure recommendations in the migration wizard in Azure Data Studio.
48+
4649
- Contributor for the target instance of SQL Server on Azure Virtual Machines, and for the storage account where you upload your database backup files from a Server Message Block (SMB) network share
4750

4851
- Reader role for the Azure resource group that contains the target instance of SQL Server on Azure Virtual Machines or for your Azure Storage account
4952

5053
- Owner or Contributor role for the Azure subscription
5154

52-
As an alternative to using one of these built-in roles, you can [assign custom roles](custom-roles.md).
55+
- As an alternative to using one of these built-in roles, you can [assign custom roles](custom-roles.md).
5356

54-
> [!IMPORTANT]
55-
> An Azure account is required only when you configure the migration steps. An Azure account isn't required for the assessment or to view Azure recommendations in the migration wizard in Azure Data Studio.
57+
> [!NOTE]
58+
> When migrating to Azure SQL Managed Instance or Azure SQL Virtual Machine via **Azure portal**, make sure the signed in user has **Storage Blob Data Reader** access on the storage account. This permission is needed to list folders and files in the blob container during migration setup via Azure portal only.
5659
5760
- Create a target instance of [SQL Server on Azure Virtual Machines](/azure/azure-sql/virtual-machines/windows/create-sql-vm-portal).
5861

0 commit comments

Comments
 (0)