feat(apigatewayv2): configure description for HttpApi (#10863)

Allows setting the description for HttpAPI.


----

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

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

@@ -85,6 +85,12 @@ export interface HttpApiProps {
    */
   readonly apiName?: string;
 
+  /**
+   * The description of the API.
+   * @default - none
+   */
+  readonly description?: string;
+
   /**
    * An integration that will be configured on the catch-all route ($default).
    * @default - none
@@ -267,6 +273,7 @@ export class HttpApi extends HttpApiBase {
       name: this.httpApiName,
       protocolType: 'HTTP',
       corsConfiguration,
+      description: props?.description,
     };
 
     const resource = new CfnApi(this, 'Resource', apiProps);

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

@@ -220,4 +220,17 @@ describe('HttpApi', () => {
       expect(countMetric.statistic).toEqual(statistic);
     });
   });
+
+  test('description is set', () => {
+    const stack = new Stack();
+    new HttpApi(stack, 'api', {
+      description: 'My Api',
+    });
+
+    expect(stack).toHaveResource('AWS::ApiGatewayV2::Api', {
+      Name: 'api',
+      ProtocolType: 'HTTP',
+      Description: 'My Api',
+    });
+  });
 });