Hent domænerelaterede maskiners API
Gælder for:
- Microsoft Defender for Endpoint Plan 1
- Microsoft Defender for Endpoint Plan 2
- Microsoft Defender XDR
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 computere , der har kommunikeret til eller fra en given domæneadresse.
Begrænsninger
- Du kan forespørge på enheder, der senest er opdateret i henhold til din konfigurerede opbevaringsperiode.
- Hastighedsbegrænsninger for denne API er 100 opkald pr. minut og 1500 opkald pr. time.
- Svar er begrænset til 500 enheder i resultater.
Tilladelser
En af følgende tilladelser er påkrævet for at kalde denne API. Du kan få mere at vide, herunder hvordan du vælger tilladelser, under Brug Microsoft Defender for Endpoint API'er
| Tilladelsestype | Tilladelse | Vist navn for tilladelse |
|---|---|---|
| Program | Machine.Read.All |
Read all machine profiles |
| Program | Machine.ReadWrite.All |
Read and write all machine information |
| Uddelegeret (arbejds- eller skolekonto) | Machine.Read |
Read machine information |
| Uddelegeret (arbejds- eller skolekonto) | Machine.ReadWrite |
Read and write machine information |
Bemærk!
Når du henter et token ved hjælp af brugerlegitimationsoplysninger:
- Brugeren skal have mindst følgende rolletilladelse:
View Data. Du kan få flere oplysninger under Opret og administrer roller. - Svar omfatter kun enheder, som brugeren har adgang til, baseret på indstillingerne for enhedsgruppe. 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/domains/{domain}/machines
Anmodningsheadere
| Navn | Type | Beskrivelse |
|---|---|---|
| Autorisation | String |
Bearer {token}. Påkrævet. |
Brødtekst i anmodning
Tom
Svar
Hvis det lykkes, og domænet findes:
- 200 OK med liste over maskinenheder
Hvis domænet 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/domains/api.securitycenter.microsoft.com/machines
Tip
Vil du vide mere? Engage med Microsoft Security-community'et i vores tech-community: Microsoft Defender for Endpoint Tech Community.