Felhasználóval kapcsolatos riasztási API lekérése

API-leírás

Lekéri egy adott felhasználói azonosítóhoz kapcsolódó riasztások gyűjteményét.

Korlátozások

Az API sebességkorlátozásai percenként 100 hívás, óránként 1500 hívás.

Engedélyek

Jogkivonat felhasználói hitelesítő adatokkal történő beszerzésekor:

• A felhasználónak legalább a következő szerepköri engedéllyel kell rendelkeznie: "Adatok megtekintése". További információ: Szerepkörök létrehozása és kezelése.
• A válasz csak az eszközökhöz társított riasztásokat tartalmazza, amelyekhez a felhasználó az eszközcsoport beállításai alapján rendelkezik hozzáféréssel. További információ: Eszközcsoportok létrehozása és kezelése.

Az API meghívásához az alábbi engedélyek egyikére van szükség. További információ, többek között az engedélyek kiválasztása: Végponthoz készült Microsoft Defender API-k használata

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	Alert.Read.All	"Az összes riasztás olvasása"
Alkalmazás	Alert.ReadWrite.All	"Az összes riasztás olvasása és írása"
Delegált (munkahelyi vagy iskolai fiók)	Alert.Read	"Riasztások olvasása"
Delegált (munkahelyi vagy iskolai fiók)	Alert.ReadWrite	"Olvasási és írási riasztások"

HTTP-kérés

GET /api/users/{id}/alerts

Az azonosító nem a teljes egyszerű felhasználónév, hanem csak a felhasználónév. (például az /api/users/user1/alerts használatára vonatkozó riasztások lekéréséhez user1@contoso.com )

Kérelemfejlécek

Name (Név)	Típus	Leírás
Engedélyezési	Karakterlánc	Tulajdonos : {token}. Kötelező megadni.

Kérelem törzse

Üres

Válasz

Ha sikeres, és a felhasználó létezik – 200 OK. Ha a felhasználó nem létezik – 200 OK üres készlettel.

Példa

Kérés

Íme egy példa a kérésre.

GET https://api.security.microsoft.com/api/users/user1/alerts