Merge pull request #271907 from gardnerjr/patch-1

Update workbooks-resources.md to include note about resource naming

Author: prmerger-automator[bot]

articles/azure-monitor/visualize/workbooks-resources.md

@@ -13,6 +13,10 @@ Resource parameters allow picking of resources in workbooks. This functionality
 
 Values from resource pickers can come from the workbook context, static list, or Azure Resource Graph queries.
 
+> [!NOTE]
+> The label for each resource in the resource parameter list is based on the resource id.  You cannot replace that name with another value. For clarity, the examples in this document show the label field set to the id, but that value isn't used in the actual parameter.
+
+
 ## Create a resource parameter (workbook resources)
 
 1. Start with an empty workbook in edit mode.
@@ -44,15 +48,13 @@ Values from resource pickers can come from the workbook context, static list, or
 
     ```kusto
     where type == 'microsoft.insights/components'
-    | project value = id, label = name, selected = false, group = resourceGroup
+    | project value = id, label = id, selected = false, group = resourceGroup
     ```
 
 1. Select **Save** to create the parameter.
 
    :::image type="content" source="./media/workbooks-resources/resource-query.png" lightbox="./media/workbooks-resources/resource-query.png" alt-text="Screenshot that shows the creation of a resource parameter by using Azure Resource Graph.":::
 
-> [!NOTE]
-> Azure Resource Graph isn't yet available in all clouds. Ensure that it's supported in your target cloud if you choose this approach.
 
 For more information on Azure Resource Graph, see [What is Azure Resource Graph?](../../governance/resource-graph/overview.md).
 
@@ -70,8 +72,8 @@ For more information on Azure Resource Graph, see [What is Azure Resource Graph?
 
         ```json
         [
-            { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication", "label": "acmeauthentication", "selected":true, "group":"Acme Backend" },
-            { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeweb", "label": "acmeweb", "selected":false, "group":"Acme Frontend" }
+            { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeauthentication", "selected":true, "group":"Acme Backend" },
+            { "value":"/subscriptions/<sub-id>/resourceGroups/<resource-group>/providers/<resource-type>/acmeweb", "selected":false, "group":"Acme Frontend" }
         ]
         ```
 
@@ -102,7 +104,7 @@ This approach can be used to bind resources to other controls like metrics.
 | Parameter | Description | Example |
 | ------------- |:-------------|:-------------|
 | `{Applications}` | The selected resource ID. | _/subscriptions/\<sub-id\>/resourceGroups/\<resource-group\>/providers/\<resource-type\>/acmeauthentication_ |
-| `{Applications:label}` | The label of the selected resource. | `acmefrontend` |
+| `{Applications:label}` | The label of the selected resource. | `acmefrontend` Note: for multi-value resource parameters, this label may be shortened like `acmefrontend (+3 others)` and may not include all labels of all selected values |
 | `{Applications:value}` | The value of the selected resource. | _'/subscriptions/\<sub-id\>/resourceGroups/\<resource-group\>/providers/\<resource-type\>/acmeauthentication'_ |
 | `{Applications:name}` | The name of the selected resource. | `acmefrontend` |
 | `{Applications:resourceGroup}` | The resource group of the selected resource. | `acmegroup` |