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:
- Microsoft Defender para o Plano 1 de Pontos Finais
- Microsoft Defender para o Plano 2 de Pontos Finais
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"
}
}