@aws-cdk/aws-ec2-alpha 2.176.0-alpha.0 → 2.177.0-alpha.0

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://aws.amazon.com"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.176.0",
+    "aws-cdk-lib": "^2.177.0",
     "constructs": "^10.0.0"
   },
   "dependencyClosure": {
@@ -2567,6 +2567,32 @@
             }
           }
         },
+        "aws-cdk-lib.aws_notifications": {
+          "targets": {
+            "dotnet": {
+              "package": "Amazon.CDK.AWS.Notifications"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.notifications"
+            },
+            "python": {
+              "module": "aws_cdk.aws_notifications"
+            }
+          }
+        },
+        "aws-cdk-lib.aws_notificationscontacts": {
+          "targets": {
+            "dotnet": {
+              "package": "Amazon.CDK.AWS.NotificationsContacts"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.notificationscontacts"
+            },
+            "python": {
+              "module": "aws_cdk.aws_notificationscontacts"
+            }
+          }
+        },
         "aws-cdk-lib.aws_oam": {
           "targets": {
             "dotnet": {
@@ -3913,7 +3939,7 @@
     "stability": "experimental"
   },
   "homepage": "https://github.com/aws/aws-cdk",
-  "jsiiVersion": "5.7.3 (build e7089ad)",
+  "jsiiVersion": "5.7.4 (build fc2a28e)",
   "keywords": [
     "aws",
     "cdk",
@@ -3935,7 +3961,7 @@
   },
   "name": "@aws-cdk/aws-ec2-alpha",
   "readme": {
-    "markdown": "# Amazon VpcV2 Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n\n## VpcV2\n\n`VpcV2` is a re-write of the [`ec2.Vpc`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.Vpc.html) construct. This new construct enables higher level of customization\non the VPC being created. `VpcV2` implements the existing [`IVpc`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.IVpc.html), therefore,\n`VpcV2` is compatible with other constructs that accepts `IVpc` (e.g. [`ApplicationLoadBalancer`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationLoadBalancer.html#construct-props)).\n\nTo create a VPC with both IPv4 and IPv6 support:\n\n```ts\n\nconst stack = new Stack();\nnew VpcV2(this, 'Vpc', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/24'),\n  secondaryAddressBlocks: [\n    IpAddresses.amazonProvidedIpv6({cidrBlockName: 'AmazonProvidedIpv6'}),\n  ],\n});\n```\n\n`VpcV2` does not automatically create subnets or allocate IP addresses, which is different from the `Vpc` construct.\n\n## SubnetV2\n\n`SubnetV2` is a re-write of the [`ec2.Subnet`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.Subnet.html) construct.\nThis new construct can be used to add subnets to a `VpcV2` instance:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc', {\n  secondaryAddressBlocks: [\n    IpAddresses.amazonProvidedIpv6({ cidrBlockName: 'AmazonProvidedIp'}),\n  ],\n});\n\nnew SubnetV2(this, 'subnetA', {\n  vpc: myVpc,\n  availabilityZone: 'us-east-1a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  ipv6CidrBlock: new IpCidr('2a05:d02c:25:4000::/60'),\n  subnetType: SubnetType.PRIVATE_ISOLATED,\n})\n```\n\n## IP Addresses Management\n\nBy default `VpcV2` uses `10.0.0.0/16` as the primary CIDR if none is defined.\nAdditional CIDRs can be adding to the VPC via the `secondaryAddressBlocks` prop.\nThe following example illustrates the different options of defining the address blocks:\n\n```ts\n\nconst stack = new Stack();\nconst ipam = new Ipam(this, 'Ipam', {\n  operatingRegion: ['us-west-1']\n});\nconst ipamPublicPool = ipam.publicScope.addPool('PublicPoolA', {\n  addressFamily: AddressFamily.IP_V6,\n  awsService: AwsServiceName.EC2,\n  locale: 'us-west-1',\n  publicIpSource: IpamPoolPublicIpSource.AMAZON,\n});\nipamPublicPool.provisionCidr('PublicPoolACidrA', { netmaskLength: 52 } );\n\nconst ipamPrivatePool = ipam.privateScope.addPool('PrivatePoolA', {\n  addressFamily: AddressFamily.IP_V4,\n});\nipamPrivatePool.provisionCidr('PrivatePoolACidrA', { netmaskLength: 8 } );\n\nnew VpcV2(this, 'Vpc', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/24'),\n  secondaryAddressBlocks: [\n    IpAddresses.amazonProvidedIpv6({ cidrBlockName: 'AmazonIpv6' }),\n    IpAddresses.ipv6Ipam({\n      ipamPool: ipamPublicPool,\n      netmaskLength: 52,\n      cidrBlockName: 'ipv6Ipam',\n    }),\n    IpAddresses.ipv4Ipam({\n      ipamPool: ipamPrivatePool,\n      netmaskLength: 8,\n      cidrBlockName: 'ipv4Ipam',\n    }),\n  ],\n});\n```\n\nSince `VpcV2` does not create subnets automatically, users have full control over IP addresses allocation across subnets.\n\n\n## Routing\n\n`RouteTable` is a new construct that allows for route tables to be customized in a variety of ways. For instance, the following example shows how a custom route table can be created and appended to a subnet:\n\n```ts\n\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  routeTable,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE_ISOLATED,\n});\n```\n\n`Routes` can be created to link subnets to various different AWS services via gateways and endpoints. Each unique route target has its own dedicated construct that can be routed to a given subnet via the `Route` construct. An example using the `InternetGateway` construct can be seen below:\n\n```ts\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE_ISOLATED });\n\nconst igw = new InternetGateway(this, 'IGW', {\n  vpc: myVpc,\n});\nnew Route(this, 'IgwRoute', {\n  routeTable,\n  destination: '0.0.0.0/0',\n  target:  { gateway: igw },\n});\n```\n\nAlternatively, `Routes` can also be created via method `addRoute` in the `RouteTable` class. An example using the `EgressOnlyInternetGateway` construct can be seen below:\nNote: `EgressOnlyInternetGateway` can only be used to set up outbound IPv6 routing.\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc',{\n      primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n      secondaryAddressBlocks: [IpAddresses.amazonProvidedIpv6({\n      cidrBlockName: 'AmazonProvided',\n    })]\n    });\n\nconst eigw = new EgressOnlyInternetGateway(this, 'EIGW', {\n  vpc: myVpc,\n});\n\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\n\nrouteTable.addRoute('EIGW', '::/0', { gateway: eigw });\n```\n\nOther route targets may require a deeper set of parameters to set up properly. For instance, the example below illustrates how to set up a `NatGateway`:\n\n```ts\n\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE_ISOLATED });\n\nconst natgw = new NatGateway(this, 'NatGW', {\n  subnet: subnet,\n  vpc: myVpc,\n  connectivityType: NatConnectivityType.PRIVATE,\n  privateIpAddress: '10.0.0.42',\n});\nnew Route(this, 'NatGwRoute', {\n  routeTable,\n  destination: '0.0.0.0/0',\n  target: { gateway: natgw },\n});\n```\n\nIt is also possible to set up endpoints connecting other AWS services. For instance, the example below illustrates the linking of a Dynamo DB endpoint via the existing `ec2.GatewayVpcEndpoint` construct as a route target:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE });\n\nconst dynamoEndpoint = new ec2.GatewayVpcEndpoint(this, 'DynamoEndpoint', {\n  service: ec2.GatewayVpcEndpointAwsService.DYNAMODB,\n  vpc: myVpc,\n  subnets: [subnet],\n});\nnew Route(this, 'DynamoDBRoute', {\n  routeTable,\n  destination: '0.0.0.0/0',\n  target: { endpoint: dynamoEndpoint },\n});\n\n```\n\n## VPC Peering Connection\n\nVPC peering connection allows you to connect two VPCs and route traffic between them using private IP addresses. The VpcV2 construct supports creating VPC peering connections through the `VPCPeeringConnection` construct from the `route` module.\n\nPeering Connection cannot be established between two VPCs with overlapping CIDR ranges. Please make sure the two VPC CIDRs do not overlap with each other else it will throw an error.\n\nFor more information, see [What is VPC peering?](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html).\n\nThe following show examples of how to create a peering connection between two VPCs for all possible combinations of same-account or cross-account, and same-region or cross-region configurations.\n\nNote: You cannot create a VPC peering connection between VPCs that have matching or overlapping CIDR blocks\n\n**Case 1: Same Account and Same Region Peering Connection**\n\n```ts\nconst stack = new Stack();\n\nconst vpcA = new VpcV2(this, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nconst vpcB = new VpcV2(this, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst peeringConnection = vpcA.createPeeringConnection('sameAccountSameRegionPeering', {\n  acceptorVpc: vpcB,\n});\n```\n\n**Case 2: Same Account and Cross Region Peering Connection**\n\nThere is no difference from Case 1 when calling `createPeeringConnection`. The only change is that one of the VPCs are created in another stack with a different region. To establish cross region VPC peering connection, acceptorVpc needs to be imported to the requestor VPC stack using `fromVpcV2Attributes` method.\n\n```ts\nconst app = new App();\n\nconst stackA = new Stack(app, 'VpcStackA', { env: { account: '000000000000', region: 'us-east-1' } });\nconst stackB = new Stack(app, 'VpcStackB', { env: { account: '000000000000', region: 'us-west-2' } });\n\nconst vpcA = new VpcV2(stackA, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nnew VpcV2(stackB, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst vpcB = VpcV2.fromVpcV2Attributes(stackA, 'ImportedVpcB', {\n      vpcId: 'MockVpcBid',\n      vpcCidrBlock: '10.1.0.0/16',\n      region: 'us-west-2',\n      ownerAccountId: '000000000000',\n    });\n\n\nconst peeringConnection = vpcA.createPeeringConnection('sameAccountCrossRegionPeering', {\n  acceptorVpc: vpcB,\n});\n```\n\n**Case 3: Cross Account Peering Connection**\n\nFor cross-account connections, the acceptor account needs an IAM role that grants the requestor account permission to initiate the connection. Create a new IAM role in the acceptor account using method `createAcceptorVpcRole` to provide the necessary permissions.\n\nOnce role is created in account, provide role arn for field `peerRoleArn` under method `createPeeringConnection`\n\n```ts\nconst stack = new Stack();\n\nconst acceptorVpc = new VpcV2(this, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nconst acceptorRoleArn = acceptorVpc.createAcceptorVpcRole('000000000000'); // Requestor account ID\n```\n\nAfter creating an IAM role in the acceptor account, we can initiate the peering connection request from the requestor VPC. Import acceptorVpc to the stack using `fromVpcV2Attributes` method, it is recommended to specify owner account id of the acceptor VPC in case of cross account peering connection, if acceptor VPC is hosted in different region provide region value for import as well.\nThe following code snippet demonstrates how to set up VPC peering between two VPCs in different AWS accounts using CDK:\n\n```ts\nconst stack = new Stack();\n\nconst acceptorVpc = VpcV2.fromVpcV2Attributes(this, 'acceptorVpc', {\n      vpcId: 'vpc-XXXX',\n      vpcCidrBlock: '10.0.0.0/16',\n      region: 'us-east-2',\n      ownerAccountId: '111111111111',\n    });\n\nconst acceptorRoleArn = 'arn:aws:iam::111111111111:role/VpcPeeringRole';\n\nconst requestorVpc = new VpcV2(this, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst peeringConnection = requestorVpc.createPeeringConnection('crossAccountCrossRegionPeering', {\n  acceptorVpc: acceptorVpc,\n  peerRoleArn: acceptorRoleArn,\n});\n```\n\n### Route Table Configuration\n\nAfter establishing the VPC peering connection, routes must be added to the respective route tables in the VPCs to enable traffic flow. If a route is added to the requestor stack, information will be able to flow from the requestor VPC to the acceptor VPC, but not in the reverse direction. For bi-directional communication, routes need to be added in both VPCs from their respective stacks.\n\nFor more information, see [Update your route tables for a VPC peering connection](https://docs.aws.amazon.com/vpc/latest/peering/vpc-peering-routing.html).\n\n```ts\nconst stack = new Stack();\n\nconst acceptorVpc = new VpcV2(this, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nconst requestorVpc = new VpcV2(this, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst peeringConnection = requestorVpc.createPeeringConnection('peeringConnection', {\n  acceptorVpc: acceptorVpc,\n});\n\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: requestorVpc,\n});\n\nrouteTable.addRoute('vpcPeeringRoute', '10.0.0.0/16', { gateway: peeringConnection });\n```\n\nThis can also be done using AWS CLI. For more information, see [create-route](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-route.html).\n\n```bash\n# Add a route to the requestor VPC route table\naws ec2 create-route --route-table-id rtb-requestor --destination-cidr-block 10.0.0.0/16 --vpc-peering-connection-id pcx-xxxxxxxx\n\n# For bi-directional add a route in the acceptor vpc account as well\naws ec2 create-route --route-table-id rtb-acceptor --destination-cidr-block 10.1.0.0/16 --vpc-peering-connection-id pcx-xxxxxxxx\n```\n\n### Deleting the Peering Connection\n\nTo delete a VPC peering connection, use the following command:\n\n```bash\naws ec2 delete-vpc-peering-connection --vpc-peering-connection-id pcx-xxxxxxxx\n```\n\nFor more information, see [Delete a VPC peering connection](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html#delete-vpc-peering-connection).\n\n## Adding Egress-Only Internet Gateway to VPC\n\nAn egress-only internet gateway is a horizontally scaled, redundant, and highly available VPC component that allows outbound communication over IPv6 from instances in your VPC to the internet, and prevents the internet from initiating an IPv6 connection with your instances.\n\nFor more information see [Enable outbound IPv6 traffic using an egress-only internet gateway](https://docs.aws.amazon.com/vpc/latest/userguide/egress-only-internet-gateway.html).\n\nVpcV2 supports adding an egress only internet gateway to VPC using the `addEgressOnlyInternetGateway` method.\n\nBy default, this method sets up a route to all outbound IPv6 address ranges, unless a specific destination is provided by the user. It can only be configured for IPv6-enabled VPCs.\nThe `Subnets` parameter accepts a `SubnetFilter`, which can be based on a `SubnetType` in VpcV2. A new route will be added to the route tables of all subnets that match this filter.\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc',{\n      primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n      secondaryAddressBlocks: [IpAddresses.amazonProvidedIpv6({\n      cidrBlockName: 'AmazonProvided',\n    })]\n    });\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  ipv6CidrBlock: new IpCidr('2001:db8:1::/64'),\n  subnetType: SubnetType.PRIVATE });\n\nmyVpc.addEgressOnlyInternetGateway({\n  subnets: [{subnetType: SubnetType.PRIVATE}],\n  destination: '::/60',\n})\n```\n\n## Adding NATGateway to the VPC\n\nA NAT gateway is a Network Address Translation (NAT) service.You can use a NAT gateway so that instances in a private subnet can connect to services outside your VPC but external services cannot initiate a connection with those instances.\n\nFor more information, see [NAT gateway basics](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html).\n\nWhen you create a NAT gateway, you specify one of the following connectivity types:\n\n**Public – (Default)**: Instances in private subnets can connect to the internet through a public NAT gateway, but cannot receive unsolicited inbound connections from the internet\n\n**Private**: Instances in private subnets can connect to other VPCs or your on-premises network through a private NAT gateway.\n\nTo define the NAT gateway connectivity type as `ConnectivityType.Public`, you need to ensure that there is an IGW(Internet Gateway) attached to the subnet's VPC.\nSince a NATGW is associated with a particular subnet, providing `subnet` field in the input props is mandatory.\n\nAdditionally, you can set up a route in any route table with the target set to the NAT Gateway. The function `addNatGateway` returns a `NATGateway` object that you can reference later.\n\nThe code example below provides the definition for adding a NAT gateway to your subnet:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PUBLIC });\n\nmyVpc.addInternetGateway();\nmyVpc.addNatGateway({\n  subnet: subnet,\n  connectivityType: NatConnectivityType.PUBLIC,\n});\n```\n\n## Enable VPNGateway for the VPC\n\nA virtual private gateway is the endpoint on the VPC side of your VPN connection.\n\nFor more information, see [What is AWS Site-to-Site VPN?](https://docs.aws.amazon.com/vpn/latest/s2svpn/VPC_VPN.html).\n\nVPN route propagation is a feature in Amazon Web Services (AWS) that automatically updates route tables in your Virtual Private Cloud (VPC) with routes learned from a VPN connection.\n\nTo enable VPN route propagation, use the `vpnRoutePropagation` property to specify the subnets as an input to the function. VPN route propagation will then be enabled for each subnet with the corresponding route table IDs.\n\nAdditionally, you can set up a route in any route table with the target set to the VPN Gateway. The function `enableVpnGatewayV2` returns a `VPNGatewayV2` object that you can reference later.\n\nThe code example below provides the definition for setting up a VPN gateway with `vpnRoutePropagation` enabled:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst vpnGateway = myVpc.enableVpnGatewayV2({\n  vpnRoutePropagation: [{ subnetType: SubnetType.PUBLIC }],\n  type: VpnConnectionType.IPSEC_1,\n});\n\nconst routeTable = new RouteTable(stack, 'routeTable', {\n  vpc: myVpc\n  } );\n\nnew Route(stack, 'route', {\n  destination: '172.31.0.0/24',\n  target: { gateway: vpnGateway },\n  routeTable: routeTable,\n});\n```\n\n## Adding InternetGateway to the VPC\n\nAn internet gateway is a horizontally scaled, redundant, and highly available VPC component that allows communication between your VPC and the internet. It supports both IPv4 and IPv6 traffic.\n\nFor more information, see [Enable VPC internet access using internet gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-igw-internet-access.html).\n\nYou can add an internet gateway to a VPC using `addInternetGateway` method. By default, this method creates a route in all Public Subnets with outbound destination set to `0.0.0.0` for IPv4 and `::0` for IPv6 enabled VPC.\nInstead of using the default settings, you can configure a custom destination range by providing an optional input `destination` to the method.\n\nThe code example below shows how to add an internet gateway with a custom outbound destination IP range:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\n\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PUBLIC });\n\nmyVpc.addInternetGateway({\n  ipv4Destination: '192.168.0.0/16',\n});\n```\n\n## Importing an existing VPC\n\nYou can import an existing VPC and its subnets using the `VpcV2.fromVpcV2Attributes()` method or an individual subnet using `SubnetV2.fromSubnetV2Attributes()` method.\n\n### Importing a VPC\n\nTo import an existing VPC, use the `VpcV2.fromVpcV2Attributes()` method. You'll need to provide the VPC ID, primary CIDR block, and information about the subnets. You can import secondary address as well created through IPAM, BYOIP(IPv4) or enabled through Amazon Provided IPv6. You must provide VPC Id and its primary CIDR block for importing it.\n\nIf you wish to add a new subnet to imported VPC, new subnet's IP range(IPv4) will be validated against provided secondary and primary address block to confirm that it is within the the range of VPC.\n\nHere's an example of importing a VPC with only the required parameters\n\n``` ts\n\nconst stack = new Stack();\n\nconst importedVpc = VpcV2.fromVpcV2Attributes(stack, 'ImportedVpc', {\n      vpcId: 'mockVpcID',\n      vpcCidrBlock: '10.0.0.0/16',\n});\n\n```\n\nIn case of cross account or cross region VPC, its recommended to provide region and ownerAccountId so that these values for the VPC can be used to populate correct arn value for the VPC. If a VPC region and account ID is not provided, then region and account configured in the stack will be used. Furthermore, these fields will be referenced later while setting up VPC peering connection, so its necessary to set these fields to a correct value.\n\nBelow is an example of importing a cross region and cross account VPC, VPC arn for this case would be 'arn:aws:ec2:us-west-2:123456789012:vpc/mockVpcID'\n\n``` ts\n\nconst stack = new Stack();\n\n//Importing a cross account or cross region VPC\nconst importedVpc = VpcV2.fromVpcV2Attributes(stack, 'ImportedVpc', {\n      vpcId: 'mockVpcID',\n      vpcCidrBlock: '10.0.0.0/16',\n      ownerAccountId: '123456789012',\n      region: 'us-west-2',\n});\n\n```\n\nHere's an example of how to import a VPC with multiple CIDR blocks, IPv6 support, and different subnet types:\n\nIn this example, we're importing a VPC with:\n\n - A primary CIDR block (10.1.0.0/16)\n - One secondary IPv4 CIDR block (10.2.0.0/16)\n - Two secondary address using IPAM pool (IPv4 and IPv6)\n - VPC has Amazon-provided IPv6 CIDR enabled\n - An isolated subnet in us-west-2a\n - A public subnet in us-west-2b\n\n```ts\n\nconst stack = new Stack();\n\nconst importedVpc = VpcV2.fromVpcV2Attributes(this, 'ImportedVPC', {\n  vpcId: 'vpc-XXX',\n  vpcCidrBlock: '10.1.0.0/16',\n  secondaryCidrBlocks: [\n    {\n      cidrBlock: '10.2.0.0/16',\n      cidrBlockName: 'ImportedBlock1',\n    },\n    {\n      ipv6IpamPoolId: 'ipam-pool-XXX',\n      ipv6NetmaskLength: 52,\n      cidrBlockName: 'ImportedIpamIpv6',\n    },\n    {\n      ipv4IpamPoolId: 'ipam-pool-XXX',\n      ipv4IpamProvisionedCidrs: ['10.2.0.0/16'],\n      cidrBlockName: 'ImportedIpamIpv4',\n    },\n    {\n      amazonProvidedIpv6CidrBlock: true,\n    }\n  ],\n  subnets: [{\n    subnetName: 'IsolatedSubnet2',\n    subnetId: 'subnet-03cd773c0fe08ed26',\n    subnetType: SubnetType.PRIVATE_ISOLATED,\n    availabilityZone: 'us-west-2a',\n    ipv4CidrBlock: '10.2.0.0/24',\n    routeTableId: 'rtb-0871c310f98da2cbb',\n  },\n  {\n    subnetId: 'subnet-0fa477e01db27d820',\n    subnetType: SubnetType.PUBLIC,\n    availabilityZone: 'us-west-2b',\n    ipv4CidrBlock: '10.3.0.0/24',\n    routeTableId: 'rtb-014f3043098fe4b96',\n  }],\n});\n\n// You can now use the imported VPC in your stack\n\n// Adding a new subnet to the imported VPC\nconst importedSubnet = new SubnetV2(this, 'NewSubnet', {\n  availabilityZone: 'us-west-2a',\n  ipv4CidrBlock: new IpCidr('10.2.2.0/24'),\n  vpc: importedVpc,\n  subnetType: SubnetType.PUBLIC,\n});\n\n// Adding gateways to the imported VPC\nimportedVpc.addInternetGateway();\nimportedVpc.addNatGateway({ subnet: importedSubnet });\nimportedVpc.addEgressOnlyInternetGateway();\n```\n\nYou can add more subnets as needed by including additional entries in the `isolatedSubnets`, `publicSubnets`, or other subnet type arrays (e.g., `privateSubnets`).\n\n### Importing Subnets\n\nYou can also import individual subnets using the `SubnetV2.fromSubnetV2Attributes()` method. This is useful when you need to work with specific subnets independently of a VPC.\n\nHere's an example of how to import a subnet:\n\n```ts\n\nSubnetV2.fromSubnetV2Attributes(this, 'ImportedSubnet', {\n  subnetId: 'subnet-0123456789abcdef0',\n  availabilityZone: 'us-west-2a',\n  ipv4CidrBlock: '10.2.0.0/24',\n  routeTableId: 'rtb-0871c310f98da2cbb',\n  subnetType: SubnetType.PRIVATE_ISOLATED,\n});\n```\n\nBy importing existing VPCs and subnets, you can easily integrate your existing AWS infrastructure with new resources created through CDK. This is particularly useful when you need to work with pre-existing network configurations or when you're migrating existing infrastructure to CDK.\n\n### Tagging VPC and its components\n\nBy default, when a resource name is given to the construct, it automatically adds a tag with the key `Name` and the value set to the provided resource name. To add additional custom tags, use the Tag Manager, like this: `Tags.of(myConstruct).add('key', 'value');`.\n\nFor example, if the `vpcName` is set to `TestVpc`, the following code will add a tag to the VPC with `key: Name` and `value: TestVpc`.\n\n```ts\n\nconst vpc = new VpcV2(this, 'VPC-integ-test-tag', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n  enableDnsHostnames: true,\n  enableDnsSupport: true,\n  vpcName: 'CDKintegTestVPC',\n});\n\n// Add custom tags if needed\nTags.of(vpc).add('Environment', 'Production');\n```\n"
+    "markdown": "# Amazon VpcV2 Construct Library\n<!--BEGIN STABILITY BANNER-->\n\n---\n\n![cdk-constructs: Experimental](https://img.shields.io/badge/cdk--constructs-experimental-important.svg?style=for-the-badge)\n\n> The APIs of higher level constructs in this module are experimental and under active development.\n> They are subject to non-backward compatible changes or removal in any future version. These are\n> not subject to the [Semantic Versioning](https://semver.org/) model and breaking changes will be\n> announced in the release notes. This means that while you may use them, you may need to update\n> your source code when upgrading to a newer version of this package.\n\n---\n\n<!--END STABILITY BANNER-->\n\n\n## VpcV2\n\n`VpcV2` is a re-write of the [`ec2.Vpc`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.Vpc.html) construct. This new construct enables higher level of customization\non the VPC being created. `VpcV2` implements the existing [`IVpc`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.IVpc.html), therefore,\n`VpcV2` is compatible with other constructs that accepts `IVpc` (e.g. [`ApplicationLoadBalancer`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_elasticloadbalancingv2.ApplicationLoadBalancer.html#construct-props)).\n\nTo create a VPC with both IPv4 and IPv6 support:\n\n```ts\n\nconst stack = new Stack();\nnew VpcV2(this, 'Vpc', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/24'),\n  secondaryAddressBlocks: [\n    IpAddresses.amazonProvidedIpv6({cidrBlockName: 'AmazonProvidedIpv6'}),\n  ],\n});\n```\n\n`VpcV2` does not automatically create subnets or allocate IP addresses, which is different from the `Vpc` construct.\n\n## SubnetV2\n\n`SubnetV2` is a re-write of the [`ec2.Subnet`](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ec2.Subnet.html) construct.\nThis new construct can be used to add subnets to a `VpcV2` instance:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc', {\n  secondaryAddressBlocks: [\n    IpAddresses.amazonProvidedIpv6({ cidrBlockName: 'AmazonProvidedIp'}),\n  ],\n});\n\nnew SubnetV2(this, 'subnetA', {\n  vpc: myVpc,\n  availabilityZone: 'us-east-1a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  ipv6CidrBlock: new IpCidr('2a05:d02c:25:4000::/60'),\n  subnetType: SubnetType.PRIVATE_ISOLATED,\n})\n```\n\n## IP Addresses Management\n\nBy default `VpcV2` uses `10.0.0.0/16` as the primary CIDR if none is defined.\nAdditional CIDRs can be adding to the VPC via the `secondaryAddressBlocks` prop.\nThe following example illustrates the different options of defining the address blocks:\n\n```ts\n\nconst stack = new Stack();\nconst ipam = new Ipam(this, 'Ipam', {\n  operatingRegion: ['us-west-1']\n});\nconst ipamPublicPool = ipam.publicScope.addPool('PublicPoolA', {\n  addressFamily: AddressFamily.IP_V6,\n  awsService: AwsServiceName.EC2,\n  locale: 'us-west-1',\n  publicIpSource: IpamPoolPublicIpSource.AMAZON,\n});\nipamPublicPool.provisionCidr('PublicPoolACidrA', { netmaskLength: 52 } );\n\nconst ipamPrivatePool = ipam.privateScope.addPool('PrivatePoolA', {\n  addressFamily: AddressFamily.IP_V4,\n});\nipamPrivatePool.provisionCidr('PrivatePoolACidrA', { netmaskLength: 8 } );\n\nnew VpcV2(this, 'Vpc', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/24'),\n  secondaryAddressBlocks: [\n    IpAddresses.amazonProvidedIpv6({ cidrBlockName: 'AmazonIpv6' }),\n    IpAddresses.ipv6Ipam({\n      ipamPool: ipamPublicPool,\n      netmaskLength: 52,\n      cidrBlockName: 'ipv6Ipam',\n    }),\n    IpAddresses.ipv4Ipam({\n      ipamPool: ipamPrivatePool,\n      netmaskLength: 8,\n      cidrBlockName: 'ipv4Ipam',\n    }),\n  ],\n});\n```\n\nSince `VpcV2` does not create subnets automatically, users have full control over IP addresses allocation across subnets.\n\n### Bring your own IPv6 addresses (BYOIP)\n\nIf you have your own IP address that you would like to use with EC2, you can set up an IPv6 pool via the AWS CLI, and use that pool ID in your application.\n\nOnce you have certified your IP address block with an ROA and have obtained an X-509 certificate, you can run the following command to provision your CIDR block in your AWS account:\n\n```shell\naws ec2 provision-byoip-cidr --region <region> --cidr <your CIDR block> --cidr-authorization-context Message=\"1|aws|<account>|<your CIDR block>|<expiration date>|SHA256\".Signature=\"<signature>\"\n```\n\nWhen your BYOIP CIDR is provisioned, you can run the following command to retrieve your IPv6 pool ID, which will be used in your VPC declaration:\n\n```shell\naws ec2 describe-byoip-cidr --region <region>\n```\n\nFor more help on setting up your IPv6 address, please review the [EC2 Documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html).\n\nOnce you have provisioned your address block, you can use the IPv6 in your VPC as follows:\n\n```ts\nconst myVpc = new VpcV2(this, 'Vpc', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n  secondaryAddressBlocks: [IpAddresses.ipv6ByoipPool({\n    cidrBlockName: 'MyByoipCidrBlock',\n    ipv6PoolId: 'ipv6pool-ec2-someHashValue',\n    ipv6CidrBlock: '2001:db8::/32'\n  })],\n  enableDnsHostnames: true,\n  enableDnsSupport: true,\n});\n```\n\n## Routing\n\n`RouteTable` is a new construct that allows for route tables to be customized in a variety of ways. For instance, the following example shows how a custom route table can be created and appended to a subnet:\n\n```ts\n\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  routeTable,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE_ISOLATED,\n});\n```\n\n`Routes` can be created to link subnets to various different AWS services via gateways and endpoints. Each unique route target has its own dedicated construct that can be routed to a given subnet via the `Route` construct. An example using the `InternetGateway` construct can be seen below:\n\n```ts\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE_ISOLATED });\n\nconst igw = new InternetGateway(this, 'IGW', {\n  vpc: myVpc,\n});\nnew Route(this, 'IgwRoute', {\n  routeTable,\n  destination: '0.0.0.0/0',\n  target:  { gateway: igw },\n});\n```\n\nAlternatively, `Routes` can also be created via method `addRoute` in the `RouteTable` class. An example using the `EgressOnlyInternetGateway` construct can be seen below:\nNote: `EgressOnlyInternetGateway` can only be used to set up outbound IPv6 routing.\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc',{\n      primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n      secondaryAddressBlocks: [IpAddresses.amazonProvidedIpv6({\n      cidrBlockName: 'AmazonProvided',\n    })]\n    });\n\nconst eigw = new EgressOnlyInternetGateway(this, 'EIGW', {\n  vpc: myVpc,\n});\n\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\n\nrouteTable.addRoute('EIGW', '::/0', { gateway: eigw });\n```\n\nOther route targets may require a deeper set of parameters to set up properly. For instance, the example below illustrates how to set up a `NatGateway`:\n\n```ts\n\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE_ISOLATED });\n\nconst natgw = new NatGateway(this, 'NatGW', {\n  subnet: subnet,\n  vpc: myVpc,\n  connectivityType: NatConnectivityType.PRIVATE,\n  privateIpAddress: '10.0.0.42',\n});\nnew Route(this, 'NatGwRoute', {\n  routeTable,\n  destination: '0.0.0.0/0',\n  target: { gateway: natgw },\n});\n```\n\nIt is also possible to set up endpoints connecting other AWS services. For instance, the example below illustrates the linking of a Dynamo DB endpoint via the existing `ec2.GatewayVpcEndpoint` construct as a route target:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PRIVATE });\n\nconst dynamoEndpoint = new ec2.GatewayVpcEndpoint(this, 'DynamoEndpoint', {\n  service: ec2.GatewayVpcEndpointAwsService.DYNAMODB,\n  vpc: myVpc,\n  subnets: [subnet],\n});\nnew Route(this, 'DynamoDBRoute', {\n  routeTable,\n  destination: '0.0.0.0/0',\n  target: { endpoint: dynamoEndpoint },\n});\n\n```\n\n## VPC Peering Connection\n\nVPC peering connection allows you to connect two VPCs and route traffic between them using private IP addresses. The VpcV2 construct supports creating VPC peering connections through the `VPCPeeringConnection` construct from the `route` module.\n\nPeering Connection cannot be established between two VPCs with overlapping CIDR ranges. Please make sure the two VPC CIDRs do not overlap with each other else it will throw an error.\n\nFor more information, see [What is VPC peering?](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html).\n\nThe following show examples of how to create a peering connection between two VPCs for all possible combinations of same-account or cross-account, and same-region or cross-region configurations.\n\nNote: You cannot create a VPC peering connection between VPCs that have matching or overlapping CIDR blocks\n\n**Case 1: Same Account and Same Region Peering Connection**\n\n```ts\nconst stack = new Stack();\n\nconst vpcA = new VpcV2(this, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nconst vpcB = new VpcV2(this, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst peeringConnection = vpcA.createPeeringConnection('sameAccountSameRegionPeering', {\n  acceptorVpc: vpcB,\n});\n```\n\n**Case 2: Same Account and Cross Region Peering Connection**\n\nThere is no difference from Case 1 when calling `createPeeringConnection`. The only change is that one of the VPCs are created in another stack with a different region. To establish cross region VPC peering connection, acceptorVpc needs to be imported to the requestor VPC stack using `fromVpcV2Attributes` method.\n\n```ts\nconst app = new App();\n\nconst stackA = new Stack(app, 'VpcStackA', { env: { account: '000000000000', region: 'us-east-1' } });\nconst stackB = new Stack(app, 'VpcStackB', { env: { account: '000000000000', region: 'us-west-2' } });\n\nconst vpcA = new VpcV2(stackA, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nnew VpcV2(stackB, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst vpcB = VpcV2.fromVpcV2Attributes(stackA, 'ImportedVpcB', {\n      vpcId: 'MockVpcBid',\n      vpcCidrBlock: '10.1.0.0/16',\n      region: 'us-west-2',\n      ownerAccountId: '000000000000',\n    });\n\n\nconst peeringConnection = vpcA.createPeeringConnection('sameAccountCrossRegionPeering', {\n  acceptorVpc: vpcB,\n});\n```\n\n**Case 3: Cross Account Peering Connection**\n\nFor cross-account connections, the acceptor account needs an IAM role that grants the requestor account permission to initiate the connection. Create a new IAM role in the acceptor account using method `createAcceptorVpcRole` to provide the necessary permissions.\n\nOnce role is created in account, provide role arn for field `peerRoleArn` under method `createPeeringConnection`\n\n```ts\nconst stack = new Stack();\n\nconst acceptorVpc = new VpcV2(this, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nconst acceptorRoleArn = acceptorVpc.createAcceptorVpcRole('000000000000'); // Requestor account ID\n```\n\nAfter creating an IAM role in the acceptor account, we can initiate the peering connection request from the requestor VPC. Import acceptorVpc to the stack using `fromVpcV2Attributes` method, it is recommended to specify owner account id of the acceptor VPC in case of cross account peering connection, if acceptor VPC is hosted in different region provide region value for import as well.\nThe following code snippet demonstrates how to set up VPC peering between two VPCs in different AWS accounts using CDK:\n\n```ts\nconst stack = new Stack();\n\nconst acceptorVpc = VpcV2.fromVpcV2Attributes(this, 'acceptorVpc', {\n      vpcId: 'vpc-XXXX',\n      vpcCidrBlock: '10.0.0.0/16',\n      region: 'us-east-2',\n      ownerAccountId: '111111111111',\n    });\n\nconst acceptorRoleArn = 'arn:aws:iam::111111111111:role/VpcPeeringRole';\n\nconst requestorVpc = new VpcV2(this, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst peeringConnection = requestorVpc.createPeeringConnection('crossAccountCrossRegionPeering', {\n  acceptorVpc: acceptorVpc,\n  peerRoleArn: acceptorRoleArn,\n});\n```\n\n### Route Table Configuration\n\nAfter establishing the VPC peering connection, routes must be added to the respective route tables in the VPCs to enable traffic flow. If a route is added to the requestor stack, information will be able to flow from the requestor VPC to the acceptor VPC, but not in the reverse direction. For bi-directional communication, routes need to be added in both VPCs from their respective stacks.\n\nFor more information, see [Update your route tables for a VPC peering connection](https://docs.aws.amazon.com/vpc/latest/peering/vpc-peering-routing.html).\n\n```ts\nconst stack = new Stack();\n\nconst acceptorVpc = new VpcV2(this, 'VpcA', {\n  primaryAddressBlock: IpAddresses.ipv4('10.0.0.0/16'),\n});\n\nconst requestorVpc = new VpcV2(this, 'VpcB', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n});\n\nconst peeringConnection = requestorVpc.createPeeringConnection('peeringConnection', {\n  acceptorVpc: acceptorVpc,\n});\n\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: requestorVpc,\n});\n\nrouteTable.addRoute('vpcPeeringRoute', '10.0.0.0/16', { gateway: peeringConnection });\n```\n\nThis can also be done using AWS CLI. For more information, see [create-route](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-route.html).\n\n```bash\n# Add a route to the requestor VPC route table\naws ec2 create-route --route-table-id rtb-requestor --destination-cidr-block 10.0.0.0/16 --vpc-peering-connection-id pcx-xxxxxxxx\n\n# For bi-directional add a route in the acceptor vpc account as well\naws ec2 create-route --route-table-id rtb-acceptor --destination-cidr-block 10.1.0.0/16 --vpc-peering-connection-id pcx-xxxxxxxx\n```\n\n### Deleting the Peering Connection\n\nTo delete a VPC peering connection, use the following command:\n\n```bash\naws ec2 delete-vpc-peering-connection --vpc-peering-connection-id pcx-xxxxxxxx\n```\n\nFor more information, see [Delete a VPC peering connection](https://docs.aws.amazon.com/vpc/latest/peering/create-vpc-peering-connection.html#delete-vpc-peering-connection).\n\n## Adding Egress-Only Internet Gateway to VPC\n\nAn egress-only internet gateway is a horizontally scaled, redundant, and highly available VPC component that allows outbound communication over IPv6 from instances in your VPC to the internet, and prevents the internet from initiating an IPv6 connection with your instances.\n\nFor more information see [Enable outbound IPv6 traffic using an egress-only internet gateway](https://docs.aws.amazon.com/vpc/latest/userguide/egress-only-internet-gateway.html).\n\nVpcV2 supports adding an egress only internet gateway to VPC using the `addEgressOnlyInternetGateway` method.\n\nBy default, this method sets up a route to all outbound IPv6 address ranges, unless a specific destination is provided by the user. It can only be configured for IPv6-enabled VPCs.\nThe `Subnets` parameter accepts a `SubnetFilter`, which can be based on a `SubnetType` in VpcV2. A new route will be added to the route tables of all subnets that match this filter.\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc',{\n      primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n      secondaryAddressBlocks: [IpAddresses.amazonProvidedIpv6({\n      cidrBlockName: 'AmazonProvided',\n    })]\n    });\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  ipv6CidrBlock: new IpCidr('2001:db8:1::/64'),\n  subnetType: SubnetType.PRIVATE });\n\nmyVpc.addEgressOnlyInternetGateway({\n  subnets: [{subnetType: SubnetType.PRIVATE}],\n  destination: '::/60',\n})\n```\n\n## Adding NATGateway to the VPC\n\nA NAT gateway is a Network Address Translation (NAT) service.You can use a NAT gateway so that instances in a private subnet can connect to services outside your VPC but external services cannot initiate a connection with those instances.\n\nFor more information, see [NAT gateway basics](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-nat-gateway.html).\n\nWhen you create a NAT gateway, you specify one of the following connectivity types:\n\n**Public – (Default)**: Instances in private subnets can connect to the internet through a public NAT gateway, but cannot receive unsolicited inbound connections from the internet\n\n**Private**: Instances in private subnets can connect to other VPCs or your on-premises network through a private NAT gateway.\n\nTo define the NAT gateway connectivity type as `ConnectivityType.Public`, you need to ensure that there is an IGW(Internet Gateway) attached to the subnet's VPC.\nSince a NATGW is associated with a particular subnet, providing `subnet` field in the input props is mandatory.\n\nAdditionally, you can set up a route in any route table with the target set to the NAT Gateway. The function `addNatGateway` returns a `NATGateway` object that you can reference later.\n\nThe code example below provides the definition for adding a NAT gateway to your subnet:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst routeTable = new RouteTable(this, 'RouteTable', {\n  vpc: myVpc,\n});\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PUBLIC });\n\nmyVpc.addInternetGateway();\nmyVpc.addNatGateway({\n  subnet: subnet,\n  connectivityType: NatConnectivityType.PUBLIC,\n});\n```\n\n## Enable VPNGateway for the VPC\n\nA virtual private gateway is the endpoint on the VPC side of your VPN connection.\n\nFor more information, see [What is AWS Site-to-Site VPN?](https://docs.aws.amazon.com/vpn/latest/s2svpn/VPC_VPN.html).\n\nVPN route propagation is a feature in Amazon Web Services (AWS) that automatically updates route tables in your Virtual Private Cloud (VPC) with routes learned from a VPN connection.\n\nTo enable VPN route propagation, use the `vpnRoutePropagation` property to specify the subnets as an input to the function. VPN route propagation will then be enabled for each subnet with the corresponding route table IDs.\n\nAdditionally, you can set up a route in any route table with the target set to the VPN Gateway. The function `enableVpnGatewayV2` returns a `VPNGatewayV2` object that you can reference later.\n\nThe code example below provides the definition for setting up a VPN gateway with `vpnRoutePropagation` enabled:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\nconst vpnGateway = myVpc.enableVpnGatewayV2({\n  vpnRoutePropagation: [{ subnetType: SubnetType.PUBLIC }],\n  type: VpnConnectionType.IPSEC_1,\n});\n\nconst routeTable = new RouteTable(stack, 'routeTable', {\n  vpc: myVpc\n  } );\n\nnew Route(stack, 'route', {\n  destination: '172.31.0.0/24',\n  target: { gateway: vpnGateway },\n  routeTable: routeTable,\n});\n```\n\n## Adding InternetGateway to the VPC\n\nAn internet gateway is a horizontally scaled, redundant, and highly available VPC component that allows communication between your VPC and the internet. It supports both IPv4 and IPv6 traffic.\n\nFor more information, see [Enable VPC internet access using internet gateways](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-igw-internet-access.html).\n\nYou can add an internet gateway to a VPC using `addInternetGateway` method. By default, this method creates a route in all Public Subnets with outbound destination set to `0.0.0.0` for IPv4 and `::0` for IPv6 enabled VPC.\nInstead of using the default settings, you can configure a custom destination range by providing an optional input `destination` to the method.\n\nThe code example below shows how to add an internet gateway with a custom outbound destination IP range:\n\n```ts\n\nconst stack = new Stack();\nconst myVpc = new VpcV2(this, 'Vpc');\n\nconst subnet = new SubnetV2(this, 'Subnet', {\n  vpc: myVpc,\n  availabilityZone: 'eu-west-2a',\n  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),\n  subnetType: SubnetType.PUBLIC });\n\nmyVpc.addInternetGateway({\n  ipv4Destination: '192.168.0.0/16',\n});\n```\n\n## Importing an existing VPC\n\nYou can import an existing VPC and its subnets using the `VpcV2.fromVpcV2Attributes()` method or an individual subnet using `SubnetV2.fromSubnetV2Attributes()` method.\n\n### Importing a VPC\n\nTo import an existing VPC, use the `VpcV2.fromVpcV2Attributes()` method. You'll need to provide the VPC ID, primary CIDR block, and information about the subnets. You can import secondary address as well created through IPAM, BYOIP(IPv4) or enabled through Amazon Provided IPv6. You must provide VPC Id and its primary CIDR block for importing it.\n\nIf you wish to add a new subnet to imported VPC, new subnet's IP range(IPv4) will be validated against provided secondary and primary address block to confirm that it is within the the range of VPC.\n\nHere's an example of importing a VPC with only the required parameters\n\n``` ts\n\nconst stack = new Stack();\n\nconst importedVpc = VpcV2.fromVpcV2Attributes(stack, 'ImportedVpc', {\n      vpcId: 'mockVpcID',\n      vpcCidrBlock: '10.0.0.0/16',\n});\n\n```\n\nIn case of cross account or cross region VPC, its recommended to provide region and ownerAccountId so that these values for the VPC can be used to populate correct arn value for the VPC. If a VPC region and account ID is not provided, then region and account configured in the stack will be used. Furthermore, these fields will be referenced later while setting up VPC peering connection, so its necessary to set these fields to a correct value.\n\nBelow is an example of importing a cross region and cross account VPC, VPC arn for this case would be 'arn:aws:ec2:us-west-2:123456789012:vpc/mockVpcID'\n\n``` ts\n\nconst stack = new Stack();\n\n//Importing a cross account or cross region VPC\nconst importedVpc = VpcV2.fromVpcV2Attributes(stack, 'ImportedVpc', {\n      vpcId: 'mockVpcID',\n      vpcCidrBlock: '10.0.0.0/16',\n      ownerAccountId: '123456789012',\n      region: 'us-west-2',\n});\n\n```\n\nHere's an example of how to import a VPC with multiple CIDR blocks, IPv6 support, and different subnet types:\n\nIn this example, we're importing a VPC with:\n\n - A primary CIDR block (10.1.0.0/16)\n - One secondary IPv4 CIDR block (10.2.0.0/16)\n - Two secondary address using IPAM pool (IPv4 and IPv6)\n - VPC has Amazon-provided IPv6 CIDR enabled\n - An isolated subnet in us-west-2a\n - A public subnet in us-west-2b\n\n```ts\n\nconst stack = new Stack();\n\nconst importedVpc = VpcV2.fromVpcV2Attributes(this, 'ImportedVPC', {\n  vpcId: 'vpc-XXX',\n  vpcCidrBlock: '10.1.0.0/16',\n  secondaryCidrBlocks: [\n    {\n      cidrBlock: '10.2.0.0/16',\n      cidrBlockName: 'ImportedBlock1',\n    },\n    {\n      ipv6IpamPoolId: 'ipam-pool-XXX',\n      ipv6NetmaskLength: 52,\n      cidrBlockName: 'ImportedIpamIpv6',\n    },\n    {\n      ipv4IpamPoolId: 'ipam-pool-XXX',\n      ipv4IpamProvisionedCidrs: ['10.2.0.0/16'],\n      cidrBlockName: 'ImportedIpamIpv4',\n    },\n    {\n      amazonProvidedIpv6CidrBlock: true,\n    }\n  ],\n  subnets: [{\n    subnetName: 'IsolatedSubnet2',\n    subnetId: 'subnet-03cd773c0fe08ed26',\n    subnetType: SubnetType.PRIVATE_ISOLATED,\n    availabilityZone: 'us-west-2a',\n    ipv4CidrBlock: '10.2.0.0/24',\n    routeTableId: 'rtb-0871c310f98da2cbb',\n  },\n  {\n    subnetId: 'subnet-0fa477e01db27d820',\n    subnetType: SubnetType.PUBLIC,\n    availabilityZone: 'us-west-2b',\n    ipv4CidrBlock: '10.3.0.0/24',\n    routeTableId: 'rtb-014f3043098fe4b96',\n  }],\n});\n\n// You can now use the imported VPC in your stack\n\n// Adding a new subnet to the imported VPC\nconst importedSubnet = new SubnetV2(this, 'NewSubnet', {\n  availabilityZone: 'us-west-2a',\n  ipv4CidrBlock: new IpCidr('10.2.2.0/24'),\n  vpc: importedVpc,\n  subnetType: SubnetType.PUBLIC,\n});\n\n// Adding gateways to the imported VPC\nimportedVpc.addInternetGateway();\nimportedVpc.addNatGateway({ subnet: importedSubnet });\nimportedVpc.addEgressOnlyInternetGateway();\n```\n\nYou can add more subnets as needed by including additional entries in the `isolatedSubnets`, `publicSubnets`, or other subnet type arrays (e.g., `privateSubnets`).\n\n### Importing Subnets\n\nYou can also import individual subnets using the `SubnetV2.fromSubnetV2Attributes()` method. This is useful when you need to work with specific subnets independently of a VPC.\n\nHere's an example of how to import a subnet:\n\n```ts\n\nSubnetV2.fromSubnetV2Attributes(this, 'ImportedSubnet', {\n  subnetId: 'subnet-0123456789abcdef0',\n  availabilityZone: 'us-west-2a',\n  ipv4CidrBlock: '10.2.0.0/24',\n  routeTableId: 'rtb-0871c310f98da2cbb',\n  subnetType: SubnetType.PRIVATE_ISOLATED,\n});\n```\n\nBy importing existing VPCs and subnets, you can easily integrate your existing AWS infrastructure with new resources created through CDK. This is particularly useful when you need to work with pre-existing network configurations or when you're migrating existing infrastructure to CDK.\n\n### Tagging VPC and its components\n\nBy default, when a resource name is given to the construct, it automatically adds a tag with the key `Name` and the value set to the provided resource name. To add additional custom tags, use the Tag Manager, like this: `Tags.of(myConstruct).add('key', 'value');`.\n\nFor example, if the `vpcName` is set to `TestVpc`, the following code will add a tag to the VPC with `key: Name` and `value: TestVpc`.\n\n```ts\n\nconst vpc = new VpcV2(this, 'VPC-integ-test-tag', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n  enableDnsHostnames: true,\n  enableDnsSupport: true,\n  vpcName: 'CDKintegTestVPC',\n});\n\n// Add custom tags if needed\nTags.of(vpc).add('Environment', 'Production');\n```\n"
   },
   "repository": {
     "directory": "packages/@aws-cdk/aws-ec2-alpha",
@@ -4286,7 +4312,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 129
+        "line": 170
       },
       "methods": [
         {
@@ -4297,7 +4323,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 135
+            "line": 176
           },
           "name": "allocateVpcCidr",
           "returns": {
@@ -4586,7 +4612,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 623
+        "line": 620
       },
       "name": "IRouteV2",
       "properties": [
@@ -4600,7 +4626,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 636
+            "line": 633
           },
           "name": "destination",
           "type": {
@@ -4619,7 +4645,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 628
+            "line": 625
           },
           "name": "routeTable",
           "type": {
@@ -4635,7 +4661,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 641
+            "line": 638
           },
           "name": "target",
           "type": {
@@ -4658,7 +4684,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/subnet-v2.ts",
-        "line": 104
+        "line": 103
       },
       "name": "ISubnetV2",
       "properties": [
@@ -4671,7 +4697,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 109
+            "line": 108
           },
           "name": "ipv6CidrBlock",
           "optional": true,
@@ -4691,7 +4717,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 116
+            "line": 115
           },
           "name": "subnetType",
           "optional": true,
@@ -4712,7 +4738,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 639
+        "line": 693
       },
       "name": "IVPCCidrBlock",
       "properties": [
@@ -4725,7 +4751,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 643
+            "line": 697
           },
           "name": "amazonProvidedIpv6CidrBlock",
           "optional": true,
@@ -4743,7 +4769,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 650
+            "line": 704
           },
           "name": "cidrBlock",
           "optional": true,
