Ratelimit you Are Doing That Too Much Try Again in 8 Minutes on Field ratelimit
Rate and concurrent request limits
This article describes the asking charge per unit limits, concurrent request limits, and other limits that Zuora enforces to maximize the stability of its service.
Rate limits
Zuora employs a number of tenant-level charge per unit limits against bursts of incoming traffic to maximize the stability of its service. Notation that the rate limits are in improver to, and independent of, the concurrent asking limits.
Rate-limiting and quotas
Zuora sets limits on the type and number of requests that a tenant tin can make per minute, per hour, and per day. All incoming requests are classified as follows:
- UI requests: all UI requests
- Authentication requests: all OAuth authentication, ZSession connexion and SOAP login requests
- API requests: all API requests other than hallmark requests
Zuora enforces the post-obit rate limits on each tenant.
Request type | Quota per minute | Quota per 60 minutes | Quota per day |
---|---|---|---|
UI | xx,000 | 1,200,000 | 14,400,000 |
Authentication | 2,000 | 67,500 | 810,000 |
API | 50,000 | 2,250,000 | 27,000,000 |
We recommend that y'all treat these limits as maximums and avoid generating unnecessary load. Nosotros may reduce limits to prevent corruption, or increase limits to enable loftier-traffic applications. To request an increased rate limit, contact Zuora Global Support.
Zuora counts your UI, hallmark and API requests in the time window of one minute, i hour or one twenty-four hours. The system communicates the quota that you are closest to exhausting in the HTTP response header in compliance with the IETF draft policy for rate limiting v2.
HTTP response header | Clarification |
---|---|
RateLimit-Limit | The asking limit quota for the fourth dimension window closest to exhaustion. |
RateLimit-Remaining | The number of requests remaining in the time window closest to quota exhaustion. |
RateLimit-Reset | The number of seconds until the quota resets for the time window closest to quota exhaustion. |
Use cases
Consider that you lot take a tenant with the default charge per unit limits of API requests. Assume that your tenant's API request numbers for the current time windows at a certain point of time are as follows:
Time window | API request charge per unit limit | API asking number for the electric current time window |
---|---|---|
I minute | fifty,000 | 49,500 |
One 60 minutes | 2,250,000 | two,249,600 |
Ane day | 27,000,000 | 25,900,000 |
At this time point, you are closest to exhausting the hourly limit of API requests. If you brand an API request, the response headers convey the hourly charge per unit limit information of your tenant. Yous can encounter the charge per unit limit information as in the following snippet of the response headers:
HTTP/one.one 200 OK
Content-Type: application/json
RateLimit-Limit : 2250000, 50000;due west=threescore, 2250000;w=3600, 27000000;w=86400
RateLimit-Remaining : 399
RateLimit-Reset : 1200
Mistake messages
In the to a higher place utilise case, the headers inform that you tin brand, at most, 399 API requests further in the next i,200 seconds (or 20 minutes). Suppose that y'all make 399 API requests within the next ten minutes, and so if you brand the 400th API request at the time signal of x minutes before the current time window is closed, yous will receive a response with HTTP status lawmaking429 - Too Many Requests and a response body in JSON equally follows:
HTTP/1.1 429 - Too Many Requests
Content-Blazon: application/json
RateLimit-Limit : 2250000, 50000;w=threescore, 2250000;w=3600, 27000000;w=86400
RateLimit-Remaining : 0
RateLimit-Reset : 600
{ "reasons": [ { "code": 70, "message": "API Rate limit exceeded for the <minute|60 minutes|day>, retry after 600 seconds" } ] }
Concurrent request limits
Zuora employs a number of concurrent request limits to maximize the stability of its service. If the Multi-entity characteristic is enabled in your tenant, the concurrent request limits apply at the entity level. Otherwise, the concurrent request limits apply at the tenant level.
Concurrent request limit types
Zuora applies dissimilar request limits to dissimilar types of requests. The request limits are:
-
Total Request limit - 40 concurrent requests by default
Most UI and API requests are counted towards your Total Request limit.
Some requests require a big amount of processing or information transfer. The following additional concurrent limits apply to such requests:-
Big Process Request limit - 20 concurrent requests by default. All big process requests are as well counted towards your Total Request limit. The requests that crave heavy database operations are large process requests. For example, requests for retrieving payments for a specified account. Run across the Large Process Requests tabular array below for more than data.
-
Big Information Request limit - 20 concurrent requests by default. All big data requests are also counted towards your Total Request limit.
-
- Custom Asking limit - 200 concurrent requests by default. Custom requests are NOT counted towards your Total Asking limit.
See the following table for the concurrent request limits that use to unlike production areas.
Product Area | Operations | Total Request Limit | Big Data Request Limit | Big Process Request Limit | Custom Request Limit |
---|---|---|---|---|---|
Subscriptions | Subscribe and ameliorate REST method calls:
Subscribe and amend SOAP calls, and the corresponding Activeness calls in the Zuora API Reference:
| ![]() | |||
Orders | Orders:
| ![]() | |||
Orders:
| ![]() | ||||
Login | Login Requests:
(No applicable concurrent limit for Login requests) | ||||
HPM | Hosted Payment Method Pages:
| ![]() | |||
CPQ | Zuora 360 Club Builder (includes APEX wrappers for SOAP APIs) | ![]() | |||
Zuora for Salesforce
(No applicable concurrent limit) | |||||
AQuA | AQuA API requests
| ![]() | |||
AQuA results files download | ![]() | ![]() | |||
Usage | Usage asking
| ![]() | ![]() | ||
Usage asking
| ![]() | ||||
Data Source Export | Information source file download | ![]() | ![]() | ||
Invoicing | Transactions
| ![]() | ![]() |
Large process requests
Soap API calls on some objects are handled every bit Big Procedure Requests. See the post-obit tabular array for details. The corresponding REST API Actions are likewise handled equally big process requests.
Lather API Calls | Objects |
---|---|
Create | invoice |
Generate | invoice |
QueryMore | Account InvoiceItem PaymentTransactionLog RatePlan RatePlanCharge RatePlanChargeTier Subscription |
Query | Business relationship Invoice InvoicePayment Payment PaymentTransactionLog RatePlan RatePlanCharge Subscription Usage ProcessedUsage |
Errors when reaching concurrent request limits
You will come across the following fault codes, error messages, or HTTP status codes:
Request Type | Error Code | Error Bulletin | HTTP Condition Code - Response Header |
---|---|---|---|
User Interface | N/A | "The total number of concurrent requests has exceeded the limit allowed by the system. Please resubmit your request later." | N/A |
Remainder API | 50000070 | "The total number of concurrent requests has exceeded the limit immune by the system. Please resubmit your asking later on." | HTTP Status: 429 Response Header: |
Lather API, version 51.0 and later on | | | HTTP Condition: 429 Response Header: |
SOAP API, versions prior to 51.0 | | | HTTP Status: 429 Response Header: |
File Download API | N/A | "The full number of concurrent requests has exceeded the limit immune by the system. Please resubmit your request subsequently." | HTTP Status: 429 Response Header: |
Zuora recommends that y'all retry sending the request after 120 seconds.
We recommend that you lot test your integration in Zuora Sandbox and brand certain you do not striking the concurrent request limits. Contact Zuora Global Support if you require additional assistance.
Other Limitations
Limitation on Memo PDF
Up to twenty,000 line items are allowed in a single memo PDF.
Limitation on Invoice PDF
A maximum of 100,000 usage charges can be processed to generate a usage nested table on a PDF file. A maximum of 100,000 invoice items tin be processed to generate an invoice particular nested table on a PDF file. Consider this scenario, even if you but display summary columns in a nested table and there are only ten lines, the organisation cannot process more than than 100,000 records to generate those ten lines.
A maximum sum of 20,000 invoice items, usage charges, and revenue enhancement items can be displayed in a detailed table or nested table on a PDF file.
A maximum of 2,000 records are immune for each of the post-obit tables to exist generated into a PDF file (2,000 is the default limit; the maximum limit is 10,000. Contact Zuora Global Support if you want to raise the limit):
- Transactions
- Previous transactions
- Subscriptions
When generating an invoice PDF, you lot will receive an error bulletin if the maximum number is exceeded.
Amendments per Subscription
Zuora recommends that you lot create no more than 100 amendments on a subscription to ensure loftier performance of the subscriptions. The limit of amendments allowed on a subscription is grand. However, if y'all create more than than 100 amendments, the performance may exist severely degraded, depending on the products and charges gear up in your subscription.
The limit of subscriptions allowed on an account is by default 12,000. All the same, if you have overridden the value of this limit for your tenant, the value will remain per your configuration.
If the renewal term period of the latest version of the subscription is Solar day or Week, the limit of amendments allowed on a subscription is 100.
The 100 amendment limit does not use to Orders. Come across Orders Performance Guidance for more data.
Limitation on numbers
Zuora Billing uses decimal data type to hold numbers, significant that numeric fields, like listing toll, are limited to the range from -9999999999999.99 to 9999999999999.99.
Source: https://knowledgecenter.zuora.com/BB_Introducing_Z_Business/Policies/Concurrent_Request_Limits
0 Response to "Ratelimit you Are Doing That Too Much Try Again in 8 Minutes on Field ratelimit"
Postar um comentário