Obtenir l’historique d’analyse par définition

Article
08/14/2024

S’applique à :

Vous voulez découvrir Microsoft Defender pour point de terminaison ? Inscrivez-vous pour bénéficier d’un essai gratuit.

Vous souhaitez découvrir Microsoft Defender Vulnerability Management ? Découvrez comment vous inscrire à un essai gratuit.

Importante

Certaines informations contenues dans cet article concernent le produit en préversion, qui peut être considérablement modifié avant sa publication commerciale. Microsoft n’offre aucune garantie, explicite ou implicite, concernant les informations fournies ici.

Remarque

Si vous êtes un client du gouvernement des États-Unis, utilisez les URI répertoriés dans Microsoft Defender pour point de terminaison pour les clients du gouvernement des États-Unis.

Conseil

Pour de meilleures performances, vous pouvez utiliser le serveur plus près de votre emplacement géographique :

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

Description de l’API

Récupère une liste de l’historique d’analyse par définitions.

Prend en charge les opérations OData.
Opérateurs pris en charge par OData :
- $top avec la valeur maximale de 4096. Retourne le nombre de sessions spécifiées dans la demande.
- $skip avec la valeur par défaut 0. Ignore le nombre de sessions spécifiées dans la demande.

Pour obtenir un exemple d’utilisation de l’opération OData, consultez l’exemple $top demande.

Limitations

Les limitations de débit pour cette API sont de 100 appels par minute et de 1 500 appels par heure.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour en savoir plus, notamment sur le choix des autorisations, consultez Utiliser les API Microsoft Defender pour point de terminaison.

Type d’autorisation	Autorisation	Nom complet de l’autorisation
Application	Machine.Read.All	Lire toutes les informations d’analyse.
Déléguée (compte professionnel ou scolaire)	Machine.Read.All	Lire toutes les informations d’analyse.

Remarque

Lors de l’obtention d’un jeton à l’aide des informations d’identification de l’utilisateur :

Pour afficher les données, l’utilisateur doit disposer au moins de l’autorisation de rôle suivante : « ViewData » ou « TvmViewData » (voir Créer et gérer des rôles pour plus d’informations)

Requête HTTP

POST api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId

En-têtes de demande

Nom	Type	Description
Autorisation	Chaîne	Porteur {token}. Obligatoire.
Content-Type	string	application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez un objet JSON avec les paramètres suivants :

Paramètre	Type	Description
ScanDefinitionIds	Chaîne	ID d’analyse. Obligatoire.

Réponse

Si elle réussit, cette méthode retourne 200 - OK code de réponse avec une liste de l’historique d’analyse par définition.

Exemple de requête

Voici un exemple de demande.

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId

{
    "ScanDefinitionIds": ["4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae", "60c4aa57-c573-4488-8d18-230914792a92", "c6220f67-2cad-4ba3-a2fa-7ded6384da56"]
}

Exemple de réponse

{
"@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId",
    "value": [
    {
    "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
    "LastScanned": "2022-12-20T11:14:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
    {
    "ScanDefinitionIds": "60c4aa57-c573-4488-8d18-230914792a92",
    "LastScanned": "2022-11-17T15:13:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
    {
    "ScanDefinitionIds": "c6220f67-2cad-4ba3-a2fa-7ded6384da56",
    "LastScanned": "2022-11-10T18:15:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
   ]
}

Exemple de demande $top

Voici un exemple de requête qui ne retourne qu’une seule session.

POST https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId?$top=1

Exemple de réponse $top

{
"@odata.context": "https://api.securitycenter.microsoft.com/api/DeviceAuthenticatedScanDefinitions/GetScanHistoryByScanDefinitionId",
    "value": [
    {
    "ScanDefinitionIds": "4ad8d463-6b3a-4894-b42a-a2de9ea0a8ae",
    "LastScanned": "2022-12-20T11:14:24.5561791Z",
    "ScanStatus": "Partial Success",
    "ScannerId": "625431694b7d2ca9d07e77ca1b029ef216bebb6d"
    },
 ]
}

Partager via