aws-cdk.aws-ec2-alpha 2.164.1a0__tar.gz → 2.165.0a0__tar.gz

{aws_cdk_aws_ec2_alpha-2.164.1a0/src/aws_cdk.aws_ec2_alpha.egg-info → aws_cdk_aws_ec2_alpha-2.165.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-cdk.aws-ec2-alpha
-Version: 2.164.1a0
+Version: 2.165.0a0
 Summary: The CDK construct library for VPC V2
 Home-page: https://github.com/aws/aws-cdk
 Author: Amazon Web Services
@@ -23,11 +23,11 @@ Requires-Python: ~=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: aws-cdk-lib<3.0.0,>=2.164.1
+Requires-Dist: aws-cdk-lib<3.0.0,>=2.165.0
 Requires-Dist: constructs<11.0.0,>=10.0.0
-Requires-Dist: jsii<2.0.0,>=1.103.1
+Requires-Dist: jsii<2.0.0,>=1.104.0
 Requires-Dist: publication>=0.0.3
-Requires-Dist: typeguard<5.0.0,>=2.13.3
+Requires-Dist: typeguard<4.3.0,>=2.13.3
 
 # Amazon VpcV2 Construct Library
 
@@ -65,8 +65,6 @@ VpcV2(self, "Vpc",
 
 `VpcV2` does not automatically create subnets or allocate IP addresses, which is different from the `Vpc` construct.
 
-Importing existing VPC in an account into CDK as a `VpcV2` is not yet supported.
-
 ## SubnetV2
 
 `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.
@@ -89,8 +87,6 @@ SubnetV2(self, "subnetA",
 )
 ```
 
-Same as `VpcV2`, importing existing subnets is not yet supported.
-
 ## IP Addresses Management
 
 By default `VpcV2` uses `10.0.0.0/16` as the primary CIDR if none is defined.
@@ -389,3 +385,124 @@ my_vpc.add_internet_gateway(
     ipv4_destination="192.168.0.0/16"
 )
 ```
+
+## Importing an existing VPC
+
+You can import an existing VPC and its subnets using the `VpcV2.fromVpcV2Attributes()` method or an individual subnet using `SubnetV2.fromSubnetV2Attributes()` method.
+
+### Importing a VPC
+
+To 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.
+
+If 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.
+
+Here's an example of importing a VPC with only the required parameters
+
+```python
+stack = Stack()
+
+imported_vpc = VpcV2.from_vpc_v2_attributes(stack, "ImportedVpc",
+    vpc_id="mockVpcID",
+    vpc_cidr_block="10.0.0.0/16"
+)
+```
+
+In 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.
+
+Below is an example of importing a cross region and cross acount VPC, VPC arn for this case would be 'arn:aws:ec2:us-west-2:123456789012:vpc/mockVpcID'
+
+```python
+stack = Stack()
+
+# Importing a cross acount or cross region VPC
+imported_vpc = VpcV2.from_vpc_v2_attributes(stack, "ImportedVpc",
+    vpc_id="mockVpcID",
+    vpc_cidr_block="10.0.0.0/16",
+    owner_account_id="123456789012",
+    region="us-west-2"
+)
+```
+
+Here's an example of how to import a VPC with multiple CIDR blocks, IPv6 support, and different subnet types:
+
+In this example, we're importing a VPC with:
+
+* A primary CIDR block (10.1.0.0/16)
+* One secondary IPv4 CIDR block (10.2.0.0/16)
+* Two secondary address using IPAM pool (IPv4 and IPv6)
+* VPC has Amazon-provided IPv6 CIDR enabled
+* An isolated subnet in us-west-2a
+* A public subnet in us-west-2b
+
+```python
+stack = Stack()
+
+imported_vpc = VpcV2.from_vpc_v2_attributes(self, "ImportedVPC",
+    vpc_id="vpc-XXX",
+    vpc_cidr_block="10.1.0.0/16",
+    secondary_cidr_blocks=[VPCCidrBlockattributes(
+        cidr_block="10.2.0.0/16",
+        cidr_block_name="ImportedBlock1"
+    ), VPCCidrBlockattributes(
+        ipv6_ipam_pool_id="ipam-pool-XXX",
+        ipv6_netmask_length=52,
+        cidr_block_name="ImportedIpamIpv6"
+    ), VPCCidrBlockattributes(
+        ipv4_ipam_pool_id="ipam-pool-XXX",
+        ipv4_ipam_provisioned_cidrs=["10.2.0.0/16"],
+        cidr_block_name="ImportedIpamIpv4"
+    ), VPCCidrBlockattributes(
+        amazon_provided_ipv6_cidr_block=True
+    )
+    ],
+    subnets=[SubnetV2Attributes(
+        subnet_name="IsolatedSubnet2",
+        subnet_id="subnet-03cd773c0fe08ed26",
+        subnet_type=SubnetType.PRIVATE_ISOLATED,
+        availability_zone="us-west-2a",
+        ipv4_cidr_block="10.2.0.0/24",
+        route_table_id="rtb-0871c310f98da2cbb"
+    ), SubnetV2Attributes(
+        subnet_id="subnet-0fa477e01db27d820",
+        subnet_type=SubnetType.PUBLIC,
+        availability_zone="us-west-2b",
+        ipv4_cidr_block="10.3.0.0/24",
+        route_table_id="rtb-014f3043098fe4b96"
+    )]
+)
+
+# You can now use the imported VPC in your stack
+
+# Adding a new subnet to the imported VPC
+imported_subnet = SubnetV2(self, "NewSubnet",
+    availability_zone="us-west-2a",
+    ipv4_cidr_block=IpCidr("10.2.2.0/24"),
+    vpc=imported_vpc,
+    subnet_type=SubnetType.PUBLIC
+)
+
+# Adding gateways to the imported VPC
+imported_vpc.add_internet_gateway()
+imported_vpc.add_nat_gateway(subnet=imported_subnet)
+imported_vpc.add_egress_only_internet_gateway()
+```
+
+You can add more subnets as needed by including additional entries in the `isolatedSubnets`, `publicSubnets`, or other subnet type arrays (e.g., `privateSubnets`).
+
+### Importing Subnets
+
+You 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.
+
+Here's an example of how to import a subnet:
+
+```python
+SubnetV2.from_subnet_v2_attributes(self, "ImportedSubnet",
+    subnet_id="subnet-0123456789abcdef0",
+    availability_zone="us-west-2a",
+    ipv4_cidr_block="10.2.0.0/24",
+    route_table_id="rtb-0871c310f98da2cbb",
+    subnet_type=SubnetType.PRIVATE_ISOLATED
+)
+```
+
+By 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.

{aws_cdk_aws_ec2_alpha-2.164.1a0 → aws_cdk_aws_ec2_alpha-2.165.0a0}/README.md

@@ -34,8 +34,6 @@ VpcV2(self, "Vpc",
 
 `VpcV2` does not automatically create subnets or allocate IP addresses, which is different from the `Vpc` construct.
 
-Importing existing VPC in an account into CDK as a `VpcV2` is not yet supported.
-
 ## SubnetV2
 
 `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.
@@ -58,8 +56,6 @@ SubnetV2(self, "subnetA",
 )
 ```
 
-Same as `VpcV2`, importing existing subnets is not yet supported.
-
 ## IP Addresses Management
 
 By default `VpcV2` uses `10.0.0.0/16` as the primary CIDR if none is defined.
@@ -358,3 +354,124 @@ my_vpc.add_internet_gateway(
     ipv4_destination="192.168.0.0/16"
 )
 ```
+
+## Importing an existing VPC
+
+You can import an existing VPC and its subnets using the `VpcV2.fromVpcV2Attributes()` method or an individual subnet using `SubnetV2.fromSubnetV2Attributes()` method.
+
+### Importing a VPC
+
+To 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.
+
+If 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.
+
+Here's an example of importing a VPC with only the required parameters
+
+```python
+stack = Stack()
+
+imported_vpc = VpcV2.from_vpc_v2_attributes(stack, "ImportedVpc",
+    vpc_id="mockVpcID",
+    vpc_cidr_block="10.0.0.0/16"
+)
+```
+
+In 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.
+
+Below is an example of importing a cross region and cross acount VPC, VPC arn for this case would be 'arn:aws:ec2:us-west-2:123456789012:vpc/mockVpcID'
+
+```python
+stack = Stack()
+
+# Importing a cross acount or cross region VPC
+imported_vpc = VpcV2.from_vpc_v2_attributes(stack, "ImportedVpc",
+    vpc_id="mockVpcID",
+    vpc_cidr_block="10.0.0.0/16",
+    owner_account_id="123456789012",
+    region="us-west-2"
+)
+```
+
+Here's an example of how to import a VPC with multiple CIDR blocks, IPv6 support, and different subnet types:
+
+In this example, we're importing a VPC with:
+
+* A primary CIDR block (10.1.0.0/16)
+* One secondary IPv4 CIDR block (10.2.0.0/16)
+* Two secondary address using IPAM pool (IPv4 and IPv6)
+* VPC has Amazon-provided IPv6 CIDR enabled
+* An isolated subnet in us-west-2a
+* A public subnet in us-west-2b
+
+```python
+stack = Stack()
+
+imported_vpc = VpcV2.from_vpc_v2_attributes(self, "ImportedVPC",
+    vpc_id="vpc-XXX",
+    vpc_cidr_block="10.1.0.0/16",
+    secondary_cidr_blocks=[VPCCidrBlockattributes(
+        cidr_block="10.2.0.0/16",
+        cidr_block_name="ImportedBlock1"
+    ), VPCCidrBlockattributes(
+        ipv6_ipam_pool_id="ipam-pool-XXX",
+        ipv6_netmask_length=52,
+        cidr_block_name="ImportedIpamIpv6"
+    ), VPCCidrBlockattributes(
+        ipv4_ipam_pool_id="ipam-pool-XXX",
+        ipv4_ipam_provisioned_cidrs=["10.2.0.0/16"],
+        cidr_block_name="ImportedIpamIpv4"
+    ), VPCCidrBlockattributes(
+        amazon_provided_ipv6_cidr_block=True
+    )
+    ],
+    subnets=[SubnetV2Attributes(
+        subnet_name="IsolatedSubnet2",
+        subnet_id="subnet-03cd773c0fe08ed26",
+        subnet_type=SubnetType.PRIVATE_ISOLATED,
+        availability_zone="us-west-2a",
+        ipv4_cidr_block="10.2.0.0/24",
+        route_table_id="rtb-0871c310f98da2cbb"
+    ), SubnetV2Attributes(
+        subnet_id="subnet-0fa477e01db27d820",
+        subnet_type=SubnetType.PUBLIC,
+        availability_zone="us-west-2b",
+        ipv4_cidr_block="10.3.0.0/24",
+        route_table_id="rtb-014f3043098fe4b96"
+    )]
+)
+
+# You can now use the imported VPC in your stack
+
+# Adding a new subnet to the imported VPC
+imported_subnet = SubnetV2(self, "NewSubnet",
+    availability_zone="us-west-2a",
+    ipv4_cidr_block=IpCidr("10.2.2.0/24"),
+    vpc=imported_vpc,
+    subnet_type=SubnetType.PUBLIC
+)
+
+# Adding gateways to the imported VPC
+imported_vpc.add_internet_gateway()
+imported_vpc.add_nat_gateway(subnet=imported_subnet)
+imported_vpc.add_egress_only_internet_gateway()
+```
+
+You can add more subnets as needed by including additional entries in the `isolatedSubnets`, `publicSubnets`, or other subnet type arrays (e.g., `privateSubnets`).
+
+### Importing Subnets
+
+You 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.
+
+Here's an example of how to import a subnet:
+
+```python
+SubnetV2.from_subnet_v2_attributes(self, "ImportedSubnet",
+    subnet_id="subnet-0123456789abcdef0",
+    availability_zone="us-west-2a",
+    ipv4_cidr_block="10.2.0.0/24",
+    route_table_id="rtb-0871c310f98da2cbb",
+    subnet_type=SubnetType.PRIVATE_ISOLATED
+)
+```
+
+By 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.

{aws_cdk_aws_ec2_alpha-2.164.1a0 → aws_cdk_aws_ec2_alpha-2.165.0a0}/setup.py

@@ -5,7 +5,7 @@ kwargs = json.loads(
     """
 {
     "name": "aws-cdk.aws-ec2-alpha",
-    "version": "2.164.1.a0",
+    "version": "2.165.0.a0",
     "description": "The CDK construct library for VPC V2",
     "license": "Apache-2.0",
     "url": "https://github.com/aws/aws-cdk",
@@ -26,7 +26,7 @@ kwargs = json.loads(
     ],
     "package_data": {
         "aws_cdk.aws_ec2_alpha._jsii": [
-            "aws-ec2-alpha@2.164.1-alpha.0.jsii.tgz"
+            "aws-ec2-alpha@2.165.0-alpha.0.jsii.tgz"
         ],
         "aws_cdk.aws_ec2_alpha": [
             "py.typed"
@@ -34,11 +34,11 @@ kwargs = json.loads(
     },
     "python_requires": "~=3.8",
     "install_requires": [
-        "aws-cdk-lib>=2.164.1, <3.0.0",
+        "aws-cdk-lib>=2.165.0, <3.0.0",
         "constructs>=10.0.0, <11.0.0",
-        "jsii>=1.103.1, <2.0.0",
+        "jsii>=1.104.0, <2.0.0",
         "publication>=0.0.3",
-        "typeguard>=2.13.3,<5.0.0"
+        "typeguard>=2.13.3,<4.3.0"
     ],
     "classifiers": [
         "Intended Audience :: Developers",