Merge pull request #108610 from mgblythe/mb-0323-dashboards

Freshness for dashboard articles

Author: v-albemi

articles/azure-portal/azure-portal-dashboard-share-access.md

@@ -13,7 +13,7 @@ ms.devlang: NA
 ms.topic: conceptual
 ms.tgt_pltfrm: NA
 ms.workload: na
-ms.date: 01/29/2020
+ms.date: 03/23/2020
 ms.author: mblythe
 
 ---
@@ -36,7 +36,7 @@ With Role-Based Access Control (RBAC), you can assign users to roles at three di
 * resource group
 * resource
 
-The permissions you assign inherit from subscription down to the resource. The published dashboard is a resource. You may already have users assigned to roles for the subscription that apply for the published dashboard.
+The permissions you assign inherit from the subscription down to the resource. The published dashboard is a resource. You may already have users assigned to roles for the subscription that apply for the published dashboard.
 
 Let's say you have an Azure subscription and various members of your team have been assigned the roles of *owner*, *contributor*, or *reader* for the subscription. Users who are owners or contributors can list, view, create, modify, or delete dashboards within the subscription. Users who are readers can list and view dashboards, but can't modify or delete them. Users with reader access can make local edits to a published dashboard, such as when troubleshooting an issue, but they can't publish those changes back to the server. They can make a private copy of the dashboard for themselves.
 
@@ -56,35 +56,31 @@ Before assigning access, you must publish the dashboard.
 
     ![publish your dashboard](./media/azure-portal-dashboard-share-access/publish-dashboard-for-access-control.png)
 
-     By default, sharing publishes your dashboard to a resource group named **dashboards**.
+     By default, sharing publishes your dashboard to a resource group named **dashboards**. To select a different resource group, clear the checkbox.
 
 Your dashboard is now published. If the permissions inherited from the subscription are suitable, you don't need to do anything more. Other users in your organization can access and modify the dashboard based on their subscription level role.
 
 ## Assign access to a dashboard
 
 You can assign a group of users to a role for that dashboard.
 
-1. After publishing the dashboard, in **Sharing + access control**, select **Manage users**.
+1. After publishing the dashboard, select the **Share** or **Unshare** option to access **Sharing + access control**.
 
-    ![manage users for a dashboard](./media/azure-portal-dashboard-share-access/manage-users-for-access-control.png)
+1. In **Sharing + access control**, select **Manage users**.
 
-    To access **Sharing + access control** from a dashboard, select the **Share** or **Unshare** option.
+    ![manage users for a dashboard](./media/azure-portal-dashboard-share-access/manage-users-for-access-control.png)
 
 1. Select **Role assignments** to see existing users that are already assigned a role for this dashboard.
 
-1. To add a new user or group, select **Add**.
+1. To add a new user or group, select **Add** then **Add role assignment**.
 
     ![add a user for access to the dashboard](./media/azure-portal-dashboard-share-access/manage-users-existing-users.png)
 
 1. Select the role that represents the permissions to grant. For this example, select **Contributor**.
 
 1. Select the user or group to assign to the role. If you don't see the user or group you're looking for in the list, use the search box. Your list of available groups depends on the groups you've created in Active Directory.
 
-1. When you have finished adding users or groups, select **OK**.
-
-    The new assignment is added to the list of users. Its **Access** is listed as **Assigned** rather than **Inherited**.
-
-    ![assigned roles](./media/azure-portal-dashboard-share-access/assigned-roles.png)
+1. When you've finished adding users or groups, select **Save**.
 
 ## Next steps
 

articles/azure-portal/azure-portal-dashboards-create-programmatically.md

@@ -12,23 +12,23 @@ ms.devlang: NA
 ms.topic: conceptual
 ms.tgt_pltfrm: NA
 ms.workload: na
-ms.date: 01/29/2020
+ms.date: 03/23/2020
 ms.author: mblythe
 
 ---
 # Programmatically create Azure Dashboards
 
-This document walks through the process of programmatically creating and publishing Azure dashboards. The dashboard shown below is referenced throughout the document.
+This article walks you through the process of programmatically creating and publishing Azure dashboards. The dashboard shown below is referenced throughout the document.
 
 ![sample dashboard](./media/azure-portal-dashboards-create-programmatically/sample-dashboard.png)
 
 ## Overview
 
