Edits

- Added healthMonitoring r/ship to reportRoot (starting point)
- Append "scenario monitoring" because Microsoft Entra Health includes SLA attainment.
- Move alert configuration READ RBAC to include file. Edit WRITE RBACs.
- Formatting
- Fix placement of "openType": true in resource docs.
- Fix directoryObjectImpactSummary derived types' descriptions.
- Updated overview

Author: FaithOmbongi

api-reference/beta/api/healthmonitoring-alert-get.md

@@ -26,14 +26,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 -->
 [!INCLUDE [permissions-table](../includes/permissions/healthmonitoring-alert-get-permissions.md)]
 
-In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to view alerts.
-
-+ Global Reader
-+ Security Administrator
-+ Security Operator
-+ Security Reader
-+ Helpdesk Administrator
-+ Reports Reader
+[!INCLUDE [rbac-healthmonitoring-alert-apis-read](../includes/rbac-for-apis/rbac-healthmonitoring-alert-apis-read.md)]
 
 ## HTTP request
 

api-reference/beta/api/healthmonitoring-alertconfiguration-get.md

@@ -26,14 +26,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 -->
 [!INCLUDE [permissions-table](../includes/permissions/healthmonitoring-alertconfiguration-get-permissions.md)]
 
-In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to view alert configurations.
-
-+ Global Reader
-+ Security Administrator
-+ Security Operator
-+ Security Reader
-+ Helpdesk Administrator
-+ Reports Reader
+[!INCLUDE [rbac-healthmonitoring-alertconfiguration-apis-read](../includes/rbac-for-apis/rbac-healthmonitoring-alertconfiguration-apis-read.md)]
 
 ## HTTP request
 
@@ -47,7 +40,7 @@ GET /reports/healthMonitoring/alertConfigurations/{alertConfigurationId}
 
 ## Optional query parameters
 
-This method supports the $select [OData query parameters](/graph/query-parameters) to help customize the response.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
 
 ## Request headers
 

api-reference/beta/api/healthmonitoring-alertconfiguration-update.md

@@ -15,7 +15,7 @@ Namespace: microsoft.graph.healthMonitoring
 
 Update the properties of a [microsoft.graph.healthMonitoring.alertConfiguration](../resources/healthmonitoring-alertconfiguration.md) object. You can use alertConfiguration settings to specify the distribution groups where alert notifications are to be sent.
 
-NOTE: This API doesn't currently support group validation.
+This API doesn't currently support group validation.
 
 ## Permissions
 
