Hent domænerelaterede maskiners API

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

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.

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.ReadWrite.All	Read and write all machine information
Uddelegeret (arbejds- eller skolekonto)	Machine.ReadWrite	Read and write machine information

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.security.microsoft.com/api/domains/api.security.microsoft.com/machines