@@ -4760,7 +4786,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 660
+            "line": 714
           },
           "name": "ipv4IpamPoolId",
           "optional": true,
@@ -4768,6 +4794,23 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The IPv6 CIDR block from the specified IPv6 address pool."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 719
+          },
+          "name": "ipv6CidrBlock",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -4777,13 +4820,30 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 655
+            "line": 709
           },
           "name": "ipv6IpamPoolId",
           "optional": true,
           "type": {
             "primitive": "string"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "experimental",
+            "summary": "The ID of the IPv6 address pool from which to allocate the IPv6 CIDR block."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 724
+          },
+          "name": "ipv6Pool",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/vpc-v2:IVPCCidrBlock"
@@ -5352,7 +5412,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 23
+        "line": 44
       },
       "methods": [
         {
@@ -5362,7 +5422,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 49
+            "line": 69
           },
           "name": "amazonProvidedIpv6",
           "parameters": [
@@ -5387,7 +5447,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 28
+            "line": 48
           },
           "name": "ipv4",
           "parameters": [
@@ -5419,7 +5479,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 35
+            "line": 55
           },
           "name": "ipv4Ipam",
           "parameters": [
@@ -5437,6 +5497,31 @@
           },
           "static": true
         },
+        {
+          "docs": {
+            "stability": "experimental",
+            "summary": "A BYOIP IPv6 address pool."
+          },
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 76
+          },
+          "name": "ipv6ByoipPool",
+          "parameters": [
+            {
+              "name": "props",
+              "type": {
+                "fqn": "@aws-cdk/aws-ec2-alpha.Ipv6PoolSecondaryAddressProps"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "@aws-cdk/aws-ec2-alpha.IIpAddresses"
+            }
+          },
+          "static": true
+        },
         {
           "docs": {
             "stability": "experimental",
@@ -5444,7 +5529,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 42
+            "line": 62
           },
           "name": "ipv6Ipam",
           "parameters": [
@@ -5483,7 +5568,7 @@
         },
         "locationInModule": {
           "filename": "lib/subnet-v2.ts",
-          "line": 25
+          "line": 24
         },
         "parameters": [
           {
@@ -5509,7 +5594,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 24
+            "line": 23
           },
           "name": "cidr",
           "type": {
@@ -5539,7 +5624,7 @@
         },
         "locationInModule": {
           "filename": "lib/ipam.ts",
-          "line": 512
+          "line": 509
         },
         "parameters": [
           {
@@ -5566,7 +5651,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/ipam.ts",
-        "line": 472
+        "line": 469
       },
       "methods": [
         {
@@ -5576,7 +5661,7 @@
           },
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 549
+            "line": 546
           },
           "name": "addScope",
           "parameters": [
@@ -5619,7 +5704,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 493
+            "line": 490
           },
           "name": "ipamId",
           "type": {
@@ -5634,7 +5719,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 498
+            "line": 495
           },
           "name": "operatingRegions",
           "type": {
@@ -5656,7 +5741,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 485
+            "line": 482
           },
           "name": "privateScope",
           "type": {
@@ -5673,7 +5758,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 478
+            "line": 475
           },
           "name": "publicScope",
           "type": {
@@ -5688,7 +5773,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 503
+            "line": 500
           },
           "name": "scopes",
           "type": {
@@ -5712,7 +5797,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/ipam.ts",
-            "line": 510
+            "line": 507
           },
           "name": "ipamName",
           "optional": true,
@@ -6031,6 +6116,67 @@
       "name": "IpamScopeType",
       "symbolId": "lib/ipam:IpamScopeType"
     },
+    "@aws-cdk/aws-ec2-alpha.Ipv6PoolSecondaryAddressProps": {
+      "assembly": "@aws-cdk/aws-ec2-alpha",
+      "datatype": true,
+      "docs": {
+        "stability": "experimental",
+        "summary": "Additional props needed for BYOIP IPv6 address props.",
+        "example": "const myVpc = new VpcV2(this, 'Vpc', {\n  primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),\n  secondaryAddressBlocks: [IpAddresses.ipv6ByoipPool({\n    cidrBlockName: 'MyByoipCidrBlock',\n    ipv6PoolId: 'ipv6pool-ec2-someHashValue',\n    ipv6CidrBlock: '2001:db8::/32'\n  })],\n  enableDnsHostnames: true,\n  enableDnsSupport: true,\n});",
+        "custom": {
+          "exampleMetadata": "infused"
+        }
+      },
+      "fqn": "@aws-cdk/aws-ec2-alpha.Ipv6PoolSecondaryAddressProps",
+      "interfaces": [
+        "@aws-cdk/aws-ec2-alpha.SecondaryAddressProps"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "lib/vpc-v2.ts",
+        "line": 23
+      },
+      "name": "Ipv6PoolSecondaryAddressProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "The most specific IPv6 address range that you can bring is /48 for CIDRs that are publicly advertisable\nand /56 for CIDRs that are not publicly advertisable.",
+            "see": "https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-byoip.html#byoip-definitions",
+            "stability": "experimental",
+            "summary": "A valid IPv6 CIDR block from the IPv6 address pool onboarded to AWS using BYOIP."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 38
+          },
+          "name": "ipv6CidrBlock",
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "Note: BYOIP Pool ID is different from the IPAM Pool ID.\nTo onboard your IPv6 address range to your AWS account please refer to the below documentation",
+            "see": "https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/byoip-onboard.html",
+            "stability": "experimental",
+            "summary": "ID of the IPv6 address pool from which to allocate the IPv6 CIDR block."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 30
+          },
+          "name": "ipv6PoolId",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "lib/vpc-v2:Ipv6PoolSecondaryAddressProps"
+    },
     "@aws-cdk/aws-ec2-alpha.NatConnectivityType": {
       "assembly": "@aws-cdk/aws-ec2-alpha",
       "docs": {
@@ -6086,7 +6232,7 @@
         },
         "locationInModule": {
           "filename": "lib/route.ts",
-          "line": 423
+          "line": 422
         },
         "parameters": [
           {
@@ -6130,7 +6276,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 391
+            "line": 390
           },
           "name": "natGatewayId",
           "type": {
@@ -6145,7 +6291,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 421
+            "line": 420
           },
           "name": "resource",
           "type": {
@@ -6160,7 +6306,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 401
+            "line": 400
           },
           "name": "routerTargetId",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteTarget",
@@ -6176,7 +6322,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 396
+            "line": 395
           },
           "name": "routerType",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteTarget",
@@ -6193,7 +6339,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 408
+            "line": 407
           },
           "name": "connectivityType",
           "optional": true,
