VPC

The VPC resource lets you create and manage AWS EC2 VPCs to isolate your AWS resources in a virtual network.

Minimal Example

Create a basic VPC with a CIDR block and enable DNS support.

import AWS from "alchemy/aws/control";

const myVPC = await AWS.EC2.VPC("my-vpc", {
  CidrBlock: "10.0.0.0/16",
  EnableDnsSupport: true,
  Tags: [
    { Key: "Name", Value: "MyVPC" }
  ]
});

Advanced Configuration

Configure a VPC with instance tenancy options and a specific IPv4 netmask length.

const advancedVPC = await AWS.EC2.VPC("advanced-vpc", {
  CidrBlock: "192.168.0.0/24",
  InstanceTenancy: "dedicated",
  Ipv4NetmaskLength: 24,
  EnableDnsHostnames: true,
  Tags: [
    { Key: "Name", Value: "AdvancedVPC" },
    { Key: "Environment", Value: "Production" }
  ]
});

Example with IPAM Pool ID

Create a VPC that uses a specific IPv4 IPAM pool.

const ipamVPC = await AWS.EC2.VPC("ipam-vpc", {
  Ipv4IpamPoolId: "ipam-pool-12345678",
  CidrBlock: "10.1.0.0/16",
  EnableDnsSupport: true,
  Tags: [
    { Key: "Name", Value: "IPAMVPC" }
  ]
});

Example with Adoption of Existing Resource

Adopt an existing VPC if it is already created instead of failing.

const existingVPC = await AWS.EC2.VPC("existing-vpc", {
  CidrBlock: "10.2.0.0/16",
  adopt: true,
  Tags: [
    { Key: "Name", Value: "ExistingVPC" }
  ]
});