Merge pull request #273085 from davidsmatlak/ds-update-arg-portal-quickstart-20240423

Edits ARG portal quickstart

Author: v-dirichards

articles/governance/resource-graph/first-query-portal.md

@@ -1,26 +1,30 @@
 ---
-title: 'Quickstart: Run first Azure Resource Graph query in portal'
-description: In this quickstart, you run your first Azure Resource Graph Explorer query using Azure portal.
-ms.date: 03/29/2024
+title: 'Quickstart: Run Resource Graph query using Azure portal'
+description: In this quickstart, you run an Azure Resource Graph query in Azure portal using Azure Resource Graph Explorer.
+ms.date: 04/23/2024
 ms.topic: quickstart
 ---
 
-# Quickstart: Run your first Resource Graph query using Azure Resource Graph Explorer
+# Quickstart: Run Resource Graph query using Azure portal
 
-The power of Azure Resource Graph is available directly in the Azure portal through Azure Resource Graph Explorer. Resource Graph Explorer allows you to query information about the Azure Resource Manager resource types and properties. Resource Graph Explorer also provides an interface for working with multiple queries, evaluating the results, and even converting the results of some queries into a chart that can be pinned to an Azure dashboard.
+This quickstart describes how to run an Azure Resource Graph query in the Azure portal using Azure Resource Graph Explorer. Resource Graph Explorer allows you to query information about the Azure Resource Manager resource types and properties. Resource Graph Explorer also provides an interface for working with multiple queries, evaluating the results, and even converting the results of some queries into a chart that can be pinned to an Azure dashboard.
 
 ## Prerequisites
 
 If you don't have an Azure account, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-## Run your first Resource Graph query
+## Run a query
 
