feat: implement UsagePlan and ApiKey support in L2 constructs for aws-apigatewayv2 (WebSocketApi) (#35060)

### Issue # (if applicable)

Closes #28756.

### Reason for this change

Couldn't create `UsagePlans` and `ApiKeys` for `WebSocketApi` (`apigatewayv2`) using L2 constructs, cause these 2 features were supported only by `RestApi` (`apigatewayv1`).

### Description of changes

`HttpApi`(`apigatewayv2`) doesn't permit creating `UsagePlans` or `ApiKeys` in any way, so bringing these functionalities from `apigatewayv1` to `apigatewayv2` is possible only for `WebSocketApi`.

- Added `UsagePlan` and `ApiKey` files in `aws-apigatewayv2/lib/websocket` folder
- Implemented needed interfaces, classes and methods very similar to what was written for `RestApi` (`apigatewayv1`)
- Included explicit dependency management between components for proper _CloudFormation_ deployment order
- Added new _JSDoc_ in order to be able to build the project

### Describe any new or updated permissions being added

N/A

### Description of how you validated changes

- Tested manually by deploying a stack containing and linking the new features
- Wrote unit and integration tests

### Checklist

- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: maramure

packages/@aws-cdk-testing/framework-integ/test/aws-apigatewayv2/test/websocket/integ.usage-plan.js.snapshot/WebSocketUsagePlanIntegDefaultTestDeployAssert17052BCC.assets.json

@@ -0,0 +1,187 @@
+{
+ "Resources": {
+  "WebSocketApi34BCF99B": {
+   "Type": "AWS::ApiGatewayV2::Api",
+   "Properties": {
+    "Name": "WebSocketApi",
+    "ProtocolType": "WEBSOCKET",
+    "RouteSelectionExpression": "$request.body.action"
+   }
+  },
+  "WebSocketStageC46B7E43": {
+   "Type": "AWS::ApiGatewayV2::Stage",
+   "Properties": {
+    "ApiId": {
+     "Ref": "WebSocketApi34BCF99B"
+    },
+    "StageName": "dev"
+   }
+  },
+  "ApiKeyF9DDEE66": {
+   "Type": "AWS::ApiGateway::ApiKey",
+   "Properties": {
+    "CustomerId": "my-customer",
+    "Description": "Basic api-key",
+    "Enabled": true,
+    "GenerateDistinctId": true,
+    "Name": "my-api-key",
+    "Value": "MyApiKeyThatIsAtLeast20Characters"
+   }
+  },
+  "UsagePlanC18B28F1": {
+   "Type": "AWS::ApiGateway::UsagePlan",
+   "Properties": {
+    "ApiStages": [
+     {
+      "ApiId": {
+       "Ref": "WebSocketApi34BCF99B"
+      },
+      "Stage": "dev"
+     },
+     {
+      "ApiId": {
+       "Ref": "WebSocketApi34BCF99B"
+      },
+      "Stage": "dev2"
+     }
+    ],
+    "Description": "Basic usage plan",
+    "Quota": {
+     "Limit": 10000,
+     "Offset": 1,
+     "Period": "MONTH"
+    },
+    "Throttle": {
+     "BurstLimit": 200,
+     "RateLimit": 100
+    },
+    "UsagePlanName": "WebSocketUsagePlan"
+   },
+   "DependsOn": [
+    "WebSocketApi34BCF99B",
+    "WebSocketStageC46B7E43"
+   ]
+  },
+  "UsagePlanUsagePlanKeyResourceawscdkawsapigatewayv2websocketusageplanApiKey13D28EDFF7C5F9B8": {
+   "Type": "AWS::ApiGateway::UsagePlanKey",
+   "Properties": {
+    "KeyId": {
+     "Ref": "ApiKeyF9DDEE66"
+    },
+    "KeyType": "API_KEY",
+    "UsagePlanId": {
+     "Ref": "UsagePlanC18B28F1"
+    }
+   },
+   "DependsOn": [
+    "WebSocketApi34BCF99B",
+    "WebSocketStageC46B7E43"
+   ]
+  },
+  "WebSocketStage281A2E5CC": {
+   "Type": "AWS::ApiGatewayV2::Stage",
+   "Properties": {
+    "ApiId": {
+     "Ref": "WebSocketApi34BCF99B"
+    },
+    "StageName": "dev2"
+   }
+  },
+  "WebSocketStage327374806": {
+   "Type": "AWS::ApiGatewayV2::Stage",
+   "Properties": {
+    "ApiId": {
+     "Ref": "WebSocketApi34BCF99B"
+    },
+    "StageName": "dev3"
+   }
+  },
+  "RateLimitedApiKeyC2569A4F": {
+   "Type": "AWS::ApiGateway::ApiKey",
+   "Properties": {
+    "CustomerId": "my-customer",
+    "Description": "Basic rate-limited-api-key",
+    "Enabled": true,
+    "GenerateDistinctId": true,
+    "Name": "my-rate-limited-api-key",
+    "Value": "MyRateLimitedApiKeyThatIsAtLeast20Characters"
+   }
+  },
+  "RateLimitedApiKeyUsagePlanResource1CA5546B": {
+   "Type": "AWS::ApiGateway::UsagePlan",
+   "Properties": {
+    "ApiStages": [
+     {
+      "ApiId": {
+       "Ref": "WebSocketApi34BCF99B"
+      },
+      "Stage": "dev3"
+     }
+    ],
+    "Quota": {
+     "Limit": 10000,
+     "Offset": 1,
+     "Period": "MONTH"
+    },
+    "Throttle": {
+     "BurstLimit": 200,
+     "RateLimit": 100
+    }
+   },
+   "DependsOn": [
+    "WebSocketApi34BCF99B",
+    "WebSocketStage327374806"
+   ]
+  },
+  "RateLimitedApiKeyUsagePlanResourceUsagePlanKeyResourceawscdkawsapigatewayv2websocketusageplanRateLimitedApiKey4FFB7A4516024339": {
+   "Type": "AWS::ApiGateway::UsagePlanKey",
+   "Properties": {
+    "KeyId": {
+     "Ref": "RateLimitedApiKeyC2569A4F"
+    },
+    "KeyType": "API_KEY",
+    "UsagePlanId": {
+     "Ref": "RateLimitedApiKeyUsagePlanResource1CA5546B"
+    }
+   },
+   "DependsOn": [
+    "WebSocketApi34BCF99B",
+    "WebSocketStage327374806"
+   ]
+  }
+ },
+ "Parameters": {
+  "BootstrapVersion": {
+   "Type": "AWS::SSM::Parameter::Value<String>",
+   "Default": "/cdk-bootstrap/hnb659fds/version",
+   "Description": "Version of the CDK Bootstrap resources in this environment, automatically retrieved from SSM Parameter Store. [cdk:skip]"
+  }
+ },
+ "Rules": {
+  "CheckBootstrapVersion": {
+   "Assertions": [
+    {
+     "Assert": {
+      "Fn::Not": [
+       {
+        "Fn::Contains": [
+         [
+          "1",
+          "2",
+          "3",
+          "4",
+          "5"
+         ],
+         {
+          "Ref": "BootstrapVersion"
+         }
+        ]
+       }
+      ]
+     },
+     "AssertDescription": "CDK bootstrap stack version 6 required. Please run 'cdk bootstrap' with a recent version of the CDK CLI."
+    }
+   ]
+  }
+ }
+}