Evitar las limitaciones o los bloqueos en SharePoint Online

Obtenga información acerca de la limitación en SharePoint Online y aprenda a evitar quedar limitado o bloqueado.

• ¿Qué es una limitación?
• ¿Cómo controlar las limitaciones?
• Escenarios comunes de limitación en SharePoint Online
• Límites específicos del escenario
• ¿Qué debe hacer si se quedara bloqueado en SharePoint Online ?
• Recursos adicionales

¿Hace a esto les resulta familiar? Está ejecutando una aplicación, por ejemplo, para escanear archivos en SharePoint, pero le limitan. O peor aún, le bloquean. ¿Lo que está ocurriendo y qué puede hacer para que sea detener?

¿Qué es una limitación?

SharePoint Online utiliza la limitación para mantener el rendimiento y la confiabilidad óptimos del servicio SharePoint Online. La limitación limita el número de llamadas u operaciones de API dentro de una ventana de tiempo para evitar el uso excesivo de recursos.

¿Qué sucede cuando obtener reducidas en SharePoint Online ?

Cuando se superan los límites de uso, SharePoint Online limita las solicitudes de ese cliente durante un breve periodo.

Para las solicitudes que realiza un usuario directamente en el explorador, SharePoint Online lo redirige a la página de información de limitación y se producirá un error en las solicitudes.

Para las solicitudes que realiza una aplicación, incluidas las llamadas de Microsoft Graph, CSOM o REST, SharePoint Online devuelve el código de estado HTTP 429 ("demasiadas solicitudes") o 503 ("Servidor demasiado ocupado") y se producirá un error en las solicitudes.

• HTTP 429 indica que la aplicación que realiza la llamada envió demasiadas solicitudes en un periodo de tiempo y superó un límite predeterminado.
• HTTP 503 indica que el servicio no está listo para controlar la solicitud. La causa común es que el servicio está experimentando picos de carga más temporales.

En ambos casos, se incluye un Retry-After encabezado en la respuesta que indica cuánto tiempo debe esperar la aplicación que llama antes de volver a intentar o realizar una nueva solicitud. Las solicitudes limitadas cuentan para los límites de uso, por lo que no respetar el Retry-After puede resultar en un aumento de la limitación.

Si la aplicación infractora sigue superando los límites de uso, SharePoint Online puede bloquear completamente la aplicación o patrones de solicitud específicos de la aplicación. En este caso, la aplicación seguirá obteniendo el código de estado HTTP 503 y Microsoft notificará al inquilino del bloque en el Centro de mensajes de Office 365.

Uso máximo o Off-Peak

La limitación y/o la ralentización del rendimiento tienen una mayor tendencia a producirse durante las horas punta que las horas valle para grandes cantidades de llamadas y/o utilización del ancho de banda. Esto se hace para ayudar a proteger el servicio y garantizar la confiabilidad para los usuarios finales. Las horas valle suelen ser las noches y los fines de semana en la zona horaria de tu región. El lugar donde se configura el inquilino de SharePoint determina la zona horaria de su región.

Unidades de recursos

Algunos límites se miden en términos de costos de API. Las API de Microsoft Graph tienen un costo unitario de recurso predeterminado por solicitud:

Limitación de peticiones de usuarios

La limitación limita el número de llamadas y operaciones que realizan colectivamente las aplicaciones en nombre de un usuario para evitar el uso excesivo de recursos.

Sin embargo, es raro que un usuario reciba limitaciones en SharePoint Online. El servicio es sólido y está diseñado para trabajar con un alto volumen. Si se ve limitado, el 99 % de las veces es debido a código personalizado, como elementos web personalizados, vistas de lista complejas y consultas, o aplicaciones personalizadas que ejecutan los usuarios. Esto no significa que no haya otros modos de recibir limitaciones, solo que son menos comunes. Por ejemplo, un usuario que sincronizando una gran cantidad de datos en 10 máquinas al mismo tiempo podría desencadenar la limitación.

Limitación de inquilinos

Algunos límites se aplican en el nivel de inquilino para garantizar que las operaciones colectivamente no usen recursos en exceso.

