Package software.amazon.awscdk.services.apigatewayv2

Interface ThrottleSettings

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ThrottleSettings.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-17T14:40:44.605Z")
@Stability(Stable)
public interface ThrottleSettings
extends software.amazon.jsii.JsiiSerializable

Container for defining throttling parameters to API stages.

Example:

 ApiKey apiKey = new ApiKey(this, "ApiKey");
 UsagePlan usagePlan = UsagePlan.Builder.create(this, "UsagePlan")
         .usagePlanName("WebSocketUsagePlan")
         .throttle(ThrottleSettings.builder()
                 .rateLimit(10)
                 .burstLimit(2)
                 .build())
         .build();
 usagePlan.addApiKey(apiKey);
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	ThrottleSettings.Builder	A builder for ThrottleSettings
static final class	ThrottleSettings.Jsii$Proxy	An implementation for ThrottleSettings

Method Summary

Modifier and Type	Method	Description
static ThrottleSettings.Builder	builder()
default Number	getBurstLimit()	The maximum API request rate limit over a time ranging from one to a few seconds.
default Number	getRateLimit()	The API request steady-state rate limit (average requests per second over an extended period of time).

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getBurstLimit

@Stability(Stable)
@Nullable
default Number getBurstLimit()

The maximum API request rate limit over a time ranging from one to a few seconds.

Default: none

getRateLimit

@Stability(Stable)
@Nullable
default Number getRateLimit()

The API request steady-state rate limit (average requests per second over an extended period of time).

Default: none

builder

@Stability(Stable)
static ThrottleSettings.Builder builder()

Returns:

a ThrottleSettings.Builder of ThrottleSettings