Exporter les méthodes et propriétés de l’API des détails de l’antivirus de l’appareil

Exporter les détails de l’intégrité de l’antivirus de l’appareil description de l’API

Récupère la liste des détails d’intégrité des appareils antivirus Microsoft Defender. Cette API a différents appels d’API (méthodes) pour obtenir différents types de données. Étant donné que la quantité de données peut être importante, il existe deux façons de les récupérer :

• JSON L’API extrait toutes les données de votre organization sous forme de réponses JSON. Cette méthode est idéale pour les petites organisations avec moins de 100 000 appareils. La réponse étant paginée, vous pouvez utiliser le champ @odata.nextLink de la réponse pour extraire les résultats suivants.

• Fichiers Cette solution d’API permet d’extraire de plus grandes quantités de données plus rapidement et de manière plus fiable. Elle est recommandée pour les grandes organisations disposant de plus de 100 000 appareils. Cette API extrait toutes les données de votre organization en tant que fichiers de téléchargement. La réponse contient des URL pour télécharger toutes les données à partir de Azure Storage. Cette API vous permet de télécharger toutes vos données à partir de Azure Storage comme suit :

  1. Appelez l’API pour obtenir une liste d’URL de téléchargement avec toutes vos données organization.

  2. Téléchargez tous les fichiers à l’aide des URL de téléchargement et traitez les données comme vous le souhaitez.

Les données collectées à l’aide JSON response de ou à l’aide de fichiers sont une instantané de l’état actuel. Ces données ne contiennent pas de données historiques. Pour collecter des données d’historique, vous devez enregistrer les données dans votre propre stockage de données.

Pour plus d’informations sur l’utilisation de l’outil de création de rapports sur l’intégrité de l’appareil et la conformité des antivirus dans le portail Microsoft Defender, consultez : Rapport sur l’intégrité de l’appareil et l’antivirus dans Microsoft Defender pour point de terminaison.

Configuration requise

• Pour que Windows Server 2012 R2 et Windows Server 2016 apparaissent dans les rapports d’intégrité des appareils, ces appareils doivent être intégrés à l’aide du package de solution unifiée moderne. Pour plus d’informations, consultez Nouvelles fonctionnalités de la solution unifiée moderne pour Windows Server 2012 R2 et 2016.

1.1 Exporter les méthodes de l’API détails de l’intégrité de l’antivirus des appareils

1.2 Limitations

• Taille de page maximale : 200 000
• Limitations de débit pour cette API : 30 appels par minute et 1 000 appels par heure

1.3 Exporter les propriétés de l’API détails de l’intégrité de l’antivirus de l’appareil (réponse JSON)

• Les propriétés définies dans le tableau suivant sont répertoriées par ordre alphabétique, par ID de propriété. Lorsque vous utilisez cette API, la sortie résultante n’est pas nécessairement retournée dans le même ordre que celui indiqué dans cette table.
• Notez que rbacgroupname et ID ne sont pas pris en charge par les opérateurs de filtre.
• D’autres colonnes peuvent être retournées dans la réponse. Ces colonnes peuvent être temporaires et peuvent être supprimées ; utiliser uniquement les colonnes documentées.

1.4 Exporter les propriétés de l’API détails de l’intégrité de l’antivirus de l’appareil (via des fichiers)

Dans chacun des fichiers d’exportation, il existe une propriété appelée DeviceGatheredInfo, qui contient des données antivirus. Chacun de ses attributs peut vous fournir des informations sur l’intégrité de l’appareil et ses status.

• Les fichiers sont compressés par gzip et au format multiligne .json .
• Les URL de téléchargement ne sont valides que pendant 3 heures ; sinon, vous pouvez utiliser le paramètre .
• Pour une vitesse de téléchargement maximale de vos données, vous pouvez vous assurer que vous effectuez le téléchargement à partir de la même région Azure que celle où résident vos données.
• Chaque enregistrement utilise environ 1 Ko de données. Vous devez en tenir compte lors du choix du paramètre approprié pageSize .
• D’autres colonnes peuvent être retournées dans la réponse. Ces colonnes sont temporaires et peuvent être supprimées. Utilisez donc uniquement les colonnes documentées.