---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Begrenzung der eingehenden REST-API-Rate

# Begrenzung der eingehenden REST-API-Rate {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Um übermäßige eingehende REST-API-Anforderungen zu verhindern, legen Sie Regeln fest, die die Anzahl der pro Stunde verarbeiteten eingehenden REST-API-Anforderungen begrenzen. Sie können Regeln erstellen, um Anforderungen für bestimmte Anwender, Anwender mit bestimmten Rollen oder alle Anwender einzuschränken.  
Hinweis:  
Wenn Anforderungen eine Instanz erreichen, verwaltet jeder Knoten eine Quotenbegrenzung pro Anwender. Alle 30 Sekunden wird die Anzahl an die Datenbank übergeben. Daher wird eine Quotenbegrenzungsregel möglicherweise bis zu 30 Sekunden nicht wirksam.

## Ratenbegrenzungspriorität {#inbound-REST-API-rate-limiting__section_isk_1gr_hdb}

Wenn eine eingehende REST-API-Anforderung mehreren Quotenbegrenzungsregeln für dieselbe Ressource entspricht, wird die Quotenbegrenzungspriorität wie folgt erzwungen:

* Regeln festgelegt für Einzelner Anwender Überschreiben Sie Regeln für Alle Anwender Und -Regeln für Anwender mit Rolle .
* Regeln festgelegt für Anwender mit Rolle Überschreiben Sie Regeln für Alle Anwender .
{#inbound-REST-API-rate-limiting__ul_oy2_xrk_hdb}  
In diesem Beispiel gibt es vier Quotenbegrenzungsregeln für dieselbe REST-API-Ressource: `RUFT /now/v2/table/Incident AB `:  
Diese Quotenbegrenzungsregeln werden in der folgenden Reihenfolge angewendet:

1. Incidents nach Anwender begrenzen Gilt für ITIL-Anwender, der bis zu 10 Anforderungen pro Stunde übermitteln kann.
2. Beschränken Sie Incidents nach Importadministratorrolle Gilt für jeden Anwender mit der Rolle „Import_admin". Jeder Anwender mit der Rolle „Import_admin" kann bis zu drei Anforderungen pro Stunde übermitteln.
3. Incidents nach itil-Rolle begrenzen Gilt für jeden Anwender mit der itil-Rolle. Jeder Anwender mit der itil-Rolle kann bis zu fünf Anforderungen pro Stunde übermitteln.
4. Incidents Begrenzen Gilt für alle Anwender. Jeder Anwender kann bis zu zwei Anforderungen pro Stunde übermitteln.
{#inbound-REST-API-rate-limiting__ul_k4q_qjr_hdb}

Wenn der ITIL-Anwender die Anforderung stellt `RUFT /now/v2/table/Incident AB `, Die Anforderung erfüllt die Kriterien für drei Regeln: Incidents Begrenzen , Incidents nach itil-Rolle begrenzen , Und Incidents nach Anwender begrenzen . Nur die Incidents nach Anwender begrenzen Regel wird angewendet, da sie Vorrang vor den anderen Regeln hat. Daher kann der ITIL-Anwender maximal 10 Anforderungen pro Stunde übermitteln.

Wenn ein Anwender zwei oder mehr Rollen hat, die den Kriterien mehrerer Quotenbegrenzungsregeln für eine REST-API-Ressource entsprechen, gilt die Regel, die die niedrigste Anzahl von Anforderungen zulässt, für die Anforderungen des Anwenders für die Ressource. Für die Beispielregeln in der obigen Abbildung wird davon ausgegangen, dass der Anwender Abel Tuter sowohl die Rolle „Import_admin" als auch die Rolle „itil" hat. Wenn Abel Tuter eine Anforderung übermittelt, erfüllt sie die Kriterien für beide Beschränken Sie Incidents nach Administratorrolle Regel und Incidents nach itil-Rolle begrenzen Regel. Nur die Beschränken Sie Incidents nach Administratorrolle Regel wird angewendet, da sie die niedrigste Anzahl von Anforderungen zulässt. Daher kann Abel Tuter maximal drei Anforderungen pro Stunde übermitteln.

## REST-API-Antwortheader {#inbound-REST-API-rate-limiting__section_l5l_5my_hdb}

Sie können eingehende REST-API-Anforderungen mit generieren [Verwenden Sie den REST-API-Explorer](https://servicenow-prod.fluidtopics.net/QZyr9s_~V0xB9fqGOlvJ4A "In diesem Tutorial verwenden Sie den REST API Explorer, um zu testen ServiceNowREST-APIs.")Oder ein HTTP-Client, z. B. Postman. Wenn die Anforderung einer Quotenbegrenzungsregel entspricht, geben mehrere HTTP-Antwortheader Informationen zur Quotenbegrenzung an:

* X-RateLimit-limit Zeigt die Anzahl der zulässigen Anforderungen pro Stunde an.
* X-RateLimit-Zurücksetzen Zeigt die Unix-Zeit bis zur nächsten geplanten Zurücksetzung an.
* X-RateLimit-Regel Zeigt die sys_ID der Quotengrenzregel an, die erzwungen wird.

{#inbound-REST-API-rate-limiting__ul_xpr_w4y_hdb}  
Wenn eine Anforderung abgelehnt wird, da sie die Quotengrenze überschreitet, gibt das System einen zurück Wiederholen Sie Es Nach Antwortheader zusätzlich zu den Antwortheadern zur Quotenbegrenzung. Die Wiederholen Sie Es Nach Der Antwortheader zeigt die Anzahl der Sekunden an, nach denen Sie die Anforderung wiederholen können, um zu vermeiden, dass die Quotengrenze überschritten wird. Die folgende Fehlerantwort wird zurückgegeben:

    {
        "error": {
            "message": "Rate limit exceeded",
            "detail": "Rate limit of 10 requests per hour for Table API exceeded"
        },
        "status": "failure"
    }

Der Status einer abgelehnten Anforderung ist 429 Zu Viele Anforderungen .

* **[Erstellen Sie ein eingehendes REST API-Quotenlimit](https://servicenow-prod.fluidtopics.net/v6fGoHzyD~XDjRLxbZ0FdQ)**   
  Erstellen Sie Quotenbegrenzungsregeln, um die Anzahl der pro Stunde verarbeiteten eingehenden REST-API-Anforderungen zu begrenzen.
* **[Setzen Sie einen Grenzwert für eingehende REST-API-Quoten zurück](https://servicenow-prod.fluidtopics.net/pS6Uq4eiQlEyVarBka1Ptg)**   
  Setzen Sie eine Quotenbegrenzungsregel zurück, um die Quotenbegrenzungsanzahl auf null (0) zurückzusetzen und alle Verstöße für die aktuelle Stunde zu löschen.
* **[Überwachen Sie die Anzahl der eingehenden REST-API-Quotenbegrenzungen und Verstöße](https://servicenow-prod.fluidtopics.net/niC5AjV_FVIfS8u5PmWcIg)**   
  Um zu bestimmen, ob Sie eine Quotenbegrenzungsregel entsprechend festgelegt haben, überwachen Sie die Anzahl und Verstöße für eingehende REST-API-Anforderungen, die durch die Regel eingeschränkt werden.
* **[Untersuchen Sie Verstöße gegen das Quotenlimit für eingehende REST-API](https://servicenow-prod.fluidtopics.net/PiS3n8I0l6PMpC0DPN~byQ)**   
  Untersuchen Sie Verstöße gegen Quotenbegrenzungen, um zu bestimmen, welche Quotenbegrenzungsregeln überschritten werden und welche Anwender diese Quotengrenzen überschreiten.

