Partilhar via

Códigos de erro comuns da API REST Microsoft Defender XDR

  • Artigo

Aplica-se a:

  • Microsoft Defender XDR

Nota

Experimente as nossas novas APIs com a API de segurança do MS Graph. Saiba mais em: Utilizar a API de segurança do Microsoft Graph – Microsoft Graph | Microsoft Learn.

Importante

Algumas informações estão relacionadas com o produto pré-lançado que pode ser substancialmente modificado antes de ser lançado comercialmente. A Microsoft não oferece garantias, expressas ou implícitas, em relação às informações aqui fornecidas.

Os códigos de erro podem ser devolvidos por uma operação em qualquer uma das APIs Microsoft Defender XDR. Cada resposta de erro contém uma mensagem de erro, que pode ajudar a resolver o problema. A coluna de mensagem de erro na secção de tabela fornece algumas mensagens de exemplo. O conteúdo das mensagens reais varia com base nos fatores que acionaram a resposta. O conteúdo variável é indicado por parênteses angulares (< >) na tabela seguinte:

Códigos de erro

Código de erro Código de estado HTTP Mensagem
BadRequest BadRequest (400) Mensagem de erro Pedido Incorreto Geral.
ODataError BadRequest (400) Consulta OData URI <inválida> a especificação do erro específico.
InvalidInput BadRequest (400) <Entrada inválida a entrada> inválida.
InvalidRequestBody BadRequest (400) Corpo do pedido inválido.
InvalidHashValue BadRequest (400) Valor <hash o hash> inválido é inválido.
InvalidDomainName BadRequest (400) Nome <de domínio o domínio> inválido é inválido.
InvalidIpAddress BadRequest (400) Endereço <IP o IP> inválido é inválido.
InvalidUrl BadRequest (400) URL <o URL> inválido é inválido.
MaximumBatchSizeExceeded BadRequest (400) Tamanho máximo do lote excedido. Recebido: <tamanho do lote recebido>, permitido: {tamanho do lote permitido}.
MissingRequiredParameter BadRequest (400) O parâmetro <> em falta está em falta.
OsPlatformNotSupported BadRequest (400) Plataforma <do SO a Plataforma> de SO cliente não é suportada para esta ação.
ClientVersionNotSupported BadRequest (400) <A ação> pedida é suportada na versão do cliente suportada pela versão <> do cliente e posterior.
Não autorizado Não autorizado (401) Não autorizado

Normalmente, este erro é causado por um cabeçalho de autorização inválido ou expirado.
Proibido Proibido (403) Proibido

Este erro pode ocorrer com um token válido, mas com permissão insuficiente para a ação.
DisabledFeature Proibido (403) A funcionalidade de inquilino não está ativada.
DisallowedOperation Proibido (403) <a operação não permitida e o motivo>.
NotFound Não Encontrado (404) Mensagem de erro Geral Não Encontrada.
ResourceNotFound Não Encontrado (404) Recurso <no qual o recurso> pedido não foi encontrado.
InternalServerError Erro interno do Servidor (500) Se não existir nenhuma mensagem de erro, repita a operação. Contacte a Microsoft se não for resolvido.

Exemplos

{
    "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 do corpo

Importante

Os parâmetros do corpo são sensíveis às maiúsculas e minúsculas.

Se ocorrer um erro InvalidRequestBody ou MissingRequiredParameter , este poderá ser causado por um erro de digitação. Reveja a documentação da API e verifique se os parâmetros submetidos correspondem ao exemplo relevante.

ID de Controlo

Cada resposta de erro contém um parâmetro de ID exclusivo para controlo. O nome da propriedade deste parâmetro é destino. Se contactar a Microsoft sobre um erro, anexar o seu ID de controlo ajuda a Microsoft a encontrar a causa principal do problema.

Sugestão

Quer saber mais? Interaja com a comunidade do Microsoft Security na nossa Tech Community: Microsoft Defender XDR Tech Community.