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.
accessConflictbadRequestUncategorizedconflictUncategorizedforbiddenUncategorizedgatewayTimeoutUncategorizedinternalServerErrorUncategorizedinvalidSessionAccessConflictinvalidSessionAuthenticationinvalidSessionNotFoundinvalidSessionReCreatableinvalidSessionRestrictedinvalidSessionUnexpectedinvalidSessionUnsupportedWorkbookmethodNotAllowedUncategorizednotFoundUncategorizednotImplementedUncategorizedpayloadTooLargeUncategorizedserviceUnavailableUncategorizedtooManyRequestsUncategorizedtransientFailureunauthorizedUncategorizedunsupportedWorkbook
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.