@@ -66,7 +66,7 @@ If successful, this method returns a `200 OK` response code and an updated [micr
 
 ### Request
 
-The following example shows a request.
+The following example shows a request. It currently supports only 1 group to receive email notification for an alert type.
 <!-- {
   "blockType": "request",
   "name": "update_alertconfiguration"
@@ -85,8 +85,6 @@ Content-Type: application/json
   ]
 }
 ```
-> Note: It currently supports only 1 group to receive email notification for an alert type.
-
 
 ### Response
 

api-reference/beta/api/healthmonitoring-healthmonitoringroot-list-alertconfigurations.md

@@ -26,14 +26,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 -->
 [!INCLUDE [permissions-table](../includes/permissions/healthmonitoring-healthmonitoringroot-list-alertconfigurations-permissions.md)]
 
-In addition to the delegated permissions, the signed-in user needs to belong to a [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allows them to view alert configurations. The following least privileged roles are supported for this operation.
-
-+ Global Reader
-+ Security Administrator
-+ Security Operator
-+ Security Reader
-+ Helpdesk Administrator
-+ Reports Reader
+[!INCLUDE [rbac-healthmonitoring-alertconfiguration-apis-read](../includes/rbac-for-apis/rbac-healthmonitoring-alertconfiguration-apis-read.md)]
 
 ## HTTP request
 

api-reference/beta/api/healthmonitoring-healthmonitoringroot-list-alerts.md

@@ -26,14 +26,7 @@ Choose the permission or permissions marked as least privileged for this API. Us
 -->
 [!INCLUDE [permissions-table](../includes/permissions/healthmonitoring-healthmonitoringroot-list-alerts-permissions.md)]
 
-In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to view alerts.
-
-+ Global Reader
-+ Security Administrator
-+ Security Operator
-+ Security Reader
-+ Helpdesk Administrator
-+ Reports Reader
+[!INCLUDE [rbac-healthmonitoring-alert-apis-read](../includes/rbac-for-apis/rbac-healthmonitoring-alert-apis-read.md)]
 
 ## HTTP request
 

api-reference/beta/includes/rbac-for-apis/rbac-healthmonitoring-alert-apis-read.md

@@ -0,0 +1,13 @@
+---
+author: huatang92
+ms.topic: include
+---
+
+In addition to the delegated permissions, the signed-in user needs to belong to a [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allows them to view alerts. The following least privileged roles are supported for this operation.
+
++ Global Reader
++ Security Administrator
++ Security Operator
++ Security Reader
++ Helpdesk Administrator
++ Reports Reader

api-reference/beta/includes/rbac-for-apis/rbac-healthmonitoring-alert-apis-write.md

@@ -3,7 +3,7 @@ author: huatang92
 ms.topic: include
 ---
 
-In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to update alerts.
+In addition to the delegated permissions, the signed-in user needs to belong to a [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allows them to update alerts. The following least privileged roles are supported for this operation.
 
 + Security Administrator
 + Security Operator

api-reference/beta/includes/rbac-for-apis/rbac-healthmonitoring-alertconfiguration-apis-read.md

@@ -0,0 +1,13 @@
+---
+author: huatang92
+ms.topic: include
+---
+
+In addition to the delegated permissions, the signed-in user needs to belong to a [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allows them to view alert configurations. The following least privileged roles are supported for this operation.
+
++ Global Reader
++ Security Administrator
++ Security Operator
++ Security Reader
++ Helpdesk Administrator
++ Reports Reader

api-reference/beta/includes/rbac-for-apis/rbac-healthmonitoring-alertconfiguration-apis-write.md

@@ -3,7 +3,7 @@ author: huatang92
 ms.topic: include
 ---
 
-In addition to the delegated permissions, the signed-in user needs to belong to at least one of the following [Microsoft Entra roles](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allow them to update alert configurations.
+In addition to the delegated permissions, the signed-in user needs to belong to a [Microsoft Entra role](/entra/identity/role-based-access-control/permissions-reference?toc=%2Fgraph%2Ftoc.json) that allows them to update alert configurations. The following least privileged roles are supported for this operation.
 
 + Security Administrator
 + Helpdesk Administrator

api-reference/beta/resources/azureadauthentication.md

@@ -1,6 +1,6 @@
 ---
 title: "azureADAuthentication resource type"
-description: "Represents the Microsoft Entra service level agreement (SLA) attainment for each month for a Microsoft Entra tenant."
+description: "Represents the Microsoft Entra Health service level agreement (SLA) attainment for each month for a Microsoft Entra tenant."
 author: "SarahBar"
 ms.localizationpriority: medium
 ms.subservice: "entra-monitoring-health"
@@ -13,7 +13,7 @@ Namespace: microsoft.graph
 
 [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
 
-Represents the Microsoft Entra service level agreement (SLA) attainment for each month for a Microsoft Entra tenant. For more information, see [What is Microsoft Entra Health?](/entra/identity/monitoring-health/concept-microsoft-entra-health)
+Represents the Microsoft Entra Health service level agreement (SLA) attainment for each month for a Microsoft Entra tenant. For more information, see [What is Microsoft Entra Health?](/entra/identity/monitoring-health/concept-microsoft-entra-health)
 
 Inherits from [entity](../resources/entity.md).