Ler em inglês

Compartilhar via


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

Aplica-se a:

  • Microsoft Defender XDR

Observação

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

Importante

Algumas informações estão relacionadas a produtos pré-lançados que podem ser substancialmente modificados antes de seu lançamento comercial. A Microsoft não faz garantias, expressas ou implícitas, quanto às informações fornecidas aqui.

Os códigos de erro podem ser retornados 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 resolve o problema. A coluna mensagem de erro na seção tabela fornece algumas mensagens de exemplo. O conteúdo das mensagens reais varia de acordo com os fatores que dispararam a resposta. O conteúdo da variável é indicado por colchetes de ângulo (< >) na seguinte tabela:

Códigos de erro

Código de erro Código de status de HTTP Mensagem
BadRequest BadRequest (400) Mensagem de erro de Solicitação Inválida Geral.
ODataError BadRequest (400) Consulta URI <OData inválida o erro específico é especificado>.
InvalidInput BadRequest (400) <Entrada inválida da entrada> inválida.
InvalidRequestBody BadRequest (400) Corpo da solicitação inválido.
InvalidHashValue BadRequest (400) Valor de 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 <a URL> inválida é inválida.
MaximumBatchSizeExceeded BadRequest (400) Tamanho máximo do lote excedido. Recebido: <tamanho do lote recebido>, permitido: {tamanho do lote permitido}.
MissingRequiredParameter BadRequest (400) Parâmetro <o parâmetro> ausente está ausente.
OsPlatformNotSupported BadRequest (400) Plataforma <do sistema operacional não há suporte para a plataforma> do sistema operacional cliente para essa ação.
ClientVersionNotSupported BadRequest (400) <A ação> solicitada tem suporte na versão <do cliente com suporte para versão do cliente e> posterior.
Não Autorizado (Unauthorized) Não autorizado (401) Não Autorizado (Unauthorized)

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

Esse erro pode ocorrer com um token válido, mas permissão insuficiente para a ação.
DisabledFeature Proibido (403) O recurso de locatário não está habilitado.
DisallowedOperation Proibido (403) <a operação não permitida e o motivo>.
NotFound Não encontrado (404) Mensagem de erro Geral Não Encontrado.
ResourceNotFound Não encontrado (404) Recurso <que o recurso> solicitado não foi encontrado.
InternalServerError Erro interno do servidor (500) Se não houver nenhuma mensagem de erro, tente novamente a operação. Entre em contato com a Microsoft se ela não for resolvida.

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 de corpo

Importante

Os parâmetros do corpo são sensíveis a casos.

Se você tiver um erro InvalidRequestBody ou MissingRequiredParameter , ele poderá ser causado por um erro de digitação. Examine a documentação da API e marcar que os parâmetros enviados correspondam ao exemplo relevante.

ID de acompanhamento

Cada resposta de erro contém um parâmetro de ID exclusivo para acompanhamento. O nome da propriedade desse parâmetro é destino. Se você entrar em contato com a Microsoft sobre um erro, anexar sua ID de rastreamento ajudará a Microsoft a encontrar a causa raiz do problema.

Dica

Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft em nossa Comunidade Tecnológica: Microsoft Defender XDR Tech Community.