Skip to content

Commit 5a7109d

Browse files
authored
Merge pull request #306770 from fauhse/ga
Massive set of changes to get ready for GA.
2 parents f7d5cc0 + 95935b7 commit 5a7109d

15 files changed

Lines changed: 196 additions & 210 deletions

articles/storage-discovery/TOC.yml

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,10 +8,10 @@ items:
88
expanded: true
99
- name: Concepts
1010
items:
11-
- name: Management components
12-
href: management-components.md
1311
- name: Planning for deployment
1412
href: deployment-planning.md
13+
- name: Management components
14+
href: management-components.md
1515
- name: Pricing
1616
href: pricing.md
1717
- name: Reliability
@@ -32,6 +32,8 @@ items:
3232
items:
3333
- name: Get Started on Storage Discovery reports
3434
href: get-started-reports.md
35+
- name: Access your insights through Azure Copilot
36+
href: /azure/copilot/discover-storage-estate-insights?toc=/azure/storage-discovery/toc.json
3537
- name: Manage
3638
items:
3739
- name: Move resources to other locations in Azure

articles/storage-discovery/create-workspace-bicep.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ The template lists [Discovery workspace properties](/azure/templates/microsoft.s
6565

6666
| Name | Description |
6767
|------------------|-------------|
68-
|`workspaceRoots` | The workspace root designates the storage resources to get insights for. This `string[]` can contain subscription URIs, resource group URIs, or individual storage account resource URIs. You may mix and match these resource types in the array. The identity under which you deploy this template [must have permissions](deployment-planning.md#permissions-to-your-storage-resources) to all resources you list at the time of deployment. Alternatively, you may also provide a single tenant URI in this array. All storage resources under the tenant are then covered by this workspace. When choosing this option, you must not provide any other resource URIs. |
68+
|`workspaceRoots` | The workspace root designates the storage resources to get insights for. This `string[]` can contain a combination of subscription IDs and resource group IDs. You may mix and match these resource types. The identity under which you deploy this template [must have permissions](deployment-planning.md#permissions-to-your-storage-resources) to all resources you list at the time of deployment. Alternatively, you may also provide a single tenant URI in this array. All storage resources under the tenant are then covered by this workspace. When choosing this option, you must not provide any other resource IDs. |
6969
|`scopes` | You can create several scopes in a workspace. A scope allows you to filter the storage resources the workspace covers and obtain different reports for each of these scopes. Filtering is based on ARM resource tags on your storage resources. This property expects a `JSON` object containing sections for `tag key name` : `value` combinations or `tag key names` only. When your storage resources have matching ARM resource tags, they're included in this scope.|
7070

7171
Here's an example of the `JSON` structure defining a single scope in a Discovery workspace.

articles/storage-discovery/create-workspace.md

Lines changed: 9 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3,16 +3,15 @@ title: Create and manage an Azure Storage Discovery Workspace
33
titleSuffix: Azure Storage Discovery
44
description: Learn how to create an Azure Storage Discovery Workspace.
55
author: fauhse
6-
76
ms.service: azure-storage-discovery
8-
ms.topic: overview
9-
ms.date: 07/22/2025
7+
ms.topic: how-to
8+
ms.date: 10/09/2025
109
ms.author: fauhse
1110
---
1211

13-
# Create and manage a storage discovery preview workspace
12+
# Deploy the Azure Storage Discovery service
1413

15-
The Azure Storage Discovery workspace is a central resource within the Azure Storage Discovery (preview) platform. A discovery workspace is designed to help users manage and visualize storage data across various scopes such as tenants, subscriptions, and resource groups.
14+
To deploy the Azure Storage Discovery service, you need to create a Discovery workspace resource in one of your resource groups. With this resource, you define which storage resources you want to cover across your Microsoft Entra tenant and how you want to segment reporting for them. The workspace offers prebuilt reports in the Azure portal that you can use to retrieve the insights you need about your storage resources.
1615

1716
Follow the steps in this article to create an Azure Storage Discovery workspace resource.
1817

@@ -24,7 +23,7 @@ You can create a storage discovery workspace using the Azure portal, Azure Power
2423

2524
Create an Azure Storage Discovery Workspace resource in the Azure portal by selecting **Create** as shown in the following image.
2625

27-
:::image source="media/create-workspace/create-resource-sml.png" alt-text="Screenshot of the Create ASDW page." lightbox="media/create-workspace/create-resource.png":::
26+
:::image source="media/create-workspace/create-resource-sml.png" alt-text="Screenshot of the Create workspace page." lightbox="media/create-workspace/create-resource.png":::
2827

2928
Choose the **Subscription** and **Resource group** in which to create the discovery workspace. The following table describes each element.
3029

@@ -46,7 +45,7 @@ Select the subscriptions and/or resource groups you want to include in the works
4645

4746
> [!NOTE]
4847
> - Ensure that the user or service principal deploying the workspace is granted at least **Reader** access to each specified root.
49-
> - Up to 100 resources - subscriptions and/or resource groups can be included in one ASDW.
48+
> - Up to 100 resources - subscriptions and/or resource groups can be included in one workspace.
5049
5150
:::image source="media/create-workspace/workspace-roots-checks-sml.png" alt-text="Screenshot of the workspaceRoots." lightbox="media/create-workspace/workspace-roots-checks.png":::
5251

@@ -64,7 +63,7 @@ Scopes are logical groupings of storage accounts within the defined workspaceRoo
6463
> [!IMPORTANT]
6564
> A **default Scope** is added automatically, which includes all storage accounts within subscriptions or resource groups added in the **workspaceRoots**.
6665
67-
Add tags on the ASDW resource, if needed, and select **Review and Create**. You aren't able to deploy the resource until an access validation is complete. If the check for the workspaceRoots resources isn't complete, a message is displayed.
66+
You can optionally add tags to this workspace resource. Then select **Review and Create**. If the access validation is still running, you can't create the workspace resource yet. Wait for this check to finish, correct any issues, then confirm by selecting **Create**.
6867

6968
:::image source="media/create-workspace/access-check-sml.png" alt-text="Screenshot of access checks running." lightbox="media/create-workspace/access-check.png":::
7069

@@ -126,8 +125,8 @@ az storage-discovery workspace create \
126125
| resource-group | The resource group where the workspace is created. |
127126
| name | The name of the workspace. |
128127
| location | Azure region for deployment. |
129-
| workspace-roots | Defines the root scope (subscriptions/resource groups) for discovery. |
130-
| scopes | Logical groupings of storage accounts to analyze. |
128+
| workspace-roots | The workspace root designates the storage resources to get insights for. This `string[]` can contain a combination of subscription IDs and resource group IDs. You may mix and match these resource types. The identity under which you deploy the workspace [must have permissions](deployment-planning.md#permissions-to-your-storage-resources) to all resources you list at the time of deployment. Alternatively, you may also provide a single tenant ID in this array. All storage resources under the tenant are then covered by this workspace. When choosing this option, you must not provide any other resource IDs. |
129+
| scopes | You can create several scopes in a workspace. A scope allows you to filter the storage resources the workspace covers and obtain different reports for each of these scopes. Filtering is based on ARM resource tags on your storage resources. This property expects a `JSON` object containing sections for `tag key name` : `value` combinations or `tag key names` only. When your storage resources have matching ARM resource tags, they're included in this scope. |
131130
| sku | Pricing tier (Free or Standard). |
132131

133132
#### Optional parameters

articles/storage-discovery/deployment-planning.md

Lines changed: 5 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ title: Planning for an Azure Storage Discovery deployment
33
titleSuffix: Azure Storage Discovery
44
description: Considerations and best-practices for deploying the Azure Storage Discovery service
55
author: fauhse
6-
ms.service: azure-storage-mover
6+
ms.service: azure-storage-discovery
77
ms.topic: overview
8-
ms.date: 08/01/2025
8+
ms.date: 10/09/2025
99
ms.author: fauhse
1010
---
1111

@@ -65,9 +65,6 @@ Since you can only configure a limited number of scopes in a workspace, you may
6565
If a workspace is to be used for higher-level insights, you can create one with one scope for your entire Azure Storage estate and then add scopes for each department.
6666
If a workspace is designated to provide insights for specific workloads, then you can create a workspace containing a scope for each workload.
6767

68-
> [!IMPORTANT]
69-
> During the Azure Storage Discovery preview period, the Discovery service covers only storage accounts located in select regions. <br>The [Understand region limitations](#understand-region-limitations) section in this article has details.
70-
7168
### Review your Azure resource tags
7269

7370
You can select which storage resources are included in a [workspace scope](management-components.md) by first selecting specific subscriptions or resource groups, and then filtering the storage resources within them by [Azure resource tags](../azure-resource-manager/management/tag-resources.md).
@@ -77,21 +74,11 @@ It's important that you familiarize yourself with the available resource tags on
7774

7875
When you deploy a Storage Discovery workspace, you need to choose a region. The region you select determines where the computed insights about your Azure Storage resources are stored. You can still capture insights for Azure Storage resources that are located in other regions. A general best practice is to choose the region for your workspace according to metadata residency requirements that apply to you and in closer proximity to your location. Visualizing your insights from a workspace closer to you can have a slight performance advantage.
7976

80-
Storage Discovery workspaces can be created in the following regions. More regions are added throughout the preview period.
77+
Storage Discovery workspaces can be created in the following regions:
8178

8279
[!INCLUDE [control-plane-regions](includes/control-plane-regions.md)]
8380

84-
## Understand region limitations
85-
86-
While a Storage Discovery workspace can cover storage accounts from other subscriptions and resource groups, and even other regions, there's an important region limitation you need to be aware of for a successful Storage Discovery deployment.
87-
88-
The Discovery service covers only storage accounts located in the following regions:
89-
<br><br>
90-
[!INCLUDE [data-plane-regions](includes/data-plane-regions.md)]
91-
<br>
92-
93-
> [!WARNING]
94-
> The Discovery service currently can't consider storage accounts located in regions not included in the previously listed locations. Including storage accounts from unsupported regions in a scope can lead to an incomplete set of insights. A short-term limitation of the preview period.
81+
A Storage Discovery workspace can cover storage accounts located in any public cloud region. If a new Azure public cloud region becomes available, there may be a delay until storage resources from this new region get covered by the Storage Discovery service.
9582

9683
## Permissions
9784

@@ -113,9 +100,8 @@ The Azure Storage Discovery workspace stores the computed insights for your stor
113100
|:--------|--------------------------------------------------------------------------------:|
114101
|Register a resource provider namespace with a subscription| Subscription: `Contributor` |
115102
|Deploy a Storage Discovery workspace <br>*([Resource provider namespace already registered](#resource-provider-namespace))*| Resource group: `Contributor` |
116-
|Share the Storage Discovery insights with another person | Storage Discovery workspace: `Reader`|
103+
|Share the Storage Discovery insights with another person | Storage Discovery workspace: `Owner`|
117104
|Enable a person to make changes to the workspace configuration| Storage Discovery workspace: `Contributor`|
118-
|Enable a person to share these insights with others | Storage Discovery workspace: `Owner`|
119105

120106
> [!CAUTION]
121107
> When you provide other users access to a workspace, you're disclosing all insights of the workspace. Other users might not be privileged to know about the existence of the Azure resources or insights about the data they store. Providing access to a workspace doesn't provide access to an individual storage account, resource group, or subscription. Individual resources remain governed by RBAC.

0 commit comments

Comments
 (0)