Bandwidth limit

Note

This extension has an unknown security posture and should only be used in deployments where both the downstream and upstream are trusted.

Tip

This extension extends and can be used with the following extension category:

Bandwidth limit configuration overview.

stat_prefix

(string, REQUIRED) The human readable prefix to use when emitting stats.

enable_mode

limit_kbps

() The limit supplied in KiB/s.

Note

It’s fine for the limit to be unset for the global configuration since the bandwidth limit can be applied at a the virtual host or route level. Thus, the limit must be set for the per route configuration otherwise the config will be rejected.

Note

When using per route configuration, the limit becomes unique to that route.

fill_interval

(Duration) Optional Fill interval in milliseconds for the token refills. Defaults to 50ms. It must be at least 20ms to avoid too aggressive refills.

runtime_enabled

Enum extensions.filters.http.bandwidth_limit.v3.BandwidthLimit.EnableMode

[extensions.filters.http.bandwidth_limit.v3.BandwidthLimit.EnableMode proto]

Defines the mode for the bandwidth limit filter. Values represent bitmask.

DISABLED

(DEFAULT) ⁣Filter is disabled.

REQUEST

⁣Filter enabled only for incoming traffic.

RESPONSE

⁣Filter enabled only for outgoing traffic.

REQUEST_AND_RESPONSE