1. Packages
  2. AWS
  3. How-to Guides
  4. AWS API Gateway V2 HTTP API Quickstart
AWS v6.63.0 published on Wednesday, Dec 4, 2024 by Pulumi

AWS API Gateway V2 HTTP API Quickstart

aws logo
AWS v6.63.0 published on Wednesday, Dec 4, 2024 by Pulumi

    View Code Deploy this example with Pulumi

    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.

    aws logo
    AWS v6.63.0 published on Wednesday, Dec 4, 2024 by Pulumi