Cuando un cliente habilita la multigeográfica, cada ubicación geográfica obtiene sus propios límites (medida de uso no compartida entre geografías). Para los límites que dependen del recuento de licencias, se usa el recuento total de licencias de usuario de inquilino (usuarios totales en todas las ubicaciones).

Limitación de aplicación

Además de la limitación por cuenta de usuario, también se limitan las aplicaciones de un inquilino.

Cada aplicación tiene sus propios límites en un inquilino, basados en el número de licencias compradas por organización (consulte los planes enumerados en Límites de SharePoint para ver las licencias incluidas). Cada solicitud que realiza una aplicación en todos los puntos de conexión de API, incluidos Microsoft Graph, CSOM y REST, cuenta para el uso de la aplicación.

SharePoint proporciona varias API. Las distintas API tienen costos diferentes en función de la complejidad de la API. SharePoint normaliza el costo de las API y lo expresa en unidades de recursos. Los límites de aplicación también se definen mediante unidades de recursos.

Para aplicaciones multiinquilino:

1. Cada inquilino que hospeda la aplicación se considera distinto, y opera independientemente de los demás. Por lo tanto, cada aplicación está sujeta a sus propios límites de uso dentro de cada inquilino, tal como se ha definido anteriormente.
2. El consumo de unidades de recursos por parte de la aplicación debe medirse por inquilino y por aplicación. Esto garantiza que cada par de inquilino-aplicación permanezca dentro de los límites de recursos permitidos especificados para ese inquilino en particular.
3. Si la aplicación alcanza su límite de recursos dentro de un inquilino, esto no afectará a otras instancias de la aplicación que operan en diferentes inquilinos. La utilización de recursos de cada inquilino está aislada, lo que evita el impacto entre inquilinos.

Microsoft se reserva el derecho de reducir los límites de uso no remunerado y sin licencia.

Otros límites

¿Cómo controlar las limitaciones?

A continuación se muestra un resumen rápido de los procedimientos recomendados para controlar las limitaciones:

• Reduzca el número de solicitudes
• Evite picos de solicitudes
• Elija las API de Microsoft Graph sobre las API de CSOM y REST cuando sea posible
• Use los encabezados HTTP Retry-After y RateLimit
• Decora tu tráfico para que sepamos quién eres (consulta la sección sobre las mejores prácticas de decoración de tráfico, más sobre eso a continuación)
• Considere la posibilidad de usar Graph Data Connect para SharePoint para análisis de sitios amplios
• Comprender si la priorización de servicios en SharePoint es la opción adecuada para su escenario

Como se indicó anteriormente, Microsoft Graph son API nacidas en la nube que tienen las últimas mejoras y optimizaciones. En general, Microsoft Graph consume menos recursos que CSOM y REST para lograr la misma funcionalidad. Por lo tanto, la adopción de Microsoft Graph puede mejorar el rendimiento de la aplicación y reducir el límite.

Si se encuentra con una limitación, es necesario usar el Retry-After encabezado HTTP para garantizar un retraso mínimo hasta que se quite la limitación. Los RateLimit encabezados HTTP le envían señales tempranas cuando está cerca de los límites y puede reducir las solicitudes de manera proactiva para evitar presionar el acelerador.

Delta con un token es la forma más eficaz de examinar contenido en SharePoint y hablamos más detalladamente de los procedimientos recomendados para analizar aplicaciones. Para ayudar a las aplicaciones que sigan las instrucciones, reducimos el costo en unidades de recursos de las solicitudes delta con un token a 1 unidad de recurso, aunque se trate de una consulta de varios elementos. La solicitud delta sin un token se considera una consulta de varios elementos y cuesta 2 unidades de recursos por solicitud.

En el procesamiento por lotes, las solicitudes en un lote son evaluadas individualmente en unidades de recursos.

CSOM y REST no tienen un costo unitario de recurso predeterminado y, por lo general, consumen más unidades de recursos que las API de Microsoft Graph para lograr la misma funcionalidad. Además de los límites de unidades de recursos, CSOM y REST también están sujetos a otros límites de recursos internos, por lo que si las aplicaciones llaman a CSOM y REST, pueden experimentar más limitaciones que los límites descritos en este documento. Le recomendamos encarecidamente que elija las API de Microsoft Graph en lugar de las API de CSOM y REST cuando sea posible.

