> 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/fr/configuration/system-settings/throttling-prevention.md). # Prévention du throttling **Prévention de la limitation de débit de KONNEKT** comprend deux politiques : une "[contrôle de la fréquence de mise à jour](/fr/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" politique et une "[limitation du débit des requêtes](/fr/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" conçue pour gérer et contrôler le rythme auquel les requêtes sont envoyées à l’API Graph de Microsoft, afin de garantir que les connexions à SharePoint Online (SPO) restent stables et offrent des performances optimales. Ces politiques sont particulièrement utiles pour éviter une utilisation excessive des ressources et maintenir une expérience utilisateur fluide. L’utilisation des API Microsoft 365 est soumise à des limitations concernant le nombre de requêtes qu’une application peut envoyer par unité de temps. Si une application consomme davantage de ressources, elle sera limitée. Vous pouvez en savoir plus à ce sujet dans le [la documentation Microsoft](https://learn.microsoft.com/en-us/sharepoint/dev/general-development/how-to-avoid-getting-throttled-or-blocked-in-sharepoint-online). Comme KONNEKT utilise l’API REST SharePoint Online et l’API Microsoft Graph, il peut arriver que les API Microsoft limitent votre utilisation de KONNEKT. Si une application est limitée, l’API correspondante (par ex. l’API REST SPO) indique à KONNEKT qu’il doit attendre pendant une durée définie. Cela commence par quelques secondes et peut aller jusqu’à plusieurs minutes, selon l’utilisation. Les impacts pour KONNEKT peuvent être une navigation lente ou des chargements/écritures de fichiers lents. Si la limitation s’étend sur plusieurs minutes, cela se traduira par des messages d’erreur indiquant que le lecteur n’est actuellement pas disponible. KONNEKT dispose de plusieurs mécanismes pour réduire l’apparition de la limitation de débit, appliqués automatiquement. ## Scénarios courants pour la prévention de la limitation de débit ### **Scénario 1 : téléversements de données en grand volume ou migration de données** Lorsqu’un utilisateur tente de téléverser un grand nombre de fichiers dans / ou qu’une migration de données est effectuée dans SPO sur une courte période, l’appareil peut atteindre la limite spécifiée. ### **Scénario 2 : opérations de lecture intensives** Si un utilisateur effectue des opérations de lecture intensives, telles que des requêtes ou des recherches dans un grand répertoire (> 1000 éléments), l’appareil peut atteindre la limite spécifiée. Exemples : * Utilisation de la recherche de l’Explorateur de fichiers dans de grands dossiers * Défilement dans des dossiers contenant de nombreux fichiers graphiques ou PDF ### **Scénario 3 : requêtes d’autorisations** Depuis la version 2.10, KONNEKT vérifie en outre les autorisations pour chaque dossier et chaque fichier, car ces requêtes consomment un nombre plus élevé d’unités de ressources que les autres opérations. Le système peut atteindre la limite spécifiée beaucoup plus rapidement, ce qui peut déclencher la prévention de la limitation de débit. Les requêtes d’autorisations ne seront pas déclenchées si "[Prévention de la limitation de débit de SharePoint](/fr/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" est définie sur 'High'. {% hint style="warning" %} Dans des environnements à forte charge, toutes les mesures peuvent ne pas suffire à empêcher la limitation de débit. KONNEKT a été conçu pour le travail de bureau courant. Si vous utilisez des fichiers à grand volume (p. ex. montage vidéo, conception graphique, CAO) ou si vous lisez/écrivez des gigaoctets de données, KONNEKT (et SPO) n’est peut-être pas l’outil le plus adapté. Veuillez également consulter nos [cas d’utilisation](/fr/readme.md#use-cases). {% endhint %} ## **Unités de ressources** Chaque type de requête GraphAPI consomme des quantités différentes d’unités de ressources : * Lectures d’un seul élément : 1 unité de ressource chacune * Opérations d’écriture et requêtes de répertoire : 2 unités de ressource chacune * Requêtes d’autorisations : 5 Pour plus de détails, voir :\ ## Comment puis-je éviter la limitation de débit ? #### Les circonstances suivantes favorisent la limitation de débit : * Utilisation d’outils tiers pour les sauvegardes SPO - surtout pendant les heures de travail * Utilisation d’outils qui analysent l’ensemble de votre système de fichiers (comme les outils de rendu d’aperçu, etc.) * Utilisation de dossiers très volumineux avec plus de 1000 fichiers au premier niveau du dossier * Utilisation excessive de la recherche de l’Explorateur de fichiers dans de grandes collections de sites ou bibliothèques de documents {% hint style="info" %} Prenez en compte les paramètres et actions suivants pour tous les utilisateurs d’un Tenant M365, sans exception. {% endhint %} #### Pour éviter la limitation de débit : * N’exécutez pas de sauvegardes SPO pendant les heures ouvrables. * Si la recherche de l’Explorateur de fichiers est inévitable : optimisez les recherches de l’Explorateur de fichiers, concentrez-vous sur des dossiers ou sous-dossiers spécifiques pour limiter les requêtes GraphAPI * Maintenance régulière : archivez ou supprimez les fichiers, dossiers, bibliothèques de documents et collections de sites obsolètes. * Évitez l’utilisation excessive de la recherche de l’Explorateur de fichiers dans de grandes collections de sites ou bibliothèques de documents * N’utilisez aucun moteur de rendu d’aperçu pour les ressources KONNEKT. Voir aussi [ici](/fr/configuration/system-settings/offline-attribute.md). Vous pouvez également définir le [filtre hors ligne](/fr/configuration/system-settings/offline-attribute.md#exclude-dedicated-file-types-from-offline-attribute-filter) sur l’extension de fichier "YYY" (qui n’existe pas), afin d’empêcher Windows Explorateur de fichiers d’afficher des aperçus pour les fichiers PDF. * Segmentez vos données (pas trop de fichiers au premier niveau d’un dossier). * Définissez "[Prévention de la limitation de débit de SharePoint](/fr/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" politique sur "High" - recommandé uniquement jusqu’à la version 2.10.2 de KONNEKT * À partir de la version 2.11.0, nous recommandons d’activer "[limitation côté client](/fr/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" et de définir la "[Prévention de la limitation de débit de SharePoint](/fr/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" politique sur "Auto". Lorsque vous activez [la journalisation KONNEKT sur "debug"](/fr/configuration/system-settings/logging.md#log-level), vous verrez des entrées de journal avec "`ThrottlingHook : besoin d’attendre X s avant de commencer`" (où X représente le nombre de secondes que SPO nous demande d’attendre). Les entrées de journal contenant "`[Sharepoint] UpdateDrives : passage du volume ignoré en raison de la prévention de la limitation de débit.`" ne sont PAS causées par la limitation de débit de SharePoint. Elles indiquent des opérations normales de prévention de la limitation de débit - rien à craindre. ;-) ## **Fonctionnement** La "[contrôle de la fréquence de mise à jour](/fr/configuration/system-settings/throttling-prevention/sharepoint-throttling-prevention.md)" politique limite les requêtes via des cycles d’actualisation améliorés, par ex. la mise à jour des collections de sites des utilisateurs. La "[limitation du débit des requêtes](/fr/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)" politique fonctionne en surveillant le nombre de requêtes et les unités de ressources correspondantes effectuées dans une fenêtre temporelle spécifiée et en appliquant des limites à ces requêtes. Cette politique, “[limitation côté client](/fr/configuration/system-settings/throttling-prevention/throttling-prevention-client-side.md)”, comprend **souples** et **strictes** limites : * **Limite souple**:\ Lorsque la limite souple est atteinte, le système commencera à limiter les requêtes. Cela signifie que la plupart des opérations seront retardées pendant une courte période (par ex. 2 secondes), et que le niveau de prévention de la limitation de débit passera à ÉLEVÉ. Certaines opérations, telles que les tâches de téléversement opportunistes et les opérations de lecture anticipée, seront reportées jusqu’à ce que le nombre de requêtes repasse sous la limite souple. * **Limite dure**:\ Lorsque la limite stricte est atteinte, le système cessera d’envoyer des requêtes. L’application affichera un message d’erreur jusqu’à ce que la fin de la fenêtre temporelle soit atteinte. {% hint style="warning" %} N’utilisez « Limite stricte » que lorsque cela est nécessaire, car cela empêche KONNEKT d’accéder aux points de terminaison de Microsoft et de communiquer avec eux. {% 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/fr/configuration/system-settings/throttling-prevention.md?ask=&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.