@@ -6210,7 +6356,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 416
+            "line": 415
           },
           "name": "maxDrainDuration",
           "optional": true,
@@ -6620,7 +6766,7 @@
         },
         "locationInModule": {
           "filename": "lib/route.ts",
-          "line": 718
+          "line": 715
         },
         "parameters": [
           {
@@ -6649,7 +6795,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 679
+        "line": 676
       },
       "name": "Route",
       "properties": [
@@ -6662,7 +6808,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 685
+            "line": 682
           },
           "name": "destination",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteV2",
@@ -6681,7 +6827,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 696
+            "line": 693
           },
           "name": "routeTable",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteV2",
@@ -6697,7 +6843,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 690
+            "line": 687
           },
           "name": "target",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteV2",
@@ -6713,7 +6859,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 701
+            "line": 698
           },
           "name": "targetRouterType",
           "type": {
@@ -6728,7 +6874,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 706
+            "line": 703
           },
           "name": "resource",
           "optional": true,
@@ -6754,7 +6900,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 647
+        "line": 644
       },
       "name": "RouteProps",
       "properties": [
@@ -6768,7 +6914,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 660
+            "line": 657
           },
           "name": "destination",
           "type": {
@@ -6787,7 +6933,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 653
+            "line": 650
           },
           "name": "routeTable",
           "type": {
@@ -6803,7 +6949,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 665
+            "line": 662
           },
           "name": "target",
           "type": {
@@ -6820,7 +6966,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 672
+            "line": 669
           },
           "name": "routeName",
           "optional": true,
