How do I connect a Lambda function to a dedicated VPC?

Last updated: 2019-07-30

I want to connect an AWS Lambda function to resources in a dedicated virtual private cloud (VPC). How do I set that up?

Short Description

Because Lambda doesn't currently support running in dedicated tenancy VPCs, you must peer the dedicated tenancy VPC to a default tenancy VPC that contains your Lambda function. For more information on Amazon Elastic Compute Cloud (Amazon EC2) instance tenancy and VPCs, see Dedicated Instance Basics.

Important: This article assumes that you understand Node.js and how to create a Lambda function. The solution requires using an Amazon Elastic Compute Cloud (Amazon EC2) Dedicated Instance. Note that your AWS account incurs charges for this instance.


Create and configure the VPCs

1.    In the Amazon VPC console, create a VPC. During creation, for IPv4 CIDR block, enter For Tenancy, choose Default.

2.    Create another VPC. During creation, for IPv4 CIDR block, enter For Tenancy, choose Dedicated.

Note: If you choose to use different CIDR blocks, make sure that the two VPCs have different, non-overlapping blocks.

3.    Create an internet gateway, and then attach it to your dedicated tenancy VPC.

Note: The internet gateway is required for the HTTP server that you'll create later in Test the connectivity. For more information, see Enabling Internet Access.

4.    Create subnets in each of your VPCs. For your default tenancy VPC (which you later access with your Lambda function), create two or more subnets across different Availability Zones. This is a best practice for redundancy and so that Lambda can provide high availability for your function.

Note: If you create only one subnet in a VPC, you can use the same CIDR block as the VPC. For multiple subnets in each VPC, use a subset of the VPC's CIDR block. For more information, see VPC and Subnet Sizing for IPv4.

5.    Create a VPC peering connection between the two VPCs that you created. On the Create Peering Connection page, do the following:
(Optional) For Peering connection name tag, enter a name for the VPC peering connection.
For VPC (Requester), choose the default tenancy VPC that you created.
For Account, make sure that My account is selected.
For Region, make sure that This region is selected.
For VPC (Accepter), choose the dedicated tenancy VPC that you created.
Choose Create Peering Connection.

6.    Accept the VPC peering connection.

7.    Add routes to each of your new VPCs' route tables as shown here. For more information, see Adding and Removing Routes from a Route Table.

For the Target values starting with pcx-..., choose Peering Connection, and then choose the peering connection that you created.
For the Target value starting with igw-..., choose Internet Gateway, and then choose the internet gateway that you created.

Default tenancy VPC:

Destination Target Status Propagated Local Active No pcx-1a2b3c4d5e6f7g8h9 Active No

Dedicated tenancy VPC:

Destination Target Status Propagated Local Active No pcx-1a2b3c4d5e6f7g8h9 Active No igw-12345678a90b12c34 Active No

Create a Lambda execution role for Amazon VPC

Note: If you already have a Lambda execution role for Amazon VPC access, skip this section.

1.    In the AWS Identity and Access Management (IAM) console, in the left navigation pane, choose Roles.

2.    On the Roles pane, choose Create role.

3.    On the Create role page, do the following:
For Select type of trusted entity, choose AWS service.
For Choose the service that will use this role, choose Lambda.
Choose Next: Permissions.

4.    Under Attach permissions policies, search for AWSLambdaVPCAccessExecutionRole. Select the policy with that name, and then choose Next: Tags.

5.    (Optional) Add tags to your preferences.

6.    Under Review, do the following:
For Role name, enter a name for this Lambda execution role. For example, lambda_vpc_basic_execution.
(Optional) For Role description, edit the description to your preferences.
Choose Create role.

Create a new Lambda function for testing

Create a new function using the Lambda console or by building and uploading your own deployment package. Make sure to:

  • Create it the function in the same AWS Region as your default tenancy VPC.
  • Attach the execution role you created (for example, lambda_vpc_basic_execution).

For testing, here's some example function code that uses the native HTTP interface in Node.js:

var http = require('http')
exports.handler = (event, context, callback) => {
    const options = {
        hostname: event.Host,
        port: event.Port
    const response = {};
   http.get(options, (res) => {
        response.httpStatus = res.statusCode
        callback(null, response)
    }).on('error', (err) =>{
        callback(null, err.message);

Connect your Lambda function to your VPC

1.    In the Lambda console, on the Configuration pane, under Network, do the following:
For Virtual Private Cloud (VPC), choose the default tenancy VPC that you created.
For Subnets, choose two or more subnets in your VPC.
For Security groups, choose a security group.
Note: The default security group is sufficient for most use cases. For more information, see Security Groups for Your VPC.

2.    Choose Save.

Test the connectivity

1.    Launch an EC2 instance in your dedicated tenancy VPC. To connect to it later, you'll need a public IPv4 address that you can assign during setup. Or, you can associate an elastic IP address with your instance after setup.

Important: You must choose an EC2 instance type that's supported as a Dedicated Instance. Note that your AWS account incurs charges for this instance.

2.    Verify that the network access control lists (ACLs) for both VPCs allow traffic on the port that you're testing (80) and for your dedicated EC2 instance's security group.

3.    Connect to your EC2 instance.

4.    Launch an HTTP server on your EC2 instance by running this command:

# If python version is 2.x:
$ sudo python -m SimpleHTTPServer 80
# If python version is 3.x
$ sudo python -m http.server 80

5.    In the Lambda console, configure a test event for your function. Use this JSON here for your event, replacing yourHost with the IP address or hostname of your EC2 instance.

  "Host": "yourHost",
  "Port": 80

6.    In the Lambda console, choose Test.

7.    Verify that the connection was successful by checking the Details of the execution result for a 200 response code like this:

  "statusCode": 200

If the function output shows non-nil values for average, max, and min latency, then your VPC peering connection is set up successfully.

Note: If Lambda times out, make sure that your security groups are configured correctly. If you get an ECONNREFUSED error, make sure that your HTTP server is running.