API-Grenzwerte für den Serviceschutz

Um eine konsistente Verfügbarkeit und Leistung für jeden sicherzustellen, wendet das System Grenzwerte für die Verwendung von APIs an. Diese Grenzwerte erkennen, wenn Clientanwendungen außergewöhnliche Anforderungen an Serverressourcen stellen.

Diese Grenzwerte wirken sich nicht auf normale Benutzer interaktiver Clients aus. Sie wirken sich nur auf Clientanwendungen aus, die ein außergewöhnliches Volumen von API-Anforderungen ausführen. Diese Grenzwerte schützen die Microsoft Dataverse-Plattform vor zufälligen und unerwarteten Anstiegen in Anforderungsvolumes, die ihre Verfügbarkeit und Leistung gefährden.

Wenn eine Clientanwendung außerordentlich anspruchsvolle Anforderungen stellt, folgt Dataverse dem gemeinsamen Muster für Onlinedienste. Es wird ein Fehler zurückgegeben, der darauf hinweist, dass zu viele Anforderungen eingegangen sind.

• Mit der Web-API gibt Dataverse einen Fehler von 429 Zu viele Anforderungen zurück.
• Mit dem Dataverse SDK für .NET erhalten Sie einen OrganizationServiceFault-Fehler mit einem von drei spezifischen Fehlercodes.

Informationen zu den Fehlern bei den Grenzwerten der Dienstschutz-API

Auswirkungen auf Clientanwendungen

Clientanwendungen sind für die Verwaltung von Dienstschutz-API-Grenzwertfehlern verantwortlich. Wie Sie diesen Fehler verwalten, hängt von der Art der Anwendung ab.

Interaktive Clientanwendungen

Die Dienstschutzgrenzwerte sind hoch genug, sodass es für eine Einzelperson selten sein sollte, bei normaler Nutzung der interaktiven Clientanwendung auf diese Grenzen zu stoßen. Es ist jedoch möglich, wenn die Clientanwendung Massenvorgänge zulässt. Clientanwendungsentwickler sollten wissen, wie Dienstschutz-API-Grenzwerte erzwungen werden und die Benutzeroberfläche entwerfen, um das Potenzial für Benutzer zu verringern, extrem anspruchsvolle Anforderungen an den Server zu senden. Selbst wenn sie dies tun, sollten sie dennoch erwarten, dass Fehler beim Dienstschutz-API-Grenzwert auftreten und bereit sind, sie zu behandeln.

Clientanwendungsentwickler sollten nicht nur den Fehler auslösen, um die Meldung für den Benutzer anzuzeigen. Die Fehlermeldung ist nicht für Endbenutzer vorgesehen. Erfahren Sie mehr über bestimmte Strategien zum Wiederholen von Vorgängen.

Datenintegrationsanwendungen

Anwendungen, die zum Laden von Daten in Dataverse entwickelt wurden oder Massenaktualisierungen durchführen, müssen Service-Schutz-API-Grenzfehler verwalten. Diese Anwendungen priorisieren den Durchsatz, damit sie ihre Arbeit in der mindesten Zeitspanne abschließen können. Diese Anwendungen müssen über eine Strategie zur Wiederholung von Operationen verfügen. Es gibt mehrere Strategien, die sie anwenden können, um den maximalen Durchsatz zu erhalten. Erfahren Sie, wie Sie den Durchsatz maximieren.

Portalanwendungen

Portalanwendungen senden normalerweise Anforderungen von anonymen Benutzern über ein Dienstprinzipalkonto. Da die Dienstschutz-API-Grenzwerte auf Benutzerbasis festgelegt sind, können Portalanwendungen die Dienstschutz-API-Grenzwerte aufgrund der Menge des Datenverkehrs im Portal erreichen. Wie interaktive Clientanwendungen sollten Fehler bei Dienstschutz-API-Limits dem Portal-Endbenutzer nicht angezeigt werden. Die Benutzeroberfläche für das Portal sollte weitere Anforderungen deaktivieren und eine Meldung anzeigen, dass der Server ausgelastet ist. Die Nachricht kann den Zeitpunkt enthalten, zu dem die Anwendung mit der Annahme neuer Anforderungen beginnen kann, wobei die Dauer basierend auf der mit dem Fehler zurückgegebenen Retry-After-Dauer berechnet wird.

