HealthMonitoringAlert.Read.All
Allows the app to read all scenario health monitoring alerts, without a signed-in user.
Permission Details
Read all scenario health monitoring alert
Allows the app to read all scenario health monitoring alerts, without a signed-in user.
5183ed5d-b7f8-4e9a-915e-dafb46b9cb62
Read all scenario health monitoring alerts
Allows the app to read all scenario health monitoring alerts
74b4ff32-4917-4536-a66d-38a4861e6220
Properties
Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Property | Type | Description |
|---|---|---|
alertType |
healthMonitoring.alertType |
Indicates which type of scenario an alert is associated with. The possible values are: unknown, mfaSignInFailure, managedDeviceSignInFailure, compliantDeviceSignInFailure, unknownFutureValue, conditionalAccessBlockedSignIn, samlSignInFailure. Use the Prefer: include-unknown-enum-members request header to get the following value or values in this evolvable enum: conditionalAccessBlockedSignIn, samlSignInFailure. Supports $filter (eq). |
category |
healthMonitoring.category |
The classification that groups the scenario. The possible values are: unknown, authentication, unknownFutureValue. |
createdDateTime |
DateTimeOffset |
The time when Microsoft Entra Health monitoring generated the alert. Supports $orderby. |
documentation |
healthMonitoring.documentation |
A key-value pair that contains the name of and link to the documentation to aid in investigation of the alert. |
enrichment |
healthMonitoring.enrichment |
Investigative information on the alert. This information typically includes counts of impacted objects, which include directory objects such as users, groups, and devices, and a pointer to supporting data. |
id |
String |
The unique GUID identifier of this alert in the associated tenant. Inherited from microsoft.graph.entity. |
scenario |
healthMonitoring.scenario |
The area being monitored on the system that is emitting the source signals. The possible values are: unknown, mfa, devices, unknownFutureValue, conditionalAccess, saml. Use the Prefer: include-unknown-enum-members request header to get the following value or values in this evolvable enum: conditionalAccess, saml. |
signals |
healthMonitoring.signals |
The collection of signals that were used in the generation of the alert. These signals are sourced from serviceActivity APIs and are added to the alert as key-value pairs. |
state |
healthMonitoring.alertState |
The current lifecycle state of the alert. The possible values are: active, resolved, unknownFutureValue. |
JSON Representation
JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
{
"@odata.type": "#microsoft.graph.healthMonitoring.alert",
"id": "String (identifier)",
"alertType": "String",
"scenario": "String",
"category": "String",
"createdDateTime": "String (timestamp)",
"state": "String",
"enrichment": {
"@odata.type": "microsoft.graph.healthMonitoring.enrichment"
},
"signals": {
"@odata.type": "microsoft.graph.healthMonitoring.signals"
},
"documentation": {
"@odata.type": "microsoft.graph.healthMonitoring.documentation"
}
}
Relationships
Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Relationship | Type | Description |
|---|---|---|
alertType |
healthMonitoring.alertType |
Related alertType data exposed by this resource. |
category |
healthMonitoring.category |
Related category data exposed by this resource. |
scenario |
healthMonitoring.scenario |
Related scenario data exposed by this resource. |
state |
healthMonitoring.alertState |
Related state data exposed by this resource. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
No API methods available for this version.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
| Methods |
|---|
GET
/reports/healthMonitoring/alerts
|
GET
/reports/healthMonitoring/alerts/{alertId}
|
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsMicrosoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
| Commands |
|---|
Get-MgBetaReportHealthMonitoringAlert
/reports/healthMonitoring/alerts
List alerts
|
Get-MgBetaReportHealthMonitoringAlert
/reports/healthMonitoring/alerts/{alertId}
Get alert
|
Code Examples
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Reports.HealthMonitoring.Alerts["{alert-id}"].GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
let alert = await client.api('/reports/healthMonitoring/alerts/{id}')
.version('beta')
.get();
Import-Module Microsoft.Graph.Beta.Reports
Get-MgBetaReportHealthMonitoringAlert -AlertId $alertId
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.reports.health_monitoring.alerts.by_alert_id('alert-id').get()
App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for HealthMonitoringAlert.Read.All
Grant Admin Consent
Application permissions always require admin consent.