Package software.amazon.awscdk.services.apigateway

Interface UsagePlanProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

UsagePlanProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-13T16:09:57.957Z")
@Stability(Stable)
public interface UsagePlanProps
extends software.amazon.jsii.JsiiSerializable

Example:

 LambdaIntegration integration;
 RestApi api = new RestApi(this, "hello-api");
 Resource v1 = api.root.addResource("v1");
 Resource echo = v1.addResource("echo");
 Method echoMethod = echo.addMethod("GET", integration, MethodOptions.builder().apiKeyRequired(true).build());
 UsagePlan plan = api.addUsagePlan("UsagePlan", UsagePlanProps.builder()
         .name("Easy")
         .throttle(ThrottleSettings.builder()
                 .rateLimit(10)
                 .burstLimit(2)
                 .build())
         .build());
 IApiKey key = api.addApiKey("ApiKey");
 plan.addApiKey(key);
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static UsagePlanProps.Builder	builder()
default List<UsagePlanPerApiStage>	getApiStages()	API Stages to be associated with the usage plan.
default String	getDescription()	Represents usage plan purpose.
default String	getName()	Name for this usage plan.
default QuotaSettings	getQuota()	Number of requests clients can make in a given time period.
default ThrottleSettings	getThrottle()	Overall throttle settings for the API.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getApiStages

@Stability(Stable)
@Nullable
default List<UsagePlanPerApiStage> getApiStages()

API Stages to be associated with the usage plan.

Default: none

getDescription

@Stability(Stable)
@Nullable
default String getDescription()

Represents usage plan purpose.

Default: none

getName

@Stability(Stable)
@Nullable
default String getName()

Name for this usage plan.

Default: none

getQuota

@Stability(Stable)
@Nullable
default QuotaSettings getQuota()

Number of requests clients can make in a given time period.

Default: none

getThrottle

@Stability(Stable)
@Nullable
default ThrottleSettings getThrottle()

Overall throttle settings for the API.

Default: none

builder

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

Returns:

a UsagePlanProps.Builder of UsagePlanProps