Hent filstatistikk-API

Artikkel
02/20/2025

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 endepunkt 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

API-beskrivelse

Henter statistikken for den angitte filen.

Begrensninger

Satsbegrensninger for denne API-en er 100 oppkall per minutt og 1500 anrop per time.
Maksimumsverdien for lookbackhours er 720 timer (30 dager).

Tillatelser

Én av følgende tillatelser er nødvendig for å kalle opp denne API-en. Hvis du vil ha mer informasjon, inkludert hvordan du velger tillatelser, kan du se Bruke Microsoft Defender for endepunkt API-er

Tillatelsestype	Tillatelse	Visningsnavn for tillatelse
Program	File.Read.All	Les filprofiler
Delegert (jobb- eller skolekonto)	File.Read.All	Les filprofiler

Obs!

Når du skaffer et token ved hjelp av brukerlegitimasjon:

Brukeren må minst ha følgende rolletillatelse: Vis data (hvis du vil ha mer informasjon, kan du se Opprette og behandle roller)

HTTP-forespørsel

GET /api/files/{id}/stats

Forespørselshoder

Navn	Type:	Beskrivelse
Autorisasjon	Streng	Bærer {token}. Obligatorisk.

URI-parametere for forespørsel

Navn	Type:	Beskrivelse
lookBackHours	Int32	Definerer timene vi søker tilbake for å hente statistikken. Standard er 30 dager. Valgfritt.

Forespørselstekst

Tom

Svar

Hvis vellykket og filen finnes – 200 OK med statistiske data i brødteksten. Hvis filen ikke finnes - finner ikke 404.

Eksempel

Eksempel på forespørsel

Her er et eksempel på forespørselen.

GET https://api.security.microsoft.com/api/files/0991a395da64e1c5fbe8732ed11e6be064081d9f/stats?lookBackHours=48

Eksempel på svar

Her er et eksempel på svaret.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.InOrgFileStats",
    "sha1": "0991a395da64e1c5fbe8732ed11e6be064081d9f",
    "organizationPrevalence": 14850,
    "orgFirstSeen": "2019-12-07T13:44:16Z",
    "orgLastSeen": "2020-01-06T13:39:36Z",
    "globallyPrevalence": 705012,
    "globalFirstObserved": "2015-03-19T12:20:07.3432441Z",
    "globalLastObserved": "2020-01-06T13:39:36Z",
    "topFileNames": [
        "MREC.exe"
    ]
}