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ó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. |
{
"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"
}
}
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.
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.
- Usar a API de segurança do Microsoft Graph – Microsoft Graph | Microsoft Learn
- visão geral das APIs Microsoft Defender XDR
- APIs do Microsoft Defender XDR com suporte
- Acessar as APIs Microsoft Defender XDR
- Saiba mais sobre limites de API e licenciamento
Dica
Você deseja aprender mais? Engage com a comunidade de Segurança da Microsoft em nossa Comunidade Tecnológica: Microsoft Defender XDR Tech Community.