Códigos de erro comuns da API REST

  • Os códigos de erro indicados na seguinte tabela podem ser devolvidos por uma operação em qualquer uma das APIs de Pontos Finais do Microsoft Defender.
  • Para além do código de erro, todas as respostas a erros contêm uma mensagem de erro, que pode ajudar a resolver o problema.
  • A mensagem é um texto gratuito que pode ser alterado.
  • Na parte inferior da página, encontrará exemplos de respostas.

Aplica-se a:

Quer experimentar o Defender para Endpoint? Inscreva-se numa versão de avaliação gratuita.

Código de erro Código de estado HTTP Mensagem
BadRequest BadRequest (400) Mensagem de erro Pedido Geral de Inserção de Erros.
ODataError BadRequest (400) Consulta URI OData inválida (o erro específico é especificado).
InvalidInput BadRequest (400) Entrada inválida {the invalid input}.
InvalidRequestBody BadRequest (400) Corpo de pedido inválido.
InvalidHashValue BadRequest (400) O valor de hash {the invalid hash} é inválido.
InvalidDomainName BadRequest (400) O nome de domínio {the invalid domain} é inválido.
InvalidIpAddress BadRequest (400) O endereço IP {the invalid IP} é inválido.
InvalidUrl BadRequest (400) O URL {the invalid URL} é inválido.
MaximumBatchSizeExceeded BadRequest (400) Tamanho máximo do lote excedido. Recebido: {batch size received}, permitido: {batch size allowed}.
MissingRequiredParameter BadRequest (400) O parâmetro {the missing parameter} está em falta.
OsPlatformNotSupported BadRequest (400) Plataforma do SO {the client OS Platform} não é suportada para esta ação.
ClientVersionNotSupported BadRequest (400) {The requested action} é suportado na versão cliente {supported client version} e superior.
Não Autorizado Não autorizado (401) Não autorizado (cabeçalho de autorização inválido ou expirado).
Proibido Proibido (403) Proibido (token válido mas permissão insuficiente para a ação).
DisabledFeature Proibido (403) A funcionalidade inquilino não está ativada.
DisallowedOperation Proibido (403) {the disallowed operation and the reason}.
NotFound Não Encontrado (404) Mensagem de erro Geral Não Encontrada.
ResourceNotFound Não Encontrado (404) O recurso {the requested resource} não foi encontrado.
InternalServerError Erro Interno do Servidor (500) (Sem mensagem de erro, repetir a operação)
TooManyRequests Demasiados Pedidos (429) A resposta representará o limite de quotas alcançado por número de pedidos ou por CPU.

Os parâmetros do corpo são sensíveis às caixas

Os parâmetros do corpo submetidos são atualmente sensíveis às mesmas.

Se detetar um erro InvalidRequestBody ou MissingRequiredParameter , este pode ser causado por um parâmetro inválido em maiúsculas ou minúsculas.

Reveja a página de documentação da API e verifique se os parâmetros submetidos correspondem ao exemplo relevante.

ID do pedido de correlação

Cada resposta de erro contém um parâmetro ID exclusivo para seguimento.

O nome da propriedade deste parâmetro é "destino".

Ao contactar-nos sobre um erro, anexar este ID irá ajudar a encontrar a causa raiz do problema.

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