API voor incidentgegevens ophalen
Van toepassing op:
Wilt u Microsoft Defender voor Eindpunt ervaren? Meld u aan voor een gratis proefversie.
Notitie
Als u een klant van de Amerikaanse overheid bent, gebruikt u de URI's die worden vermeld in Microsoft Defender voor Eindpunt voor klanten van de Amerikaanse overheid.
Tip
Voor betere prestaties kunt u de server dichter bij uw geografische locatie gebruiken:
- 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
Notitie
Probeer onze nieuwe API's met behulp van de MS Graph-beveiligings-API. Meer informatie vindt u op: De Microsoft Graph-beveiligings-API gebruiken - Microsoft Graph | Microsoft Learn.
Haalt een specifiek incident op met de bijbehorende id
- Frequentiebeperkingen voor deze API zijn 100 aanroepen per minuut en 1500 aanroepen per uur.
Een van de volgende machtigingen is vereist om deze API aan te roepen.
Machtigingstype | Machtiging | Weergavenaam van machtiging |
---|---|---|
Toepassing | Incident.Read.All | Read all Incidents |
Toepassing | Incident.ReadWrite.All | Read and write all Incidents |
Gedelegeerd (werk- of schoolaccount) | Incident.Read | Read Incidents |
Gedelegeerd (werk- of schoolaccount) | Incident.ReadWrite | Read and write Incidents |
Notitie
Bij het verkrijgen van een token met behulp van gebruikersreferenties:
- De gebruiker moet ten minste de volgende rolmachtiging hebben:
View Data
- Het antwoord bevat alleen incidenten waaraan de gebruiker wordt blootgesteld
GET .../api/incidents/{id}
Naam | Type | Beschrijving |
---|---|---|
Machtiging | Tekenreeks | Bearer {token}. Vereist. |
Leeg
Als dit lukt, retourneert 200 OK
deze methode en de incidententiteit in de antwoordtekst.
Als het incident met de opgegeven id niet is gevonden, is 404 niet gevonden.
Hier volgt een voorbeeld van de aanvraag.
GET https://api.security.microsoft.com/api/incidents/{id}
De Microsoft Graph-beveiligings-API gebruiken - Microsoft Graph | Microsoft Learn
Tip
Wil je meer weten? Neem contact op met de Microsoft Beveiliging-community in onze Tech Community: Microsoft Defender XDR Tech Community.