-Run your first query from the Azure portal using Azure Resource Graph Explorer.
+Run a query from the Azure portal using Azure Resource Graph Explorer.
 
 1. Sign in to the [Azure portal](https://portal.azure.com).
 1. Search for _resource graph_ and select **Resource Graph Explorer**.
 
-   :::image type="content" source="./media/first-query-portal/search-resource-graph.png" alt-text="Screenshot of the Azure portal to search for resource graph.":::
+   :::image type="content" source="./media/first-query-portal/search-resource-graph.png" alt-text="Screenshot of the Azure portal to search for resource graph." lightbox="./media/first-query-portal/search-resource-graph.png":::
+
+1. If you need to change the scope, select **Directory**. Then select the directory, management group, or subscription for the resources you want to query.
+
+   :::image type="content" source="./media/first-query-portal/query-scope.png" alt-text="Screenshot of the Azure Resource Graph Explorer to change the scope for directory, management group, or subscription." lightbox="./media/first-query-portal/query-scope.png":::
 
 1. In the **Query 1** portion of the window, copy and paste the following query. Then select **Run query**.
 
@@ -30,13 +34,13 @@ Run your first query from the Azure portal using Azure Resource Graph Explorer.
    | limit 5
    ```
 
-   :::image type="content" source="./media/first-query-portal/run-query.png" alt-text="Screenshot of Azure Resource Graph Explorer that highlights run query, results, and messages.":::
+   :::image type="content" source="./media/first-query-portal/run-query.png" alt-text="Screenshot of Azure Resource Graph Explorer that highlights run query, results, and messages." lightbox="./media/first-query-portal/run-query.png":::
 
-   This query example doesn't provide a sort modifier like `order by`. If you run this query multiple times, it's likely to yield a different set of resources per request.
+   This query example doesn't provide a sort modifier like `order by`. If you run the query multiple times, it might yield a different set of resources for each request.
 
 1. Review the query response in the **Results** tab and select the **Messages** tab to see details about the query, including the count of results and duration of the query. Errors, if any, are displayed in **Messages**.
 
-1. Update the query to `order by` the **name** property. Then, select **Run query**
+1. Update the query to `order by` the `name` property. Then, select **Run query**
 
    ```kusto
    resources
@@ -45,9 +49,9 @@ Run your first query from the Azure portal using Azure Resource Graph Explorer.
    | order by name asc
    ```
 
-   Like the first query, running this query multiple times is likely to yield a different set of resources per request. The order of the query commands is important. In this example, the `order by` comes after the `limit`. This command order first limits the query results and then orders them.
+   Like the previous query, running this query multiple times might yield a different set of resources for each request. The order of the query commands is important. In this example, the `order by` comes after the `limit`. The query limits the results to five resources and then orders those results by name.
 
-1. Update the query to `order by` the **name** property and then `limit` to the top five results. Then, select **Run query**.
+1. Update the query to `order by` the `name` property and then `limit` to the top five results. Then, select **Run query**.
 
    ```kusto
    resources
@@ -56,7 +60,7 @@ Run your first query from the Azure portal using Azure Resource Graph Explorer.
    | limit 5
    ```
 
-   When the final query is run several times, and with no changes in your environment, the results are consistent and ordered by the **name** property, but still limited to the top five results.
+   If this query is run several times with no changes to your environment, the results are consistent and ordered by the `name` property, but still limited to five results. The query orders the results by name and then limits the output to five resources.
 
 ### Schema browser
 
@@ -72,19 +76,21 @@ authorizationresources
 | where properties['roleName'] == "INSERT_VALUE_HERE"
 ```
 
-:::image type="content" source="./media/first-query-portal/schema-browser.png" alt-text="Screenshot of Azure Resource Graph Explorer schema browser that highlights resource type and properties.":::
+:::image type="content" source="./media/first-query-portal/schema-browser.png" alt-text="Screenshot of Azure Resource Graph Explorer schema browser that highlights resource type and properties." lightbox="./media/first-query-portal/schema-browser.png":::
 
 ## Download query results as a CSV file
 
 To download comma-separated values (CSV) results from the Azure portal, browse to the Azure Resource Graph Explorer and run a query. On the toolbar, select **Download as CSV** as shown in the following screenshot:
 
-:::image type="content" source="./media/first-query-portal/download-csv.png" alt-text="Screenshot of Azure Resource Graph Explorer with Download as CSV highlighted.":::
+:::image type="content" source="./media/first-query-portal/download-csv.png" alt-text="Screenshot of Azure Resource Graph Explorer with Download as CSV highlighted." lightbox="./media/first-query-portal/download-csv.png":::
 
 When you use the **Download as CSV** export functionality of Azure Resource Graph Explorer, the result set is limited to 55,000 records. This limitation is a platform limit that can't be overridden by filing an Azure support ticket.
 
-## Create a chart from the Resource Graph query
+## Create a chart from query results
+
+You can create charts from queries that output a count for the number of resources. Queries that output lists can't be made into a chart. If you try to create a chart from a list, a message like _the result set isn't compatible with a donut chart visualization_ is displayed in the **Charts** tab.
 
-After running the previous query, if you select the **Charts** tab, you get a message that "the result set isn't compatible with a pie chart visualization." Queries that list results can't be made into a chart, but queries that provide counts of resources can.
+To create a chart from query results, do the following steps:
 
 1. In the **Query 1** portion of the window, enter the following query and select **Run query**.
 
@@ -98,18 +104,19 @@ After running the previous query, if you select the **Charts** tab, you get a me
 
 1. Select the **Charts** tab. Change the type from _Select chart type..._ to either _Bar chart_ or _Donut chart_.
 
-   :::image type="content" source="./media/first-query-portal/query-chart.png" alt-text="Screenshot of Azure Resource Graph Explorer with charts drop-down menu highlighted.":::
+   :::image type="content" source="./media/first-query-portal/query-chart.png" alt-text="Screenshot of Azure Resource Graph Explorer with charts drop-down menu highlighted." lightbox="./media/first-query-portal/query-chart.png":::
 
-## Pin the query visualization to a dashboard
+## Pin query visualization to dashboard
 
 When you have results from a query that can be visualized, that data visualization can be pinned to your Azure portal dashboard. After running the previous query, follow these steps:
 
-1. Select **Save** and provide the name _VM by OS type_. Then select **Save** at the bottom of the right pane.
+1. Select **Save** and use the name _Virtual machine by OS type_ and type as _Private queries_. Then select **Save** at the bottom of the right pane.
 1. Select **Run query** to rerun the query you saved.
 1. On the **Charts** tab, select a data visualization. Then select **Pin to dashboard**.
 1. From **Pin to Dashboard** select the existing dashboard where you want the chart to appear.
+1. Select **Dashboard** from the _hamburger menu_ (three horizontal lines) on the top, left side of any portal page.
 
-The query is now available on your dashboard with the title **VM by OS type**. If the query wasn't saved before it was pinned, the name is _Query 1_ instead.
+The query is now available on your dashboard with the title **Virtual machine by OS type**. If the query wasn't saved before it was pinned, the name is _Query 1_ instead.
 
 The query and resulting data visualization run and update each time the dashboard loads, providing real time and dynamic insights to your Azure environment directly in your workflow.
 
@@ -122,12 +129,20 @@ For more information about working with dashboards, see [Create a dashboard in t
 If you want to remove the sample Resource Graph dashboards from your Azure portal environment, do the following steps:
 
 1. Select **Dashboard** from the _hamburger menu_ (three horizontal lines) on the top, left side of any portal page.
-1. On your dashboard, find the **VM by OS type** chart and select the ellipsis (`...`) to display the menu.
+1. On your dashboard, find the **Virtual machine by OS type** chart and select the ellipsis (`...`) to display the menu.
 1. Select **Remove from dashboard** select **Save** to confirm.
 
+If you want to delete saved queries, like _Virtual machine by OS type_, do the following steps:
+
+1. Go to Azure Resource Graph Explorer.
+1. Select **Open a query**.
+1. Select **Type** _Private queries_.
+1. From **Query name** select the rubbish bin icon to **Delete this query**.
+1. Select **Yes** to confirm the deletion.
+
 ## Next steps
 
-In this quickstart, you used Azure Resource Graph Explorer to run your first query and looked at dashboard examples powered by Resource Graph. To learn more about the Resource Graph language, continue to the query language details page.
+In this quickstart, you used Azure Resource Graph Explorer to run a query and reviewed how to use charts and dashboards. To learn more, go to the query language details article.
 
 > [!div class="nextstepaction"]
 > [Understanding the Azure Resource Graph query language](./concepts/query-language.md)