Codes d’erreur courants de l’API RESTCommon REST API error codes

  • Les codes d'erreur répertoriés dans le tableau suivant peuvent être renvoyés par une opération sur l'une des API microsoft Defender pour les points de terminaison.The error codes listed in the following table may be returned by an operation on any of Microsoft Defender for Endpoint APIs.
  • En plus du code d'erreur, chaque réponse d'erreur contient un message d'erreur, qui peut aider à résoudre le problème.In addition to the error code, every error response contains an error message, which can help resolve the problem.
  • Le message est un texte libre qui peut être modifié.The message is a free text that can be changed.
  • En bas de la page, vous trouverez des exemples de réponse.At the bottom of the page, you can find response examples.

Vous souhaitez faire l'expérience de Defender pour point de terminaison ?Want to experience Defender for Endpoint? Inscrivez-vous à un essai gratuit.Sign up for a free trial.

Code d’erreurError code Code d’état HTTPHTTP status code MessageMessage
BadRequestBadRequest BadRequest (400)BadRequest (400) Message d'erreur Général Bad Request.General Bad Request error message.
ODataErrorODataError BadRequest (400)BadRequest (400) Requête URI OData non valide (l'erreur spécifique est spécifiée).Invalid OData URI query (the specific error is specified).
InvalidInputInvalidInput BadRequest (400)BadRequest (400) Entrée non valide {l'entrée non valide}.Invalid input {the invalid input}.
InvalidRequestBodyInvalidRequestBody BadRequest (400)BadRequest (400) Corps de la demande non valide.Invalid request body.
InvalidHashValueInvalidHashValue BadRequest (400)BadRequest (400) La valeur de hachage {le hachage non valide} n’est pas valide.Hash value {the invalid hash} is invalid.
InvalidDomainNameInvalidDomainName BadRequest (400)BadRequest (400) Nom de domaine {le domaine non valide} non valide.Domain name {the invalid domain} is invalid.
InvalidIpAddressInvalidIpAddress BadRequest (400)BadRequest (400) Adresse IP {l’adresse IP non valide} n’est pas valide.IP address {the invalid IP} is invalid.
InvalidUrlInvalidUrl BadRequest (400)BadRequest (400) URL {l’URL non valide} n’est pas valide.URL {the invalid URL} is invalid.
MaximumBatchSizeExceededMaximumBatchSizeExceeded BadRequest (400)BadRequest (400) La taille maximale du lot est dépassée.Maximum batch size exceeded. Received: {batch size received}, allowed: {batch size allowed}.Received: {batch size received}, allowed: {batch size allowed}.
MissingRequiredParameterMissingRequiredParameter BadRequest (400)BadRequest (400) Le paramètre {le paramètre manquant} est manquant.Parameter {the missing parameter} is missing.
OsPlatformNotSupportedOsPlatformNotSupported BadRequest (400)BadRequest (400) La plateforme du système d’exploitation {la plateforme de système d’exploitation cliente} n’est pas prise en charge pour cette action.OS Platform {the client OS Platform} is not supported for this action.
ClientVersionNotSupportedClientVersionNotSupported BadRequest (400)BadRequest (400) {The requested action} is supported on client version {supported client version} and above.{The requested action} is supported on client version {supported client version} and above.
Non autorisé (Unauthorized)Unauthorized Non autorisé (401)Unauthorized (401) Non autorisé (en-tête d’autorisation non valide ou expiré).Unauthorized (invalid or expired authorization header).
Interdit (Forbidden)Forbidden Interdit (403)Forbidden (403) Interdit (jeton valide mais autorisation insuffisante pour l’action).Forbidden (valid token but insufficient permission for the action).
DisabledFeatureDisabledFeature Interdit (403)Forbidden (403) La fonctionnalité client n’est pas activée.Tenant feature is not enabled.
DisallowedOperationDisallowedOperation Interdit (403)Forbidden (403) {l’opération nonallée et la raison}.{the disallowed operation and the reason}.
NotFoundNotFound In found (404)Not Found (404) Message d’erreur Général in trouvé.General Not Found error message.
ResourceNotFoundResourceNotFound In found (404)Not Found (404) Ressource {la ressource demandée} in trouvée.Resource {the requested resource} was not found.
InternalServerErrorInternalServerError Erreur interne du serveur (500)Internal Server Error (500) (Aucun message d'erreur, nouvelle tentative de l'opération)(No error message, retry the operation)
TooManyRequestsTooManyRequests Trop de demandes (429)Too Many Requests (429) La réponse représente l'atteinte de la limite de quota soit par nombre de demandes, soit par processeur.Response will represent reaching quota limit either by number of requests or by CPU.

Les paramètres body sont sensibles à la casBody parameters are case-sensitive

Les paramètres du corps soumis sont actuellement sensibles à la cas.The submitted body parameters are currently case-sensitive.
Si vous faites l'expérience d'erreurs InvalidRequestBody ou MissingRequiredParameter, cela peut être dû à une majuscule de paramètre incorrecte ou à une lettre majuscule incorrecte.If you experience an InvalidRequestBody or MissingRequiredParameter errors, it might be caused from a wrong parameter capital or lower-case letter.
Consultez la page de documentation de l'API et vérifiez que les paramètres envoyés correspondent à l'exemple approprié.Review the API documentation page and check that the submitted parameters match the relevant example.

ID de demande de corrélationCorrelation request ID

Chaque réponse d'erreur contient un paramètre d'ID unique pour le suivi.Each error response contains a unique ID parameter for tracking.
Le nom de propriété de ce paramètre est « target ».The property name of this parameter is "target".
Lorsque vous nous contactez à propos d'une erreur, l'attachement de cet ID permet de trouver la cause première du problème.When contacting us about an error, attaching this ID will help find the root cause of the problem.

範例Examples

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