API-methoden en eigenschappen van antivirusstatus van apparaat exporteren

API-beschrijving van antivirusstatus van apparaat exporteren

Hiermee wordt een lijst met Microsoft Defender statusgegevens van het antivirusapparaat opgehaald. Deze API heeft verschillende API-aanroepen (methoden) om verschillende typen gegevens op te halen. Omdat de hoeveelheid gegevens groot kan zijn, zijn er twee manieren waarop deze kunnen worden opgehaald:

• JSON De API haalt alle gegevens in uw organisatie op als JSON-antwoorden. Deze methode is het beste voor kleine organisaties met minder dan 100 K-apparaten. Het antwoord is gepagineerd, zodat u het veld @odata.nextLink uit het antwoord kunt gebruiken om de volgende resultaten op te halen.

• Archief Met deze API-oplossing kunnen grotere hoeveelheden gegevens sneller en betrouwbaarder worden opgehaald en wordt aanbevolen voor grote organisaties met meer dan 100.000 apparaten. Deze API haalt alle gegevens in uw organisatie op als downloadbestanden. Het antwoord bevat URL's voor het downloaden van alle gegevens uit Azure Storage. Met deze API kunt u als volgt al uw gegevens downloaden van Azure Storage:

  1. Roep de API aan om een lijst met download-URL's met alle gegevens van uw organisatie op te halen.

  2. Download alle bestanden met behulp van de download-URL's en verwerk de gegevens zoals u wilt.

Gegevens die worden verzameld met of met behulp van JSON response bestanden, zijn een momentopname van de huidige status. Deze gegevens bevatten geen historische gegevens. Als u historische gegevens wilt verzamelen, moet u de gegevens opslaan in uw eigen gegevensopslag.

Zie voor informatie over het gebruik van het hulpprogramma Apparaatstatus- en antiviruscompatibiliteitsrapportage in de Microsoft Defender-portal: Apparaatstatus- en antivirusrapport in Microsoft Defender voor Eindpunt.

Vereisten

• Windows Server 2012 R2 en Windows Server 2016 worden alleen weergegeven in apparaatstatusrapporten als deze apparaten worden onboarded met behulp van het moderne geïntegreerde oplossingspakket. Zie Nieuwe functionaliteit in de moderne geïntegreerde oplossing voor Windows Server 2012 R2 en 2016 voor meer informatie.

1.1 API-methoden voor antivirusstatus van apparaat exporteren

1.2 Beperkingen

• Maximale paginagrootte: 200.000
• Frequentiebeperkingen voor deze API: 30 aanroepen per minuut en 1000 aanroepen per uur

1.3 Api-eigenschappen van antivirusstatus van apparaat exporteren (JSON-antwoord)

• De eigenschappen die in de volgende tabel zijn gedefinieerd, worden alfabetisch weergegeven, op eigenschaps-id. Wanneer u deze API gebruikt, wordt de resulterende uitvoer niet noodzakelijkerwijs geretourneerd in dezelfde volgorde die in deze tabel wordt vermeld.
• Houd er rekening mee dat rbacgroupname en id geen ondersteunde filteroperators zijn.
• Er kunnen nog enkele kolommen worden geretourneerd in het antwoord. Deze kolommen kunnen tijdelijk zijn en kunnen worden verwijderd; alleen de gedocumenteerde kolommen gebruiken.

1.4 API-eigenschappen van antivirusstatus van apparaat exporteren (via bestanden)

In elk van de exportbestanden bevindt zich een eigenschap met de naam DeviceGatheredInfo, die antivirusgegevens bevat. Elk van de kenmerken kan u informatie geven over de status en status van het apparaat.

• De bestanden zijn gzip-gecomprimeerd en hebben een indeling met meerdere regels .json .
• De download-URL's zijn slechts 3 uur geldig; anders kunt u de parameter gebruiken.
• Voor een maximale downloadsnelheid van uw gegevens kunt u ervoor zorgen dat u downloadt vanuit dezelfde Azure regio waarin uw gegevens zich bevinden.
• Elke record gebruikt ongeveer 1 KB aan gegevens. Houd hier rekening mee bij het kiezen van de juiste pageSize parameter.
• Er kunnen meer kolommen worden geretourneerd in het antwoord. Deze kolommen zijn tijdelijk en kunnen worden verwijderd, dus gebruik alleen de gedocumenteerde kolommen.