> 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

**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 tasa a la que se realizan solicitudes a la GraphAPI de Microsoft, garantizando que las conexiones a SharePoint Online (SPO) se mantengan estables y funcionen de forma óptima. Estas políticas son especialmente útiles para prevenir 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 utiliza más recursos, se le aplicará limitación. Puede encontrar más información al respecto en el [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 se ve limitada, la API correspondiente (p. ej., la API REST de SPO) indica a KONNEKT que debe esperar un tiempo determinado. Esto puede ir desde unos segundos hasta minutos, según el uso. Para KONNEKT, los impactos pueden ser una navegación lenta o la carga/escritura de archivos. Si la limitación se prolonga hasta minutos, dará lugar a mensajes de error indicando 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 la limitación

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

Cuando un usuario intenta cargar una gran cantidad de archivos o realizar una migración de datos dentro de SPO en un período corto, 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 permisos por carpetas y archivos, ya que estas consultas consumen un mayor número de unidades de recursos en comparación con las otras operaciones. El sistema puede alcanzar el límite especificado mucho más rápido, lo que puede activar la prevención de limitación. Las consultas de permisos no se activarán si "[Prevención de limitación de SharePoint](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" está configurado en 'High'.

{% hint style="warning" %}
En entornos de alta carga, no todas las medidas pueden ser suficientes para evitar la limitación.

KONNEKT fue creado para el 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 recurso cada una
* Operaciones de escritura y consultas de directorio: 2 unidades de recurso 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 evitar la limitación?

#### Las siguientes circunstancias favorecen la limitación:

* 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 el generador de vistas previas, 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 los siguientes ajustes y acciones para todos los usuarios de un Tenant de M365 sin excepciones.
{% endhint %}

#### Para evitar la limitación:

* No ejecute 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, 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 vistas previas para los recursos de KONNEKT. Véase también [aquí](/es/configuration/system-settings/offline-attribute.md). Además, puede establecer el [Filtro sin conexión](/es/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) a la extensión de archivo "YYY" (que no existe), para evitar que el Explorador de archivos de Windows genere vistas previas de archivos PDF.
* Segmente sus datos (no demasiados archivos en el primer nivel de una carpeta).
* Establezca "[Prevención de limitación 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 "[limitación del lado del cliente](/es/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" y configurando la "[Prevención de limitación de SharePoint](/es/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" política en "Auto".

Cuando active el [registro de KONNEKT en "debug"](/es/configuration/system-settings/logging.md#log-level), verá entradas de registro con "`ThrottlingHook: es necesario esperar X s 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 de limitación.`" NO están causadas por la limitación de SharePoint. Estas indican operaciones normales para evitar la limitación: no hay 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, al actualizar 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 monitorizando 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, “[limitación del lado del cliente](/es/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)”, incluye **blandos** y **duros** límites:

* **Límite blando**:\
  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 de limitación cambiará a HIGH. Algunas operaciones, como los trabajos de carga oportunista 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 solicitudes. La aplicación mostrará un mensaje de error hasta que se alcance el final de la ventana de tiempo.

{% hint style="warning" %}
Utilice "Hard Limit" solo cuando sea necesario, ya que impide que KONNEKT acceda y se comunique con los puntos de conexión 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