-Shared dashboards in the [Azure portal](https://portal.azure.com) are [resources](../azure-resource-manager/management/overview.md) just like virtual machines and storage accounts. You can manage resources programmatically by using the [Azure Resource Manager REST APIs](/rest/api/), the [Azure CLI](/cli/azure), and [Azure PowerShell commands](/powershell/azure/get-started-azureps).  
+Shared dashboards in the [Azure portal](https://portal.azure.com) are [resources](../azure-resource-manager/management/overview.md) just like virtual machines and storage accounts. You can manage resources programmatically by using the [Azure Resource Manager REST APIs](/rest/api/), the [Azure CLI](/cli/azure), and [Azure PowerShell commands](/powershell/azure/get-started-azureps).
 
 Many features build on these APIs to make resource management easier. Each of these APIs and tools offers ways to create, list, retrieve, modify, and delete resources. Since dashboards are resources, you can pick your favorite API or tool to use.
 
-Whichever tools you use, you need to construct a JSON representation of your dashboard object. This object contains information about the tiles on the dashboard. It includes sizes, positions, resources they're bound to, and any user customizations.
+Whichever tools you use, to create a dashboard programmatically, you construct a JSON representation of your dashboard object. This object contains information about the tiles on the dashboard. It includes sizes, positions, resources they're bound to, and any user customizations.
 
 The most practical way to build up this JSON document is to use the Azure portal. You can interactively add and position your tiles. Then export the JSON and create a template from the result for later use in scripts, programs, and deployment tools.
 
@@ -48,7 +48,7 @@ Others have fixed sizes to choose from in their context menu.
 
 ## Share the dashboard
 
-After you configure the dashboard, the next steps are to publish the dashboard using the **Share** command and then use the Resource Explorer to fetch the JSON.
+After you configure the dashboard, the next step is to publish the dashboard using the **Share** command.
 
 ![sharing a dashboard](./media/azure-portal-dashboards-create-programmatically/share-command.png)
 
@@ -58,13 +58,9 @@ Selecting **Share** prompts you to choose which subscription and resource group
 
 ## Fetch the JSON representation of the dashboard
 
-Publishing only takes a few seconds.  When it's done, the next step is to go to the [Resource Explorer](https://portal.azure.com/#blade/HubsExtension/ArmExplorerBlade) to fetch the JSON.
+Publishing only takes a few seconds. When it's done, the next step is to fetch the JSON using the **Download** command.
 
-![browse Resource Explorer](./media/azure-portal-dashboards-create-programmatically/search-resource-explorer.png)
-
-From the Resource Explorer, navigate to the subscription and resource group that you chose. Next, select the newly published dashboard resource to reveal the JSON.
-
-![view JSON in Resource Explorer](./media/azure-portal-dashboards-create-programmatically/resource-explorer-json-detail.png)
+![download JSON representation](./media/azure-portal-dashboards-create-programmatically/download-command.png)
 
 ## Create a template from the JSON
 
@@ -123,21 +119,18 @@ Declare required template metadata and the parameters at the top of the JSON tem
 
     ... rest of template omitted ...
 ```
-
-You can see the full, working template at the end of this document.
-
 Once you've configured your template, deploy it using any of the following methods:
 
 * [REST APIs](/rest/api/resources/deployments)
 * [PowerShell](../azure-resource-manager/resource-group-template-deploy.md)
 * [Azure CLI](/cli/azure/group/deployment#az-group-deployment-create)
 * [The Azure portal template deployment page](https://portal.azure.com/#create/Microsoft.Template)
 
-Here are two versions of our example dashboard JSON. The first is the version that we exported from the portal that was already bound to a resource. The second is the template version that can be programmatically bound to any virtual machine and deployed using Azure Resource Manager.
+Next you'll see two versions of our example dashboard JSON. The first is the version that we exported from the portal that was already bound to a resource. The second is the template version that can be programmatically bound to any virtual machine and deployed using Azure Resource Manager.
 
-## JSON representation of our example dashboard before templating
+### JSON representation of our example dashboard before templating
 
-This example shows what you can expect to see if you followed along with this article. The instructions exported the JSON representation of a dashboard that is already deployed. The hard-coded resource identifiers that show that this dashboard is pointing at a specific Azure virtual machine.
+This example shows what you can expect to see if you followed along with this article. The instructions exported the JSON representation of a dashboard that is already deployed. The hard-coded resource identifiers show that this dashboard is pointing at a specific Azure virtual machine.
 
 ```json
 
@@ -659,6 +652,6 @@ This example deploys a dashboard by itself, but the template language lets you d
         }
     ]
 }
