- Erste Schritte
- Die Swagger-Definition
- Beispiele mit der Orchestrator-API
- Warnungsanforderungen
- Anfragen zu Assets
- Kalenderanforderungen
- Umgebungsabfragen
- Ordneranforderungen
- Generische Aufgabenanforderungen
- Jobanfragen
- Bibliotheksabfragen
- Lizenzabfragen
- Paketanfragen
- Berechtigungsabfragen
- Anfragen für persönliche Arbeitsbereiche
- Prozessabfragen
- Bearbeitung von Anforderungen an die Datenaufbewahrung
- Anforderungen von Warteschlangenelementen
- Anforderungen an Warteschlangenaufbewahrungsrichtlinien
- Roboteranfragen
- Rollenanfragen
- Zeitplanabfragen
- Anfragen zu Einstellungen
- Anforderungen für Speicher-Buckets
- Aufgabenanforderungen
- Aufgabenkataloganforderungen
- Aufgabenformularanforderungen
- Mandantenabfragen
- Transaktionsanfragen
- Benutzerabfragen
- Webhook-Abfragen
Ratenlimits
- Sie gewährleisten ein vorhersagbares System: Wenn Sie das API-Aufruflimit kennen, können Sie Ihre Anwendungen besser entwerfen und warten. Es bietet eine vorhersehbare Umgebung und minimiert Überraschungen aufgrund unerwarteter Grenzwertüberschreitungen.
- Sie verbessern die Leistung: Durch die Kontrolle des Datenverkehrs auf unseren Servern sorgen wir für optimale Leistung und schnellere Antworten, wodurch Ihr Produkterlebnis erheblich verbessert wird.
- Sie verbessern die Sicherheit: Die unten beschriebenen Grenzwerte dienen als zusätzliche Sicherheitsebene und schützen Ihr System vor potenziellen Cyber-Bedrohungen.
- Sie stellen eine gerechte Nutzung sicher: Unsere Ratenlimits gewährleisten eine gerechte Ressourcenverteilung an alle Nutzer und einen reibungslosen Betrieb auch während der Spitzenzeiten.
Die unten beschriebenen Grenzwerte erfordern einige Anpassungen Ihrerseits. Wir sind jedoch zuversichtlich, dass sie langfristige Vorteile bringen werden.
Diese Grenzwerte werden durchgesetzt:
|
Endpoint |
Limits |
Gültig seit |
|---|---|---|
|
|
100 API-Anforderungen/Minute/Mandant |
Juli 2024 |
|
| 100 API-Anforderungen/Minute/Mandant | Juli 2024 |
Bitte beachten Sie, dass diese Einschränkungen nicht für das Hinzufügen von Warteschlangenelementen und das Verarbeiten von Aufträgen gelten. Daher gibt es keine Auswirkungen auf das Hinzufügen eines Warteschlangenelements, das Entfernen eines Elements aus einer Warteschlange, das Festlegen seines Status oder das Starten und Verarbeiten einer beliebigen Anzahl von Aufträgen.
Sie können Ihre API-Nutzung pro Monat oder Tag auf der Registerkarte API-Prüfung auf Mandantenebene im Fenster Überwachung überprüfen.
|
Kopfzeile |
Beschreibung |
Beispiel |
|---|---|---|
|
|
Allen Anforderungen, die über die vorgenannten Grenzen hinausgehen, wird die HTTP-Antwort 429 zurückgegeben, die diesen Header enthält. Zeigt die Anzahl der Sekunden an, die Sie warten müssen, bis der Endpunkt wieder für Sie verfügbar ist. |
Retry-After: 10 bedeutet, dass das Ratenlimit am Endpunkt in 10 Sekunden abläuft. Alle Wiederholungen innerhalb dieser 10 Sekunden führen zur Antwort 429.
|
|
|
Die Anzahl der verbleibenden Aufrufe |
X-RateLimit-Remaining: 30 bedeutet, dass Sie im aktuellen Zeitbereich 30 verbleibende Aufrufe haben
|
Wenn die Anzahl der Anforderungen pro Minute unter 10 ist, wird sie als 0 gerendert.
Die folgenden Aktivitäten sind von diesen Einschränkungen betroffen:
- Get Job
- Warteschlangenobjekte erhalten (Get Queue Items)
- Orchestrator Http Request (bei Verwendung zum Aufrufen der
GET /odata/Jobs- oderGET /odata/QueueItems-Endpunkte)
Dies empfehlen wir Ihnen, um sicherzustellen, dass Sie unsere Grenzwerte einhalten und in vollem Umfang nutzen können:
- Überprüfen Sie Ihre API-Nutzungsmuster und die Informationen, die Sie von unseren zuvor erwähnten Endpunkten vom Typ
GetAllabrufen. - Passen Sie Ihre API-Aufrufhäufigkeit und Datenextraktionsverfahren ggf. an diese Grenzwerte an.
- In den Abschnitten Exportieren von Aufträgen und Exportieren von Warteschlangenelementen finden Sie Beispiele zum Abrufen von Aufträgen und Warteschlangenelementdaten.
- Verwenden Sie die Option Insights-Datenexport in Echtzeit.
- Wenden Sie sich an Ihren Kontomanager oder unser Support-Team, wenn Sie Fragen haben oder weitere Erläuterungen benötigen.
Die API-Endpunkte, die zum Abrufen von Auftragslisten und Warteschlangenelementen verwendet werden, können sich als problematisch erweisen, wenn sie für die Echtzeitüberwachung und den Datenexport verwendet werden. Zum Beispiel:
-
Wenn bis zu 1.000 Elemente angefordert werden und jedes Element bis zu 1 MB an großen Daten umfasst, kann die Antwort auf einen einzigen API-Aufruf 1 GB groß sein. Da es zwischengeschaltete Stellen gibt, die keine Antworten dieser Größe zulassen, schlagen die Anforderungen fehl.
-
Wenn Sie komplexe Filter verwenden und dann eine Warteschlange mit mehreren Millionen Warteschlangenelementen paginieren, kann nach einigen Dutzend Seiten eine Zeitüberschreitung bei den Anforderungen auftreten. Das ist auf die Datenmenge zurückzuführen, die aus der Datenbank abgerufen werden muss.
GetAll-Endpunktantworten weggelassen. Das sind die betroffenen Felder:
|
Endpoint |
Ausgelassene Felder |
Was Sie stattdessen verwenden können |
Gültig seit |
|---|---|---|---|
|
|
|
Verwenden Sie für Exporte den speziellen Endpunkt:
GET/odata/Jobs/UiPath.Server.Configuration.Data.ExportWeitere Informationen finden Sie unter Exportieren von Aufträgen. |
Community- und Canary-Mandanten: März 2024 Enterprise-Mandanten: Juli 2024 |
|
|
|
Verwenden Sie für Exporte den speziellen Endpunkt:
/odata/QueueDefinitions
({key})/UiPathDataSvc.ExportSiehe Exportieren von Warteschlangenelementen für Details. |
Community- und Canary-Mandanten: März 2024 Enterprise-Mandanten: Juli 2024 |
GET /odata/Jobs- oder GET
/odata/QueueItems-Endpunkte über die API oder über die Aktivitäten Get Jobs, Get Queue Items oder Orchestrator HTTP Request verwenden, müssen Sie ermitteln, ob Sie eines der aufgelisteten Felder verwenden. Wenn das der Fall ist, beachten Sie bitte, dass der Inhalt dieser Felder als „null“ zurückgegeben wird.
Wir empfehlen Ihnen, Prozesse in Ihren Canary-Mandanten zu testen, um die Auswirkungen zu bewerten.
Sie können die folgenden Alternativen verwenden, um die Felder abzurufen:
- In den Abschnitten Exportieren von Aufträgen und Exportieren von Warteschlangenelementen finden Sie Beispiele zum Abrufen von Aufträgen und Warteschlangenelementdaten.
- Verwenden Sie die Option Insights-Datenexport in Echtzeit.
- Wenden Sie sich an Ihren Account Manager oder unser Supportteam, wenn die genannten Methoden nicht für Sie funktionieren.
Änderungen an Ratenlimits und großen Datenfeldern werden in lokalen Umgebungen nicht implementiert.
Wenn Sie einen eigenständigen Orchestrator verwenden und erwägen, in die Cloud zu migrieren, können Sie die IIS-Anforderungsprotokolle verwenden, um die Anforderungsrate für die betroffenen Endpunkte zu bestimmen. Die Analyse hängt davon ab, wie Sie die Protokolle aggregieren, wofür Sie z. B. Microsoft Log Parser verwenden können.
Um die Auswirkungen auf große Datenfelder zu bewerten, empfehlen wir, Ihre Prozesse in Canary-Mandanten zu testen.
