Compartilhar via


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

Este artigo descreve códigos de erro retornados pelas pastas de trabalho e gráficos APIs 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, confira 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, confira Respostas de erro e tipos de recurso do Microsoft Graph.

Códigos e mensagens de erro

A tabela a seguir lista os códigos de erro e as mensagens 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 O recurso não pôde ser encontrado.
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 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 internos aninhados doError . 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, confira Exemplos opcionais de código de erro de segundo nível.

Observação

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