命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示有风险Microsoft Entra用户。 Microsoft Entra ID保护基于各种信号和机器学习持续评估用户风险。 此 API 为Microsoft Entra租户中的所有风险用户提供编程访问。
有关风险事件的详细信息，请参阅Microsoft Entra ID保护。
注意
- 使用 riskyUsers API 需要Microsoft Entra ID P2 许可证。
- 风险用户数据的可用性受Microsoft Entra数据保留策略的约束。
方法
| 方法 | 返回类型 | Description |
|---|---|---|
| List | riskyUser 集合 | 获取 riskyUser 对象及其属性的列表。 |
| Get | riskyUser | 读取 riskyUser 对象的属性和关系。 |
| 确认已被盗用 | 无 | 确认一个或多个 有风险的用户 对象已泄露。 |
| 确认安全 | 无 | 确认一个或多个 有风险的用户 对象是安全的。 |
| Dismiss | 无 | 消除一个或多个 riskyUser 对象的风险。 |
| 列表历史记录 | riskyUserHistoryItem 集合 | 从历史记录导航属性获取 riskyUserHistoryItems 。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | string | 面临风险的用户的唯一 ID。 |
| isDeleted | 布尔值 | 指示是否删除用户。 可能的值为： true、 false。 |
| isProcessing | 布尔值 | 指示后端是否正在处理用户的风险状态。 |
| riskLastUpdatedDateTime | DateTimeOffset | 风险用户上次更新的日期和时间。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00:00:00Z。 |
| riskLevel | riskLevel | 检测到的风险用户的级别。 可能的值为 low、、medium、high、hiddennone、 unknownFutureValue。 |
| riskState | riskState | 用户风险的状态。 可取值包括：none、confirmedSafe、remediated、dismissed、atRisk、confirmedCompromised、unknownFutureValue。 |
| riskDetail | riskDetail | 检测到的风险的详细信息。 注意：此属性的详细信息仅适用于Microsoft Entra ID P2 客户。 将返回 hidden所有其他客户。 |
| userDisplayName | string | 有风险的用户显示名称。 |
| userPrincipalName | string | 风险用户主体名称。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"id": "string",
"riskLastUpdatedDateTime": "dateTimeOffset",
"isProcessing": "Boolean",
"isDeleted": "Boolean",
"riskDetail": "string",
"riskLevel": "string",
"riskState": "string",
"userDisplayName": "string",
"userPrincipalName": "string"
}