命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示Microsoft Entra ID保护基于各种信号和机器学习评估的Microsoft Entra代理。 此 API 提供对Microsoft Entra租户中所有风险代理的编程访问，@odata.type 指示此代理的确切类型。 支持的类型包括 riskyAgentIdentity、 riskyAgentIdentityBlueprintPrincipal 和 riskyAgentUser。
继承自 entity。
Methods
| 方法 | 返回类型 | Description |
|---|---|---|
| List | riskyAgent 集合 | 获取 riskyAgent 对象及其属性的列表。 |
| Get | riskyAgent | 读取 riskyAgent 对象的属性和关系。 |
| Dismiss | 无 | 消除一个或多个 riskyAgent 对象的风险。 |
| 确认已被盗用 | 无 | 确认一个或多个 riskyAgent 对象已泄露。 |
| 确认安全 | 无 | 确认一个或多个 riskyAgent 对象是否安全。 |
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| agentDisplayName | String | 代理的名称。 支持 $filter（eq、startsWith）。 |
| id | String |
riskyAgentIdentity、riskyAgentIdentityBlueprintPrincipal 或 riskyAgentUser 的对象 ID。 继承自 entity。 支持 $filter（eq、startsWith）。 |
| isDeleted | 布尔值 | 指示是否删除代理。 |
| isEnabled | Boolean | 指示是否启用代理。 |
| isProcessing | 布尔值 | 指示代理的风险状态是否正在后端进行处理。 |
| riskDetail | riskDetail | 代理检测到的风险的详细信息。 支持 $filter（eq）。 |
| riskLastModifiedDateTime | DateTimeOffset | 风险代理上次更新的日期和时间。 DateTimeOffset 表示使用 ISO 8601 格式的日期和时间信息，并且始终处于 UTC 时间。 例如，2014 年 1 月 1 日午夜 UTC 为 2014-01-01T00：00：00Z。 支持 $filter (eq、 le和 ge) 。 |
| riskLevel | riskLevel | 检测到的风险代理的级别。 可能的值包括 low、medium、high、hidden、none、unknownFutureValue。 支持 $filter（eq）。 |
| riskState | riskState | 代理风险的状态。 可能的值包括 none、confirmedSafe、dismissed、atRisk、confirmedCompromised、unknownFutureValue。 支持 $filter（eq）。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.riskyAgent",
"id": "String (identifier)",
"agentDisplayName": "String",
"isDeleted": "Boolean",
"isEnabled": "Boolean",
"isProcessing": "Boolean",
"riskLastModifiedDateTime": "String (timestamp)",
"riskState": "String",
"riskLevel": "String",
"riskDetail": "String"
}