@@ -6850,7 +6996,7 @@
         },
         "locationInModule": {
           "filename": "lib/route.ts",
-          "line": 790
+          "line": 787
         },
         "parameters": [
           {
@@ -6879,7 +7025,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 779
+        "line": 776
       },
       "methods": [
         {
@@ -6889,7 +7035,7 @@
           },
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 811
+            "line": 808
           },
           "name": "addRoute",
           "parameters": [
@@ -6940,7 +7086,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 788
+            "line": 785
           },
           "name": "resource",
           "type": {
@@ -6955,7 +7101,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 783
+            "line": 780
           },
           "name": "routeTableId",
           "overrides": "aws-cdk-lib.aws_ec2.IRouteTable",
@@ -6981,7 +7127,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 761
+        "line": 758
       },
       "name": "RouteTableProps",
       "properties": [
@@ -6994,7 +7140,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 765
+            "line": 762
           },
           "name": "vpc",
           "type": {
@@ -7011,7 +7157,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 772
+            "line": 769
           },
           "name": "routeTableName",
           "optional": true,
@@ -7037,7 +7183,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 572
+        "line": 569
       },
       "name": "RouteTargetProps",
       "properties": [
@@ -7052,7 +7198,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 587
+            "line": 584
           },
           "name": "endpoint",
           "optional": true,
