unifiedRoleManagementAlertConfiguration resource type
Namespace: microsoft.graph
Important
APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
An abstract type that exposes the tenant-specific configurations of a security alert that can be updated or modified in Privileged Identity Management (PIM) for Microsoft Entra roles.
This abstract type is inherited by the following derived types:
- invalidLicenseAlertConfiguration
- noMfaOnRoleActivationAlertConfiguration
- redundantAssignmentAlertConfiguration
- rolesAssignedOutsidePrivilegedIdentityManagementAlertConfiguration
- sequentialActivationRenewalsAlertConfiguration
- staleSignInAlertConfiguration
- tooManyGlobalAdminsAssignedToTenantAlertConfiguration
Inherits from entity.
For more information about working with security alerts for Microsoft Entra roles using PIM APIs, see Manage security alerts for Microsoft Entra roles using PIM APIs in Microsoft Graph.
Methods
| Method | Return type | Description |
|---|---|---|
| List | unifiedRoleManagementAlertConfiguration collection | Get a list of the unifiedRoleManagementAlertConfiguration objects and their properties. |
| Get | unifiedRoleManagementAlertConfiguration | Read the properties and relationships of an unifiedRoleManagementAlertConfiguration object. |
| Update | unifiedRoleManagementAlertConfiguration | Update the properties of an unifiedRoleManagementAlertConfiguration object. |
Properties
| Property | Type | Description |
|---|---|---|
| alertDefinitionId | String | The identifier of an alert definition. Supports $filter (eq, ne). |
| id | String | The identifier of the alert configuration. Inherited from entity. |
| isEnabled | Boolean | true if the alert is enabled. Setting it to false disables PIM scanning the tenant to identify instances that trigger the alert. |
| scopeId | String | The identifier of the scope to which the alert is related. Only / is supported to represent the tenant scope. Supports $filter (eq, ne). |
| scopeType | String | The type of scope where the alert is created. DirectoryRole is the only currently supported scope type for Microsoft Entra roles. |
Relationships
| Relationship | Type | Description |
|---|---|---|
| alertDefinition | unifiedRoleManagementAlertDefinition | The definition of the alert that contains its description, impact, and measures to mitigate or prevent it. Supports $expand. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.unifiedRoleManagementAlertConfiguration",
"id": "String (identifier)",
"alertDefinitionId": "String",
"scopeType": "String",
"scopeId": "String",
"isEnabled": "Boolean"
}