Manage throttling counter

You can either create a new throttling counters or delete those already exisiting.

Create a throttling counter

In the API throttling panel of API Keys and Traffic Management, you can set up throttling counters for specific sets of input conditions that incoming requests will match. In other words, you set up match criteria that determine whether a specific request increments the counter and applies toward the moving average threshold set for that counter.

📘

API

You can also complete this task by using the API Keys and Traffic Management API. Run the Create a throttling counter operation.

  1. In API Keys and Traffic Management, select the API throttling tab.

  2. Click + to create a throttling counter.

  3. Set the Enable this counter switch to Yes.

  4. In the Counter name field, enter a meaningful name for the counter.
    For example, if you are creating a counter that limits requests to a particular registered API, you can use the name of this API to name the counter.

  5. From the Access control group list, select the access control group that you want to associate with the counter.

  6. In the Requests per second field, enter the allowed number of requests per second.
    This value indicates the maximum allowed number of requests matching the associated throttling conditions per second. If the request count reaches the defined limit, API Gateway rejects any excessive requests with a 429 response until the moving average for this throttling counter diminishes to the set threshold. This usually takes up to ten seconds.

  7. In the When limit is reached field, select the preferred API Gateway behavior when the throttling counter reaches its requests-per-second limit.
    Select Warn to allow the requests above 80% of the throttling limit for this counter to still reach your origin and configure throttling headers to provide information about the limit. Select Deny to reject the requests that exceed the throttling limit for this counter.

  8. If you selected Warn:

    1. Click Add Alert to create an alert configuration.
    2. In Alert name, enter a meaningful name for the alert.
    3. In Emails, enter the internal email addresses to send the alert to. Internal email addresses end with akamai.com.

👍

Click ... > View in alerting app to view your alert configuration and history of its occurrence in the ​Control Center​ Alerts application.

  1. In the Counter notes field, enter meaningful notes about the counter for future reference.

  2. In the Throttling headers section, select the response headers to return to the origin or API client.

Header

Description

X-Throttling-Limit

The requests-per-second limit set for a throttling counter.

X-Throttling-Rate

The remaining requests available in the current second.

Delete a throttling counter

If you no longer want a throttling counter with specific conditions to increase when requests that match the conditions reach your APIs, you may delete the throttling counter.

📘

API

You can also complete this task by using the API Keys and Traffic Management API. Run the Delete a throttling counter operation.

  1. In API Keys and Traffic Management, select the API throttling tab.

  2. Click ... > Delete a throttling counter.

  3. In the confirmation window, click Yes.


Did this page help you?