@@ -7071,7 +7217,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 579
+            "line": 576
           },
           "name": "gateway",
           "optional": true,
@@ -7099,7 +7245,7 @@
         },
         "locationInModule": {
           "filename": "lib/route.ts",
-          "line": 610
+          "line": 607
         },
         "parameters": [
           {
@@ -7113,7 +7259,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 593
+        "line": 590
       },
       "name": "RouteTargetType",
       "properties": [
@@ -7127,7 +7273,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 608
+            "line": 605
           },
           "name": "endpoint",
           "optional": true,
@@ -7145,7 +7291,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 600
+            "line": 597
           },
           "name": "gateway",
           "optional": true,
@@ -7215,7 +7361,7 @@
         },
         "locationInModule": {
           "filename": "lib/subnet-v2.ts",
-          "line": 246
+          "line": 243
         },
         "parameters": [
           {
@@ -7253,7 +7399,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/subnet-v2.ts",
-        "line": 131
+        "line": 130
       },
       "methods": [
         {
@@ -7263,7 +7409,7 @@
           },
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 136
+            "line": 134
           },
           "name": "fromSubnetV2Attributes",
           "parameters": [
@@ -7300,7 +7446,7 @@
           },
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 333
+            "line": 330
           },
           "name": "associateNetworkAcl",
           "overrides": "aws-cdk-lib.aws_ec2.ISubnet",
