Códigos de error de la API REST de Microsoft Defender XDR comunes

  • Artículo

Se aplica a:

  • Microsoft Defender XDR

Nota:

Pruebe nuestras nuevas API mediante la API de seguridad de MS Graph. Obtenga más información en: Uso de la API de seguridad de Microsoft Graph: Microsoft Graph | Microsoft Learn.

Importante

Parte de la información se refiere a productos preliminares que pueden ser modificados sustancialmente antes de su lanzamiento comercial. Microsoft no otorga garantías, expresas o implícitas, con respecto a la información que aquí se proporciona.

Una operación puede devolver códigos de error en cualquiera de las API de Microsoft Defender XDR. Cada respuesta de error contiene un mensaje de error, que puede ayudar a resolver el problema. La columna de mensaje de error de la sección de tabla proporciona algunos mensajes de ejemplo. El contenido de los mensajes reales varía en función de los factores que desencadenaron la respuesta. El contenido de la variable se indica entre corchetes angulares (< >) en la tabla siguiente:

Códigos de error

Código de error Código de estado HTTP Mensaje
BadRequest BadRequest (400) Mensaje de error de solicitud incorrecta general.
ODataError BadRequest (400) Consulta URI <de OData no válida se especifica> el error específico.
InvalidInput BadRequest (400) <Entrada no válida la entrada> no válida.
InvalidRequestBody BadRequest (400) Cuerpo de la solicitud no válido.
InvalidHashValue BadRequest (400) <Valor hash que el hash> no válido no es válido.
InvalidDomainName BadRequest (400) <Nombre de dominio el dominio> no válido no es válido.
InvalidIpAddress BadRequest (400) <Dirección IP la dirección IP> no válida no es válida.
InvalidUrl BadRequest (400) La dirección URL <> no válida no es válida.
MaximumBatchSizeExceeded BadRequest (400) Se ha superado el tamaño máximo del lote. Recibido: <tamaño de lote recibido>, permitido: {tamaño de lote permitido}.
MissingRequiredParameter BadRequest (400) Parámetro <que falta en el parámetro> .
OsPlatformNotSupported BadRequest (400) Plataforma <del sistema operativo la plataforma> del sistema operativo cliente no se admite para esta acción.
ClientVersionNotSupported BadRequest (400) <La acción> solicitada se admite en la versión de cliente compatible con la versión <> de cliente y versiones posteriores.
No autorizado (Unauthorized) No autorizado (401) No autorizado (Unauthorized)

Este error suele deberse a un encabezado de autorización no válido o expirado.
Prohibido (Forbidden) Prohibido (403) Prohibido (Forbidden)

Este error puede producirse con un token válido, pero un permiso insuficiente para la acción.
DisabledFeature Prohibido (403) La característica de inquilino no está habilitada.
No permitidaOperation Prohibido (403) <la operación no permitida y la razón>.
NotFound No encontrado (404) Mensaje de error General no encontrado.
ResourceNotFound No encontrado (404) No se encontró el recurso <> solicitado.
InternalServerError Error interno del servidor (500) Si no hay ningún mensaje de error, vuelva a intentar la operación. Póngase en contacto con Microsoft si no se resuelve.

Ejemplos

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

Parámetros de cuerpo

Importante

Los parámetros del cuerpo distinguen mayúsculas de minúsculas.

Si experimenta un error InvalidRequestBody o MissingRequiredParameter , puede deberse a un error tipográfico. Revise la documentación de la API y compruebe que los parámetros enviados coinciden con el ejemplo pertinente.

Identificador de seguimiento

Cada respuesta de error contiene un parámetro de identificador único para el seguimiento. El nombre de propiedad de este parámetro es target. Si se pone en contacto con Microsoft sobre un error, adjuntar el identificador de seguimiento ayuda a Microsoft a encontrar la causa principal del problema.

Sugerencia

¿Desea obtener más información? Engage con la comunidad de seguridad de Microsoft en nuestra comunidad tecnológica: Microsoft Defender XDR Tech Community.