feat(apigatewayv2): support for setting routeSelectionExpression for an HTTP API

packages/@aws-cdk-testing/framework-integ/test/aws-apigatewayv2/test/http/integ.api.js.snapshot/aws-cdk-aws-apigatewayv2.template.json

@@ -4,7 +4,8 @@
    "Type": "AWS::ApiGatewayV2::Api",
    "Properties": {
     "Name": "HttpApi",
-    "ProtocolType": "HTTP"
+    "ProtocolType": "HTTP",
+    "RouteSelectionExpression": "${request.method} ${request.path}"
    }
   },
   "HttpApiDefaultStage3EEB07D6": {

packages/@aws-cdk-testing/framework-integ/test/aws-apigatewayv2/test/http/integ.api.ts

@@ -6,7 +6,9 @@ import * as apigw from 'aws-cdk-lib/aws-apigatewayv2';
 const app = new cdk.App();
 const stack = new cdk.Stack(app, 'aws-cdk-aws-apigatewayv2');
 
-new apigw.HttpApi(stack, 'HttpApi');
+new apigw.HttpApi(stack, 'HttpApi', {
+  routeSelectionExpression: true,
+});
 
 new IntegTest(app, 'http-api', {
   testCases: [stack],

packages/aws-cdk-lib/aws-apigatewayv2/README.md

@@ -93,6 +93,14 @@ new apigwv2.HttpApi(this, 'HttpProxyApi', {
 });
 ```
 
+The `routeSelectionExpression` option allows configuring the HTTP API to accept only `${request.method} ${request.path}`. Setting it to `true` automatically applies this value.
+
+```ts
+new apigwv2.HttpApi(this, 'HttpProxyApi', {
+  routeSelectionExpression: true,
+});
+```
+
 ### Cross Origin Resource Sharing (CORS)
 
 [Cross-origin resource sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) is a browser security

packages/aws-cdk-lib/aws-apigatewayv2/lib/http/api.ts

@@ -160,6 +160,15 @@ export interface HttpApiProps {
    * @default - no default authorization scopes
    */
   readonly defaultAuthorizationScopes?: string[];
+
+  /**
+   * Whether to set the default route selection expression for the API.
+   *
+   * When enabled, "${request.method} ${request.path}" is set as the default route selection expression.
+   *
+   * @default false
+   */
+  readonly routeSelectionExpression?: boolean;
 }
 
 /**
@@ -434,6 +443,7 @@ export class HttpApi extends HttpApiBase {
       corsConfiguration,
       description: props?.description,
       disableExecuteApiEndpoint: this.disableExecuteApiEndpoint,
+      routeSelectionExpression: props?.routeSelectionExpression ? '${request.method} ${request.path}' : undefined,
     };
 
     const resource = new CfnApi(this, 'Resource', apiProps);

packages/aws-cdk-lib/aws-apigatewayv2/test/http/api.test.ts

@@ -234,6 +234,32 @@ describe('HttpApi', () => {
     });
   });
 
+  test('routeSelectionExpression is enabled', () => {
+    const stack = new Stack();
+    new HttpApi(stack, 'api', {
+      routeSelectionExpression: true,
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::ApiGatewayV2::Api', {
+      Name: 'api',
+      ProtocolType: 'HTTP',
+      RouteSelectionExpression: '${request.method} ${request.path}',
+    });
+  });
+
+  test.each([false, undefined])('routeSelectionExpression is not enabled', (routeSelectionExpression) => {
+    const stack = new Stack();
+    new HttpApi(stack, 'api', {
+      routeSelectionExpression,
+    });
+
+    Template.fromStack(stack).hasResourceProperties('AWS::ApiGatewayV2::Api', {
+      Name: 'api',
+      ProtocolType: 'HTTP',
+      RouteSelectionExpression: Match.absent(),
+    });
+  });
+
   test('can add a vpc links', () => {
     // GIVEN
     const stack = new Stack();