@@ -7337,7 +7483,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 198
+            "line": 195
           },
           "name": "availabilityZone",
           "overrides": "aws-cdk-lib.aws_ec2.ISubnet",
@@ -7353,7 +7499,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 210
+            "line": 207
           },
           "name": "internetConnectivityEstablished",
           "overrides": "aws-cdk-lib.aws_ec2.ISubnet",
@@ -7369,7 +7515,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 223
+            "line": 220
           },
           "name": "ipv4CidrBlock",
           "overrides": "aws-cdk-lib.aws_ec2.ISubnet",
@@ -7385,7 +7531,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 355
+            "line": 352
           },
           "name": "networkAcl",
           "type": {
@@ -7400,7 +7546,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 347
+            "line": 344
           },
           "name": "routeTable",
           "overrides": "aws-cdk-lib.aws_ec2.ISubnet",
@@ -7419,7 +7565,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 204
+            "line": 201
           },
           "name": "subnetId",
           "overrides": "aws-cdk-lib.aws_ec2.ISubnet",
@@ -7435,7 +7581,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 228
+            "line": 225
           },
           "name": "ipv6CidrBlock",
           "optional": true,
@@ -7455,7 +7601,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 234
+            "line": 231
           },
           "name": "subnetType",
           "optional": true,
@@ -7482,7 +7628,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/subnet-v2.ts",
-        "line": 363
+        "line": 360
       },
       "name": "SubnetV2Attributes",
       "properties": [
@@ -7496,7 +7642,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 369
+            "line": 366
           },
           "name": "availabilityZone",
           "type": {
@@ -7513,7 +7659,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 376
+            "line": 373
           },
           "name": "ipv4CidrBlock",
           "type": {
@@ -7529,7 +7675,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 395
+            "line": 392
           },
           "name": "subnetId",
           "type": {
@@ -7545,7 +7691,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 400
+            "line": 397
           },
           "name": "subnetType",
           "type": {
@@ -7562,7 +7708,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 383
+            "line": 380
           },
           "name": "ipv6CidrBlock",
           "optional": true,
