- Démarrage
- Lisez-moi
- À propos d'OData et des références
- URL d'Orchestrator
- Références d'API
- Rate limits and large data fields usage optimization
- Ressources logiques et métadonnées
- Opérations disponibles
- Fichiers énumérés (Enumerated Files)
- Utilisation de l'API de cloud
- Création des requêtes d'API
- Applications externes (OAuth)
- Autorisations par point de terminaison
- Codes de réponse
- Définition Swagger
- Exemples d'utilisation de l'API Orchestrator
- Demandes d'alertes
- Requêtes relatives aux actifs
- Requêtes de calendriers
- Requêtes relatives aux environnements
- Requêtes de dossiers
- Requêtes de tâches génériques
- Requêtes relatives aux tâches
- Requêtes relatives aux bibliothèques
- Requêtes relatives aux licences
- Requêtes relatives aux paquets (Packages Requests)
- Requêtes relatives aux autorisations
- Demandes d'espaces de travail personnels
- Requêtes relatives aux processus
- Traiter les requêtes liées à la stratégie de conservation des données
- Demandes d'éléments de la file d'attente
- Requêtes en matière de stratégie de rétention des files d’attente
- Requêtes relatives aux Robots
- Requêtes relatives aux rôles (Roles Requests)
- Requêtes relatives aux planifications
- Requêtes relatives aux paramètres
- Requêtes de compartiments de stockage
- Requêtes de tâches
- Demandes de catalogues de tâches
- Demandes de formulaires de tâches
- Requêtes relatives aux locataires
- Requêtes relatives aux transactions
- Requêtes relatives aux utilisateurs
- Requêtes relatives aux Webhooks
Rate limits and large data fields usage optimization
- Elles garantissent la prévisibilité du système : connaître la limite d'appels API permet de mieux concevoir et de mieux gérer vos applications. Cela assure un environnement prédictible, ce qui réduit les éventuelles surprises dues à des dépassements de limite inattendus.
- Elles améliorent les performances : en contrôlant le trafic sur nos serveurs, nous assurons des performances optimales et des réponses plus rapides, ce qui améliore considérablement votre expérience produit.
- Elles renforcent la sécurité : les limites détaillées ci-dessous agissent comme un niveau de sécurité supplémentaire, protégeant votre système face à d'éventuelles cybermenaces.
- Elles garantissent une utilisation adéquate : nos limites de débit garantissent une attribution équitable des ressources à tous les utilisateurs, ainsi qu'un fonctionnement fluide, même au cours des périodes d'utilisation maximale.
The limits and large data fields optimizations outlined below require some adjustments on your end, but we are confident that they will bring long-term benefits.
Voici les limites que nous appliquons :
Endpoint |
Exemples |
Limits |
Date d’entrée en vigueur |
---|---|---|---|
|
|
100 requêtes API/minute/locataire |
Juillet 2024 |
|
| 100 requêtes API/minute/locataire | Juillet 2024 |
GET/odata/Jobs(<job_id>)
is not rate limited.
Il est important de noter que ces limites ne s’appliquent pas à l’ajout d’éléments de file d’attente ni au traitement des tâches. Ainsi, il n’y a aucun impact sur l’ajout d’un élément de file d’attente, sa suppression, la configuration de son état, ou encore le démarrage et le traitement d’un certain nombre de tâches.
Vous pouvez suivre votre utilisation d’API par mois ou par jour en vous rendant sur l’onglet Audit d’API de la fenêtre Surveillance, au niveau du locataire.
En-tête |
Description |
Exemple |
---|---|---|
|
Toutes les demandes au-delà des limites susmentionnées reçoivent une réponse HTTP 429 comportant cet en-tête. Elle affiche le nombre de secondes que vous devez attendre avant que le point de terminaison ne soit à nouveau disponible. |
Retry-After: 10 signifie que la limite de débit sur le point de terminaison expire dans 10 secondes. Toutes les nouvelles tentatives dans ces 10 secondes entraînent une réponse 429.
|
|
Nombre d’appels restants |
X-RateLimit-Remaining: 30 signifie qu’il vous reste 30 appels dans la plage horaire actuelle
|
Si le nombre de requêtes par minute est inférieur à 10, il sera renvoyé comme 0.
Les activités suivantes sont affectées par ces limites :
- Get Job
- Obtenir les éléments de file d'attente (Get Queue Items)
- Requête HTTP d’Orchestrator (Orchestrator HTTP Request), lorsque celle-ci est utilisée pour appeler les points de terminaison
GET /odata/Jobs
ouGET /odata/QueueItems
Retry-after
response header, meaning that they perform automatic retries of Orchestrator operations. Please make sure to always use the latest version of System activities to benefit from this.
Voici ce que nous vous recommandons de faire pour veiller à ce que vous ne dépassiez pas nos limites et que vous en tiriez pleinement parti :
- Analysez votre utilisation des API et les informations que vous récupérez à partir de nos points de terminaison de type
GetAll
, mentionnés plus haut. - Ajustez la fréquence des appels de votre API ainsi que les procédures d’extraction de données pour vous aligner sur ces seuils, le cas échéant.
- Consultez les sections les sections Exportation des tâches et Exportation des éléments de la file d’attente pour obtenir des exemples de récupération des données des tâches et des éléments de la file d’attente.
- Utilisez l’option d’exportation de données en temps réel d’Insights.
- Make sure you always use the latest version of System activities.
- Contactez votre gestionnaire de compte ou notre équipe d’assistance si vous avez des questions ou désirez avoir plus de précisions.
Les points de terminaison d’API utilisés pour récupérer des listes de tâches et d’éléments de file d’attente peuvent s’avérer problématiques lorsqu’ils sont utilisés à des fins de surveillance en temps réel et d’exportation de données. Par exemple :
-
Si la requête concerne 1000 éléments et que chaque élément représente 1 Mo de données volumineuses, la réponse à un seul appel d’API peut atteindre une taille de 1 Go. Dans la mesure où certains intermédiaires n’autorisent pas les réponses d’une taille aussi importante, cela conduit à un échec des requêtes.
-
Lorsque des filtres complexes sont utilisés et que la pagination d’une file d’attente contient plusieurs millions d’éléments de file d’attente, les requêtes peuvent conduire une expiration du délai de traitement après quelques dizaines de pages. Cela est lié à la quantité de données devant être extraites de la base de données.
Jobs - GetAll
endpoint responses. These are the impacted fields:
Endpoint |
Champs omis |
Ce que vous pouvez utiliser à la place |
Date d’entrée en vigueur |
---|---|---|---|
|
|
Pour les exportations, utilisez le point de terminaison dédié :
GET/odata/Jobs/UiPath.Server.Configuration.Data.Export Pour plus de détails, consultez la section Exportation des tâches. |
Locataires Communauté (Community) et Contrôle de validité (Canary) : mars 2024 Locataires Enterprise : juillet 2024 |
GET /odata/Jobs
endpoint, either via API or via the Get Jobs, Get Queue Items, or Orchestrator HTTP Request activities, you need to find out whether you use any of the listed fields. If you do, please be aware that the content of these fields will be returned as null.
Nous vous recommandons de tester les processus dans vos locataires Canary afin d’en évaluer l’impact.
GET/odata/QueueItems
endpoint is optimized by applying these size limitations to its fields:
Champ |
Limite | Date d’entrée en vigueur |
How to tell that you are impacted |
How to address this |
---|---|---|---|---|
Progress |
1,048,576 characters |
> Community and Canary tenants: April 2024 > Enterprise tenants: May 2024 |
A specific error message is returned. |
We recommend that you use storage buckets and/or Data Service blob storage if you need to store more data. |
104,857 characters |
All tenants: September 2024 | |||
AnalyticsData |
10 KB |
> Community and Canary tenants: June 2024 > Enterprise tenants: September 2024 |
Enterprise: If your current data load exceeds these limits, we will send monthly reports to administrators. | |
Output |
100 KB | |||
SpecificData |
500 KB | |||
ProcessingException - Reason |
102,400 characters | |||
ProcessingException - Details |
102,400 characters |
The following filter is also limited for performance purposes:
Filtrer (Filter) |
Limite |
Date d’entrée en vigueur |
How to tell that you are impacted |
How to address this |
---|---|---|---|---|
|
> If you do not use the
$top filter, you receive 100 records by default.
> If you use the
$top filter, you receive a maximum of 100 records. Anything exceeding 100 triggers a 400 Bad Request error message.
|
> Community and Canary tenant: June 2024 > Enterprise tenants: September 2024 |
Enterprise: We aim to send an email notification to administrators if we detect the usage of this filter in API calls. However, we ask that you keep a close eye on your end as well. |
We recommend that you modify your process or API usage logic accordingly if you expect to exceed this limit. |
Jobs
and QueueItems
fields:
- Consultez les sections les sections Exportation des tâches et Exportation des éléments de la file d’attente pour obtenir des exemples de récupération des données des tâches et des éléments de la file d’attente.
- Utilisez l’option d’exportation de données en temps réel d’Insights.
- Contactez votre gestionnaire de compte ou notre équipe d’assistance si les méthodes précédentes ne fonctionnent pas pour vous.
Les limites de débit et les modifications des champs de données volumineux ne seront pas implémentées dans les environnements locaux.
Si vous utilisez une version autonome d’Orchestrator et que vous envisagez de passer au cloud, vous pouvez utiliser les journaux des requêtes IIS afin de déterminer le volume des requêtes pour les points de terminaison impactés. L’analyse dépendra de votre méthode d’agrégation des journaux, pour laquelle vous pouvez par exemple utiliser l’analyseur de journaux Microsoft.
Pour évaluer l’impact sur les champs de données volumineux, nous vous recommandons de tester vos processus dans les locataires Canary.