Auswirkungen auf Plug-Ins und benutzerdefinierte Workflowaktivitäten

Plug-Ins und benutzerdefinierte Workflowaktivitäten wenden Geschäftslogik an, die von eingehenden Anforderungen ausgelöst wird. Dienstschutzgrenzwerte gelten nicht für Datenvorgänge, die aus Plug-Ins und benutzerdefinierten Workflowaktivitäten stammen. Plug-Ins und benutzerdefinierte Workflowaktivitäten werden innerhalb des isolierten Sandkastendiensts ausgeführt. Dataverse-Vorgänge, die für den Sandkastendienst aufgerufen werden, verwenden nicht die öffentlichen API-Endpunkte.

Wenn Ihre Anwendung Vorgänge ausführt, die benutzerdefinierte Logik auslösen, zählt die Anzahl der anforderungen, die von Plug-Ins oder benutzerdefinierten Workflowaktivitäten gesendet werden, nicht auf Dienstschutz-API-Grenzwerte. Die zusätzliche Berechnungszeit, die diese Vorgänge verursachen, wird jedoch der ursprünglichen Anfrage hinzugefügt, die sie ausgelöst hat. Diese Berechnungszeit ist Teil der Dienstschutz-API-Grenzwerte. Erfahren Sie, wie das System Dienstschutz-API-Grenzwerte erzwingt.

Operationen wiederholen

Wenn ein Dienstschutz-API-Grenzwertfehler auftritt, wird ein Wert bereitgestellt, der die Dauer angibt, bevor neue Anforderungen des Benutzers verarbeitet werden können.

• Wenn ein 429-Fehler von der Web-API zurückgegeben wird, enthält die Antwort einen Retry-After-Header mit der Anzahl von Sekunden.
• Mit dem SDK für .NET wird ein TimeSpan-Wert in der OrganizationServiceFault.ErrorDetails -Auflistung mit dem Schlüssel Retry-Afterzurückgegeben.

Die Dauer der Wiederholung nach dem Löschen

Die Retry-After Dauer hängt von der Art der Vorgänge ab, die im vorherigen 5-Minuten-Zeitraum gesendet wurden. Je anspruchsvoller die Anforderungen sind, desto länger dauert es, bis der Server wiederhergestellt werden kann.

Aufgrund der Art und Weise, wie die Grenzwerte ausgewertet werden, können Sie davon ausgehen, dass die Anzahl der Anforderungen und Ausführungszeitlimits für einen Zeitraum von 5 Minuten überschritten wird, bevor die Dienstschutz-API-Grenzwerte wirksam werden. Eine Überschreitung der Anzahl gleichzeitiger Anforderungen gibt jedoch sofort einen Fehler zurück. Wenn die Anwendung weiterhin solche anspruchsvollen Anforderungen sendet, wird die Dauer verlängert, um die Auswirkungen auf gemeinsam genutzte Ressourcen zu minimieren. Diese Erweiterung bewirkt, dass das einzelne Wiederversuchsintervall länger ist, was bedeutet, dass Ihre Anwendung längere Inaktivitätsperioden während des Wartens erfährt. Dieses Verhalten kann sich in Zukunft ändern.

Wenn möglich, versuchen Sie, eine konsistente Rate zu erzielen, indem Sie mit einer niedrigeren Anzahl von Anforderungen beginnen und schrittweise erhöhen, bis Sie mit dem Erreichen der Dienstschutz-API-Grenzwerte beginnen. Lassen Sie danach dem Server mitteilen, wie viele Anforderungen er innerhalb eines Zeitraums von 5 Minuten verarbeiten kann. Begrenzen Sie die maximale Anzahl von Anfragen innerhalb dieses 5-Minuten-Zeitraums und erhöhen Sie sie schrittweise, um den Wiederholungszeitraum gering zu halten, den Gesamtdurchsatz zu optimieren und Spitzenbelastungen der Serverressourcen zu minimieren.

