Hämta API för incidentinformation
Gäller för:
Vill du uppleva Microsoft Defender för Endpoint? Registrera dig för en kostnadsfri utvärderingsversion.
Anteckning
Om du är en us government-kund använder du de URI:er som anges i Microsoft Defender för Endpoint för amerikanska myndighetskunder.
Tips
För bättre prestanda kan du använda servern närmare din geoplats:
- 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
Anteckning
Prova våra nya API:er med ms Graph-säkerhets-API. Läs mer på: Använda Säkerhets-API:et för Microsoft Graph – Microsoft Graph | Microsoft Learn.
Hämtar en specifik incident med sitt ID
- Frekvensbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.
En av följande behörigheter krävs för att anropa det här API:et.
Behörighetstyp | Behörighet | Visningsnamn för behörighet |
---|---|---|
Program | Incident.Read.All | Read all Incidents |
Program | Incident.ReadWrite.All | Read and write all Incidents |
Delegerat (arbets- eller skolkonto) | Incident.Read | Read Incidents |
Delegerat (arbets- eller skolkonto) | Incident.ReadWrite | Read and write Incidents |
Anteckning
När du hämtar en token med användarautentiseringsuppgifter:
- Användaren måste ha minst följande rollbehörighet:
View Data
- Svaret omfattar endast incidenter som användaren exponeras för
GET .../api/incidents/{id}
Namn | Typ | Beskrivning |
---|---|---|
Tillstånd | Sträng | Ägaren {token}. Krävs. |
Tom
Om det lyckas returnerar 200 OK
den här metoden , och incidententiteten i svarstexten.
Om incidenten med det angivna ID:t inte hittades – 404 Hittades inte.
Här är ett exempel på begäran.
GET https://api.security.microsoft.com/api/incidents/{id}
Använda Säkerhets-API:et för Microsoft Graph – Microsoft Graph | Microsoft Learn
Tips
Vill du veta mer? Interagera med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender XDR Tech Community.