Merge pull request #258023 from spelluru/patch-18

Update event-schema-resources.md

Author: Jill Grant

articles/event-grid/event-schema-health-resources.md

@@ -5,7 +5,7 @@ ms.topic: conceptual
 ms.date: 09/26/2023
 ---
 
-# Azure Resource Notifications - Health Resources events in Azure Event Grid
+# Azure Resource Notifications - Health Resources events in Azure Event Grid (Preview)
 HealthResources system topic provides accurate, reliable, and comprehensive health information, enabling deeper understanding of the diverse service issues impacting your Azure resources namely, single instance virtual machines (VMs), Virtual Machine Scale Set VMS, and Virtual Machine Scale Sets. Health Resources offers two event types for consumption: `AvailabilityStatusChanged` and `ResourceAnnotated`.
 
 This article provides the properties and the schema for Azure Resource Notifications Health Resources events. For an introduction to event schemas in general, see [Azure Event Grid event schema](event-schema.md). In addition, you can find samples of generated events and a link to a related article on how to create system topic for this topic type. 
@@ -336,8 +336,7 @@ The following example shows the schema of a key-value modified event:
 
 ---
 
-## Contact us
-If you have any questions or feedback on this feature, don't hesitate to reach us at [[email protected]](mailto:[email protected]). 
+[!INCLUDE [contact-resource-notifications](./includes/contact-resource-notifications.md)]
 
 ## Next steps
 See [Subscribe to Azure Resource Notifications - Health Resources events](subscribe-to-resource-notifications-health-resources-events.md).

articles/event-grid/event-schema-resource-notifications.md

@@ -28,6 +28,7 @@ In addition to these permissions, you need to grant the following permissions to
 | Topic Type | Permission |
 | ---------- | ---------- | 
 | HealthResources | `Microsoft.ResourceNotifications/systemTopics/subscribeToHealthResources/action` |
+| Azure Resource Management | `Microsoft.ResourceNotifications/systemTopics/subscribeToResources/action` |
 
 To enhance customer experience, a built-in role definition that encompasses all the requisite permissions for receiving data through any ARN system topic is available. This role includes permissions mandated by Event Grid for system topic and event subscription creation. This built-in role definition is regularly updated to incorporate more topic types as they become accessible through our service. **As a result, users assigned this built-in role automatically gains access to all future ARN topic types**. You can choose to either utilize the provided built-in role definition or craft your own custom role definitions to enforce access control.
 
@@ -64,4 +65,7 @@ If you have any questions or feedback on this feature, don't hesitate to reach u
 
 
 ## Next steps
-See [Azure Resource Notifications - Health Resources events in Azure Event Grid](event-schema-health-resources.md).
+See the following articles:
+
+- [Azure Resource Notifications - Health Resources events in Azure Event Grid](event-schema-health-resources.md).
+- [Azure Resource Notifications - Azure Resource Manager events in Azure Event Grid](event-schema-resources.md).

articles/event-grid/event-schema-resources.md

@@ -5,7 +5,7 @@ ms.topic: conceptual
 ms.date: 10/06/2023
 ---
 
-# Azure Resource Notifications - Resources events in Azure Event Grid
+# Azure Resource Notifications - Azure Resource Manager events in Azure Event Grid (Preview)
 The Azure Resource Management system topic provides insights into the life cycle of various Azure resources.
 
 The Event Grid system topics for Azure subscriptions and Azure resource groups provide resource life cycle events using a broader range of event types including action, write, and delete events for scenarios involving success, failure, and cancellation. However, it's worth noting that they don't include the resource payload. For details about these events, see [Event Grid system topic for Azure subscriptions](event-schema-subscriptions.md) and [Event Grid system topic for Azure resource groups](event-schema-resource-groups.md). 
@@ -442,8 +442,7 @@ This section shows the `Deleted` event generated when an Azure Storage account i
 
 ---
 
-## Contact us
-If you have any questions or feedback on this feature, don't hesitate to reach us at [[email protected]](mailto:[email protected]). 
+[!INCLUDE [contact-resource-notifications](./includes/contact-resource-notifications.md)]
 
 ## Next steps
 See [Subscribe to Azure Resource Notifications - Resources events](subscribe-to-resource-notifications-resources-events.md).

articles/event-grid/includes/contact-resource-notifications.md