Dado que los límites de las aplicaciones se expresan en unidades de recursos, la frecuencia real de solicitudes, como las solicitudes por minuto, depende de la elección de la API de la aplicación y del costo por unidad de recurso de la API correspondiente. En general, puede estimar la tasa de solicitudes usando un promedio de 2 unidades de recursos por solicitud y dividir los límites de unidades de recursos por 2 para obtener la tasa de solicitudes estimada.

Aunque cada aplicación tiene sus límites dentro de un inquilino y permitimos que los inquilinos ejecuten más de una aplicación, varias aplicaciones que se ejecutan en el mismo inquilino comparten el mismo cubo de recursos y, en raras ocasiones, pueden causar una limitación de velocidad cuando demasiadas aplicaciones envían solicitudes a la vez.

Encabezado Retry-after

Cuando las aplicaciones experimentan limitaciones, SharePoint Online devuelve un encabezado HTTP Retry-After en la solicitud que indica cuántos segundos debe esperar la aplicación que realiza la llamada antes de reintentar o realizar una nueva solicitud.

Respetar el encabezado HTTP Retry-After es la manera más rápida de controlar las limitaciones, ya que SharePoint Online determina de forma dinámica el momento adecuado para volver a intentarlo.

Las solicitudes limitadas cuentan para los límites de uso, por lo que no respetar el Retry-After puede resultar en un aumento de la limitación. En otras palabras, los reintentos agresivos van en contra de las aplicaciones de llamada porque, aunque las llamadas fallen, siguen contando para los límites de uso. Respetar el encabezado HTTP Retry-After garantiza el retraso más corto y reduce el derroche de la cuota en solicitudes limitadas.

Encabezados RateLimit

SharePoint Online no devuelve ni admite IETF RateLimit encabezados. Aunque otros servicios pueden usar estos encabezados, las aplicaciones no deben depender de ellos para SharePoint Online y, en su lugar, deben respetar el encabezado cuando se produce una Retry-After limitación.

¿Cómo decorar tu tráfico HTTP?

El tráfico correctamente decorado tendrá prioridad sobre el tráfico que no lo esté.

¿Cuál es la definición de tráfico no decorado?

• El tráfico es no decorado si no hay ninguna cadena de agente de usuario ni AppID/AppTitle en las llamadas de las API a SharePoint Online. La cadena User-Agent debe tener un formato específico, como se describe a continuación.
• Si está desarrollando una aplicación web que se ejecuta en el explorador, la mayoría de los exploradores modernos no permiten sobrescribir la cadena del agente de usuario y no es necesario implementarla.

¿Cuáles son las recomendaciones?

• Si ha creado una aplicación, se recomienda registrar y utilizar AppID y AppTitle: esto asegurará una mejor experiencia general y una mejor ruta para solucionar cualquier problema en el futuro. Incluya también la información de cadena del agente de usuario tal y como se define en el paso siguiente.

  Nota:

  Consulte la documentación de identidad de Microsoft, como la página Inicio rápido: Registrar una aplicación en la plataforma de identidad de Microsoft para obtener información sobre cómo crear una aplicación de Azure AD.

• Asegúrese de incluir la cadena User-Agent en la llamada API a SharePoint con la siguiente convención de nomenclatura

• Si va a crear sus propias bibliotecas de JavaScript, que se usan para llamar a las API de SharePoint Online, asegúrese de incluir la información User-Agent en la solicitud HTTP y, potencialmente, registre la aplicación web también como una aplicación, si corresponde.

Escenarios comunes de limitación en SharePoint Online

Las causas más comunes de limitación en SharePoint Online por usuario son el modelo de objetos de cliente (COM) o código de Representational State Transfer (REST) que realiza acciones demasiados con demasiada frecuencia.

• Tráfico esporádico

  La carga constante o las consultas repetitivas complejas en SharePoint Online deben ser optimizadas para conseguir un bajo impacto. Si no sigue los procedimientos recomendados para el análisis de aplicaciones que procesan archivos en masa probablemente tendrá como resultado una limitación. Estas aplicaciones incluyen motores de sincronización, proveedores de copias de seguridad, indexadores de búsqueda, motores de clasificación, herramientas de prevención de pérdida de datos y cualquier otra herramienta que intente razonar sobre la totalidad de los datos y aplicarles cambios.

