Throttling

Last Updated: Nov 10, 2017

What is throttling policy

You can set throttling for APIs, users, and apps by minute, hour, or day, or you can sort out the specific users or apps with designated throttling policy. The throttling policy is described as follows:

  • Throttling policy contains the following dimensions:

    API traffic limit The call times within a unit time for the API bound by the policy must not exceed the set value. The time unit may be minute, hour, or day, for example, 5,000 times per minute.
    App traffic limit The call times called by each app within a unit time for an API bound to the policy must not exceed the set value, for example, 50,000 times per hour.
    User traffic limit The call times called by each Alibaba Cloud account within a unit time must not exceed the set value. An Alibaba Cloud account may have multiple apps. The traffic limit for an Alibaba Cloud account is exactly the limit on the total traffic of all apps in this account. For example, the traffic may be 500,000 times per day.
    • The three values can be set in one throttling policy. Note that the user traffic limit must not exceed the API traffic limit, and the app traffic limit must not exceed the user traffic limit.

    • In addition, you can set an additional threshold value as the traffic limit value (not allowed to exceed the value of API traffic limit) for special apps or users. However, the basic app traffic limit and user traffic limit settings in the throttling policy are no longer applicable to the special apps or users.

  • An unchangable region must be selected for the throttling policy, and the throttling policy can only be applied to APIs in the same region.

  • The traffic of a single IP address is restricted within 100 QPS regarding with the value of API traffic limit.

  • A throttling policy can be bound to multiple APIs, with the limit value and special object settings appliable to each API separately. The lattest policy bound to the API overwrites the previous one and takes effect immediately.

  • To add a special app or user, you must obtain the app ID (AppID) or the Alibaba Mail account of the user.

  • On the API Gateway console, you can create, modify, delete, view, bind, and unbind a throttling policy.

Thank you! We've received your feedback.