Incidensinformációs API lekérése
Érintett szolgáltatás:
Szeretné megismerni a Végponthoz készült Microsoft 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
Megjegyzés
Próbálja ki az új API-kat az MS Graph security API használatával. További információ: A Microsoft Graph biztonsági API használata – Microsoft Graph | Microsoft Learn.
Lekér egy adott incidenst az azonosítója alapján
- Az API sebességkorlátozásai percenként 100 hívás, óránként 1500 hívás.
Az API meghívásához az alábbi engedélyek egyikére van szükség.
Engedély típusa | Engedély | Engedély megjelenítendő neve |
---|---|---|
Alkalmazás | Incident.Read.All | Read all Incidents |
Alkalmazás | Incident.ReadWrite.All | Read and write all Incidents |
Delegált (munkahelyi vagy iskolai fiók) | Incident.Read | Read Incidents |
Delegált (munkahelyi vagy iskolai fiók) | Incident.ReadWrite | Read and write Incidents |
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
- A válasz csak azokat az incidenseket tartalmazza, amelyeknek a felhasználó ki van téve
GET .../api/incidents/{id}
Name (Név) | Típus | Leírás |
---|---|---|
Felhatalmazás | Karakterlánc | Tulajdonos : {token}. Kötelező megadni. |
Üres
Ha a metódus sikeres, a visszaadja 200 OK
a értéket, és az incidens entitást a válasz törzsében.
Ha a megadott azonosítóval rendelkező incidens nem található – 404 Nem található.
Íme egy példa a kérésre.
GET https://api.security.microsoft.com/api/incidents/{id}
A Microsoft Graph biztonsági API használata – Microsoft Graph | Microsoft Learn
Tipp.
Szeretne többet megtudni? Lépjen kapcsolatba a Microsoft biztonsági közösségével a technikai közösségünkben: Microsoft Defender XDR Tech Community.