• Tráfico abrumador

  Un solo proceso supera drásticamente los límites de limitación, de forma continua, durante un período prolongado.

  • Usa los servicios web para crear una herramienta para sincronizar las propiedades de perfil de usuario. La herramienta actualiza las propiedades de perfil de usuario según la información de su sistema de recursos humanos (HR) de línea de negocio (LOB). La herramienta realiza llamadas en demasiado alta frecuencia.
  • Ejecuta un script de prueba de carga en SharePoint Online y experimenta limitaciones. Las pruebas de carga no están permitidas en SharePoint Online.
  • Personalizar el sitio de grupo en SharePoint Online, por ejemplo, mediante la adición de un indicador de estado en la página principal. Este indicador de estado se actualiza con frecuencia, lo que hace que la página realizar llamadas demasiados al servicio SharePoint Online: Esto desencadena la limitación de peticiones.
  • La ejecución del cliente OneDrive Sync al mismo tiempo que se ejecutan aplicaciones de migración o aplicaciones que rastrean sitios y escriben datos puede generar grandes volúmenes de solicitudes que pueden desencadenar limitaciones.

• Casos de uso no admitidos

  El uso no admitido de SharePoint Online puede dar lugar a una limitación. El uso de SharePoint y OneDrive como servicio intermedio entre Microsoft 365 y otro repositorio es un ejemplo de un caso de uso no admitido.

• Crear varios AppID para la misma aplicación

  No cree AppID independientes en las que las aplicaciones realizan esencialmente las mismas operaciones, como por ejemplo copias de seguridad o prevención de pérdida de datos. Las aplicaciones que se ejecutan en el mismo espacio empresarial comparten en última instancia los mismos recursos que el espacio empresarial. En el pasado, algunas aplicaciones han intentado este enfoque para evitar el límite de las aplicaciones, pero han acabado agotando los recursos del inquilino y provocando que se limiten varias aplicaciones en el inquilino.

Límites específicos del escenario

Al usar la autenticación de solo aplicación con el permiso Sites.Read.All

Si usa las API de búsqueda de SharePoint Online con autenticación de solo aplicación y la aplicación tiene el permiso Sites.Read.All (o más fuerte), la aplicación se registrará con permisos completos y podrá consultar todo el contenido de SharePoint Online (incluido el contenido privado de OneDrive para la Empresa del usuario).

Para garantizar que el servicio sigue siendo rápido y fiable, las consultas que usan este permiso se limitan a 25 solicitudes por segundo. La consulta de búsqueda devolverá una respuesta HTTP 429. Al esperar la recuperación de limitación, debe asegurarse de pausar todas las solicitudes de consulta de búsqueda que pueda realizar al servicio con un permiso similar solo para aplicaciones. Realizar llamadas adicionales mientras recibe respuestas de limitación alargará el tiempo que tarda la aplicación en dejar de estar limitada.

Al buscar con permisos de usuario delegados

La búsqueda con permisos de usuario delegados se produce cuando una aplicación envía una solicitud de consulta de búsqueda con los permisos del usuario con la sesión iniciada. A continuación puede ver algunos ejemplos de solicitudes delegadas: el cuadro de búsqueda de una página de SharePoint, un elemento web basado en búsquedas o una aplicación personalizada incrustada en una página de SharePoint y un flujo de trabajo de Power Automate que consulta información de elementos.

Para garantizar la estabilidad del servicio, el servicio limitará las solicitudes de usuario delegadas que superen las 10 solicitudes por segundo por usuario. Este límite por usuario se agrega a todas las solicitudes de todas las aplicaciones. Si un único usuario envía más de 10 solicitudes de consulta de búsqueda por segundo, se devuelve un HTTP 429. La aplicación solicitante debe esperar el tiempo de espera especificado en el encabezado de respuesta antes de enviar solicitudes posteriores. Al diseñar aplicaciones basadas en búsquedas, páginas de SharePoint y flujos de trabajo, los implementadores deben asegurarse de que la página y la aplicación no superen las 10 solicitudes por segundo en conjunto y controlen 429 respuestas de limitación. Para obtener más información y orientación sobre el diseño de páginas y la optimización de la búsqueda, vea Optimizar las solicitudes de búsqueda en páginas de sitios modernos de SharePoint Online y Usar la herramienta de diagnóstico de página para SharePoint Online.

