Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Serverless REST API on AWS

A simple REST API that counts the number of times a route has been hit. For a detailed walkthrough of this example, see the article Create a Serverless REST API.


  1. Install Pulumi and configure your AWS credentials.

  2. Create a new stack:

    $ pulumi stack init count-api-testing
  3. Set the AWS region:

    $ pulumi config set aws:region us-west-2
  4. Restore NPM modules via npm install.

  5. Run pulumi update to preview and deploy changes:

    $ pulumi update
    Previewing update of stack 'count-api-testing'
    Updating stack 'count-api-testing'
    Performing changes:
        Type                                      Name                                     Status      Info
    +   pulumi:pulumi:Stack                       cloud-js-httpendpoint-count-api-testing  created
    +   ├─ cloud:table:Table                      counterTable                             created
    +   │  └─ aws:dynamodb:Table                  counterTable                             created
    +   └─ cloud:http:HttpEndpoint                hello-world                              created
    +      ├─ cloud:function:Function             hello-world4fcc7b60                      created
    +      │  └─ aws:serverless:Function          hello-world4fcc7b60                      created
    +      │     ├─ aws:iam:Role                  hello-world4fcc7b60                      created
    +      │     ├─ aws:lambda:Function           hello-world4fcc7b60                      created
    +      │     ├─ aws:iam:RolePolicyAttachment  hello-world4fcc7b60-32be53a2             created
    +      │     └─ aws:iam:RolePolicyAttachment  hello-world4fcc7b60-fd1a00e5             created
    +      ├─ aws:apigateway:RestApi              hello-world                              created
    +      ├─ aws:apigateway:Deployment           hello-world                              created
    +      ├─ aws:lambda:Permission               hello-world-4fcc7b60                     created
    +      └─ aws:apigateway:Stage                hello-world                              created
    endpoint: ""
    info: 14 changes performed:
        + 14 resources created
    Update duration: 48.510747688s
  6. View the endpoint URL and curl a few routes:

    $ pulumi stack output 
    Current stack outputs (1):
        OUTPUT            VALUE
    $ curl $(pulumi stack output endpoint)/hello
    $ curl $(pulumi stack output endpoint)/hello
    $ curl $(pulumi stack output endpoint)/woohoo
  7. 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.

You can’t perform that action at this time.