@@ -0,0 +1,35 @@
+---
+ title: include file
+ description: include file
+ services: event-grid
+ author: spelluru
+ ms.service: event-grid
+ ms.topic: include
+ ms.date: 11/07/2023
+ ms.author: spelluru
+ ms.custom: include file
+---
+
+## Contact us
+If you have any questions or feedback on this feature, don't hesitate to reach us at [[email protected]](mailto:[email protected]). 
+
+To better assist you with specific feedback about a certain event, provide the following information: 
+ 
+### For missing events:
+
+- System topic type name
+- Approximate timestamp in UTC when the operation was executed
+- Base resource ID for which the notification was generated
+- Navigate to your resource in Azure portal and select JSON view at the far right corner. Resource ID is the first field on the JSON view page.
+- Expected event type
+- Operation executed (for example, VM  started or stopped, Storage account created etc.)
+- Description of issue encountered (for example, VM started and no Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged event generated)
+- If possible, provide the correlation ID of operation executed 
+
+### For event that was delayed or has unexpected content
+
+- System topic type name
+- Entire contents of the notification excluding data.resourceInfo.properties
+- Description of issue encountered and impacted field values
+
+Ensure that you aren't providing any end user identifiable information while you're sharing this data. 

articles/event-grid/subscribe-to-resource-notifications-health-resources-events.md

@@ -6,7 +6,7 @@ ms.custom: devx-track-azurecli, devx-track-azurepowershell
 ms.date: 09/08/2023
 ---
 
-# Subscribe to events raised by Azure Resource Notifications - Health Resources system topic
+# Subscribe to events raised by Azure Resource Notifications - Health Resources system topic (Preview)
 This article explains the steps needed to subscribe to events published by Azure Resource Notifications - Health Resources. For detailed information about these events, see [Azure Resource Notifications - Health Resources events](event-schema-health-resources.md).
 
 ## Create Health Resources system topic
@@ -243,8 +243,7 @@ Value = Microsoft.Compute/virtualMachines
 
 ---
 
-## Contact us
-If you have any questions or feedback on this feature, don't hesitate to reach us at [[email protected]](mailto:[email protected]). 
+[!INCLUDE [contact-resource-notifications](./includes/contact-resource-notifications.md)]
 
 ## Next steps
 For detailed information about these events, see [Azure Resource Notifications - Health Resources events](event-schema-health-resources.md).

articles/event-grid/subscribe-to-resource-notifications-resources-events.md

@@ -5,7 +5,7 @@ ms.topic: how-to
 ms.date: 10/08/2023
 ---
 
-# Subscribe to events raised by Azure Resource Notifications - Resources system topic
+# Subscribe to Azure Resource Manager events - Resources system topic (Preview)
 This article explains the steps needed to subscribe to events published by Azure Resource Notifications - Resources. For detailed information about these events, see [Azure Resource Notifications - Resources events](event-schema-resources.md).
 
 ## Create Resources system topic
@@ -294,29 +294,7 @@ Value = "virtualMachines"
 
 ---
 
-## Contact us
-If you have any questions or feedback on this feature, don't hesitate to reach us at [[email protected]](mailto:[email protected]). 
-
-To better assist you with specific feedback about a certain event, provide the following information: 
- 
-### For missing events:
-
-- System topic type name
-- Approximate timestamp in UTC when the operation was executed
-- Base resource ID for which the notification was generated
-- Navigate to your resource in Azure portal and select JSON view at the far right corner. Resource ID is the first field on the JSON view page.
-- Expected event type
-- Operation executed (for example, VM  started or stopped, Storage account created etc.)
-- Description of issue encountered (for example, VM started and no Microsoft.ResourceNotifications.HealthResources.AvailabilityStatusChanged event generated)
-- If possible, provide the correlation ID of operation executed 
-
-### For event that was delayed or has unexpected content
-
-- System topic type name
-- Entire contents of the notification excluding data.resourceInfo.properties
-- Description of issue encountered and impacted field values
-
-Ensure that you aren't providing any end user identifiable information while you're sharing this data. 
+[!INCLUDE [contact-resource-notifications](./includes/contact-resource-notifications.md)]
 
 ## Next steps
 For detailed information about these events, see [Azure Resource Notifications - Resources events](event-schema-resources.md).

articles/event-grid/toc.yml

@@ -347,7 +347,7 @@ items:
               href: event-schema-resource-notifications.md
             - name: Health Resources
               href: event-schema-health-resources.md
-            - name: Resources
+            - name: Azure Resource Management
               href: event-schema-resources.md
           - name: Azure Service Bus
             href: event-schema-service-bus.md
@@ -597,4 +597,4 @@ items:
       - name: Pricing Calculator
         href: https://azure.microsoft.com/pricing/calculator/
       - name: Stack Overflow
-        href: https://stackoverflow.com/questions/tagged/azure-eventgrid
+        href: https://stackoverflow.com/questions/tagged/azure-eventgrid