Nutzungskontingente
Ein Kontingent begrenzt, wie oft eine Operation innerhalb eines gleitenden Zeitfensters laufen kann. Wer das Limit erreicht, erhält die Meldung, die Sie für diese Regel geschrieben haben.
Regeln an der Operation
Kontingente werden in der Config an der Operation als Liste von Regeln deklariert. Eine Regel setzt points, die höchste Zahl erlaubter Läufe im Fenster, und duration, die Länge des Fensters in Sekunden. Null points bedeutet unbegrenzt. Das Fenster gleitet: Jeder Lauf erhält einen Zeitstempel, und Läufe, die älter als die Dauer sind, fallen aus der Zählung.
Wessen Läufe gezählt werden
Eine Regel kann pro angemeldetem Nutzer zählen, sodass jede Person ein eigenes Kontingent hat. Ein Kontingent kann auch über einen größeren Pool geteilt werden.
Am Limit
Der Aufruf schlägt mit RATE_LIMITED und der Meldung der Regel fehl. Eine Regel ohne Meldung gibt einen Fehler zurück, der die Nutzung, das Limit und den Zeitpunkt des Zurücksetzens des Fensters nennt.
Stufen aus der Regelreihenfolge
Regeln werden von oben nach unten ausgewertet, und die erste zutreffende gewinnt. Eine Regel kann beschränkt werden auf die Mitglieder eines Segments, was eine gestufte Einrichtung ergibt: eine unbegrenzte Regel für ein Segment zahlender Nutzer, gefolgt von einer gemessenen Regel für alle anderen.
Reihenfolge der Prüfungen und Ausfall
Kontingente werden geprüft, nachdem die Preconditions bestanden sind. Kann der Zählerspeicher nicht gelesen werden, erlaubt eine Regel den Aufruf standardmäßig, und eine Regel kann so eingestellt werden, dass sie geschlossen ausfällt und ablehnt. Ein Kontingent misst nur Operationen.
Details nachlesen
Die Referenz zur Operationen-Config listet jedes Feld einer Kontingentregel auf und zeigt das gestufte Muster.