> For the complete documentation index, see [llms.txt](https://docs.konnekt.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.konnekt.io/es/configuration/system-settings/throttling-prevention.md).

# Prevención de limitación de velocidad

**La prevención de limitación de KONNEKT** incluye dos políticas, una "[control de frecuencia de actualización](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" política y una "[limitación de la tasa de solicitudes](/es/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" política diseñada para gestionar y controlar la frecuencia con la que se realizan solicitudes a la API de Microsoft Graph, garantizando que las conexiones a SharePoint Online (SPO) permanezcan estables y funcionen de forma óptima. Estas políticas son especialmente útiles para evitar un uso excesivo de recursos y mantener una experiencia de usuario fluida.

El uso de las API de Microsoft 365 está sujeto a limitaciones en cuanto a la cantidad de solicitudes por unidad de tiempo que una aplicación puede enviar. Si una aplicación consume más recursos, se le aplicará limitación. Puede encontrar más información al respecto en la [la documentación de Microsoft](https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online).

Dado que KONNEKT utiliza la API REST de Microsoft SharePoint Online y la API de Microsoft Graph, puede ocurrir que las API de Microsoft limiten el uso de KONNEKT. Si una aplicación está limitada, la API correspondiente (p. ej., SPO REST API) le indica a KONNEKT que debe esperar un tiempo definido. Esto comienza con unos segundos y puede aumentar hasta minutos, dependiendo del uso. Los efectos para KONNEKT pueden ser una navegación o una carga/escritura de archivos más lentas. Si la limitación se prolonga hasta minutos, dará lugar a mensajes de error que indican que la unidad no está disponible actualmente.

KONNEKT tiene varios mecanismos para reducir la aparición de limitaciones, que se aplican automáticamente.

## Escenarios comunes para la prevención de throttling

### **Escenario 1: cargas de datos de gran volumen o migración de datos**

Cuando un usuario intenta cargar una gran cantidad de archivos a / o realizar una migración de datos dentro de SPO en un corto período, el dispositivo puede alcanzar el límite especificado.

### **Escenario 2: operaciones de lectura intensivas**

Si un usuario realiza operaciones de lectura intensivas, como consultar o buscar en un directorio grande (> 1000 elementos), el dispositivo puede alcanzar el límite especificado.

Ejemplos:

* Usar la búsqueda del Explorador de archivos en carpetas grandes
* Desplazarse por carpetas con numerosos archivos gráficos o PDF

### **Escenario 3: consultas de permisos**

Desde la versión 2.10, KONNEKT además comprueba los permisos por carpeta y archivos, ya que estas consultas consumen un mayor número de unidades de recursos en comparación con las demás operaciones. El sistema puede alcanzar el límite especificado mucho más rápido, lo que puede activar la prevención de throttling. Las consultas de permisos no se activarán si "[Prevención del throttling de SharePoint](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" está configurado en 'High'.

{% hint style="warning" %}
En entornos de alta carga, es posible que todas las medidas no sean suficientes para prevenir el throttling.

KONNEKT fue diseñado para trabajo de oficina habitual. Si utiliza archivos de gran volumen (p. ej., edición de video, diseño gráfico, CAD) o lee/escribe gigabytes de datos, KONNEKT (& SPO) puede no ser la herramienta adecuada.

Consulte también nuestros [casos de uso](/es/readme.md#use-cases).
{% endhint %}

## **Unidades de recursos**

Cada tipo de solicitud de GraphAPI consume diferentes cantidades de unidades de recursos:

* Lecturas de un solo elemento: 1 unidad de recursos cada una
* Operaciones de escritura y consultas de directorio: 2 unidades de recursos cada una
* Consultas de permisos: 5

Para más detalles, consulte:\
<https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online>

## ¿Cómo puedo prevenir el throttling?

#### Las siguientes circunstancias favorecen el throttling:

* Uso de herramientas de terceros para copias de seguridad de SPO, especialmente durante el horario laboral
* Uso de herramientas que rastrean todo su sistema de archivos (como generadores de vista previa, etc.)
* Uso de carpetas muy grandes con >1000 archivos en el primer nivel de la carpeta
* Uso excesivo de la búsqueda del Explorador de archivos en grandes colecciones de sitios o bibliotecas de documentos

{% hint style="info" %}
Considere las siguientes configuraciones y acciones para todos los usuarios de un inquilino de Microsoft 365 sin excepciones.
{% endhint %}

#### Para evitar el throttling:

* No realice copias de seguridad de SPO durante el horario laboral.
* Si la búsqueda del Explorador de archivos es inevitable: optimice las búsquedas del Explorador de archivos y céntrese en carpetas o subcarpetas específicas para limitar las solicitudes de GraphAPI
* Mantenimiento regular: archive o elimine archivos, carpetas, bibliotecas de documentos y colecciones de sitios obsoletos.
* Evite el uso excesivo de la búsqueda del Explorador de archivos en grandes colecciones de sitios o bibliotecas de documentos
* No utilice ningún generador de vista previa para los recursos de KONNEKT. Consulte también [aquí](/es/configuration/system-settings/offline-attribute.md). Además, puede configurar el [Filtro sin conexión](/es/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) con la extensión de archivo "YYY" (que no existe), para evitar que Windows File Explorer genere vistas previas de archivos PDF.
* Segmenta tus datos (no demasiados archivos en el primer nivel de una carpeta).
* Establezca "[Prevención del throttling de SharePoint](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" Política en "High" - solo recomendado hasta la versión 2.10.2 de KONNEKT
* A partir de la versión 2.11.0, recomendamos habilitar "[throttling del lado del cliente](/es/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" y establecer la "[Prevención del throttling de SharePoint](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" política en "Auto".

Cuando configure el [registro de KONNEKT en "debug"](/es/configuration/system-settings/logging.md#log-level), verá entradas de registro con "`ThrottlingHook: hay que esperar Xs antes de iniciar`" (donde X representa la cantidad de segundos que SPO quiere que esperemos).

Las entradas de registro que contienen "`[Sharepoint] UpdateDrives: omitiendo el volumen debido a la prevención del throttling.`" NO están causadas por el throttling de SharePoint. Indican operaciones normales para prevenir el throttling: nada de qué preocuparse. ;-)

## **Cómo funciona**

La "[control de frecuencia de actualización](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" política limita las solicitudes mediante ciclos de actualización mejorados; por ejemplo, actualizando las colecciones de sitios de los usuarios.

La "[limitación de la tasa de solicitudes](/es/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" política funciona supervisando el número de solicitudes y las unidades de recursos correspondientes realizadas dentro de una ventana de tiempo especificada y aplicando límites a estas solicitudes. Esta política, “[throttling del lado del cliente](/es/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)”, incluye **blandos** y **duros** límites:

* **Límite suave**:\
  Cuando se alcance el límite blando, el sistema comenzará a limitar las solicitudes. Esto significa que la mayoría de las operaciones se retrasarán durante un breve período (p. ej., 2 segundos) y el nivel de prevención del throttling cambiará a HIGH. Algunas operaciones, como los trabajos de carga oportunistas y las operaciones de lectura anticipada, se pospondrán hasta que la cantidad de solicitudes descienda por debajo del límite blando.
* **Límite duro**:\
  Cuando se alcance el límite duro, el sistema dejará de enviar cualquier solicitud. La aplicación mostrará un mensaje de error hasta que se alcance el final de la ventana de tiempo.

{% hint style="warning" %}
Use "Hard Limit" solo cuando sea necesario, ya que impide que KONNEKT acceda y se comunique con los endpoints de Microsoft.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.konnekt.io/es/configuration/system-settings/throttling-prevention.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
