AWS API Gateway V2 HTTP API

This example lives in the pulumi/examples repository. Check out just this directory to use it:

$ git clone --filter=blob:none --sparse https://github.com/pulumi/examples pulumi-examples
$ git -C pulumi-examples sparse-checkout set aws-ts-apigatewayv2-http-api
$ cd pulumi-examples/aws-ts-apigatewayv2-http-api

Set up a HTTP API using AWS API Gateway V2, complete with a route, stage and integration.

Deploying and running the program#

Note: some values in this example will be different from run to run. These values are indicated with ***.

1. Create a new stack:

   $ pulumi stack init http-api

2. Set the AWS region:

   $ pulumi config set aws:region us-east-2

3. Restore NPM modules via npm install or yarn install.

4. Run pulumi up to preview and deploy changes:

   $ pulumi up
   Previewing update (http-api)
   ...
   
   Updating (http-api)
   
        Type                             Name                                   Status
    +   pulumi:pulumi:Stack              aws-ts-apigatewayv2-http-api-http-api  created
    +   ├─ aws:apigatewayv2:Api          httpApiGateway                         created
    +   ├─ aws:iam:Role                  lambdaRole                             created
    +   ├─ aws:lambda:Function           lambdaFunction                         created
    +   ├─ aws:iam:RolePolicyAttachment  lambdaRoleAttachment                   created
    +   ├─ aws:lambda:Permission         lambdaPermission                       created
    +   ├─ aws:apigatewayv2:Integration  lambdaIntegration                      created
    +   ├─ aws:apigatewayv2:Route        apiRoute                               created
    +   └─ aws:apigatewayv2:Stage        apiStage                               created
   
   Outputs:
       endpoint: "https://****.execute-api.us-east-2.amazonaws.com/http-api"
   
   Resources:
       + 9 created
   
   Duration: 33s

5. View the endpoint URL and curl a few routes:

   $ pulumi stack output
   Current stack outputs (1):
       OUTPUT            VALUE
       endpoint          https://***.execute-api.us-east-2.amazonaws.com/http-api
   
   $ curl $(pulumi stack output endpoint)
   Hello, Pulumi!

6. To view the runtime logs of the Lambda function, use the pulumi logs command. To get a log stream, use pulumi logs --follow.

Clean up#

1. Run pulumi destroy to tear down all resources.

2. To delete the stack itself, run pulumi stack rm. Note that this command deletes all deployment history from the Pulumi console.