Partage via

Codes d’erreur courants de l’API REST Microsoft Defender XDR

  • Article

S’applique à :

  • Microsoft Defender XDR

Remarque

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.

Importante

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 :

Codes d’erreur

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.

Exemples

{
    "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"
    }
}

Paramètres de corps

Importante

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é.

ID de suivi

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.

Conseil

Voulez-vous en savoir plus ? Engage avec la communauté Microsoft Security dans notre communauté technique : Microsoft Defender XDR Tech Community.