Códigos de error para las API de libros y gráficos

  • Artículo

En este artículo se describen los códigos de error que devuelven los libros y las API de gráficos en Microsoft Graph cuando se produce un error en una solicitud enviada a través de estas API. Para obtener más información sobre el control de respuestas de errores de libros y API de gráficos en Microsoft Graph, vea Control de errores para las API de Excel en Microsoft Graph. Para obtener más información sobre las respuestas de error y los tipos de recursos en Microsoft Graph, consulte Respuestas de error y tipos de recursos de Microsoft Graph.

Códigos de error y mensajes

En la tabla siguiente se enumeran los códigos de error y los mensajes actuales. El servicio puede agregar nuevos códigos de error en cualquier momento.

Código de estado Código de error Mensaje de error
400 badRequest La solicitud es incorrecta o tiene un formato no válido.
401 unauthorized El autor de la llamada no se autentica.
403 forbidden El autor de la llamada no tiene permiso para realizar la acción.
404 notFound No se encontró el recurso.
405 methodNotAllowed El método HTTP de la solicitud no se permite en el recurso.
409 conflict El estado actual entra en conflicto con lo que la solicitud espera.
413 payloadTooLarge El tamaño de la solicitud supera el límite máximo.
429 tooManyRequests Se ha limitado la aplicación o el usuario.
500 internalServerError Error interno del servidor al procesar la solicitud.
501 notImplemented La característica solicitada no se implementó.
502 badGateway El servidor encontró un error temporal y no pudo completar la solicitud.
503 serviceUnavailable El servicio no está disponible. Vuelva a intentar la solicitud.
504 gatewayTimeout El servidor, mientras actúa como proxy, no recibió una respuesta oportuna del servidor ascendente para completar la solicitud.

Códigos de error detallados

A continuación se muestran los códigos de error necesarios que la aplicación podría encontrar en el primer nivel de objetos innerError anidados. El servicio puede agregar nuevos códigos de error en cualquier momento.

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

Para obtener ejemplos de códigos de error opcionales en el primer nivel de objetos innerErroranidados, consulte Ejemplos opcionales de código de error de segundo nivel.

Nota:

El objeto innerError podría contener de forma recursiva objetos innerError más profundos con códigos de error adicionales más específicos. Estos códigos innerError más profundos están pensados solo para fines de diagnóstico.

Contenido relacionado