Interaktive Anwendungserneuerung

Wenn der Client eine interaktive Anwendung ist, zeigen Sie eine Meldung an, dass der Server ausgelastet ist, während Sie die Vom Benutzer vorgenommene Anforderung wiederholen. Möglicherweise möchten Sie dem Benutzer eine Option zum Abbrechen des Vorgangs bereitstellen. Erlauben Sie Benutzern nicht, weitere Anforderungen zu übermitteln, bis die vorherige von Ihnen gesendete Anforderung abgeschlossen ist.

Nicht interaktive Anwendungs-Wiederholungsversuche

Wenn der Client nicht interaktiv ist, warten Sie, bis die Dauer abgelaufen ist, bevor Sie die Anforderung erneut senden. Um die Ausführung des aktuellen Vorgangs anzuhalten, verwenden Sie Task.Delay oder entsprechende Methoden.

So versuchen Sie es erneut

Im folgenden Abschnitt wird beschrieben, wie .NET-Anwendungen mithilfe des Dataverse SDK für .NET oder Web-API erneut versucht werden:

/// <summary>
/// Specifies the Retry policies
/// </summary>
/// <param name="config">Configuration data for the service</param>
/// <returns></returns>
static IAsyncPolicy<HttpResponseMessage> GetRetryPolicy(Config config)
{
    return HttpPolicyExtensions
      .HandleTransientHttpError()
      .OrResult(httpResponseMessage => httpResponseMessage.StatusCode == System.Net.HttpStatusCode.TooManyRequests)
      .WaitAndRetryAsync(
         retryCount: config.MaxRetries,
         sleepDurationProvider: (count, response, context) =>
         {
            int seconds;
            HttpResponseHeaders headers = response.Result.Headers;

            if (headers.Contains("Retry-After"))
            {
               seconds = int.Parse(headers.GetValues("Retry-After").FirstOrDefault());
            }
            else
            {
               seconds = (int)Math.Pow(2, count);
            }
            return TimeSpan.FromSeconds(seconds);
         },
         onRetryAsync: (_, _, _, _) => { return Task.CompletedTask; }
      );
}

So erzwingt das System Dienstschutz-API-Grenzwerte

Zwei der Dienstschutz-API-Grenzwerte verwenden ein Schiebefenster von fünf Minuten (300 Sekunden). Wenn eine der beiden Grenzwerte die vorhergehenden 300 Sekunden überschreitet, gibt das System einen Dienstschutz-API-Grenzwertfehler für nachfolgende Anforderungen zurück. Dieser Fehler schützt den Dienst, bis die "Retry-After"-Dauer endet.

Das System wertet Dienstschutz-API-Grenzwerte für jeden Benutzer aus. Jeder authentifizierte Benutzer hat einen unabhängigen Grenzwert. Das System beschränkt nur die Benutzerkonten, die außergewöhnliche Anforderungen stellen. Andere Benutzer erleben keine Auswirkungen.

Das System erzwingt Dienstschutz-API-Grenzwerte basierend auf drei Facets:

• Die Anzahl der Anforderungen, die ein Benutzer sendet.
• Die kombinierte Ausführungszeit, die das System zum Verarbeiten von Anforderungen benötigt, die ein Benutzer sendet.
• Die Anzahl der gleichzeitigen Anforderungen, die ein Benutzer sendet.

Wenn das System den Grenzwert nur für die Anzahl von Anforderungen erzwungen hat, die ein Benutzer sendet, wäre es möglich, ihn zu umgehen. Das System fügt die anderen Facets hinzu, um diesen Versuchen entgegenzuwirken. Beispiel:

• Sie können weniger Anforderungen senden, indem Sie sie in Batchvorgängen bündeln.
  • Der kombinierte Ausführungszeitgrenzwert gibt diesen Grenzwert an.
• Anstatt Anforderungen einzeln nacheinander zu senden, könnten Sie eine große Anzahl gleichzeitiger Anforderungen senden, bevor Dienstschutz-API-Grenzwerte erzwungen werden.
  • Die Zähler für den Grenzwert gleichzeitiger Anfragen begrenzen diesen.

