Códigos de error comunes de API de RESTCommon REST API error codes

  • Los códigos de error enumerados en la tabla siguiente pueden devolverse mediante una operación en cualquiera de las API de Microsoft Defender para puntos de conexión.The error codes listed in the following table may be returned by an operation on any of Microsoft Defender for Endpoint APIs.
  • Además del código de error, cada respuesta de error contiene un mensaje de error, que puede ayudar a resolver el problema.In addition to the error code, every error response contains an error message, which can help resolve the problem.
  • El mensaje es un texto gratuito que se puede cambiar.The message is a free text that can be changed.
  • En la parte inferior de la página, puede encontrar ejemplos de respuesta.At the bottom of the page, you can find response examples.

¿Desea experimentar Defender for Endpoint?Want to experience Defender for Endpoint? Regístrate para obtener una versión de prueba gratuita.Sign up for a free trial.

Código de errorError code Código de estado HTTPHTTP status code MessageMessage
BadRequestBadRequest BadRequest (400)BadRequest (400) Mensaje de error General Bad Request.General Bad Request error message.
ODataErrorODataError BadRequest (400)BadRequest (400) Consulta URI de OData no válida (se especifica el error específico).Invalid OData URI query (the specific error is specified).
InvalidInputInvalidInput BadRequest (400)BadRequest (400) Entrada no válida {la entrada no válida}.Invalid input {the invalid input}.
InvalidRequestBodyInvalidRequestBody BadRequest (400)BadRequest (400) Cuerpo de la solicitud no válido.Invalid request body.
InvalidHashValueInvalidHashValue BadRequest (400)BadRequest (400) El valor hash {el hash no válido} no es válido.Hash value {the invalid hash} is invalid.
InvalidDomainNameInvalidDomainName BadRequest (400)BadRequest (400) El nombre de dominio {el dominio no válido} no es válido.Domain name {the invalid domain} is invalid.
InvalidIpAddressInvalidIpAddress BadRequest (400)BadRequest (400) La dirección IP {la IP no válida} no es válida.IP address {the invalid IP} is invalid.
InvalidUrlInvalidUrl BadRequest (400)BadRequest (400) La dirección URL {la dirección URL no válida} no es válida.URL {the invalid URL} is invalid.
MaximumBatchSizeExceededMaximumBatchSizeExceeded BadRequest (400)BadRequest (400) Se ha superado el tamaño máximo de lote.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) Falta el parámetro {el parámetro que falta}.Parameter {the missing parameter} is missing.
OsPlatformNotSupportedOsPlatformNotSupported BadRequest (400)BadRequest (400) La plataforma del sistema operativo {la plataforma del sistema operativo cliente} no es compatible con esta acción.OS Platform {the client OS Platform} is not supported for this action.
ClientVersionNotSupportedClientVersionNotSupported BadRequest (400)BadRequest (400) {La acción solicitada} se admite en la versión de cliente {versión de cliente admitida} y versiones posteriores.{The requested action} is supported on client version {supported client version} and above.
No autorizado (Unauthorized)Unauthorized No autorizado (401)Unauthorized (401) No autorizado (encabezado de autorización no válido o expirado).Unauthorized (invalid or expired authorization header).
Prohibido (Forbidden)Forbidden Prohibido (403)Forbidden (403) Prohibido (token válido pero permiso insuficiente para la acción).Forbidden (valid token but insufficient permission for the action).
DisabledFeatureDisabledFeature Prohibido (403)Forbidden (403) La característica inquilino no está habilitada.Tenant feature is not enabled.
DisallowedOperationDisallowedOperation Prohibido (403)Forbidden (403) {la operación no permitido y el motivo}.{the disallowed operation and the reason}.
NotFoundNotFound No encontrado (404)Not Found (404) Mensaje de error General No encontrado.General Not Found error message.
ResourceNotFoundResourceNotFound No encontrado (404)Not Found (404) No se encontró el recurso {el recurso solicitado}.Resource {the requested resource} was not found.
InternalServerErrorInternalServerError Error interno del servidor (500)Internal Server Error (500) (Sin mensaje de error, vuelva a intentar la operación)(No error message, retry the operation)
TooManyRequestsTooManyRequests Demasiadas solicitudes (429)Too Many Requests (429) La respuesta representará alcanzar el límite de cuota por número de solicitudes o por CPU.Response will represent reaching quota limit either by number of requests or by CPU.

Los parámetros de cuerpo distinguen mayúsculas de minúsculasBody parameters are case-sensitive

Los parámetros de cuerpo enviados distinguen entre mayúsculas y minúsculas.The submitted body parameters are currently case-sensitive.
Si experimenta errores InvalidRequestBody o MissingRequiredParameter, es posible que se deba a un capital de parámetro incorrecto o a una letra minúscula.If you experience an InvalidRequestBody or MissingRequiredParameter errors, it might be caused from a wrong parameter capital or lower-case letter.
Revise la página de documentación de la API y compruebe que los parámetros enviados coinciden con el ejemplo correspondiente.Review the API documentation page and check that the submitted parameters match the relevant example.

Identificador de solicitud de correlaciónCorrelation request ID

Cada respuesta de error contiene un parámetro id. único para el seguimiento.Each error response contains a unique ID parameter for tracking.
El nombre de la propiedad de este parámetro es "target".The property name of this parameter is "target".
Al ponerse en contacto con nosotros sobre un error, adjuntar este identificador ayudará a encontrar la causa raíz del problema.When contacting us about an error, attaching this ID will help find the root cause of the problem.

EjemplosExamples

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