unifiedRoleManagementAlert 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示 Privileged Identity Management (PIM) 中Microsoft Entra 角色的安全警报的详细信息。 警报信息包括租户中相关的警报 定义、 配置和 事件 收集。

PIM 中针对Microsoft Entra 角色的每个安全警报都是 获取Microsoft Entra 角色的安全警报中所述的几种类型之一。 可以使用事件关系 列出 警报的实际 事件 的详细信息。 警报及其相关事件始终属于同一类型。 例如，有关租户中全局管理员过多的警报与 类型 tooManyGlobalAdminsAssignedToTenantAlertIncident 的事件相关。

继承自 entity。

有关使用 PIM API 处理Microsoft Entra 角色的安全警报的详细信息，请参阅 在 Microsoft Graph 中使用 PIM API 管理 Microsoft Entra 角色的安全警报。

方法

方法	返回类型	Description
List	unifiedRoleManagementAlert 集合	获取 unifiedRoleManagementAlert 对象及其属性的列表。
Get	unifiedRoleManagementAlert	读取 unifiedRoleManagementAlert 对象的属性和关系。
更新	unifiedRoleManagementAlert	更新 unifiedRoleManagementAlert 对象的属性。
Refresh	None	针对 Microsoft Entra 角色的所有警报或单个警报刷新特权标识管理 (PIM) 的事件。
获取长时间运行的操作	None	如果刷新操作返回了 Location 对象，则获取该操作的状态。

属性

属性	类型	说明
alertDefinitionId	String	警报定义的标识符。 支持 $filter（eq、ne）。
id	String	警报配置的标识符。 继承自 entity。
incidentCount	Int32	租户中触发的与警报相关的事件数。 只能是正整数。
isActive	布尔值	false 默认情况下。 true 如果警报处于活动状态，则为 。
lastModifiedDateTime	DateTimeOffset	更新警报配置或生成新事件的日期时间。
lastScannedDateTime	DateTimeOffset	上次扫描租户以查找触发此警报的事件的日期时间。
scopeId	String	警报相关范围的标识符。 / 是租户唯一受支持的租户。 支持 $filter（eq、ne）。
scopeType	String	创建警报的范围类型。 DirectoryRole 是当前唯一受支持的Microsoft Entra 角色的范围类型。

关系

关系	类型	说明
alertConfiguration	unifiedRoleManagementAlertConfiguration	PIM 中针对Microsoft Entra 角色的警报配置。 警报配置是预定义的，无法创建或删除，但可以修改某些配置。 支持 $filterisEnabled 属性和 $expand。
alertDefinition	unifiedRoleManagementAlertDefinition	包含用于缓解或防止在租户中触发安全警报的说明、影响和措施。 支持 $expand。
alertIncidents	unifiedRoleManagementAlertIncident 集合	表示已在 Privileged Identity Management (PIM) 中为租户中的 Microsoft Entra 角色触发的此类警报的事件。 支持 $expand。

以下 JSON 表示形式显示了资源类型。 下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.unifiedRoleManagementAlert",
  "id": "String (identifier)",
  "alertDefinitionId": "String",
  "scopeId": "String",
  "scopeType": "String",
  "incidentCount": "Integer",
  "isActive": "Boolean",
  "lastModifiedDateTime": "String (timestamp)",
  "lastScannedDateTime": "String (timestamp)"
}

相关内容

• 在 Microsoft Graph 中使用 PIM API 管理 Microsoft Entra 角色的安全警报。