Jeder Webserver, den Ihre Umgebung zur Verfügung stellt, erzwingt diese Grenzwerte unabhängig voneinander. Die meisten Umgebungen verfügen über mehrere Webserver. Testumgebungen weisen nur einen einzelnen Webserver zu. Mehrere Faktoren bestimmen die tatsächliche Anzahl der Webserver, die Ihre Umgebung zur Verfügung stellt. Dataverse stellt diese Faktoren als Teil des verwalteten Diensts bereit. Einer der Faktoren ist, wie viele Benutzerlizenzen Sie kaufen.

In der folgenden Tabelle werden die Standardmäßigen Dienstschutz-API-Grenzwerte beschrieben, die das System pro Webserver erzwingt:

Fehler beim Dienstschutz-API-Grenzwert

In diesem Abschnitt werden die drei Arten von Dienstschutz-API-Grenzwertfehlern beschrieben, die vom System zurückgegeben werden können. Außerdem werden Faktoren beschrieben, die diese Fehler verursachen, und mögliche Gegenmaßnahmenstrategien.

• Der Fehlercode ist der numerische Fehlerwert, den das SDK für .NET OrganizationServiceFaultErrorDetails zurückgibt.
• Der Hex-Code ist der hexadezimale Fehlerwert, den die Web-API zurückgibt.

Anzahl von Anforderungen

Dieser Grenzwert zählt die Gesamtzahl der Anforderungen während des vorhergehenden 300-Sekunden-Zeitraums.

Ein typischer Benutzer einer interaktiven Anwendung sendet nicht 1.200 Anforderungen pro Minute, um diesen Grenzwert zu überschreiten, es sei denn, die Anwendung ermöglicht Es Benutzern, Massenvorgänge auszuführen.

Wenn beispielsweise eine Listenansicht die Auswahl von 250 Datensätzen gleichzeitig aktiviert und einem Benutzer ermöglicht, einen Vorgang für alle diese Datensätze auszuführen, muss der Benutzer diesen Vorgang 24 Mal in einer Zeitspanne von 300 Sekunden ausführen. Der Benutzer muss den Vorgang innerhalb von 12,5 Sekunden für jede Liste ausführen.

Wenn Ihre Anwendung diese Funktion bereitstellt, berücksichtigen Sie einige der folgenden Strategien:

• Verringern Sie die Gesamtzahl der Datensätze, die Benutzer in einer Liste auswählen können. Wenn die Anzahl der in einer Liste angezeigten Elemente auf 50 reduziert wird, muss der Benutzer diesen Vorgang 120 Mal innerhalb von 300 Sekunden ausführen. Der Benutzer muss den Vorgang innerhalb von 2,5 Sekunden für jede Liste ausführen.
• Kombinieren Sie die ausgewählten Vorgänge in einem Batch. Ein Batch kann bis zu 1.000 Vorgänge enthalten und umgeht das Limit für die Anzahl von Anfragen. Sie müssen jedoch auf das Zeitlimit für die Ausführung vorbereitet sein.

Ausführungszeit

Dieser Grenzwert verfolgt die kombinierte Ausführungszeit eingehender Anforderungen während des vorherigen 300-Sekunden-Zeitraums.

Einige Vorgänge erfordern mehr Ressourcen als andere. Batchvorgänge, Das Importieren von Lösungen und hochkomplexe Abfragen können sehr anspruchsvoll sein. Diese Vorgänge können auch simultan in gleichzeitigen Anforderungen ausgeführt werden. Daher können Sie innerhalb des 5-Minuten-Fensters Vorgänge anfordern, die mehr als 20 Minuten kombinierte Berechnungszeit erfordern.

Sie können auf diese Begrenzung stoßen, wenn Sie Strategien verwenden, die Batchvorgänge und gleichzeitige Anforderungen umfassen, um das Limit der Anzahl der Anfragen zu vermeiden.

Gleichzeitige Anforderungen

Dieser Grenzwert verfolgt die Anzahl der gleichzeitigen Anforderungen.