Al buscar resultados de búsqueda de personas

Al realizar una búsqueda con un origen de resultados que solicite resultados de personas, es posible limitar las solicitudes que superen un límite de 25 solicitudes por segundo para toda la organización. Este límite se aplica a todas las solicitudes de búsqueda de SharePoint de CSOM y REST con el origen de resultados "Local People Results" listo para usar o un origen de resultado de búsqueda de personas personalizado.

Si tiene aplicaciones o componentes que provocan que se limiten las solicitudes de búsqueda de personas, le recomendamos que:

1. Considere si las solicitudes son necesarias para la aplicación. Por ejemplo, si usa un sitio de búsqueda personalizado que realiza muchas consultas simultáneas, compruebe si algunas de esas solicitudes se pueden quitar sin ningún impacto significativo en la experiencia de búsqueda de su organización. Como alternativa, puede considerar la posibilidad de probar nuestra experiencia de búsqueda de personas moderna en Búsqueda de Microsoft mediante búsquedas desde la página de inicio de SharePoint. La búsqueda de personas en la Búsqueda de Microsoft se ha optimizado para mejorar el rendimiento y obtener resultados más relevantes.
2. Evite realizar solicitudes simultáneas. Por ejemplo, en lugar de emitir 10 solicitudes a la vez, ejelítelas consecutivamente (solo emita la siguiente consulta una vez completada la anterior). Es posible que necesite considerar la posibilidad de almacenar en caché esos resultados si los necesita rápidamente, por ejemplo, para la carga de una página.
3. Intente consolidar las solicitudes en una sola consulta. Por ejemplo, en lugar de realizar 10 consultas simultáneas para WorkEmail:user1@constoso.com, WorkEmail:user2@constoso.com,..., WorkEmail:user10@contoso.com, pruebe la única consulta, WorkEmail:user1@constoso.com WorkEmail:user2@constoso.com ... WorkEmail:user10@contoso.com.
4. Considere la posibilidad de usar la API de Microsoft Graph si realmente es necesario un escenario de gran volumen de solicitudes (más de 25 solicitudes por segundo).

Al obtener acceso a sitios de OneDrive

Cuando un cliente realiza intentos excesivos de obtener acceso a muchas colecciones de sitios de OneDrive que no existen, es posible que limitemos las solicitudes de la dirección IP de ese cliente. El cliente recibirá una respuesta HTTP 429 al obtener acceso a cualquier colección de sitios de OneDrive durante el período de limitación.

Clientes multigeográficos y limitación

Cuando un cliente habilita la limitación, cada uno obtiene sus propios límites (medida de uso no compartida entre geografías). Para los límites que dependen del recuento de licencias, se usa el recuento total de licencias de usuario de inquilino (usuarios totales en todas las ubicaciones).

¿Qué debe hacer si se quedara bloqueado en SharePoint Online ?

El bloqueo es la forma más extrema de limitación. Rara vez bloqueamos un espacio empresarial a menos que detectemos tráfico excesivo a largo plazo que pueda poner en peligro el estado general del servicio SharePoint Online. Se aplican bloqueos para impedir que el tráfico excesivo degrade el rendimiento y la confiabilidad de SharePoint Online. Un bloqueo, que se encuentra en el nivel de la aplicación o del usuario, impide la ejecución del proceso incorrecto hasta que solucione el problema. Si se bloquea su suscripción, debe tomar medidas para modificar los procesos incorrectos, para poder quitar el bloqueo.

Si bloqueamos su suscripción, se lo notificaremos en el Centro de mensajes de Office 365. El mensaje describe la causa del bloqueo, ofrece instrucciones sobre cómo resolver el problema en cuestión y le indica con quién ponerse en contacto para quitar el bloqueo.

Vea también

• Prioridad de servicios en SharePoint
• Diagnosticar problemas de rendimiento con SharePoint Online
• Planeamiento de capacidad y pruebas de carga en SharePoint Online
• Centro de desarrollo de Microsoft Graph
• guía de limitación de Microsoft Graph
• Evitar la limitación en la aplicación mediante encabezados RateLimit en SharePoint Online
• Cuatro opciones para el análisis del sitio