-
-
 ```
+
+Now that you've seen an example of using a parameterized template to deploy a dashboard, you can try deploying the template by using the [Azure Resource Manager REST APIs](/rest/api/), the [Azure CLI](/cli/azure), or [Azure PowerShell commands](/powershell/azure/get-started-azureps).

articles/azure-portal/azure-portal-dashboards.md

@@ -13,7 +13,7 @@ ms.devlang: NA
 ms.topic: conceptual
 ms.tgt_pltfrm: NA
 ms.workload: na
-ms.date: 01/29/2020
+ms.date: 03/23/2020
 ms.author: mblythe
 
 ---
@@ -35,7 +35,7 @@ In this example, we create a new, private dashboard and assign a name. Follow th
 
 1. Select **New dashboard**.
 
-    ![Screenshot of default dashboard](./media/azure-portal-dashboards/create-new-dashboard.png)
+    ![Screenshot of new dashboard](./media/azure-portal-dashboards/create-new-dashboard.png)
 
     This action opens the **Tile Gallery**, from which you'll select tiles, and an empty grid where you'll arrange the tiles.
 
@@ -45,13 +45,13 @@ In this example, we create a new, private dashboard and assign a name. Follow th
 
 1. Select **Done customizing** in the page header to exit edit mode.
 
-The dashboard view now shows your empty dashboard. Select the arrow next to the dashboard name to see dashboards available to you. The list might include dashboards that other users have created and shared.
+The dashboard view now shows your new dashboard. Select the arrow next to the dashboard name to see dashboards available to you. The list might include dashboards that other users have created and shared.
 
 ## Edit a dashboard
 
 Now, let's edit the dashboard to add, resize, and arrange tiles that represent your Azure resources.
 
-### Add tiles
+### Add tiles from the dashboard
 
 To add tiles to a dashboard, follow these steps:
 
@@ -63,14 +63,14 @@ To add tiles to a dashboard, follow these steps:
 
 1. Select **Add** to add the tile to the dashboard with a default size and location. Or, drag the tile to the grid and place it where you want.
 
-Many resource pages include a pushpin icon in the command bar. If you select the icon, a tile representing the source page is pinned to the dashboard that is currently active. This method is an alternative way to add tiles to your dashboard.
-
-![Screenshot of page command bar with pin icon](./media/azure-portal-dashboards/dashboard-pin-blade.png)
-
 > [!TIP]
 > If you work with more than one organization, add the **Organization identity** tile to your dashboard to clearly show which organization the resources belong to.
->
->
+
+### Add tiles from a resource page
+
+There is an alternative way to add tiles to your dashboard. Many resource pages include a pushpin icon in the command bar. If you select the icon, a tile representing the source page is pinned to the dashboard that is currently active. 
+
+![Screenshot of page command bar with pin icon](./media/azure-portal-dashboards/dashboard-pin-blade.png)
 
 ### Resize or rearrange tiles
 
@@ -88,14 +88,17 @@ To change the size of a tile or to rearrange the tiles on a dashboard, follow th
 
 Some tiles might require more configuration to show the information you want. For example, the **Metrics chart** tile has to be set up to display a metric from **Azure Monitor**. You can also customize tile data to override the dashboard's default time settings.
 
-Any tile that needs to be set up displays a **Configure tile** banner until you customize the tile. Select that banner, then do the required setup.
+Any tile that needs to be set up displays a **Configure tile** banner until you customize the tile. To customize the tile:
 
-![Screenshot of tile that requires configuration](./media/azure-portal-dashboards/dashboard-configure-tile.png)
+1. Select **Done customizing** in the page header to exit edit mode.
+
+1. Select the banner, then do the required setup.
+
+    ![Screenshot of tile that requires configuration](./media/azure-portal-dashboards/dashboard-configure-tile.png)
 
 > [!NOTE]
 > A markdown tile lets you display custom, static content on your dashboard. This could be basic instructions, an image, a set of hyperlinks, or even contact information. For more information about using a markdown tile, see [Use a markdown tile on Azure dashboards to show custom content](azure-portal-markdown-tile.md).
->
->
+
 ### Customize tile data
 
 Data on the dashboard automatically shows activity for the past 24 hours. To show a different time span for just this tile, follow these steps:
@@ -136,50 +139,27 @@ To use an existing dashboard as a template for a new dashboard, follow these ste
 
 ## Publish and share a dashboard
 
-When you create a dashboard, it's private by default, which means you're the only one who can see it. To make dashboards available to others, you can share them with other users. First, you have to publish the dashboard as an Azure resource. To publish and share a custom dashboard, follow these steps:
-
-1. Select ![share icon](./media/azure-portal-dashboards/dashboard-share-icon.png) **Share** from the page header. **Sharing + access control** opens.
-
-1. Verify that the correct dashboard name is shown.
-
-1. Select a **Subscription name**. Users with access to the subscription can use the shared dashboard. Access to the resources represented by the individual tiles is determined by Azure role-based access control.
-
-1. Select the checkbox to publish this dashboard to the 'dashboards' resource group for the selected subscription. Or, clear the checkbox and choose to publish to an existing resource group instead.
-
-1. Choose a location for the dashboard resource. We recommend you locate the dashboard with other resources. If you choose from existing resource groups, the dashboard is automatically located with that resource group.
-
-1. Select **Publish**.
-
-    ![Screenshot of dashboard publishing dialog](./media/azure-portal-dashboards/dashboard-publish.png)
-
-### Set access control on a shared dashboard
-
-After the dashboard is published, manage who has access to the dashboard by following these steps:
-
-1. In the **Sharing + access control** pane, select **Manage users**.
-
-    ![Screenshot of dashboard sharing + access control dialog](./media/azure-portal-dashboards/dashboard-share-access-control.png)
-
-1. The **Access Control** page opens. You can review the level of access for someone or add a new role assignment. When you add a role assignment here, you're granting permissions to the dashboard.
-
-> [!NOTE]
-> Tiles are representative views of resources in your organization. Access to resources is managed through role-based access control assignment and permissions are inherited from the subscription down to the resource. Giving access to a dashboard doesn't automatically assign permissions to the resources shown on the dashboard. For more information about permissions to shared dashboards and role-based access control for resources, see [Share Azure dashboards by using Role-Based Access Control](azure-portal-dashboard-share-access.md).
+When you create a dashboard, it's private by default, which means you're the only one who can see it. To make dashboards available to others, you can publish and share them. For more information, see [Share Azure dashboards by using Role-Based Access Control](azure-portal-dashboard-share-access.md).
 
 ### Open a shared dashboard
 
 To find and open a shared dashboard, follow these steps:
 
 1. Select the arrow next to the dashboard name.
 
-1. Select from the displayed list of dashboards or **Browse all dashboards** if the dashboard you want to open isn't listed.
+1. Select from the displayed list of dashboards. If the dashboard you want to open isn't listed:
+
+    1. select **Browse all dashboards**.
+
+        ![Screenshot of dashboard selection menu](./media/azure-portal-dashboards/dashboard-browse.png)
 
-    ![Screenshot of dashboard selection menu](./media/azure-portal-dashboards/dashboard-browse.png)
+    1. In the **Type** field, select **Shared dashboards**.
 
-1. In the **Type** field, select **Shared dashboards**.
+        ![Screenshot of all dashboards selection menu](./media/azure-portal-dashboards/dashboard-browse-all.png)
 
-1. Select one or more subscriptions. You can also enter text to filter dashboards by name.
+    1. Select one or more subscriptions. You can also enter text to filter dashboards by name.
 
-1. Select a dashboard from the list of shared dashboards.
+    1. Select a dashboard from the list of shared dashboards.
 
 ## Delete a dashboard