software.amazon.awscdk.services.apigateway

Class UsagePlan

java.lang.Object

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.apigateway.UsagePlan

All Implemented Interfaces:

IConstruct, IDependable, IResource, IUsagePlan

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:47.786Z")
public class UsagePlan
extends Resource
implements IUsagePlan

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	Class and Description
static class	UsagePlan.Builder A fluent builder for UsagePlan.

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.apigateway.IUsagePlan

IUsagePlan.Jsii$Default, IUsagePlan.Jsii$Proxy

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	UsagePlan(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	UsagePlan(software.amazon.jsii.JsiiObjectRef objRef)
	UsagePlan(software.constructs.Construct scope, java.lang.String id)
	UsagePlan(software.constructs.Construct scope, java.lang.String id, UsagePlanProps props)

Method Summary

Modifier and Type	Method and Description
void	addApiKey(IApiKey apiKey) Adds an ApiKey.
void	addApiKey(IApiKey apiKey, AddApiKeyOptions options) Adds an ApiKey.
void	addApiStage(UsagePlanPerApiStage apiStage) Adds an apiStage.
static IUsagePlan	fromUsagePlanId(software.constructs.Construct scope, java.lang.String id, java.lang.String usagePlanId) Import an externally defined usage plan using its ARN.
java.lang.String	getUsagePlanId() Id of the usage plan.

Methods inherited from class software.amazon.awscdk.core.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isResource

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Constructor Detail

UsagePlan

protected UsagePlan(software.amazon.jsii.JsiiObjectRef objRef)

UsagePlan

protected UsagePlan(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

UsagePlan

public UsagePlan(software.constructs.Construct scope,
                 java.lang.String id,
                 UsagePlanProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

UsagePlan

public UsagePlan(software.constructs.Construct scope,
                 java.lang.String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

fromUsagePlanId

public static IUsagePlan fromUsagePlanId(software.constructs.Construct scope,
                                         java.lang.String id,
                                         java.lang.String usagePlanId)

Import an externally defined usage plan using its ARN.

Parameters:

scope - the construct that will "own" the imported usage plan. This parameter is required.

id - the id of the imported usage plan in the construct tree. This parameter is required.

usagePlanId - the id of an existing usage plan. This parameter is required.

addApiKey

public void addApiKey(IApiKey apiKey,
                      AddApiKeyOptions options)

Adds an ApiKey.

Specified by:

addApiKey in interface IUsagePlan

Parameters:

apiKey - the api key to associate with this usage plan. This parameter is required.

options - options that control the behaviour of this method.

addApiKey

public void addApiKey(IApiKey apiKey)

Adds an ApiKey.

Specified by:

addApiKey in interface IUsagePlan

Parameters:

apiKey - the api key to associate with this usage plan. This parameter is required.

addApiStage

public void addApiStage(UsagePlanPerApiStage apiStage)

Adds an apiStage.

Parameters:

apiStage - This parameter is required.

getUsagePlanId

public java.lang.String getUsagePlanId()

Id of the usage plan.

Specified by:

getUsagePlanId in interface IUsagePlan