Codes d’erreur courants de l’API REST Microsoft Defender XDR
S’applique à :
- Microsoft Defender XDR
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.
Important
Certaines informations ont trait à un produit préalablement publié, qui peut être modifié de manière significative avant sa publication commerciale. Microsoft n’offre aucune garantie, explicite ou implicite, concernant les informations fournies ici.
Les codes d’erreur peuvent être retournés par une opération sur l’une des API Microsoft Defender XDR. Chaque réponse d’erreur contient un message d’erreur, qui peut aider à résoudre le problème. La colonne message d’erreur dans la section de la table fournit des exemples de messages. Le contenu des messages réels varie en fonction des facteurs qui ont déclenché la réponse. Le contenu de la variable est indiqué par des crochets (< >
) dans le tableau suivant :
Code d’erreur | Code d’état HTTP | Message |
---|---|---|
BadRequest | BadRequest (400) | Message d’erreur de demande incorrecte générale. |
ODataError | BadRequest (400) | Requête URI <OData non valide dont l’erreur spécifique est spécifiée>. |
InvalidInput | BadRequest (400) | <Entrée non valide entrée l’entrée> non valide. |
InvalidRequestBody | BadRequest (400) | Corps de la demande non valide. |
InvalidHashValue | BadRequest (400) | Valeur <de hachage le hachage> non valide n’est pas valide. |
InvalidDomainName | BadRequest (400) | <Nom de domaine le domaine> non valide n’est pas valide. |
InvalidIpAddress | BadRequest (400) | Adresse <IP non valide> . |
InvalidUrl | BadRequest (400) | URL <l’URL> non valide n’est pas valide. |
MaximumBatchSizeExceededed | BadRequest (400) | Taille de lot maximale dépassée. Reçu : <taille de lot reçue>, autorisée : {taille de lot autorisée}. |
MissingRequiredParameter | BadRequest (400) | Paramètre <manquant> . |
OsPlatformNotSupported | BadRequest (400) | Plateforme <du système d’exploitation la plateforme> du système d’exploitation cliente n’est pas prise en charge pour cette action. |
ClientVersionNotSupported | BadRequest (400) | <L’action> demandée est prise en charge sur la version <du client prise en charge et les versions> ultérieures. |
Non autorisé (Unauthorized) | Non autorisé (401) | Non autorisé (Unauthorized) Cette erreur est généralement due à un en-tête d’autorisation non valide ou expiré. |
Interdit (Forbidden) | Interdit (403) | Interdit (Forbidden) Cette erreur peut se produire avec un jeton valide mais une autorisation insuffisante pour l’action. |
DisabledFeature | Interdit (403) | La fonctionnalité de locataire n’est pas activée. |
DisallowedOperation | Interdit (403) | <l’opération non autorisée et la raison>. |
NotFound | Introuvable (404) | Message d’erreur Général introuvable. |
ResourceNotFound | Introuvable (404) | Ressource <que la ressource> demandée n’a pas été trouvée. |
InternalServerError | Erreur interne du serveur (500) | S’il n’y a pas de message d’erreur, réessayez l’opération. Contactez Microsoft s’il n’est pas résolu. |
{
"error": {
"code": "ResourceNotFound",
"message": "Machine 123123123 was not found",
"target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
}
}
{
"error": {
"code": "InvalidRequestBody",
"message": "Request body is incorrect",
"target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
}
}
Important
Les paramètres de corps respectent la casse.
Si vous rencontrez une erreur InvalidRequestBody ou MissingRequiredParameter , cela peut être dû à une faute de frappe. Passez en revue la documentation de l’API et case activée que les paramètres envoyés correspondent à l’exemple approprié.
Chaque réponse d’erreur contient un paramètre d’ID unique pour le suivi. Le nom de propriété de ce paramètre est target. Si vous contactez Microsoft à propos d’une erreur, l’attachement de votre ID de suivi permet à Microsoft de trouver la cause racine du problème.
- Utiliser l’API de sécurité Microsoft Graph - Microsoft Graph | Microsoft Learn
- Vue d’ensemble des API Microsoft Defender XDR
- API Microsoft Defender XDR prises en charge
- Accéder aux API Microsoft Defender XDR
- En savoir plus sur les limites et les licences des API
Conseil
Voulez-vous en savoir plus ? Engage avec la communauté Microsoft Security dans notre communauté technique : Microsoft Defender XDR Tech Community.