AWS API Gateway V2 HTTP API Quickstart

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-quickcreate
$ cd pulumi-examples/aws-ts-apigatewayv2-http-api-quickcreate

Set up a simple HTTP API using AWS API Gateway V2

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-quickstart-http-api  created
   +   ├─ aws:iam:Role                  lambdaRole                               created
   +   ├─ aws:lambda:Function           lambdaFunction                           created
   +   ├─ aws:iam:RolePolicyAttachment  lambdaRoleAttachment                     created
   +   ├─ aws:apigatewayv2:Api          httpApiGateway                           created
   +   └─ aws:lambda:Permission         lambdapermission                         created
   
   Outputs:
       endpoint: "https://****.execute-api.us-east-2.amazonaws.com"
   
   Resources:
       + 6 created
   
   Duration: 22s

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
   
   $ 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.