Hent API til filrelaterede maskiner
Gælder for:
Vil du opleve Microsoft Defender for Endpoint? Tilmeld dig en gratis prøveversion.
Bemærk!
Hvis du er us government-kunde, skal du bruge de URI'er, der er angivet i Microsoft Defender for Endpoint for US Government-kunder.
Tip
For at opnå en bedre ydeevne kan du bruge serveren tættere på din geografiske placering:
- 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 en samling af maskiner , der er relateret til en given filhash.
Begrænsninger
- Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1500 opkald pr. time.
- Kun SHA-1-hashfunktionen understøttes (ikke MD5 eller SHA-256).
Tilladelser
En af følgende tilladelser er påkrævet for at kalde denne API. Hvis du vil vide mere, herunder hvordan du vælger tilladelser, skal du se Brug Microsoft Defender til Slutpunkt-API'er
| Tilladelsestype | Tilladelse | Vist navn for tilladelse |
|---|---|---|
| Program | Machine.Read.All | 'Læs alle computerprofiler' |
| Program | Machine.ReadWrite.All | 'Læs og skriv alle computeroplysninger' |
| Uddelegeret (arbejds- eller skolekonto) | Machine.Read | 'Læs computeroplysninger' |
| Uddelegeret (arbejds- eller skolekonto) | Machine.ReadWrite | 'Læs og skriv computeroplysninger' |
Bemærk!
Når du henter et token ved hjælp af brugerlegitimationsoplysninger:
- Brugeren skal som minimum have følgende rolletilladelse: 'Vis data' (du kan få flere oplysninger under Opret og administrer roller)
- Svaret omfatter kun enheder, som brugeren har adgang til, baseret på indstillinger for enhedsgrupper (du kan få flere oplysninger under Opret og administrer enhedsgrupper)
Oprettelse af enhedsgruppe understøttes i Defender for Endpoint Plan 1 og Plan 2.
HTTP-anmodning
GET /api/files/{id}/machines
Anmodningsheadere
| Navn | Type | Beskrivelse |
|---|---|---|
| Autorisation | String | Ihændehaver {token}. Påkrævet. |
Brødtekst i anmodning
Tom
Svar
Hvis det lykkes, og filen findes - 200 OK med en liste over computerenheder i brødteksten. Hvis filen ikke findes - 200 OK med et tomt sæt.
Eksempel
Bøn
Her er et eksempel på anmodningen.
GET https://api.securitycenter.microsoft.com/api/files/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/machines
Tip
Vil du vide mere? Kontakt Microsoft Security-community'et i vores Tech Community: Microsoft Defender for Endpoint Tech Community.