Guía sobre la limitación | Conceptos de la API Graph
Importante
Se recomienda encarecidamente que utilice Microsoft Graph en lugar de la API de Azure AD Graph para tener acceso a recursos de Azure Active Directory. Nuestros esfuerzos de desarrollo se concentran ahora en Microsoft Graph y no están previstas mejoras adicionales para la API de Azure AD Graph. Hay un número muy limitado de escenarios para los que la API de Azure AD Graph todavía podría ser adecuada; para más información, vea la entrada del blog Microsoft Graph o Azure AD Graph en el centro de desarrollo de Office.
¿Qué es la limitación?
La limitación establece un tope en el número de llamadas simultáneas a un servicio para evitar el uso excesivo de recursos. Azure Active Directory (AD) Graph está diseñado para administrar un volumen muy alto de solicitudes. En el caso de un número gigantesco de solicitudes, la limitación ayuda a mantener el rendimiento óptimo y la confiabilidad del servicio Azure AD Graph.
Los límites establecidos varían según el escenario. Por ejemplo, si va a realizar un gran número de escrituras en el inquilino, la posibilidad de limitación es mayor que si solo realiza lecturas.
¿Qué ocurre cuando tiene lugar la limitación?
Cuando se sobrepasa un umbral de limitación, Azure AD Graph limita las solicitudes cliente adicionales mientras la limitación está vigente. Cuando se aplica la limitación, Azure AD Graph devuelve el código de estado HTTP 429 ("Demasiadas solicitudes") y la solicitud da error. El comportamiento de limitación puede depender del tipo y el número de solicitudes. Por ejemplo, si tiene un volumen muy elevado de solicitudes, se limitan todos los tipos de solicitudes. Los límites del umbral pueden variar en función del tipo de solicitud. Por lo tanto, podría encontrar un escenario donde se limitan escrituras pero todavía se permiten lecturas.
Escenarios comunes de limitación
Las causas más comunes de la limitación de los clientes son:
- Un gran número de solicitudes en todas las aplicaciones de un inquilino.
- Un gran número de solicitudes de una aplicación determinada en todos los inquilinos.
Procedimientos recomendados para tratar con las limitaciones
- Reducir el número de operaciones por solicitud.
- Reducir la frecuencia de llamadas.
- Cuando una solicitud genere un código de error HTTP 429, espere el número de segundos especificado en el campo de encabezado de respuesta Retry-After y reintente la solicitud.
Al implementar el control de errores, use el código de error HTTP 429 para detectar la limitación. La respuesta con error incluirá el campo Retry-After en el encabezado de respuesta.
- Espere el número de segundos especificado en el campo Retry-After.
- Vuelva a intentarlo.
- Si la solicitud vuelve a dar error con un código de error 429, significa que se le están aplicando limitaciones. Continúe usando el retraso de Retry-After recomendado y reintente la solicitud hasta que tenga éxito.
La manera más rápida de recuperarse de la limitación es interrumpir las solicitudes mediante el retraso Retry-After ya que AAD Graph sigue registrando el uso de recursos mientras se limita a un cliente. Puesto que todas las solicitudes se acumulan contra los límites de uso, debe evitar intentos inmediatos.
Para obtener una explicación más amplia de la limitación en Microsoft Cloud, consulte Throttling Pattern (Patrón de limitación).