AWS API Gateway V2 HTTP API Quickstart | Python
Set up a simple HTTP API using AWS API Gateway V2. The API executes a simple Lambda function
- Install Pulumi.
- Configure Pulumi for AWS.
- Install Python.
Deploying and running the program
Note: some values in this example will be different from run to run. These values are indicated
Create a new stack:
$ pulumi stack init http-api
Set the AWS region:
$ pulumi config set aws:region us-east-2
pulumi upto preview and deploy changes:
$ pulumi up Previewing update (http-api) ... Updating (http-api) Type Name Status + pulumi:pulumi:Stack aws-py-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
Note: this command will create a virtual environment and restore dependencies automatically as described in Pulumi docs.
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!
To view the runtime logs of the Lambda function, use the
pulumi logscommand. To get a log stream, use
pulumi logs --follow.
At this point, you have a running HTTP API. Feel free to modify your program, and run
pulumi upto redeploy changes. The Pulumi CLI automatically detects what has changed and makes the minimal edits necessary to accomplish these changes. This could be altering the function used by the Lambda, or anything else you’d like!
pulumi destroyto tear down all resources.
To delete the stack itself, run
pulumi stack rm. Note that this command deletes all deployment history from the Pulumi Console.