@@ -7580,7 +7726,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 390
+            "line": 387
           },
           "name": "routeTableId",
           "optional": true,
@@ -7598,7 +7744,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 407
+            "line": 404
           },
           "name": "subnetName",
           "optional": true,
@@ -7624,7 +7770,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/subnet-v2.ts",
-        "line": 43
+        "line": 42
       },
       "name": "SubnetV2Props",
       "properties": [
@@ -7637,7 +7783,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 65
+            "line": 64
           },
           "name": "availabilityZone",
           "type": {
@@ -7654,7 +7800,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 53
+            "line": 52
           },
           "name": "ipv4CidrBlock",
           "type": {
@@ -7671,7 +7817,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 82
+            "line": 81
           },
           "name": "subnetType",
           "type": {
@@ -7687,7 +7833,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 47
+            "line": 46
           },
           "name": "vpc",
           "type": {
@@ -7705,7 +7851,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 97
+            "line": 96
           },
           "name": "assignIpv6AddressOnCreation",
           "optional": true,
@@ -7723,7 +7869,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 60
+            "line": 59
           },
           "name": "ipv6CidrBlock",
           "optional": true,
@@ -7741,7 +7887,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 72
+            "line": 71
           },
           "name": "routeTable",
           "optional": true,
@@ -7759,7 +7905,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/subnet-v2.ts",
-            "line": 89
+            "line": 88
           },
           "name": "subnetName",
           "optional": true,
@@ -7776,7 +7922,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "Attributes for VPCCidrBlock used for defining a new CIDR Block and also for importing an existing CIDR.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as ec2_alpha from '@aws-cdk/aws-ec2-alpha';\nconst vPCCidrBlockattributes: ec2_alpha.VPCCidrBlockattributes = {\n  amazonProvidedIpv6CidrBlock: false,\n  cidrBlock: 'cidrBlock',\n  cidrBlockName: 'cidrBlockName',\n  ipv4IpamPoolId: 'ipv4IpamPoolId',\n  ipv4IpamProvisionedCidrs: ['ipv4IpamProvisionedCidrs'],\n  ipv4NetmaskLength: 123,\n  ipv6IpamPoolId: 'ipv6IpamPoolId',\n  ipv6NetmaskLength: 123,\n};",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as ec2_alpha from '@aws-cdk/aws-ec2-alpha';\nconst vPCCidrBlockattributes: ec2_alpha.VPCCidrBlockattributes = {\n  amazonProvidedIpv6CidrBlock: false,\n  cidrBlock: 'cidrBlock',\n  cidrBlockName: 'cidrBlockName',\n  ipv4IpamPoolId: 'ipv4IpamPoolId',\n  ipv4IpamProvisionedCidrs: ['ipv4IpamProvisionedCidrs'],\n  ipv4NetmaskLength: 123,\n  ipv6CidrBlock: 'ipv6CidrBlock',\n  ipv6IpamPoolId: 'ipv6IpamPoolId',\n  ipv6NetmaskLength: 123,\n  ipv6Pool: 'ipv6Pool',\n};",
         "custom": {
           "exampleMetadata": "fixture=_generated"
         }
@@ -7785,7 +7931,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 667
+        "line": 731
       },
       "name": "VPCCidrBlockattributes",
       "properties": [
@@ -7799,7 +7945,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 673
+            "line": 737
           },
           "name": "amazonProvidedIpv6CidrBlock",
           "optional": true,
@@ -7817,7 +7963,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 680
+            "line": 744
           },
           "name": "cidrBlock",
           "optional": true,
@@ -7835,7 +7981,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 687
+            "line": 751
           },
           "name": "cidrBlockName",
           "optional": true,
@@ -7853,7 +7999,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 715
+            "line": 779
           },
           "name": "ipv4IpamPoolId",
           "optional": true,
@@ -7871,7 +8017,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 723
+            "line": 787
           },
           "name": "ipv4IpamProvisionedCidrs",
           "optional": true,
@@ -7894,7 +8040,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 701
+            "line": 765
           },
           "name": "ipv4NetmaskLength",
           "optional": true,
@@ -7902,6 +8048,24 @@
             "primitive": "number"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No IPv6 CIDR block associated with VPC.",
+            "stability": "experimental",
+            "summary": "The IPv6 CIDR block from the specified IPv6 address pool."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 794
+          },
+          "name": "ipv6CidrBlock",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -7912,7 +8076,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 708
+            "line": 772
           },
           "name": "ipv6IpamPoolId",
           "optional": true,
@@ -7930,13 +8094,32 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 694
+            "line": 758
           },
           "name": "ipv6NetmaskLength",
           "optional": true,
           "type": {
             "primitive": "number"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- No BYOIP pool associated with VPC.",
+            "remarks": "Note: BYOIP Pool ID is different than IPAM Pool ID.",
+            "stability": "experimental",
+            "summary": "The ID of the IPv6 address pool from which to allocate the IPv6 CIDR block."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 802
+          },
+          "name": "ipv6Pool",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/vpc-v2:VPCCidrBlockattributes"
@@ -7960,7 +8143,7 @@
         },
         "locationInModule": {
           "filename": "lib/route.ts",
-          "line": 490
+          "line": 488
         },
         "parameters": [
           {
@@ -7989,7 +8172,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/route.ts",
-        "line": 473
+        "line": 472
       },
       "name": "VPCPeeringConnection",
       "properties": [
@@ -8001,7 +8184,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 488
+            "line": 486
           },
           "name": "resource",
           "type": {
@@ -8016,7 +8199,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 483
+            "line": 481
           },
           "name": "routerTargetId",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteTarget",
@@ -8032,7 +8215,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/route.ts",
-            "line": 478
+            "line": 476
           },
           "name": "routerType",
           "overrides": "@aws-cdk/aws-ec2-alpha.IRouteTarget",
@@ -8420,7 +8603,7 @@
       "docs": {
         "stability": "experimental",
         "summary": "Consolidated return parameters to pass to VPC construct.",
-        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as ec2_alpha from '@aws-cdk/aws-ec2-alpha';\nimport * as cdk from 'aws-cdk-lib';\n\ndeclare const cfnResource: cdk.CfnResource;\ndeclare const ipamPool: ec2_alpha.IIpamPool;\nconst vpcCidrOptions: ec2_alpha.VpcCidrOptions = {\n  amazonProvided: false,\n  cidrBlockName: 'cidrBlockName',\n  dependencies: [cfnResource],\n  ipv4CidrBlock: 'ipv4CidrBlock',\n  ipv4IpamPool: ipamPool,\n  ipv4IpamProvisionedCidrs: ['ipv4IpamProvisionedCidrs'],\n  ipv4NetmaskLength: 123,\n  ipv6IpamPool: ipamPool,\n  ipv6NetmaskLength: 123,\n};",
+        "example": "// The code below shows an example of how to instantiate this type.\n// The values are placeholders you should change.\nimport * as ec2_alpha from '@aws-cdk/aws-ec2-alpha';\nimport * as cdk from 'aws-cdk-lib';\n\ndeclare const cfnResource: cdk.CfnResource;\ndeclare const ipamPool: ec2_alpha.IIpamPool;\nconst vpcCidrOptions: ec2_alpha.VpcCidrOptions = {\n  amazonProvided: false,\n  cidrBlockName: 'cidrBlockName',\n  dependencies: [cfnResource],\n  ipv4CidrBlock: 'ipv4CidrBlock',\n  ipv4IpamPool: ipamPool,\n  ipv4IpamProvisionedCidrs: ['ipv4IpamProvisionedCidrs'],\n  ipv4NetmaskLength: 123,\n  ipv6CidrBlock: 'ipv6CidrBlock',\n  ipv6IpamPool: ipamPool,\n  ipv6NetmaskLength: 123,\n  ipv6PoolId: 'ipv6PoolId',\n};",
         "custom": {
           "exampleMetadata": "fixture=_generated"
         }
@@ -8429,7 +8612,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 57
+        "line": 84
       },
       "name": "VpcCidrOptions",
       "properties": [
@@ -8443,7 +8626,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 100
+            "line": 127
           },
           "name": "amazonProvided",
           "optional": true,
