aws-cdk-lib 2.211.0__py3-none-any.whl → 2.212.0__py3-none-any.whl

aws_cdk/aws_apigatewayv2/__init__.py

@@ -21,6 +21,7 @@ r'''
 
   * [Manage Connections Permission](#manage-connections-permission)
   * [Managing access to WebSocket APIs](#managing-access-to-websocket-apis)
+  * [Usage Plan and API Keys](#usage-plan-and-api-keys)
 
 ## Introduction
 
@@ -605,6 +606,155 @@ apigwv2.HttpStage(self, "Stage",
     detailed_metrics_enabled=True
 )
 ```
+
+## Usage Plan and API Keys
+
+A usage plan specifies who can access one or more deployed WebSocket API stages, and the rate at which they can be accessed. The plan uses API keys to
+identify API clients and meters access to the associated API stages for each key. Usage plans also allow configuring throttling limits and quota limits that are
+enforced on individual client API keys.
+
+The following example shows how to create and associate a usage plan and an API key for WebSocket APIs:
+
+```python
+api_key = apigwv2.ApiKey(self, "ApiKey")
+
+usage_plan = apigwv2.UsagePlan(self, "UsagePlan",
+    usage_plan_name="WebSocketUsagePlan",
+    throttle=apigwv2.ThrottleSettings(
+        rate_limit=10,
+        burst_limit=2
+    )
+)
+
+usage_plan.add_api_key(api_key)
+```
+
+To associate a plan to a given WebSocketAPI stage:
+
+```python
+api = apigwv2.WebSocketApi(self, "my-api")
+stage = apigwv2.WebSocketStage(self, "my-stage",
+    web_socket_api=api,
+    stage_name="dev"
+)
+
+usage_plan = apigwv2.UsagePlan(self, "my-usage-plan",
+    usage_plan_name="Basic"
+)
+
+usage_plan.add_api_stage(
+    api=api,
+    stage=stage
+)
+```
+
+Existing usage plans can be imported into a CDK app using its id.
+
+```python
+usage_plan = apigwv2.UsagePlan.from_usage_plan_id(self, "imported-usage-plan", "<usage-plan-id>")
+```
+
+The name and value of the API Key can be specified at creation; if not provided, a name and a value will be automatically generated by API Gateway.
+
+```python
+# Auto-generated name and value
+auto_key = apigwv2.ApiKey(self, "AutoKey")
+
+# Explicit name and value
+explicit_key = apigwv2.ApiKey(self, "ExplicitKey",
+    api_key_name="MyWebSocketApiKey",
+    value="MyApiKeyThatIsAtLeast20Characters"
+)
+```
+
+Existing API keys can also be imported into a CDK app using its id.
+
+```python
+imported_key = apigwv2.ApiKey.from_api_key_id(self, "imported-key", "<api-key-id>")
+```
+
+The "grant" methods can be used to give prepackaged sets of permissions to other resources. The
+following code provides read permission to an API key.
+
+```python
+import aws_cdk.aws_iam as iam
+
+
+user = iam.User(self, "User")
+api_key = apigwv2.ApiKey(self, "ApiKey",
+    customer_id="test-customer"
+)
+api_key.grant_read(user)
+```
+
+### Adding an API Key to an imported WebSocketApi
+
+API Keys for WebSocket APIs are associated through Usage Plans, not directly to stages. When you import a WebSocketApi, you need to create a Usage Plan that references the
+imported stage and then associate the API key with that Usage Plan.
+
+```python
+# web_socket_api: apigwv2.IWebSocketApi
+
+
+imported_stage = apigwv2.WebSocketStage.from_web_socket_stage_attributes(self, "imported-stage",
+    stage_name="myStage",
+    api=web_socket_api
+)
+
+api_key = apigwv2.ApiKey(self, "MyApiKey")
+
+usage_plan = apigwv2.UsagePlan(self, "MyUsagePlan",
+    api_stages=[apigwv2.UsagePlanPerApiStage(api=web_socket_api, stage=imported_stage)]
+)
+
+usage_plan.add_api_key(api_key)
+```
+
+### Multiple API Keys
+
+It is possible to specify multiple API keys for a given Usage Plan, by calling `usagePlan.addApiKey()`.
+
+When using multiple API keys, you may need to ensure that the CloudFormation logical ids of the API keys remain consistent across deployments. You can set the logical id as part of the `addApiKey()` method
+
+```python
+# usage_plan: apigwv2.UsagePlan
+# api_key: apigwv2.ApiKey
+
+
+usage_plan.add_api_key(api_key,
+    override_logical_id="MyCustomLogicalId"
+)
+```
+
+### Rate Limited API Key
+
+In scenarios where you need to create a single api key and configure rate limiting for it, you can use `RateLimitedApiKey`.
+This construct lets you specify rate limiting properties which should be applied only to the api key being created.
+The API key created has the specified rate limits, such as quota and throttles, applied.
+
+The following example shows how to use a rate limited api key :
+
+```python
+# api: apigwv2.WebSocketApi
+# stage: apigwv2.WebSocketStage
+
+
+key = apigwv2.RateLimitedApiKey(self, "rate-limited-api-key",
+    customer_id="test-customer",
+    api_stages=[apigwv2.UsagePlanPerApiStage(
+        api=api,
+        stage=stage
+    )],
+    quota=apigwv2.QuotaSettings(
+        limit=10000,
+        period=apigwv2.Period.MONTH
+    ),
+    throttle=apigwv2.ThrottleSettings(
+        rate_limit=100,
+        burst_limit=200
+    )
+)
+```
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -721,6 +871,309 @@ class AccessLogDestinationConfig:
         )
 
 
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.AddApiKeyOptions",
+    jsii_struct_bases=[],
+    name_mapping={"override_logical_id": "overrideLogicalId"},
+)
+class AddApiKeyOptions:
+    def __init__(
+        self,
+        *,
+        override_logical_id: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Options to the UsagePlan.addApiKey() method.
+
+        :param override_logical_id: Override the CloudFormation logical id of the AWS::ApiGateway::UsagePlanKey resource. Default: - autogenerated by the CDK
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # usage_plan: apigwv2.UsagePlan
+            # api_key: apigwv2.ApiKey
+            
+            
+            usage_plan.add_api_key(api_key,
+                override_logical_id="MyCustomLogicalId"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__0941f7d28f81063a43bd13461ff2c77b07dbc27ccb33f1747ba86e63cb135cfa)
+            check_type(argname="argument override_logical_id", value=override_logical_id, expected_type=type_hints["override_logical_id"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if override_logical_id is not None:
+            self._values["override_logical_id"] = override_logical_id
+
+    @builtins.property
+    def override_logical_id(self) -> typing.Optional[builtins.str]:
+        '''Override the CloudFormation logical id of the AWS::ApiGateway::UsagePlanKey resource.
+
+        :default: - autogenerated by the CDK
+        '''
+        result = self._values.get("override_logical_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "AddApiKeyOptions(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.ApiKeyOptions",
+    jsii_struct_bases=[],
+    name_mapping={
+        "api_key_name": "apiKeyName",
+        "description": "description",
+        "value": "value",
+    },
+)
+class ApiKeyOptions:
+    def __init__(
+        self,
+        *,
+        api_key_name: typing.Optional[builtins.str] = None,
+        description: typing.Optional[builtins.str] = None,
+        value: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''The options for creating an API Key.
+
+        :param api_key_name: A name for the API key. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name. Default: automatically generated name
+        :param description: A description of the purpose of the API key. Default: none
+        :param value: The value of the API key. Must be at least 20 characters long. Default: none
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_apigatewayv2 as apigatewayv2
+            
+            api_key_options = apigatewayv2.ApiKeyOptions(
+                api_key_name="apiKeyName",
+                description="description",
+                value="value"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__7a705f0b737f132294a153b02c31b4d08ac0e91a2d1357048ce93fa1d3dcc0aa)
+            check_type(argname="argument api_key_name", value=api_key_name, expected_type=type_hints["api_key_name"])
+            check_type(argname="argument description", value=description, expected_type=type_hints["description"])
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if api_key_name is not None:
+            self._values["api_key_name"] = api_key_name
+        if description is not None:
+            self._values["description"] = description
+        if value is not None:
+            self._values["value"] = value
+
+    @builtins.property
+    def api_key_name(self) -> typing.Optional[builtins.str]:
+        '''A name for the API key.
+
+        If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name.
+
+        :default: automatically generated name
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-name
+        '''
+        result = self._values.get("api_key_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def description(self) -> typing.Optional[builtins.str]:
+        '''A description of the purpose of the API key.
+
+        :default: none
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-description
+        '''
+        result = self._values.get("description")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def value(self) -> typing.Optional[builtins.str]:
+        '''The value of the API key.
+
+        Must be at least 20 characters long.
+
+        :default: none
+
+        :link: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-value
+        '''
+        result = self._values.get("value")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "ApiKeyOptions(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.ApiKeyProps",
+    jsii_struct_bases=[ApiKeyOptions],
+    name_mapping={
+        "api_key_name": "apiKeyName",
+        "description": "description",
+        "value": "value",
+        "customer_id": "customerId",
+        "enabled": "enabled",
+        "generate_distinct_id": "generateDistinctId",
+    },
+)
+class ApiKeyProps(ApiKeyOptions):
+    def __init__(
+        self,
+        *,
+        api_key_name: typing.Optional[builtins.str] = None,
+        description: typing.Optional[builtins.str] = None,
+        value: typing.Optional[builtins.str] = None,
+        customer_id: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        generate_distinct_id: typing.Optional[builtins.bool] = None,
+    ) -> None:
+        '''ApiKey Properties.
+
+        :param api_key_name: A name for the API key. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name. Default: automatically generated name
+        :param description: A description of the purpose of the API key. Default: none
+        :param value: The value of the API key. Must be at least 20 characters long. Default: none
+        :param customer_id: An AWS Marketplace customer identifier to use when integrating with the AWS SaaS Marketplace. Default: none
+        :param enabled: Indicates whether the API key can be used by clients. Default: true
+        :param generate_distinct_id: Specifies whether the key identifier is distinct from the created API key value. Default: false
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # Auto-generated name and value
+            auto_key = apigwv2.ApiKey(self, "AutoKey")
+            
+            # Explicit name and value
+            explicit_key = apigwv2.ApiKey(self, "ExplicitKey",
+                api_key_name="MyWebSocketApiKey",
+                value="MyApiKeyThatIsAtLeast20Characters"
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__8f84fc0c61e7fd558c82b45bbc4bcd6801e5a01a36339712c0577607b261c786)
+            check_type(argname="argument api_key_name", value=api_key_name, expected_type=type_hints["api_key_name"])
+            check_type(argname="argument description", value=description, expected_type=type_hints["description"])
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+            check_type(argname="argument customer_id", value=customer_id, expected_type=type_hints["customer_id"])
+            check_type(argname="argument enabled", value=enabled, expected_type=type_hints["enabled"])
+            check_type(argname="argument generate_distinct_id", value=generate_distinct_id, expected_type=type_hints["generate_distinct_id"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if api_key_name is not None:
+            self._values["api_key_name"] = api_key_name
+        if description is not None:
+            self._values["description"] = description
+        if value is not None:
+            self._values["value"] = value
+        if customer_id is not None:
+            self._values["customer_id"] = customer_id
+        if enabled is not None:
+            self._values["enabled"] = enabled
+        if generate_distinct_id is not None:
+            self._values["generate_distinct_id"] = generate_distinct_id
+
+    @builtins.property
+    def api_key_name(self) -> typing.Optional[builtins.str]:
+        '''A name for the API key.
+
+        If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name.
+
+        :default: automatically generated name
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-name
+        '''
+        result = self._values.get("api_key_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def description(self) -> typing.Optional[builtins.str]:
+        '''A description of the purpose of the API key.
+
+        :default: none
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-description
+        '''
+        result = self._values.get("description")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def value(self) -> typing.Optional[builtins.str]:
+        '''The value of the API key.
+
+        Must be at least 20 characters long.
+
+        :default: none
+
+        :link: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-value
+        '''
+        result = self._values.get("value")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def customer_id(self) -> typing.Optional[builtins.str]:
+        '''An AWS Marketplace customer identifier to use when integrating with the AWS SaaS Marketplace.
+
+        :default: none
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-customerid
+        '''
+        result = self._values.get("customer_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def enabled(self) -> typing.Optional[builtins.bool]:
+        '''Indicates whether the API key can be used by clients.
+
+        :default: true
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-enabled
+        '''
+        result = self._values.get("enabled")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    @builtins.property
+    def generate_distinct_id(self) -> typing.Optional[builtins.bool]:
+        '''Specifies whether the key identifier is distinct from the created API key value.
+
+        :default: false
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-generatedistinctid
+        '''
+        result = self._values.get("generate_distinct_id")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "ApiKeyProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_apigatewayv2.ApiMappingAttributes",
     jsii_struct_bases=[],
@@ -11926,6 +12379,58 @@ class _IApiProxy(
 typing.cast(typing.Any, IApi).__jsii_proxy_class__ = lambda : _IApiProxy
 
 
+@jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IApiKey")
+class IApiKey(_IResource_c80c4260, typing_extensions.Protocol):
+    '''API keys are alphanumeric string values that you distribute to app developer customers to grant access to your API.'''
+
+    @builtins.property
+    @jsii.member(jsii_name="keyArn")
+    def key_arn(self) -> builtins.str:
+        '''The API key ARN.
+
+        :attribute: true
+        '''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="keyId")
+    def key_id(self) -> builtins.str:
+        '''The API key ID.
+
+        :attribute: true
+        '''
+        ...
+
+
+class _IApiKeyProxy(
+    jsii.proxy_for(_IResource_c80c4260), # type: ignore[misc]
+):
+    '''API keys are alphanumeric string values that you distribute to app developer customers to grant access to your API.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_apigatewayv2.IApiKey"
+
+    @builtins.property
+    @jsii.member(jsii_name="keyArn")
+    def key_arn(self) -> builtins.str:
+        '''The API key ARN.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "keyArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="keyId")
+    def key_id(self) -> builtins.str:
+        '''The API key ID.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "keyId"))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, IApiKey).__jsii_proxy_class__ = lambda : _IApiKeyProxy
+
+
 @jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IApiMapping")
 class IApiMapping(_IResource_c80c4260, typing_extensions.Protocol):
     '''Represents an ApiGatewayV2 ApiMapping resource.
@@ -13107,10 +13612,77 @@ class _IStageProxy(
             visible=visible,
         )
 
-        return typing.cast(_Metric_e396a4dc, jsii.invoke(self, "metric", [metric_name, props]))
+        return typing.cast(_Metric_e396a4dc, jsii.invoke(self, "metric", [metric_name, props]))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, IStage).__jsii_proxy_class__ = lambda : _IStageProxy
+
+
+@jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IUsagePlan")
+class IUsagePlan(_IResource_c80c4260, typing_extensions.Protocol):
+    '''A UsagePlan, either managed by this CDK app, or imported.'''
+
+    @builtins.property
+    @jsii.member(jsii_name="usagePlanId")
+    def usage_plan_id(self) -> builtins.str:
+        '''Id of the usage plan.
+
+        :attribute: true
+        '''
+        ...
+
+    @jsii.member(jsii_name="addApiKey")
+    def add_api_key(
+        self,
+        api_key: IApiKey,
+        *,
+        override_logical_id: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Adds an ApiKey.
+
+        :param api_key: the api key to associate with this usage plan.
+        :param override_logical_id: Override the CloudFormation logical id of the AWS::ApiGateway::UsagePlanKey resource. Default: - autogenerated by the CDK
+        '''
+        ...
+
+
+class _IUsagePlanProxy(
+    jsii.proxy_for(_IResource_c80c4260), # type: ignore[misc]
+):
+    '''A UsagePlan, either managed by this CDK app, or imported.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_apigatewayv2.IUsagePlan"
+
+    @builtins.property
+    @jsii.member(jsii_name="usagePlanId")
+    def usage_plan_id(self) -> builtins.str:
+        '''Id of the usage plan.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "usagePlanId"))
+
+    @jsii.member(jsii_name="addApiKey")
+    def add_api_key(
+        self,
+        api_key: IApiKey,
+        *,
+        override_logical_id: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Adds an ApiKey.
+
+        :param api_key: the api key to associate with this usage plan.
+        :param override_logical_id: Override the CloudFormation logical id of the AWS::ApiGateway::UsagePlanKey resource. Default: - autogenerated by the CDK
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__4feb0fa4d2b3aa6f0e443abfac19ee78cf632f1573ba5c6ccfa6fb8619018bcb)
+            check_type(argname="argument api_key", value=api_key, expected_type=type_hints["api_key"])
+        options = AddApiKeyOptions(override_logical_id=override_logical_id)
+
+        return typing.cast(None, jsii.invoke(self, "addApiKey", [api_key, options]))
 
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
-typing.cast(typing.Any, IStage).__jsii_proxy_class__ = lambda : _IStageProxy
+typing.cast(typing.Any, IUsagePlan).__jsii_proxy_class__ = lambda : _IUsagePlanProxy
 
 
 @jsii.interface(jsii_type="aws-cdk-lib.aws_apigatewayv2.IVpcLink")
@@ -13925,32 +14497,505 @@ class PayloadFormatVersion(
     def custom(cls, version: builtins.str) -> "PayloadFormatVersion":
         '''A custom payload version.
 
-        Typically used if there is a version number that the CDK doesn't support yet
+        Typically used if there is a version number that the CDK doesn't support yet
+
+        :param version: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__a53d9648a03276b93776e272dffc7b5b30a9504625fd8b3e8e2c463dff76f46e)
+            check_type(argname="argument version", value=version, expected_type=type_hints["version"])
+        return typing.cast("PayloadFormatVersion", jsii.sinvoke(cls, "custom", [version]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="VERSION_1_0")
+    def VERSION_1_0(cls) -> "PayloadFormatVersion":
+        '''Version 1.0.'''
+        return typing.cast("PayloadFormatVersion", jsii.sget(cls, "VERSION_1_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="VERSION_2_0")
+    def VERSION_2_0(cls) -> "PayloadFormatVersion":
+        '''Version 2.0.'''
+        return typing.cast("PayloadFormatVersion", jsii.sget(cls, "VERSION_2_0"))
+
+    @builtins.property
+    @jsii.member(jsii_name="version")
+    def version(self) -> builtins.str:
+        '''version as a string.'''
+        return typing.cast(builtins.str, jsii.get(self, "version"))
+
+
+@jsii.enum(jsii_type="aws-cdk-lib.aws_apigatewayv2.Period")
+class Period(enum.Enum):
+    '''Time period for which quota settings apply.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        # api: apigwv2.WebSocketApi
+        # stage: apigwv2.WebSocketStage
+        
+        
+        key = apigwv2.RateLimitedApiKey(self, "rate-limited-api-key",
+            customer_id="test-customer",
+            api_stages=[apigwv2.UsagePlanPerApiStage(
+                api=api,
+                stage=stage
+            )],
+            quota=apigwv2.QuotaSettings(
+                limit=10000,
+                period=apigwv2.Period.MONTH
+            ),
+            throttle=apigwv2.ThrottleSettings(
+                rate_limit=100,
+                burst_limit=200
+            )
+        )
+    '''
+
+    DAY = "DAY"
+    '''The quota resets every day.'''
+    WEEK = "WEEK"
+    '''The quota resets every week.'''
+    MONTH = "MONTH"
+    '''The quota resets every month.'''
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.QuotaSettings",
+    jsii_struct_bases=[],
+    name_mapping={"limit": "limit", "offset": "offset", "period": "period"},
+)
+class QuotaSettings:
+    def __init__(
+        self,
+        *,
+        limit: typing.Optional[jsii.Number] = None,
+        offset: typing.Optional[jsii.Number] = None,
+        period: typing.Optional[Period] = None,
+    ) -> None:
+        '''Specifies the maximum number of requests that clients can make to API Gateway APIs.
+
+        :param limit: The maximum number of requests that users can make within the specified time period. Default: none
+        :param offset: For the initial time period, the number of requests to subtract from the specified limit. Default: none
+        :param period: The time period for which the maximum limit of requests applies. Default: none
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # api: apigwv2.WebSocketApi
+            # stage: apigwv2.WebSocketStage
+            
+            
+            key = apigwv2.RateLimitedApiKey(self, "rate-limited-api-key",
+                customer_id="test-customer",
+                api_stages=[apigwv2.UsagePlanPerApiStage(
+                    api=api,
+                    stage=stage
+                )],
+                quota=apigwv2.QuotaSettings(
+                    limit=10000,
+                    period=apigwv2.Period.MONTH
+                ),
+                throttle=apigwv2.ThrottleSettings(
+                    rate_limit=100,
+                    burst_limit=200
+                )
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__389f76c9bffb156f327520f7fb1eb3786b6c053de75cac1df18d9cac22ff10e6)
+            check_type(argname="argument limit", value=limit, expected_type=type_hints["limit"])
+            check_type(argname="argument offset", value=offset, expected_type=type_hints["offset"])
+            check_type(argname="argument period", value=period, expected_type=type_hints["period"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if limit is not None:
+            self._values["limit"] = limit
+        if offset is not None:
+            self._values["offset"] = offset
+        if period is not None:
+            self._values["period"] = period
+
+    @builtins.property
+    def limit(self) -> typing.Optional[jsii.Number]:
+        '''The maximum number of requests that users can make within the specified time period.
+
+        :default: none
+        '''
+        result = self._values.get("limit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def offset(self) -> typing.Optional[jsii.Number]:
+        '''For the initial time period, the number of requests to subtract from the specified limit.
+
+        :default: none
+        '''
+        result = self._values.get("offset")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def period(self) -> typing.Optional[Period]:
+        '''The time period for which the maximum limit of requests applies.
+
+        :default: none
+        '''
+        result = self._values.get("period")
+        return typing.cast(typing.Optional[Period], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "QuotaSettings(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.implements(IApiKey)
+class RateLimitedApiKey(
+    _Resource_45bc6135,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.RateLimitedApiKey",
+):
+    '''An API Gateway ApiKey, for which a rate limiting configuration can be specified.
+
+    :resource: AWS::ApiGateway::ApiKey
+    :exampleMetadata: infused
+
+    Example::
+
+        # api: apigwv2.WebSocketApi
+        # stage: apigwv2.WebSocketStage
+        
+        
+        key = apigwv2.RateLimitedApiKey(self, "rate-limited-api-key",
+            customer_id="test-customer",
+            api_stages=[apigwv2.UsagePlanPerApiStage(
+                api=api,
+                stage=stage
+            )],
+            quota=apigwv2.QuotaSettings(
+                limit=10000,
+                period=apigwv2.Period.MONTH
+            ),
+            throttle=apigwv2.ThrottleSettings(
+                rate_limit=100,
+                burst_limit=200
+            )
+        )
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        api_stages: typing.Optional[typing.Sequence[typing.Union["UsagePlanPerApiStage", typing.Dict[builtins.str, typing.Any]]]] = None,
+        quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+        throttle: typing.Optional[typing.Union["ThrottleSettings", typing.Dict[builtins.str, typing.Any]]] = None,
+        customer_id: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        generate_distinct_id: typing.Optional[builtins.bool] = None,
+        api_key_name: typing.Optional[builtins.str] = None,
+        description: typing.Optional[builtins.str] = None,
+        value: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''
+        :param scope: -
+        :param id: -
+        :param api_stages: API Stages to be associated with the RateLimitedApiKey. Default: none
+        :param quota: Number of requests clients can make in a given time period. Default: none
+        :param throttle: Overall throttle settings for the API. Default: none
+        :param customer_id: An AWS Marketplace customer identifier to use when integrating with the AWS SaaS Marketplace. Default: none
+        :param enabled: Indicates whether the API key can be used by clients. Default: true
+        :param generate_distinct_id: Specifies whether the key identifier is distinct from the created API key value. Default: false
+        :param api_key_name: A name for the API key. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name. Default: automatically generated name
+        :param description: A description of the purpose of the API key. Default: none
+        :param value: The value of the API key. Must be at least 20 characters long. Default: none
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__572a1cdbe73f523ab11fbfefb643d76b815fde625cf2ad61720c812e98d9dfe3)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = RateLimitedApiKeyProps(
+            api_stages=api_stages,
+            quota=quota,
+            throttle=throttle,
+            customer_id=customer_id,
+            enabled=enabled,
+            generate_distinct_id=generate_distinct_id,
+            api_key_name=api_key_name,
+            description=description,
+            value=value,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="grantRead")
+    def grant_read(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
+        '''Permits the IAM principal all read operations through this key.
+
+        :param grantee: The principal to grant access to.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__28c60e4a8e61709e5f61997104043903178afb5475d6f9b2228b53f119383675)
+            check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
+        return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantRead", [grantee]))
+
+    @jsii.member(jsii_name="grantReadWrite")
+    def grant_read_write(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
+        '''Permits the IAM principal all read and write operations through this key.
+
+        :param grantee: The principal to grant access to.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__5c816a8984b9edeedfec843ede15881183785d76c9b0dadcd9c8d226383c7277)
+            check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
+        return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantReadWrite", [grantee]))
+
+    @jsii.member(jsii_name="grantWrite")
+    def grant_write(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
+        '''Permits the IAM principal all write operations through this key.
+
+        :param grantee: The principal to grant access to.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__2ff79bd17198356348211d47ed321f48be3c130579981227c653a29c050fc0dd)
+            check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
+        return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantWrite", [grantee]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
+    @builtins.property
+    @jsii.member(jsii_name="keyArn")
+    def key_arn(self) -> builtins.str:
+        '''The API key ARN.'''
+        return typing.cast(builtins.str, jsii.get(self, "keyArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="keyId")
+    def key_id(self) -> builtins.str:
+        '''The API key ID.'''
+        return typing.cast(builtins.str, jsii.get(self, "keyId"))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.RateLimitedApiKeyProps",
+    jsii_struct_bases=[ApiKeyProps],
+    name_mapping={
+        "api_key_name": "apiKeyName",
+        "description": "description",
+        "value": "value",
+        "customer_id": "customerId",
+        "enabled": "enabled",
+        "generate_distinct_id": "generateDistinctId",
+        "api_stages": "apiStages",
+        "quota": "quota",
+        "throttle": "throttle",
+    },
+)
+class RateLimitedApiKeyProps(ApiKeyProps):
+    def __init__(
+        self,
+        *,
+        api_key_name: typing.Optional[builtins.str] = None,
+        description: typing.Optional[builtins.str] = None,
+        value: typing.Optional[builtins.str] = None,
+        customer_id: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        generate_distinct_id: typing.Optional[builtins.bool] = None,
+        api_stages: typing.Optional[typing.Sequence[typing.Union["UsagePlanPerApiStage", typing.Dict[builtins.str, typing.Any]]]] = None,
+        quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+        throttle: typing.Optional[typing.Union["ThrottleSettings", typing.Dict[builtins.str, typing.Any]]] = None,
+    ) -> None:
+        '''RateLimitedApiKey properties.
+
+        :param api_key_name: A name for the API key. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name. Default: automatically generated name
+        :param description: A description of the purpose of the API key. Default: none
+        :param value: The value of the API key. Must be at least 20 characters long. Default: none
+        :param customer_id: An AWS Marketplace customer identifier to use when integrating with the AWS SaaS Marketplace. Default: none
+        :param enabled: Indicates whether the API key can be used by clients. Default: true
+        :param generate_distinct_id: Specifies whether the key identifier is distinct from the created API key value. Default: false
+        :param api_stages: API Stages to be associated with the RateLimitedApiKey. Default: none
+        :param quota: Number of requests clients can make in a given time period. Default: none
+        :param throttle: Overall throttle settings for the API. Default: none
+
+        :exampleMetadata: infused
+
+        Example::
+
+            # api: apigwv2.WebSocketApi
+            # stage: apigwv2.WebSocketStage
+            
+            
+            key = apigwv2.RateLimitedApiKey(self, "rate-limited-api-key",
+                customer_id="test-customer",
+                api_stages=[apigwv2.UsagePlanPerApiStage(
+                    api=api,
+                    stage=stage
+                )],
+                quota=apigwv2.QuotaSettings(
+                    limit=10000,
+                    period=apigwv2.Period.MONTH
+                ),
+                throttle=apigwv2.ThrottleSettings(
+                    rate_limit=100,
+                    burst_limit=200
+                )
+            )
+        '''
+        if isinstance(quota, dict):
+            quota = QuotaSettings(**quota)
+        if isinstance(throttle, dict):
+            throttle = ThrottleSettings(**throttle)
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__6e548d95c67601d1846a7247a02ee697fc027c348e58bd8b62a648333ec0f5b5)
+            check_type(argname="argument api_key_name", value=api_key_name, expected_type=type_hints["api_key_name"])
+            check_type(argname="argument description", value=description, expected_type=type_hints["description"])
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+            check_type(argname="argument customer_id", value=customer_id, expected_type=type_hints["customer_id"])
+            check_type(argname="argument enabled", value=enabled, expected_type=type_hints["enabled"])
+            check_type(argname="argument generate_distinct_id", value=generate_distinct_id, expected_type=type_hints["generate_distinct_id"])
+            check_type(argname="argument api_stages", value=api_stages, expected_type=type_hints["api_stages"])
+            check_type(argname="argument quota", value=quota, expected_type=type_hints["quota"])
+            check_type(argname="argument throttle", value=throttle, expected_type=type_hints["throttle"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if api_key_name is not None:
+            self._values["api_key_name"] = api_key_name
+        if description is not None:
+            self._values["description"] = description
+        if value is not None:
+            self._values["value"] = value
+        if customer_id is not None:
+            self._values["customer_id"] = customer_id
+        if enabled is not None:
+            self._values["enabled"] = enabled
+        if generate_distinct_id is not None:
+            self._values["generate_distinct_id"] = generate_distinct_id
+        if api_stages is not None:
+            self._values["api_stages"] = api_stages
+        if quota is not None:
+            self._values["quota"] = quota
+        if throttle is not None:
+            self._values["throttle"] = throttle
+
+    @builtins.property
+    def api_key_name(self) -> typing.Optional[builtins.str]:
+        '''A name for the API key.
+
+        If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name.
+
+        :default: automatically generated name
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-name
+        '''
+        result = self._values.get("api_key_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def description(self) -> typing.Optional[builtins.str]:
+        '''A description of the purpose of the API key.
+
+        :default: none
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-description
+        '''
+        result = self._values.get("description")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def value(self) -> typing.Optional[builtins.str]:
+        '''The value of the API key.
+
+        Must be at least 20 characters long.
+
+        :default: none
+
+        :link: https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-value
+        '''
+        result = self._values.get("value")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def customer_id(self) -> typing.Optional[builtins.str]:
+        '''An AWS Marketplace customer identifier to use when integrating with the AWS SaaS Marketplace.
+
+        :default: none
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-customerid
+        '''
+        result = self._values.get("customer_id")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def enabled(self) -> typing.Optional[builtins.bool]:
+        '''Indicates whether the API key can be used by clients.
+
+        :default: true
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-enabled
+        '''
+        result = self._values.get("enabled")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    @builtins.property
+    def generate_distinct_id(self) -> typing.Optional[builtins.bool]:
+        '''Specifies whether the key identifier is distinct from the created API key value.
+
+        :default: false
+
+        :link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-apikey.html#cfn-apigateway-apikey-generatedistinctid
+        '''
+        result = self._values.get("generate_distinct_id")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
+    @builtins.property
+    def api_stages(self) -> typing.Optional[typing.List["UsagePlanPerApiStage"]]:
+        '''API Stages to be associated with the RateLimitedApiKey.
+
+        :default: none
+        '''
+        result = self._values.get("api_stages")
+        return typing.cast(typing.Optional[typing.List["UsagePlanPerApiStage"]], result)
+
+    @builtins.property
+    def quota(self) -> typing.Optional[QuotaSettings]:
+        '''Number of requests clients can make in a given time period.
+
+        :default: none
+        '''
+        result = self._values.get("quota")
+        return typing.cast(typing.Optional[QuotaSettings], result)
 
-        :param version: -
+    @builtins.property
+    def throttle(self) -> typing.Optional["ThrottleSettings"]:
+        '''Overall throttle settings for the API.
+
+        :default: none
         '''
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__a53d9648a03276b93776e272dffc7b5b30a9504625fd8b3e8e2c463dff76f46e)
-            check_type(argname="argument version", value=version, expected_type=type_hints["version"])
-        return typing.cast("PayloadFormatVersion", jsii.sinvoke(cls, "custom", [version]))
+        result = self._values.get("throttle")
+        return typing.cast(typing.Optional["ThrottleSettings"], result)
 
-    @jsii.python.classproperty
-    @jsii.member(jsii_name="VERSION_1_0")
-    def VERSION_1_0(cls) -> "PayloadFormatVersion":
-        '''Version 1.0.'''
-        return typing.cast("PayloadFormatVersion", jsii.sget(cls, "VERSION_1_0"))
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
 
-    @jsii.python.classproperty
-    @jsii.member(jsii_name="VERSION_2_0")
-    def VERSION_2_0(cls) -> "PayloadFormatVersion":
-        '''Version 2.0.'''
-        return typing.cast("PayloadFormatVersion", jsii.sget(cls, "VERSION_2_0"))
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
 
-    @builtins.property
-    @jsii.member(jsii_name="version")
-    def version(self) -> builtins.str:
-        '''version as a string.'''
-        return typing.cast(builtins.str, jsii.get(self, "version"))
+    def __repr__(self) -> str:
+        return "RateLimitedApiKeyProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
 
 
 @jsii.enum(jsii_type="aws-cdk-lib.aws_apigatewayv2.SecurityPolicy")
@@ -14202,52 +15247,388 @@ class ThrottleSettings:
     ) -> None:
         '''Container for defining throttling parameters to API stages.
 
-        :param burst_limit: The maximum API request rate limit over a time ranging from one to a few seconds. Default: none
-        :param rate_limit: The API request steady-state rate limit (average requests per second over an extended period of time). Default: none
+        :param burst_limit: The maximum API request rate limit over a time ranging from one to a few seconds. Default: none
+        :param rate_limit: The API request steady-state rate limit (average requests per second over an extended period of time). Default: none
+
+        :exampleMetadata: infused
+
+        Example::
+
+            api_key = apigwv2.ApiKey(self, "ApiKey")
+            
+            usage_plan = apigwv2.UsagePlan(self, "UsagePlan",
+                usage_plan_name="WebSocketUsagePlan",
+                throttle=apigwv2.ThrottleSettings(
+                    rate_limit=10,
+                    burst_limit=2
+                )
+            )
+            
+            usage_plan.add_api_key(api_key)
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__05ad6ca26340cecc4f71b6ccbf9e9a3f2f4b4aaba5752582219c37ea0e30d878)
+            check_type(argname="argument burst_limit", value=burst_limit, expected_type=type_hints["burst_limit"])
+            check_type(argname="argument rate_limit", value=rate_limit, expected_type=type_hints["rate_limit"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if burst_limit is not None:
+            self._values["burst_limit"] = burst_limit
+        if rate_limit is not None:
+            self._values["rate_limit"] = rate_limit
+
+    @builtins.property
+    def burst_limit(self) -> typing.Optional[jsii.Number]:
+        '''The maximum API request rate limit over a time ranging from one to a few seconds.
+
+        :default: none
+        '''
+        result = self._values.get("burst_limit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    @builtins.property
+    def rate_limit(self) -> typing.Optional[jsii.Number]:
+        '''The API request steady-state rate limit (average requests per second over an extended period of time).
+
+        :default: none
+        '''
+        result = self._values.get("rate_limit")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "ThrottleSettings(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.implements(IUsagePlan)
+class UsagePlan(
+    _Resource_45bc6135,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.UsagePlan",
+):
+    '''A UsagePlan.
+
+    :resource: AWS::ApiGateway::UsagePlan
+    :exampleMetadata: infused
+
+    Example::
+
+        api_key = apigwv2.ApiKey(self, "ApiKey")
+        
+        usage_plan = apigwv2.UsagePlan(self, "UsagePlan",
+            usage_plan_name="WebSocketUsagePlan",
+            throttle=apigwv2.ThrottleSettings(
+                rate_limit=10,
+                burst_limit=2
+            )
+        )
+        
+        usage_plan.add_api_key(api_key)
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        api_stages: typing.Optional[typing.Sequence[typing.Union["UsagePlanPerApiStage", typing.Dict[builtins.str, typing.Any]]]] = None,
+        description: typing.Optional[builtins.str] = None,
+        quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+        throttle: typing.Optional[typing.Union[ThrottleSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+        usage_plan_name: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''
+        :param scope: -
+        :param id: -
+        :param api_stages: API Stages to be associated with the usage plan. Default: none
+        :param description: Represents usage plan purpose. Default: none
+        :param quota: Number of requests clients can make in a given time period. Default: none
+        :param throttle: Overall throttle settings for the API. Default: none
+        :param usage_plan_name: Name for this usage plan. Default: none
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9c44a8270fda500e46d4376c78e5434b821d32274b06bed98229286ec47af912)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = UsagePlanProps(
+            api_stages=api_stages,
+            description=description,
+            quota=quota,
+            throttle=throttle,
+            usage_plan_name=usage_plan_name,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="fromUsagePlanId")
+    @builtins.classmethod
+    def from_usage_plan_id(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        usage_plan_id: builtins.str,
+    ) -> IUsagePlan:
+        '''Import an externally defined usage plan using its ARN.
+
+        :param scope: the construct that will "own" the imported usage plan.
+        :param id: the id of the imported usage plan in the construct tree.
+        :param usage_plan_id: the id of an existing usage plan.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9903279f47ccd34953dfccff0e79862896fbecac5df5b4c485f95f32e4803558)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument usage_plan_id", value=usage_plan_id, expected_type=type_hints["usage_plan_id"])
+        return typing.cast(IUsagePlan, jsii.sinvoke(cls, "fromUsagePlanId", [scope, id, usage_plan_id]))
+
+    @jsii.member(jsii_name="addApiKey")
+    def add_api_key(
+        self,
+        api_key: IApiKey,
+        *,
+        override_logical_id: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Adds an ApiKey.
+
+        :param api_key: the api key to associate with this usage plan.
+        :param override_logical_id: Override the CloudFormation logical id of the AWS::ApiGateway::UsagePlanKey resource. Default: - autogenerated by the CDK
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__892ce11886a70d15231181494f2d96dd60dca39f438ede2530803c668aab974a)
+            check_type(argname="argument api_key", value=api_key, expected_type=type_hints["api_key"])
+        options = AddApiKeyOptions(override_logical_id=override_logical_id)
+
+        return typing.cast(None, jsii.invoke(self, "addApiKey", [api_key, options]))
+
+    @jsii.member(jsii_name="addApiStage")
+    def add_api_stage(
+        self,
+        *,
+        api: typing.Optional[IWebSocketApi] = None,
+        stage: typing.Optional[IWebSocketStage] = None,
+    ) -> None:
+        '''Adds an apiStage.
+
+        :param api: The WebSocket API to associate with the usage plan. Default: none
+        :param stage: [disable-awslint:ref-via-interface]. Default: none
+        '''
+        api_stage = UsagePlanPerApiStage(api=api, stage=stage)
+
+        return typing.cast(None, jsii.invoke(self, "addApiStage", [api_stage]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
+    @builtins.property
+    @jsii.member(jsii_name="usagePlanId")
+    def usage_plan_id(self) -> builtins.str:
+        '''Id of the usage plan.
+
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "usagePlanId"))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.UsagePlanPerApiStage",
+    jsii_struct_bases=[],
+    name_mapping={"api": "api", "stage": "stage"},
+)
+class UsagePlanPerApiStage:
+    def __init__(
+        self,
+        *,
+        api: typing.Optional[IWebSocketApi] = None,
+        stage: typing.Optional[IWebSocketStage] = None,
+    ) -> None:
+        '''Represents the API stages that a usage plan applies to.
+
+        :param api: The WebSocket API to associate with the usage plan. Default: none
+        :param stage: [disable-awslint:ref-via-interface]. Default: none
+
+        :exampleMetadata: infused
+
+        Example::
+
+            api = apigwv2.WebSocketApi(self, "my-api")
+            stage = apigwv2.WebSocketStage(self, "my-stage",
+                web_socket_api=api,
+                stage_name="dev"
+            )
+            
+            usage_plan = apigwv2.UsagePlan(self, "my-usage-plan",
+                usage_plan_name="Basic"
+            )
+            
+            usage_plan.add_api_stage(
+                api=api,
+                stage=stage
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__9167cbb0fc31fdca6b0d63f3c3394dad8530b4e18ee7a76dc830fe05762c83b0)
+            check_type(argname="argument api", value=api, expected_type=type_hints["api"])
+            check_type(argname="argument stage", value=stage, expected_type=type_hints["stage"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if api is not None:
+            self._values["api"] = api
+        if stage is not None:
+            self._values["stage"] = stage
+
+    @builtins.property
+    def api(self) -> typing.Optional[IWebSocketApi]:
+        '''The WebSocket API to associate with the usage plan.
+
+        :default: none
+        '''
+        result = self._values.get("api")
+        return typing.cast(typing.Optional[IWebSocketApi], result)
+
+    @builtins.property
+    def stage(self) -> typing.Optional[IWebSocketStage]:
+        '''[disable-awslint:ref-via-interface].
+
+        :default: none
+        '''
+        result = self._values.get("stage")
+        return typing.cast(typing.Optional[IWebSocketStage], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "UsagePlanPerApiStage(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.UsagePlanProps",
+    jsii_struct_bases=[],
+    name_mapping={
+        "api_stages": "apiStages",
+        "description": "description",
+        "quota": "quota",
+        "throttle": "throttle",
+        "usage_plan_name": "usagePlanName",
+    },
+)
+class UsagePlanProps:
+    def __init__(
+        self,
+        *,
+        api_stages: typing.Optional[typing.Sequence[typing.Union[UsagePlanPerApiStage, typing.Dict[builtins.str, typing.Any]]]] = None,
+        description: typing.Optional[builtins.str] = None,
+        quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+        throttle: typing.Optional[typing.Union[ThrottleSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+        usage_plan_name: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''Properties for defining an API Gateway Usage Plan for WebSocket APIs.
+
+        :param api_stages: API Stages to be associated with the usage plan. Default: none
+        :param description: Represents usage plan purpose. Default: none
+        :param quota: Number of requests clients can make in a given time period. Default: none
+        :param throttle: Overall throttle settings for the API. Default: none
+        :param usage_plan_name: Name for this usage plan. Default: none
+
+        :exampleMetadata: infused
+
+        Example::
+
+            api = apigwv2.WebSocketApi(self, "my-api")
+            stage = apigwv2.WebSocketStage(self, "my-stage",
+                web_socket_api=api,
+                stage_name="dev"
+            )
+            
+            usage_plan = apigwv2.UsagePlan(self, "my-usage-plan",
+                usage_plan_name="Basic"
+            )
+            
+            usage_plan.add_api_stage(
+                api=api,
+                stage=stage
+            )
+        '''
+        if isinstance(quota, dict):
+            quota = QuotaSettings(**quota)
+        if isinstance(throttle, dict):
+            throttle = ThrottleSettings(**throttle)
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__b1b0eb1f59edcc1e5a9d1e11fa7f21e101c738b5672a0443acc881f463fb1423)
+            check_type(argname="argument api_stages", value=api_stages, expected_type=type_hints["api_stages"])
+            check_type(argname="argument description", value=description, expected_type=type_hints["description"])
+            check_type(argname="argument quota", value=quota, expected_type=type_hints["quota"])
+            check_type(argname="argument throttle", value=throttle, expected_type=type_hints["throttle"])
+            check_type(argname="argument usage_plan_name", value=usage_plan_name, expected_type=type_hints["usage_plan_name"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if api_stages is not None:
+            self._values["api_stages"] = api_stages
+        if description is not None:
+            self._values["description"] = description
+        if quota is not None:
+            self._values["quota"] = quota
+        if throttle is not None:
+            self._values["throttle"] = throttle
+        if usage_plan_name is not None:
+            self._values["usage_plan_name"] = usage_plan_name
+
+    @builtins.property
+    def api_stages(self) -> typing.Optional[typing.List[UsagePlanPerApiStage]]:
+        '''API Stages to be associated with the usage plan.
+
+        :default: none
+        '''
+        result = self._values.get("api_stages")
+        return typing.cast(typing.Optional[typing.List[UsagePlanPerApiStage]], result)
+
+    @builtins.property
+    def description(self) -> typing.Optional[builtins.str]:
+        '''Represents usage plan purpose.
 
-        :exampleMetadata: infused
+        :default: none
+        '''
+        result = self._values.get("description")
+        return typing.cast(typing.Optional[builtins.str], result)
 
-        Example::
+    @builtins.property
+    def quota(self) -> typing.Optional[QuotaSettings]:
+        '''Number of requests clients can make in a given time period.
 
-            # api: apigwv2.HttpApi
-            
-            
-            apigwv2.HttpStage(self, "Stage",
-                http_api=api,
-                throttle=apigwv2.ThrottleSettings(
-                    rate_limit=1000,
-                    burst_limit=1000
-                ),
-                detailed_metrics_enabled=True
-            )
+        :default: none
         '''
-        if __debug__:
-            type_hints = typing.get_type_hints(_typecheckingstub__05ad6ca26340cecc4f71b6ccbf9e9a3f2f4b4aaba5752582219c37ea0e30d878)
-            check_type(argname="argument burst_limit", value=burst_limit, expected_type=type_hints["burst_limit"])
-            check_type(argname="argument rate_limit", value=rate_limit, expected_type=type_hints["rate_limit"])
-        self._values: typing.Dict[builtins.str, typing.Any] = {}
-        if burst_limit is not None:
-            self._values["burst_limit"] = burst_limit
-        if rate_limit is not None:
-            self._values["rate_limit"] = rate_limit
+        result = self._values.get("quota")
+        return typing.cast(typing.Optional[QuotaSettings], result)
 
     @builtins.property
-    def burst_limit(self) -> typing.Optional[jsii.Number]:
-        '''The maximum API request rate limit over a time ranging from one to a few seconds.
+    def throttle(self) -> typing.Optional[ThrottleSettings]:
+        '''Overall throttle settings for the API.
 
         :default: none
         '''
-        result = self._values.get("burst_limit")
-        return typing.cast(typing.Optional[jsii.Number], result)
+        result = self._values.get("throttle")
+        return typing.cast(typing.Optional[ThrottleSettings], result)
 
     @builtins.property
-    def rate_limit(self) -> typing.Optional[jsii.Number]:
-        '''The API request steady-state rate limit (average requests per second over an extended period of time).
+    def usage_plan_name(self) -> typing.Optional[builtins.str]:
+        '''Name for this usage plan.
 
         :default: none
         '''
-        result = self._values.get("rate_limit")
-        return typing.cast(typing.Optional[jsii.Number], result)
+        result = self._values.get("usage_plan_name")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -14256,7 +15637,7 @@ class ThrottleSettings:
         return not (rhs == self)
 
     def __repr__(self) -> str:
-        return "ThrottleSettings(%s)" % ", ".join(
+        return "UsagePlanProps(%s)" % ", ".join(
             k + "=" + repr(v) for k, v in self._values.items()
         )
 
@@ -16682,20 +18063,21 @@ class WebSocketStage(
 
     Example::
 
-        from aws_cdk.aws_apigatewayv2_integrations import WebSocketLambdaIntegration
-        
-        # message_handler: lambda.Function
+        # web_socket_api: apigwv2.IWebSocketApi
         
         
-        web_socket_api = apigwv2.WebSocketApi(self, "mywsapi")
-        apigwv2.WebSocketStage(self, "mystage",
-            web_socket_api=web_socket_api,
-            stage_name="dev",
-            auto_deploy=True
+        imported_stage = apigwv2.WebSocketStage.from_web_socket_stage_attributes(self, "imported-stage",
+            stage_name="myStage",
+            api=web_socket_api
         )
-        web_socket_api.add_route("sendMessage",
-            integration=WebSocketLambdaIntegration("SendMessageIntegration", message_handler)
+        
+        api_key = apigwv2.ApiKey(self, "MyApiKey")
+        
+        usage_plan = apigwv2.UsagePlan(self, "MyUsagePlan",
+            api_stages=[apigwv2.UsagePlanPerApiStage(api=web_socket_api, stage=imported_stage)]
         )
+        
+        usage_plan.add_api_key(api_key)
     '''
 
     def __init__(
@@ -16901,20 +18283,25 @@ class WebSocketStageAttributes(StageAttributes):
         :param stage_name: The name of the stage.
         :param api: The API to which this stage is associated.
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         Example::
 
-            # The code below shows an example of how to instantiate this type.
-            # The values are placeholders you should change.
-            from aws_cdk import aws_apigatewayv2 as apigatewayv2
+            # web_socket_api: apigwv2.IWebSocketApi
             
-            # web_socket_api: apigatewayv2.WebSocketApi
             
-            web_socket_stage_attributes = apigatewayv2.WebSocketStageAttributes(
-                api=web_socket_api,
-                stage_name="stageName"
+            imported_stage = apigwv2.WebSocketStage.from_web_socket_stage_attributes(self, "imported-stage",
+                stage_name="myStage",
+                api=web_socket_api
+            )
+            
+            api_key = apigwv2.ApiKey(self, "MyApiKey")
+            
+            usage_plan = apigwv2.UsagePlan(self, "MyUsagePlan",
+                api_stages=[apigwv2.UsagePlanPerApiStage(api=web_socket_api, stage=imported_stage)]
             )
+            
+            usage_plan.add_api_key(api_key)
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__66ef15ad422b243bd7d761fe83ba5889c94c75b085fc8898f13f5fdbdf2f9a98)
@@ -17268,6 +18655,147 @@ class AddRoutesOptions(BatchHttpRouteOptions):
         )
 
 
+@jsii.implements(IApiKey)
+class ApiKey(
+    _Resource_45bc6135,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_apigatewayv2.ApiKey",
+):
+    '''An API Gateway ApiKey.
+
+    An ApiKey can be distributed to API clients that are connecting to
+    WebSocket APIs that require API key authentication. The key is used
+    to authenticate WebSocket connections and associate them with usage plans
+    for throttling and quota management.
+
+    :resource: AWS::ApiGateway::ApiKey
+    :exampleMetadata: infused
+
+    Example::
+
+        api_key = apigwv2.ApiKey(self, "ApiKey")
+        
+        usage_plan = apigwv2.UsagePlan(self, "UsagePlan",
+            usage_plan_name="WebSocketUsagePlan",
+            throttle=apigwv2.ThrottleSettings(
+                rate_limit=10,
+                burst_limit=2
+            )
+        )
+        
+        usage_plan.add_api_key(api_key)
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        customer_id: typing.Optional[builtins.str] = None,
+        enabled: typing.Optional[builtins.bool] = None,
+        generate_distinct_id: typing.Optional[builtins.bool] = None,
+        api_key_name: typing.Optional[builtins.str] = None,
+        description: typing.Optional[builtins.str] = None,
+        value: typing.Optional[builtins.str] = None,
+    ) -> None:
+        '''
+        :param scope: -
+        :param id: -
+        :param customer_id: An AWS Marketplace customer identifier to use when integrating with the AWS SaaS Marketplace. Default: none
+        :param enabled: Indicates whether the API key can be used by clients. Default: true
+        :param generate_distinct_id: Specifies whether the key identifier is distinct from the created API key value. Default: false
+        :param api_key_name: A name for the API key. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the API key name. Default: automatically generated name
+        :param description: A description of the purpose of the API key. Default: none
+        :param value: The value of the API key. Must be at least 20 characters long. Default: none
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__18c2dfbb6541b5bea91e0bd851d692e9bbad202ded4cba74973cb8a90161036c)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = ApiKeyProps(
+            customer_id=customer_id,
+            enabled=enabled,
+            generate_distinct_id=generate_distinct_id,
+            api_key_name=api_key_name,
+            description=description,
+            value=value,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="fromApiKeyId")
+    @builtins.classmethod
+    def from_api_key_id(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        api_key_id: builtins.str,
+    ) -> IApiKey:
+        '''Import an ApiKey by its Id.
+
+        :param scope: -
+        :param id: -
+        :param api_key_id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__f76f41cb204d2ae2963a27d942e6861e29eae70b4ed5762816d1b6f31b1477c5)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument api_key_id", value=api_key_id, expected_type=type_hints["api_key_id"])
+        return typing.cast(IApiKey, jsii.sinvoke(cls, "fromApiKeyId", [scope, id, api_key_id]))
+
+    @jsii.member(jsii_name="grantRead")
+    def grant_read(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
+        '''Permits the IAM principal all read operations through this key.
+
+        :param grantee: The principal to grant access to.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__ce9b01bd26cfea509e4d7bbddd06eb09db4a7f429082af90962d5b5c3825ab7d)
+            check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
+        return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantRead", [grantee]))
+
+    @jsii.member(jsii_name="grantReadWrite")
+    def grant_read_write(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
+        '''Permits the IAM principal all read and write operations through this key.
+
+        :param grantee: The principal to grant access to.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__1927f55f5fccf80e91c10574698a5522929c80cae47332c837e9dfd8f8e053c2)
+            check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
+        return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantReadWrite", [grantee]))
+
+    @jsii.member(jsii_name="grantWrite")
+    def grant_write(self, grantee: _IGrantable_71c4f5de) -> _Grant_a7ae64f8:
+        '''Permits the IAM principal all write operations through this key.
+
+        :param grantee: The principal to grant access to.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__eb3bf1a09f37630c026370072be172a15006c00dde871dbc489e7fb912fbe310)
+            check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
+        return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantWrite", [grantee]))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
+    @builtins.property
+    @jsii.member(jsii_name="keyArn")
+    def key_arn(self) -> builtins.str:
+        '''The API key ARN.'''
+        return typing.cast(builtins.str, jsii.get(self, "keyArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="keyId")
+    def key_id(self) -> builtins.str:
+        '''The API key ID.'''
+        return typing.cast(builtins.str, jsii.get(self, "keyId"))
+
+
 @jsii.implements(IApiMapping)
 class ApiMapping(
     _Resource_45bc6135,
@@ -20428,7 +21956,11 @@ class HttpStage(
 
 __all__ = [
     "AccessLogDestinationConfig",
+    "AddApiKeyOptions",
     "AddRoutesOptions",
+    "ApiKey",
+    "ApiKeyOptions",
+    "ApiKeyProps",
     "ApiMapping",
     "ApiMappingAttributes",
     "ApiMappingProps",
@@ -20501,6 +22033,7 @@ __all__ = [
     "IAccessLogDestination",
     "IAccessLogSettings",
     "IApi",
+    "IApiKey",
     "IApiMapping",
     "IAuthorizer",
     "IDomainName",
@@ -20514,6 +22047,7 @@ __all__ = [
     "IMappingValue",
     "IRoute",
     "IStage",
+    "IUsagePlan",
     "IVpcLink",
     "IWebSocketApi",
     "IWebSocketAuthorizer",
@@ -20529,10 +22063,17 @@ __all__ = [
     "ParameterMapping",
     "PassthroughBehavior",
     "PayloadFormatVersion",
+    "Period",
+    "QuotaSettings",
+    "RateLimitedApiKey",
+    "RateLimitedApiKeyProps",
     "SecurityPolicy",
     "StageAttributes",
     "StageOptions",
     "ThrottleSettings",
+    "UsagePlan",
+    "UsagePlanPerApiStage",
+    "UsagePlanProps",
     "VpcLink",
     "VpcLinkAttributes",
     "VpcLinkProps",
@@ -20570,6 +22111,34 @@ def _typecheckingstub__8b68ef5fb39547463ffa4e3d85b867bf69e399a3812672f092c1af8a4
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__0941f7d28f81063a43bd13461ff2c77b07dbc27ccb33f1747ba86e63cb135cfa(
+    *,
+    override_logical_id: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__7a705f0b737f132294a153b02c31b4d08ac0e91a2d1357048ce93fa1d3dcc0aa(
+    *,
+    api_key_name: typing.Optional[builtins.str] = None,
+    description: typing.Optional[builtins.str] = None,
+    value: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__8f84fc0c61e7fd558c82b45bbc4bcd6801e5a01a36339712c0577607b261c786(
+    *,
+    api_key_name: typing.Optional[builtins.str] = None,
+    description: typing.Optional[builtins.str] = None,
+    value: typing.Optional[builtins.str] = None,
+    customer_id: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    generate_distinct_id: typing.Optional[builtins.bool] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__87e51f8314eb457688965754ef962ccc6b34cd3477e30e0b5c48927231e6e450(
     *,
     api_mapping_id: builtins.str,
@@ -22312,6 +23881,14 @@ def _typecheckingstub__d4b9c7a822660da49cf87c3fc29340609a45b07f2b21e9c3832e9a550
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__4feb0fa4d2b3aa6f0e443abfac19ee78cf632f1573ba5c6ccfa6fb8619018bcb(
+    api_key: IApiKey,
+    *,
+    override_logical_id: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__331fd0db1f61e3b086b38ed9cad76e580f9f7392bb87bb910e5961df862b2ca9(
     role: _IRole_235f5d8e,
 ) -> None:
@@ -22452,6 +24029,65 @@ def _typecheckingstub__a53d9648a03276b93776e272dffc7b5b30a9504625fd8b3e8e2c463df
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__389f76c9bffb156f327520f7fb1eb3786b6c053de75cac1df18d9cac22ff10e6(
+    *,
+    limit: typing.Optional[jsii.Number] = None,
+    offset: typing.Optional[jsii.Number] = None,
+    period: typing.Optional[Period] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__572a1cdbe73f523ab11fbfefb643d76b815fde625cf2ad61720c812e98d9dfe3(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    api_stages: typing.Optional[typing.Sequence[typing.Union[UsagePlanPerApiStage, typing.Dict[builtins.str, typing.Any]]]] = None,
+    quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    throttle: typing.Optional[typing.Union[ThrottleSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    customer_id: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    generate_distinct_id: typing.Optional[builtins.bool] = None,
+    api_key_name: typing.Optional[builtins.str] = None,
+    description: typing.Optional[builtins.str] = None,
+    value: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__28c60e4a8e61709e5f61997104043903178afb5475d6f9b2228b53f119383675(
+    grantee: _IGrantable_71c4f5de,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__5c816a8984b9edeedfec843ede15881183785d76c9b0dadcd9c8d226383c7277(
+    grantee: _IGrantable_71c4f5de,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__2ff79bd17198356348211d47ed321f48be3c130579981227c653a29c050fc0dd(
+    grantee: _IGrantable_71c4f5de,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__6e548d95c67601d1846a7247a02ee697fc027c348e58bd8b62a648333ec0f5b5(
+    *,
+    api_key_name: typing.Optional[builtins.str] = None,
+    description: typing.Optional[builtins.str] = None,
+    value: typing.Optional[builtins.str] = None,
+    customer_id: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    generate_distinct_id: typing.Optional[builtins.bool] = None,
+    api_stages: typing.Optional[typing.Sequence[typing.Union[UsagePlanPerApiStage, typing.Dict[builtins.str, typing.Any]]]] = None,
+    quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    throttle: typing.Optional[typing.Union[ThrottleSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__6e40657661365d1f987be571ab8023633c7e4116f50e9a7122d3a476e9b80a5b(
     *,
     stage_name: builtins.str,
@@ -22480,6 +24116,54 @@ def _typecheckingstub__05ad6ca26340cecc4f71b6ccbf9e9a3f2f4b4aaba5752582219c37ea0
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__9c44a8270fda500e46d4376c78e5434b821d32274b06bed98229286ec47af912(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    api_stages: typing.Optional[typing.Sequence[typing.Union[UsagePlanPerApiStage, typing.Dict[builtins.str, typing.Any]]]] = None,
+    description: typing.Optional[builtins.str] = None,
+    quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    throttle: typing.Optional[typing.Union[ThrottleSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    usage_plan_name: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__9903279f47ccd34953dfccff0e79862896fbecac5df5b4c485f95f32e4803558(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    usage_plan_id: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__892ce11886a70d15231181494f2d96dd60dca39f438ede2530803c668aab974a(
+    api_key: IApiKey,
+    *,
+    override_logical_id: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__9167cbb0fc31fdca6b0d63f3c3394dad8530b4e18ee7a76dc830fe05762c83b0(
+    *,
+    api: typing.Optional[IWebSocketApi] = None,
+    stage: typing.Optional[IWebSocketStage] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__b1b0eb1f59edcc1e5a9d1e11fa7f21e101c738b5672a0443acc881f463fb1423(
+    *,
+    api_stages: typing.Optional[typing.Sequence[typing.Union[UsagePlanPerApiStage, typing.Dict[builtins.str, typing.Any]]]] = None,
+    description: typing.Optional[builtins.str] = None,
+    quota: typing.Optional[typing.Union[QuotaSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    throttle: typing.Optional[typing.Union[ThrottleSettings, typing.Dict[builtins.str, typing.Any]]] = None,
+    usage_plan_name: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__fbb2a4db39618c2d297b1697d524767a581ac4642c8c11e547be18b2311d9920(
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,
@@ -22888,6 +24572,46 @@ def _typecheckingstub__34561766c812822f47fe25e397c094ff6c4e8ebdecb2a857bcc289f99
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__18c2dfbb6541b5bea91e0bd851d692e9bbad202ded4cba74973cb8a90161036c(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    customer_id: typing.Optional[builtins.str] = None,
+    enabled: typing.Optional[builtins.bool] = None,
+    generate_distinct_id: typing.Optional[builtins.bool] = None,
+    api_key_name: typing.Optional[builtins.str] = None,
+    description: typing.Optional[builtins.str] = None,
+    value: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__f76f41cb204d2ae2963a27d942e6861e29eae70b4ed5762816d1b6f31b1477c5(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    api_key_id: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__ce9b01bd26cfea509e4d7bbddd06eb09db4a7f429082af90962d5b5c3825ab7d(
+    grantee: _IGrantable_71c4f5de,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__1927f55f5fccf80e91c10574698a5522929c80cae47332c837e9dfd8f8e053c2(
+    grantee: _IGrantable_71c4f5de,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__eb3bf1a09f37630c026370072be172a15006c00dde871dbc489e7fb912fbe310(
+    grantee: _IGrantable_71c4f5de,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__20562f173d26f5b2f63b53ea1553375396a2401df8e153d3e4cbaf824bffd090(
     scope: _constructs_77d1e7e8.Construct,
     id: builtins.str,