Respuestas de error de Microsoft Graph y tipos de recursos
Los errores de Microsoft Graph se devuelven mediante códigos de estado HTTP estándar y un objeto de respuesta de error JSON.
Códigos de estado HTTP
La siguiente tabla enumera y describe los códigos de estado HTTP que se pueden devolver.
| Código de estado | Mensaje de estado | Descripción |
|---|---|---|
| 400 | Solicitud incorrecta (Bad Request) | No se puede procesar la solicitud porque tiene un formato incorrecto o incorrecto. |
| 401 | No autorizado (Unauthorized) | La información de autenticación requerida no se encuentra o no es válida para el recurso. |
| 402 | Pago requerido | No se han cumplido los requisitos de pago de la API. |
| 403 | Prohibido | Se denegó el acceso al recurso solicitado. Es posible que el usuario no tenga suficiente permiso o que no tenga una licencia necesaria. Importante: Si se aplican directivas de acceso condicional a un recurso, se puede devolver un HTTP 403; Forbidden error=insufficient_claims mensaje. Para obtener más información sobre Microsoft Graph y el acceso condicional, consulte Guía para desarrolladores para Microsoft Entra acceso condicional. |
| 404 | No encontrado (Not Found) | El recurso solicitado no existe. |
| 405 | Método no permitido (Method Not Allowed) | El método HTTP de la solicitud no se permite en el recurso. |
| 406 | No es aceptable (Not Acceptable) | Este servicio no es compatible con el formato solicitado en el encabezado Accept. |
| 409 | Conflict | El estado actual entra en conflicto con lo que la solicitud espera. Por ejemplo, la carpeta principal especificada podría no existir. |
| 410 | Pasado (Gone) | El recurso solicitado ya no está disponible en el servidor. |
| 411 | Longitud requerida (Length Required) | Se requiere un encabezado Content-Length en la solicitud. |
| 412 | Error de condición previa (Precondition Failed) | Una condición previa proporcionada en la solicitud (como un encabezado if-match) no coincide con el estado actual del recurso. |
| 413 | Entidad de solicitud demasiado grande (Request Entity Too Large) | El tamaño de la solicitud supera el límite máximo. |
| 415 | Tipo de medio no compatible (Unsupported Media Type) | El tipo de contenido de la solicitud es un formato que no es compatible con el servicio. |
| 416 | El rango solicitado no se cumple (Requested Range Not Satisfiable) | El rango de bytes especificado no es válido o no está disponible. |
| 422 | Entidad no procesable (Unprocessable Entity) | No se puede procesar la solicitud porque es semánticamente incorrecta. |
| 423 | Bloqueado | El recurso al que está accediendo está bloqueado. |
| 429 | Demasiadas solicitudes (Too Many Requests) | La aplicación cliente se ha limitado y no debe intentar repetir la solicitud hasta que haya transcurrido un período de tiempo. |
| 500 | Error interno del servidor (Internal Server Error) | Se produjo un error interno del servidor al procesar la solicitud. |
| 501 | No implementado (Not Implemented) | La característica solicitada no se implementó. |
| 503 | Servicio no disponible | El servicio no está disponible temporalmente por mantenimiento o está sobrecargado. Puede repetir la solicitud después de un retraso, la longitud de los cuales puede especificarse en un encabezado Retry-After. |
| 504 | Tiempo de espera de puerta de enlace (Gateway Timeout) | El servidor, mientras actúa como proxy, no recibió una respuesta oportuna del servidor ascendente al que necesitaba acceder al intentar completar la solicitud. |
| 507 | Almacenamiento insuficiente (Insufficient Storage) | Se ha alcanzado la cuota de almacenamiento máxima. |
| 509 | Ha superado el límite de ancho de banda | Su aplicación se ha limitado por superar el extremo máximo de ancho de banda. Su aplicación puede reintentar la solicitud de nuevo cuando haya transcurrido más tiempo. |
La respuesta de error es un solo objeto JSON que contiene una propiedad única denominada error. Este objeto incluye todos los detalles del error. Puede usar la información devuelta aquí en lugar o además del código de estado HTTP. A continuación se muestra un ejemplo de un cuerpo completo de error JSON.
{
"error": {
"code": "badRequest",
"message": "Uploaded fragment overlaps with existing data.",
"innerError": {
"code": "invalidRange",
"request-id": "request-id",
"date": "date-time"
}
}
}
Tipo de recurso de error
El recurso de error se devuelve cuando se produce un error en el procesamiento de una solicitud.
Las respuestas de error siguen la definición de las directrices de la API REST de Microsoft.
Representación JSON
El recurso de error se compone de un único recurso:
{
"error": {
"code": "string",
"message": "string",
"innererror": {
"code": "string"
},
"details": []
}
}
| Nombre de la propiedad | Valor | Descripción |
|---|---|---|
| code | cadenas | Una cadena de código de error para el error que se ha producido |
| message | string | Mensaje listo para desarrolladores sobre el error que se produjo. Esto no debe mostrarse directamente al usuario. |
| innererror | objeto error | Opcional. Un objeto de error adicional que podría ser más específico que el error de nivel superior. |
| details | error object | Opcional. Lista de objetos de error adicionales que podrían proporcionar un desglose de varios errores encontrados al procesar la solicitud. |
Propiedades
La propiedad de código contiene un valor legible por la máquina en el que puede tomar una dependencia en el código.
El objeto innererror podría contener de forma recursiva más objetos innererror con propiedades de códigos de error adicionales más específicas. Al controlar un error, las aplicaciones deben recorrer en bucle todos los códigos de error anidados que están disponibles y usar el más detallado que comprendan.
La propiedad message es un valor legible que describe la condición de error. No dependa del contenido de este valor en el código.
La propiedad message de la raíz contiene un mensaje de error diseñado para que el desarrollador lea. Los mensajes de error no se localizan y no deben mostrarse directamente al usuario. Al controlar los errores, el código no debe depender de los valores de propiedad del mensaje porque pueden cambiar en cualquier momento y suelen contener información dinámica específica de la solicitud con errores. Solo debe codificar en los códigos de error devueltos en las propiedades de código .
La propiedad details es una matriz opcional de objetos de error que tienen el mismo formato JSON que el objeto de error de nivel superior. En el caso de una solicitud que se compone de varias operaciones, como una operación masiva o por lotes, podría ser necesario devolver un error independiente para cada operación. En este caso, la lista de detalles se rellena con estos errores individuales.