IP-címekkel kapcsolatos riasztások API lekérése - Microsoft Defender for Endpoint

Cikk
08/14/2024

Érintett szolgáltatás:

Szeretné megismerni a Végponthoz készült Defendert? Regisztráció az ingyenes próbaverzióra

Megjegyzés:

Ha Ön az USA kormányzati szerveinek ügyfele, használja az USA kormányzati ügyfeleinek készült Végponthoz készült Microsoft Defenderben felsorolt URI-kat.

Tipp

A jobb teljesítmény érdekében a földrajzi helyhez közelebbi kiszolgálót használhat:

us.api.security.microsoft.com
eu.api.security.microsoft.com
uk.api.security.microsoft.com
au.api.security.microsoft.com
swa.api.security.microsoft.com
ina.api.security.microsoft.com

API-leírás

Lekéri egy adott IP-címhez 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

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

Engedély típusa	Engedély	Engedély megjelenítendő neve
Alkalmazás	Alert.Read.All	`Read all alerts`
Alkalmazás	Alert.ReadWrite.All	`Read and write all alerts`
Delegált (munkahelyi vagy iskolai fiók)	Alert.Read	`Read alerts`
Delegált (munkahelyi vagy iskolai fiók)	Alert.ReadWrite	`Read and write alerts`

Megjegyzés:

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: View Data. 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ó eszközcsoport-beállítások alapján rendelkezik hozzáféréssel (további információért lásd: Eszközcsoportok létrehozása és kezelése ).

Az eszközcsoport létrehozása a Végponthoz készült Defender 1. és 2. csomagjában támogatott.

HTTP-kérés

GET /api/ips/{ip}/alerts

Kérelemfejlécek

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

Kérelem törzse

Üres

Válasz

Ha sikeres, és az IP-cím létezik – 200 OK a riasztási entitások listájával a törzsben. Ha az IP-cím ismeretlen, de érvényes, üres készletet ad vissza. Ha az IP-cím érvénytelen, http 400-et ad vissza.

Példa

Kérés

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

GET https://api.securitycenter.microsoft.com/api/ips/10.209.67.177/alerts