Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt die Microsoft Entra Agents dar, die gefährdet sind, wie sie von Microsoft Entra ID Protection basierend auf verschiedenen Signalen und maschinellem Lernen bewertet werden. Diese API bietet programmgesteuerten Zugriff auf alle gefährdeten Agents in Ihrem Microsoft Entra Mandanten. Die @odata.type gibt den genauen Typ dieses Agents an. Die unterstützten Typen sind riskyAgentIdentity, riskyAgentIdentityBlueprintPrincipal und riskyAgentUser.
Erbt von entity.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| List | riskyAgent-Sammlung | Rufen Sie eine Liste der riskyAgent-Objekte und deren Eigenschaften ab. |
| Get | riskyAgent | Lesen der Eigenschaften und Beziehungen des riskyAgent-Objekts . |
| Dismiss | Keine | Schließen Sie das Risiko eines oder mehrerer riskyAgent-Objekte. |
| Gefährdung bestätigen | Keine | Bestätigen Sie, dass ein oder mehrere riskanteAgent-Objekte kompromittiert sind. |
| Als sicher bestätigen | Keine | Bestätigen Sie ein oder mehrere riskyAgent-Objekte als sicher. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| agentDisplayName | Zeichenfolge | Name des Agents. Unterstützt $filter (eq, startsWith). |
| id | Zeichenfolge | Die Objekt-ID von riskyAgentIdentity, riskyAgentIdentityBlueprintPrincipal oder riskyAgentUser. Geerbt von entity. Unterstützt $filter (eq, startsWith). |
| isDeleted | Boolean | Gibt an, ob der Agent gelöscht wird. |
| isEnabled | Boolescher Wert | Gibt an, ob der Agent aktiviert ist. |
| isProcessing | Boolean | Gibt an, ob der risikobehaftete Zustand eines Agents im Back-End verarbeitet wird. |
| riskDetail | riskDetail | Details zum erkannten Risiko des Agents. Unterstützt $filter (eq). |
| riskLastModifiedDateTime | DateTimeOffset | Das Datum und die Uhrzeit der letzten Aktualisierung des Risiko-Agents. Der DateTimeOffset-Typ stellt die Datums- und Uhrzeitinformationen mithilfe des ISO 8601-Formats dar und wird immer in UTC-Zeit angegeben. Mitternacht UTC am 1. Januar 2014 lautet beispielsweise 2014-01-01T00:00:00Z. Unterstützt $filter (eq, leund ge). |
| riskLevel | riskLevel | Ebene des erkannten risikobehafteten Agents. Mögliche Werte sind: low, medium, high, hidden, none, unknownFutureValue. Unterstützt $filter (eq). |
| riskState | riskState | Status des Risikos des Agenten. Mögliche Werte sind: none, confirmedSafe, dismissed, atRisk, confirmedCompromised, unknownFutureValue. Unterstützt $filter (eq). |
Beziehungen
Keine.
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
{
"@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"
}