Få API for hendelsesinformasjon
Gjelder for:
Vil du oppleve Microsoft Defender for endepunkt? Registrer deg for en gratis prøveperiode.
Obs!
Hvis du er us Government-kunde, kan du bruke URI-ene som er oppført i Microsoft Defender for Endpoint for US Government-kunder.
Tips
Hvis du vil ha bedre ytelse, kan du bruke serveren nærmere geografisk plassering:
- 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
Obs!
Prøv våre nye API-er ved hjelp av MS Graph Security API. Finn ut mer på: Bruk Microsoft Graph security API - Microsoft Graph | Microsoft Learn.
Henter en bestemt hendelse etter ID-en
- Satsbegrensninger for denne API-en er 100 oppkall per minutt og 1500 anrop per time.
Én av følgende tillatelser er nødvendig for å kalle opp denne API-en.
Tillatelsestype | Tillatelse | Visningsnavn for tillatelse |
---|---|---|
Program | Incident.Read.All | Read all Incidents |
Program | Incident.ReadWrite.All | Read and write all Incidents |
Delegert (jobb- eller skolekonto) | Hendelse.Lest | Read Incidents |
Delegert (jobb- eller skolekonto) | Incident.ReadWrite | Read and write Incidents |
Obs!
Når du skaffer et token ved hjelp av brukerlegitimasjon:
- Brukeren må minst ha følgende rolletillatelse:
View Data
- Svaret inkluderer bare hendelser som brukeren er utsatt for
GET .../api/incidents/{id}
Navn | Type: | Beskrivelse |
---|---|---|
Autorisasjon | Streng | Bærer {token}. Obligatorisk. |
Tom
Hvis vellykket, returnerer 200 OK
denne metoden , og hendelsesenheten i svarteksten.
Hvis hendelsen med den angitte ID-en ikke ble funnet - 404 Ikke funnet.
Her er et eksempel på forespørselen.
GET https://api.security.microsoft.com/api/incidents/{id}
Bruk Microsoft Graph-sikkerhets-API -en – Microsoft Graph | Microsoft Learn
Tips
Vil du lære mer? Kommuniser med Microsoft Sikkerhet-fellesskapet i det tekniske fellesskapet vårt: Microsoft Defender XDR Tech Community.