How do I troubleshoot "Exceeded throttle limit" or "Exceeded quota limit" errors for my API Gateway REST API?

Resolution

Prerequisites: Verify that you turned on Amazon CloudWatch Logs to troubleshoot API Gateway. To generate event logs only for requests to your API that failed with an error, make sure that you chose Errors only. Then, use the CloudWatch console to view logged API requests and responses.

API Gateway has account-level quotas per AWS Region. If you exceed the limit, then you get an "Exceeded throttle limit" or "Exceeded quota limit" error. For more information on throttling-related settings, see How throttling limit settings are applied in API Gateway.

"Exceeded throttle limit" error

Check the rate or burst limit for the throttling limits for your client or operations that you set for the API stage for your usage plan. If you exceed the rate or burst limit, then you receive an "Exceeded throttle limit" error.

To resolve this error, use a standard retry behavior mode with jittered exponential backoff, and then resubmit your API request.

"Exceeded quota limit" error

If you exceed your API Gateway usage plan quota limit, then you receive an "Exceeded quota limit" error.

To resolve this error, extend the remaining quotas with the AWS Management Console.

Related information

How do I find API Gateway REST API errors in my CloudWatch logs?