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.
API-Beschreibung
Ruft eine Sammlung von Warnungen im Zusammenhang mit einer bestimmten Benutzer-ID ab.
Begrenzungen
Die Ratenbeschränkungen für diese API sind 100 Aufrufe pro Minute und 1.500 Aufrufe pro Stunde.
Berechtigungen
Beim Abrufen eines Tokens mit Benutzeranmeldeinformationen:
- Der Benutzer muss mindestens über die folgende Rollenberechtigung verfügen: "Daten anzeigen". Weitere Informationen finden Sie unter Erstellen und Verwalten von Rollen.
- Die Antwort umfasst nur Warnungen, die Geräten zugeordnet sind, auf die der Benutzer basierend auf den Gerätegruppeneinstellungen Zugriff hat. Weitere Informationen finden Sie unter Erstellen und Verwalten von Gerätegruppen.
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter Verwenden von Microsoft Defender for Endpoint-APIs.
| Berechtigungstyp | Permission | Anzeigename der Berechtigung |
|---|---|---|
| Application | Alert.Read.All | "Alle Warnungen lesen" |
| Application | Alert.ReadWrite.All | "Alle Warnungen lesen und schreiben" |
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Alert.Read | "Warnungen lesen" |
| Delegiert (Geschäfts-, Schul- oder Unikonto) | Alert.ReadWrite | Warnungen zum Lesen und Schreiben |
HTTP-Anforderung
GET /api/users/{id}/alerts
Die ID ist nicht der vollständige UPN, sondern nur der Benutzername. (Zum Abrufen von Warnungen für user1@contoso.com die Verwendung von /api/users/user1/alerts)
Anforderungsheader
| Name | Typ | Beschreibung |
|---|---|---|
| Authorization | Zeichenfolge | Bearer {token}. Erforderlich. |
Anforderungstext
Empty
Antwort
Wenn erfolgreich und Der Benutzer vorhanden ist – 200 OK. Wenn der Benutzer nicht vorhanden ist: 200 OK mit einem leeren Satz.
Beispiel
Anforderung
Hier sehen Sie ein Beispiel für die Anforderung.
GET https://api.securitycenter.microsoft.com/api/users/user1/alerts