API Obtenir des informations sur les incidents
S’applique à :
Vous voulez découvrir Microsoft Defender pour point de terminaison ? Inscrivez-vous pour bénéficier d’un essai gratuit.
Notes
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
Notes
Essayez nos nouvelles API à l’aide de l’API de sécurité MS Graph. Pour plus d’informations, consultez : Utiliser l’API de sécurité Microsoft Graph - Microsoft Graph | Microsoft Learn.
Récupère un incident spécifique par son ID
- Les limitations de débit pour cette API sont de 100 appels par minute et de 1 500 appels par heure.
L’une des autorisations suivantes est nécessaire pour appeler cette API.
Type d’autorisation | Autorisation | Nom complet de l’autorisation |
---|---|---|
Application | Incident.Read.All | Read all Incidents |
Application | Incident.ReadWrite.All | Read and write all Incidents |
Déléguée (compte professionnel ou scolaire) | Incident.Read | Read Incidents |
Déléguée (compte professionnel ou scolaire) | Incident.ReadWrite | Read and write Incidents |
Notes
Lors de l’obtention d’un jeton à l’aide des informations d’identification de l’utilisateur :
- L’utilisateur doit disposer au moins de l’autorisation de rôle suivante :
View Data
- La réponse inclut uniquement les incidents auxquels l’utilisateur est exposé
GET .../api/incidents/{id}
Nom | Type | Description |
---|---|---|
Autorisation | Chaîne | Porteur {token}. Obligatoire. |
Empty
Si elle réussit, cette méthode retourne 200 OK
et l’entité d’incident dans le corps de la réponse.
Si l’incident avec l’ID spécifié n’a pas été trouvé - 404 Introuvable.
Voici un exemple de demande.
GET https://api.security.microsoft.com/api/incidents/{id}
Utiliser l’API de sécurité Microsoft Graph - Microsoft Graph | Microsoft Learn
Conseil
Voulez-vous en savoir plus ? Collaborez avec la communauté Microsoft Security dans notre communauté technique : communauté technique Microsoft Defender XDR.