Grenzwert für eingehende REST-APIs erstellen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer
  • Erstellen Sie Quotengrenzregeln, um die Anzahl der pro Stunde verarbeiteten eingehenden REST-API-Anforderungen zu begrenzen.

    Vorbereitungen

    Erforderliche Rolle: rate_limit_admin

    Warum und wann dieser Vorgang ausgeführt wird

    Legen Sie Quotengrenzen für alle Benutzer oder Benutzer mit bestimmten Rollen fest.
    Hinweis:
    Wenn Anforderungen eine Instanz erreichen, verwaltet jeder Knoten eine Ratenbeschränkung pro Benutzer. Alle 30 Sekunden wird die Zählung in die Datenbank übernommen. Eine Quotengrenzregel kann daher bis zu 30 Sekunden nicht wirksam sein.

    Prozedur

    1. Navigieren zu Alle > System-Webservices > REST > Quotenbegrenzungsregeln.
    2. Klicken Sie auf Neu, und geben Sie die folgenden Feldwerte ein.
      Tabelle : 1. REST-API-Quotengrenzregel-Formular
      Feld Beschreibung
      REST-API-Ressource Der Wert wird von den Werten abgeleitet, die in den folgenden Feldern eingegeben werden.
      Name Eindeutiger Name für die Quotengrenzregel.
      REST-API REST-API, die aus der Liste aller nach außen gerichteten REST-APIs für die Instanz ausgewählt wird.
      Version Version der REST-API. Die aufgeführten Werte sind abhängig von der ausgewählten REST-API.
      Ressource Ressource für die Version. Die aufgeführten Werte sind abhängig von der ausgewählten Version.
      Tabelle Die gewünschte Tabelle. Wird nur angezeigt, wenn Sie die Table-API als REST-API auswählen.
      Import Set-Tabelle Die gewünschte Import Set-Tabelle. Wird nur angezeigt, wenn Sie Import Set-API als REST-API auswählen.
      Aktiv Aktivieren Sie die Checkbox, um anzugeben, dass die Quotengrenzregel aktiv ist.

      Quotengrenzregeln werden standardmäßig aktiviert, sobald Sie sie erstellen. Sie können Quotengrenzregeln deaktivieren, um die Durchsetzung einer Quotengrenze zu beenden, oder Quotengrenzregeln aktivieren, um die Quotengrenze wieder zu erzwingen.

      Anforderungsbegrenzung pro Stunde Die maximal zulässige Anzahl von Anforderungen pro Stunde.
      Hinweis:
      Immer wenn Sie den Wert dieses Feldes aktualisieren, setzt die Now Platform die Anzahl der Anforderungen auf 0 zurück und löscht alle Verstöße für die aktuelle Stunde.
      Anwenden auf Benutzer, die durch diese Regel eingeschränkt werden:
      • Einzelbenutzer wendet die Quotengrenze auf einen bestimmten Benutzer an.
      • Benutzer mit Rolle wendet die Quotengrenze auf alle Benutzer mit einer bestimmten Rolle an.
      • Alle Benutzer wendet die Quotengrenze auf alle Benutzer an.
      Rolle Rolle, für die die Quotengrenze gilt. Wird nur angezeigt, wenn Sie Benutzer mit Rolle im Feld Anwenden auf auswählen.
      Anwender Benutzer, für den die Quotengrenze gilt. Wird nur angezeigt, wenn Sie Einzelbenutzer im Feld Anwenden auf auswählen.
    3. Klicken Sie auf Absenden.
      Die neue Quotengrenze tritt in Kraft.

    Nächste Maßnahme

    Nachdem Sie die Regel abgesendet haben, fügt die Now Platform die folgenden zugehörigen Listen zum Regeldatensatz hinzu:
    Quotengrenzwerte
    Führt die Anzahl der eingehenden REST-API-Anforderungen, die von dieser Quotengrenzregel betroffen sind, nach Benutzer auf.
    Verstöße gegen Quotengrenze
    Führt die Verstöße gegen die Quotengrenzregel nach Benutzer auf.

    Sie können diese zugehörigen Listen für Folgendes verwenden: Quotengrenzwerte und Verstöße für eingehende REST-APIs überwachen.