Códigos de erro para APIs de pastas de trabalho e gráficos

Este artigo descreve códigos de erro retornados pelas APIs de pastas de trabalho e gráficos no Microsoft Graph quando uma solicitação enviada por essas APIs falha. Para obter detalhes sobre como lidar com respostas de erro de APIs de pastas de trabalho e gráficos no Microsoft Graph, consulte Tratamento de erros para APIs do Excel no Microsoft Graph. Para obter mais informações sobre respostas de erro e tipos de recursos no Microsoft Graph, consulte Tipos de recursos e respostas de erro do Microsoft Graph.

Mensagens e códigos de erro

A tabela a seguir lista as mensagens e códigos de erro atuais. O serviço pode adicionar novos códigos de erro a qualquer momento.

Código de status Código do erro Mensagem de erro
400 badRequest A solicitação está incorreta ou foi mal formada.
401 unauthorized O chamador não é autenticado.
403 forbidden O chamador não tem permissão para executar a ação.
404 notFound Não foi possível encontrar o recurso.
405 methodNotAllowed O método HTTP na solicitação 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 durante o processamento da solicitação.
501 notImplemented O recurso solicitado não foi implementado.
502 badGateway O servidor encontrou um erro temporário e não pôde concluir sua solicitação.
503 serviceUnavailable O serviço não está disponível. Tente sua solicitação novamente.
504 gatewayTimeout O servidor, enquanto atuava como um proxy, não recebeu uma resposta oportuna do servidor upstream para concluir a solicitação.

Códigos de erro detalhados

A seguir estão os códigos de erro necessários que seu aplicativo pode encontrar no primeiro nível de objetos innerError aninhados. O serviço pode adicionar novos códigos de erro a qualquer momento.

  • 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, consulte Exemplos de código de erro opcionais de segundo nível.

Observação

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