@@ -8461,7 +8644,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 115
+            "line": 142
           },
           "name": "cidrBlockName",
           "optional": true,
@@ -8479,7 +8662,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 107
+            "line": 134
           },
           "name": "dependencies",
           "optional": true,
@@ -8502,7 +8685,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 64
+            "line": 91
           },
           "name": "ipv4CidrBlock",
           "optional": true,
@@ -8520,7 +8703,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 78
+            "line": 105
           },
           "name": "ipv4IpamPool",
           "optional": true,
@@ -8538,7 +8721,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 123
+            "line": 150
           },
           "name": "ipv4IpamProvisionedCidrs",
           "optional": true,
@@ -8561,7 +8744,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 71
+            "line": 98
           },
           "name": "ipv4NetmaskLength",
           "optional": true,
@@ -8569,6 +8752,24 @@
             "primitive": "number"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- None",
+            "stability": "experimental",
+            "summary": "IPv6 CIDR block from the BOYIP IPv6 address pool."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 157
+          },
+          "name": "ipv6CidrBlock",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -8579,7 +8780,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 93
+            "line": 120
           },
           "name": "ipv6IpamPool",
           "optional": true,
@@ -8597,13 +8798,31 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 85
+            "line": 112
           },
           "name": "ipv6NetmaskLength",
           "optional": true,
           "type": {
             "primitive": "number"
           }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- None",
+            "stability": "experimental",
+            "summary": "ID of the BYOIP IPv6 address pool from which to allocate the IPv6 CIDR block."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "lib/vpc-v2.ts",
+            "line": 164
+          },
+          "name": "ipv6PoolId",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
         }
       ],
       "symbolId": "lib/vpc-v2:VpcCidrOptions"
@@ -8628,7 +8847,7 @@
         },
         "locationInModule": {
           "filename": "lib/vpc-v2.ts",
-          "line": 454
+          "line": 493
         },
         "parameters": [
           {
@@ -8655,7 +8874,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 266
+        "line": 307
       },
       "methods": [
         {
@@ -8665,7 +8884,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 271
+            "line": 311
           },
           "name": "fromVpcV2Attributes",
           "parameters": [
@@ -8706,7 +8925,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 388
+            "line": 427
           },
           "name": "dnsHostnamesEnabled",
           "type": {
@@ -8721,7 +8940,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 393
+            "line": 432
           },
           "name": "dnsSupportEnabled",
           "type": {
@@ -8736,7 +8955,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 413
+            "line": 452
           },
           "name": "internetConnectivityEstablished",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8752,7 +8971,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 378
+            "line": 417
           },
           "name": "ipAddresses",
           "type": {
@@ -8768,7 +8987,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 452
+            "line": 491
           },
           "name": "ipv4CidrBlock",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8785,7 +9004,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 373
+            "line": 412
           },
           "name": "ipv6CidrBlocks",
           "type": {
@@ -8805,7 +9024,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 398
+            "line": 437
           },
           "name": "isolatedSubnets",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8826,7 +9045,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 435
+            "line": 474
           },
           "name": "ownerAccountId",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8842,7 +9061,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 408
+            "line": 447
           },
           "name": "privateSubnets",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8863,7 +9082,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 403
+            "line": 442
           },
           "name": "publicSubnets",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8884,7 +9103,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 430
+            "line": 469
           },
           "name": "region",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8900,7 +9119,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 383
+            "line": 422
           },
           "name": "resource",
           "type": {
@@ -8916,7 +9135,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 444
+            "line": 483
           },
           "name": "useIpv6",
           "type": {
@@ -8934,7 +9153,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 362
+            "line": 401
           },
           "name": "vpcArn",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8953,7 +9172,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 367
+            "line": 406
           },
           "name": "vpcCidrBlock",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8969,7 +9188,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 357
+            "line": 396
           },
           "name": "vpcId",
           "overrides": "@aws-cdk/aws-ec2-alpha.VpcV2Base",
@@ -8985,7 +9204,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 425
+            "line": 464
           },
           "name": "ipv4IpamProvisionedCidrs",
           "optional": true,
@@ -9007,7 +9226,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 418
+            "line": 457
           },
           "name": "secondaryCidrBlock",
           "optional": true,
@@ -9032,7 +9251,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 450
+            "line": 489
           },
           "name": "vpcName",
           "optional": true,
@@ -9059,7 +9278,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 203
+        "line": 244
       },
       "name": "VpcV2Attributes",
       "properties": [
@@ -9072,7 +9291,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 235
+            "line": 276
           },
           "name": "vpcCidrBlock",
           "type": {
@@ -9088,7 +9307,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 209
+            "line": 250
           },
           "name": "vpcId",
           "type": {
@@ -9105,7 +9324,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 229
+            "line": 270
           },
           "name": "ownerAccountId",
           "optional": true,
@@ -9123,7 +9342,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 219
+            "line": 260
           },
           "name": "region",
           "optional": true,
@@ -9141,7 +9360,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 256
+            "line": 297
           },
           "name": "secondaryCidrBlocks",
           "optional": true,
@@ -9164,7 +9383,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 249
+            "line": 290
           },
           "name": "subnets",
           "optional": true,
@@ -9187,7 +9406,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 242
+            "line": 283
           },
           "name": "vpnGatewayId",
           "optional": true,
@@ -9254,7 +9473,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 390
+            "line": 389
           },
           "name": "addClientVpnEndpoint",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9286,7 +9505,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 423
+            "line": 422
           },
           "name": "addEgressOnlyInternetGateway",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9307,7 +9526,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 531
+            "line": 530
           },
           "name": "addFlowLog",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9339,7 +9558,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 410
+            "line": 409
           },
           "name": "addGatewayEndpoint",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9370,7 +9589,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 400
+            "line": 399
           },
           "name": "addInterfaceEndpoint",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9402,7 +9621,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 467
+            "line": 466
           },
           "name": "addInternetGateway",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9423,7 +9642,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 518
+            "line": 517
           },
           "name": "addNatGateway",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9448,7 +9667,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 380
+            "line": 379
           },
           "name": "addVpnConnection",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9479,7 +9698,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 541
+            "line": 540
           },
           "name": "createAcceptorVpcRole",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9504,7 +9723,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 571
+            "line": 570
           },
           "name": "createPeeringConnection",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9536,7 +9755,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 322
+            "line": 321
           },
           "name": "enableVpnGateway",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9556,7 +9775,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 360
+            "line": 359
           },
           "name": "enableVpnGatewayV2",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9581,7 +9800,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 595
+            "line": 594
           },
           "name": "selectSubnetObjects",
           "parameters": [
@@ -9613,7 +9832,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 304
+            "line": 303
           },
           "name": "selectSubnets",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9643,7 +9862,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 231
+            "line": 230
           },
           "name": "availabilityZones",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9665,7 +9884,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 236
+            "line": 235
           },
           "name": "internetConnectivityEstablished",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9683,7 +9902,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 257
+            "line": 256
           },
           "name": "ipv4CidrBlock",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9700,7 +9919,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 226
+            "line": 225
           },
           "name": "isolatedSubnets",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9722,7 +9941,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 272
+            "line": 271
           },
           "name": "ownerAccountId",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9738,7 +9957,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 221
+            "line": 220
           },
           "name": "privateSubnets",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9759,7 +9978,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 216
+            "line": 215
           },
           "name": "publicSubnets",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9781,7 +10000,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 267
+            "line": 266
           },
           "name": "region",
           "overrides": "@aws-cdk/aws-ec2-alpha.IVpcV2",
@@ -9798,7 +10017,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 206
+            "line": 205
           },
           "name": "vpcArn",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9815,7 +10034,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 211
+            "line": 210
           },
           "name": "vpcCidrBlock",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9832,7 +10051,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 201
+            "line": 200
           },
           "name": "vpcId",
           "overrides": "aws-cdk-lib.aws_ec2.IVpc",
@@ -9848,7 +10067,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 588
+            "line": 587
           },
           "name": "internetGatewayId",
           "optional": true,
@@ -9865,7 +10084,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 279
+            "line": 278
           },
           "name": "ipv4IpamProvisionedCidrs",
           "optional": true,
@@ -9888,7 +10107,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 249
+            "line": 248
           },
           "name": "secondaryCidrBlock",
           "optional": true,
@@ -9911,7 +10130,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 262
+            "line": 261
           },
           "name": "vpcName",
           "optional": true,
@@ -9928,7 +10147,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 581
+            "line": 580
           },
           "name": "vpnGatewayId",
           "optional": true,
@@ -9944,7 +10163,7 @@
           },
           "locationInModule": {
             "filename": "lib/vpc-v2-base.ts",
-            "line": 284
+            "line": 283
           },
           "name": "incompleteSubnetDefinition",
           "protected": true,
@@ -9970,7 +10189,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "lib/vpc-v2.ts",
-        "line": 148
+        "line": 189
       },
       "name": "VpcV2Props",
       "properties": [
@@ -9985,7 +10204,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 190
+            "line": 231
           },
           "name": "defaultInstanceTenancy",
           "optional": true,
@@ -10003,7 +10222,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 171
+            "line": 212
           },
           "name": "enableDnsHostnames",
           "optional": true,
@@ -10021,7 +10240,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 178
+            "line": 219
           },
           "name": "enableDnsSupport",
           "optional": true,
@@ -10040,7 +10259,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 155
+            "line": 196
           },
           "name": "primaryAddressBlock",
           "optional": true,
@@ -10060,7 +10279,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 164
+            "line": 205
           },
           "name": "secondaryAddressBlocks",
           "optional": true,
@@ -10083,7 +10302,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "lib/vpc-v2.ts",
-            "line": 197
+            "line": 238
           },
           "name": "vpcName",
           "optional": true,
@@ -10095,6 +10314,6 @@
       "symbolId": "lib/vpc-v2:VpcV2Props"
     }
   },
-  "version": "2.176.0-alpha.0",
+  "version": "2.177.0-alpha.0",
   "fingerprint": "**********"
 }