Clientanwendungen sind nicht darauf beschränkt, einzelne Anforderungen sequenziell zu senden. Der Client kann parallele Programmiermuster oder verschiedene Methoden anwenden, um mehrere Anforderungen gleichzeitig zu senden. Der Server kann erkennen, wann er auf mehrere Anforderungen desselben Benutzers gleichzeitig reagiert. Wenn diese Anzahl gleichzeitiger Anforderungen überschritten wird, löst der Server diesen Fehler aus. Der Grenzwert kann in einigen Fällen höher als 52 sein.

Das Senden gleichzeitiger Anforderungen kann ein wichtiger Bestandteil einer Strategie sein, um den Durchsatz zu maximieren, aber es ist wichtig, sie unter Kontrolle zu halten. Wenn Sie parallele Programmierung in .NET verwenden, hängt der Standardgrad der Parallelität von der Anzahl der CPU-Kerne auf dem Server ab, auf dem der Code ausgeführt wird. Der Grenzwert sollte nicht überschritten werden. Sie können die Eigenschaft ParallelOptions.MaxDegreeOfParallelism festlegen, um eine maximale Anzahl gleichzeitiger Aufgaben zu definieren.

Erfahren Sie mehr über das Senden paralleler Anforderungen.

Durchsatz maximieren

Wenn Sie über eine Anwendung verfügen, die den Durchsatz priorisieren muss, um die meisten Daten in kürzester Zeit zu verschieben, wenden Sie die folgenden Strategien an.

Lassen Sie den Server ihnen mitteilen, wie viel es verarbeiten kann

Versuchen Sie nicht zu berechnen, wie viele Anfragen gleichzeitig zu senden sind. Jede Umgebung kann unterschiedlich sein. Erhöhen Sie schrittweise die Rate, mit der Sie Anforderungen senden, bis Sie Grenzwerte erreichen, und verlassen Sie sich dann auf den Dienstschutz-API-Grenzwert Retry-After, um Sie zu informieren, wann Sie mehr senden können. Dieser Wert hält den Gesamtdurchsatz auf dem höchstmöglichen Niveau.

Verwenden von Multi-Threads

Der höhere Grenzwert für die Anzahl gleichzeitiger Threads ist, was Ihre Anwendung verwenden kann, um eine erhebliche Leistungsverbesserung zu erzielen. Diese Verbesserung trifft zu, wenn Ihre einzelnen Vorgänge relativ schnell sind. Je nach Art der daten, die Sie verarbeiten, müssen Sie möglicherweise die Anzahl der Threads anpassen, um den optimalen Durchsatz zu erzielen. Erfahren Sie mehr über das Senden von Anforderungen parallel.

Vermeiden großer Batches

Batching bezieht sich auf das Senden mehrerer Vorgänge in einer einzelnen Anfrage.

Das Senden einzelner Anforderungen mit einem hohen Grad an Parallelität ist in den meisten Szenarien am schnellsten. Falls Sie das Gefühl haben, dass die Batchgröße die Leistung verbessern könnte, beginnen Sie mit einer kleinen Batchgröße von 10 und erhöhen Sie die Parallelität, bis Sie Dienstschutz-API-Grenzwertfehler erhalten, die erneut versucht werden.

Mit dem SDK für .NET bedeutet dieser Ansatz die Verwendung von ExecuteMultipleRequest, was typischerweise das Senden von bis zu 1.000 Vorgängen in einer Anforderung ermöglicht. Der Hauptvorteil dieses Ansatzes besteht darin, dass die Gesamtmenge der XML-Nutzlast reduziert wird, die über die Leitung gesendet werden muss. Dieser Ansatz bietet einen Leistungsvorteil, wenn die Netzwerklatenz ein Problem ist. Für Dienstschutzgrenzwerte erhöht sie die Gesamtausführungszeit pro Anforderung. Größere Batches erhöhen die Wahrscheinlichkeit, dass Sie auf Ausführungszeitlimits stoßen, anstatt auf Limits bei der Anzahl der Anforderungen.

