Compartilhar via


Códigos de erro para APIs de livros e gráficos

Este artigo descreve os códigos de erro que são devolvidos pelas APIs de livros e gráficos no Microsoft Graph quando um pedido enviado através destas APIs falha. Para obter detalhes sobre como lidar com respostas de erros de APIs de livros e gráficos no Microsoft Graph, veja Processamento de erros para APIs do Excel no Microsoft Graph. Para obter mais informações sobre respostas a erros e tipos de recursos no Microsoft Graph, veja Respostas de erro e tipos de recursos do Microsoft Graph.

Códigos de erro e mensagens

A tabela seguinte lista os códigos de erro e mensagens atuais. O serviço pode adicionar novos códigos de erro em qualquer altura.

Código de Estado Código do erro Mensagem de erro
400 badRequest A solicitação está incorreta ou foi mal formada.
401 unauthorized O autor da chamada não está autenticado.
403 forbidden O chamador não tem permissão para executar a ação.
404 notFound Não foi possível localizar o recurso.
405 methodNotAllowed O método HTTP no pedido não é permitido no recurso.
409 conflict O estado atual está em conflito com o que a solicitação espera.
413 payloadTooLarge O tamanho da solicitação excede o limite máximo.
429 tooManyRequests O aplicativo ou o usuário foi restringido.
500 internalServerError Ocorreu um erro interno do servidor ao processar o pedido.
501 notImplemented O recurso solicitado não foi implementado.
502 badGateway O servidor encontrou um erro temporário e não conseguiu concluir o pedido.
503 serviceUnavailable O serviço não está disponível. Tente novamente o seu pedido.
504 gatewayTimeout O servidor, enquanto atuava como proxy, não recebeu uma resposta atempadamente do servidor upstream para concluir o pedido.

Códigos de erro detalhados

Seguem-se os códigos de erro necessários que a sua aplicação pode encontrar no primeiro nível de objetos innerError aninhados. O serviço pode adicionar novos códigos de erro em qualquer altura.

  • accessConflict
  • badRequestUncategorized
  • conflictUncategorized
  • forbiddenUncategorized
  • gatewayTimeoutUncategorized
  • internalServerErrorUncategorized
  • invalidSessionAccessConflict
  • invalidSessionAuthentication
  • invalidSessionNotFound
  • invalidSessionReCreatable
  • invalidSessionRestricted
  • invalidSessionUnexpected
  • invalidSessionUnsupportedWorkbook
  • methodNotAllowedUncategorized
  • notFoundUncategorized
  • notImplementedUncategorized
  • payloadTooLargeUncategorized
  • serviceUnavailableUncategorized
  • tooManyRequestsUncategorized
  • transientFailure
  • unauthorizedUncategorized
  • unsupportedWorkbook

Para obter exemplos de códigos de erro opcionais no primeiro nível de objetos innerError aninhados, veja Exemplos opcionais de código de erro de segundo nível.

Observação

O objeto innerError pode conter recursivamente objetos innerError mais profundos com códigos de erro adicionais e mais específicos. Estes códigos innerError mais profundos destinam-se apenas a diagnóstico finalidade.