In der Vergangenheit waren Vorgänge aufgrund der Auswirkungen auf die Leistung, die dieser Grenzwert haben könnte, ExecuteMultiple auf nur zwei gleichzeitig beschränkt. Dieser Grenzwert ist nicht mehr relevant, da die API-Grenzwerte für die Ausführungszeit des Dienstschutzes diesen Grenzwert überflüssig gemacht haben.

Bei Verwendung der Web-API bedeutet die kleinere JSON-Nutzlast, die über die Leitung für einzelne Anforderungen gesendet wird, dass die Netzwerklatenz kein Problem darstellt. Erfahren Sie mehr über das Ausführen von Batchvorgängen mithilfe der Web-API.

Strategien zum Verwalten von Dienstschutz-API-Grenzwerten

In diesem Abschnitt wird beschrieben, wie Sie Ihre Clients und Systeme entwerfen können, um Fehler beim Dienstschutz-API-Grenzwert zu vermeiden. Sie können auch überlegen, wie Sie Ihre Lizenzen verwalten, um die Auswirkungen zu verringern.

Aktualisieren Der Clientanwendung

Dataverse hat seit 2018 Dienstschutz-API-Grenzwerte erzwungen. Viele Clientanwendungen wurden jedoch vor diesen Grenzwerten geschrieben. Diese Clients erwarten diese Fehler nicht und können die Fehler nicht richtig behandeln. Aktualisieren Sie diese Anwendungen, und wenden Sie die Muster auf zuvor beschriebene Wiederholungsvorgänge an.

Umstieg auf die Echtzeitintegration

Der Hauptpunkt der Dienstschutz-API-Grenzwerte besteht darin, die Auswirkungen von hoch anspruchsvollen Anforderungen, die über einen kurzen Zeitraum auftreten, zu glätten. Wenn Ihre aktuellen Geschäftsprozesse von großen regelmäßigen, wöchentlichen oder monatlichen Aufträgen abhängen, die versuchen, große Datenmengen in einem kurzen Zeitraum zu verarbeiten, überlegen Sie, wie Sie eine Echtzeit-Datenintegrationsstrategie aktivieren können. Wenn Sie sich von Prozessen entfernen können, die sehr anspruchsvolle Vorgänge erfordern, können Sie den Einfluss von Schutzgrenzwerten für Dienste reduzieren.

Häufig gestellte Fragen

Dieser Abschnitt enthält häufig gestellte Fragen. Wenn Sie Fragen haben, die nicht beantwortet werden, posten Sie sie mithilfe der Schaltfläche " Feedback " unten auf dieser Seite, um Feedback zu dieser Seite zu übermitteln.

Ich verwende eine von mir lizenzierte ETL-Anwendung. Wie erhalte ich einen optimalen Durchsatz?

Arbeiten Sie mit dem ETL-Anwendungsanbieter zusammen, um zu erfahren, welche Einstellungen angewendet werden sollen. Stellen Sie sicher, dass Sie eine Version des Produkts verwenden, die das Retry-After Verhalten unterstützt.

Gelten diese Grenzwerte für die Dataverse-Suche?

Nein. Die systemeigene Dataverse-Suche verwendet eine andere API (api/search anstelle von api/data) und weist unterschiedliche Regeln auf. Wenn Sie die Dataverse-Such-API verwenden, gibt es für jeden Benutzer ein Einschränkungslimit von einer Anforderung pro Sekunde.

Erfahren Sie mehr über Dataverse Search Service Protection Limits.

Inwiefern gelten diese Grenzwerte für die Anzahl der Anfragen, die ein Benutzer täglich stellen kann?

Diese Grenzwerte beziehen sich nicht auf Berechtigungsgrenzwerte. Erfahren Sie mehr über Berechtigungsbeschränkungen.

Werden Grenzwerte für Anwendungsbenutzer unterschiedlich angewendet?

Nein. Das System wendet dieselben Grenzwerte für alle Benutzer an.

Siehe auch

Power Platform verwalten / Lizenzierung und Lizenzverwaltung / Anforderungsgrenzen und -zuweisungen
Dataverse API-Grenzwerte – Übersicht
Verwenden der Dataverse-Web-API
Verwenden des Dataverse SDK für .NET