aws-cdk.aws-ec2-alpha 2.174.1a0__tar.gz → 2.175.0a0__tar.gz

{aws_cdk_aws_ec2_alpha-2.174.1a0/src/aws_cdk.aws_ec2_alpha.egg-info → aws_cdk_aws_ec2_alpha-2.175.0a0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-cdk.aws-ec2-alpha
-Version: 2.174.1a0
+Version: 2.175.0a0
 Summary: The CDK construct library for VPC V2
 Home-page: https://github.com/aws/aws-cdk
 Author: Amazon Web Services
@@ -23,7 +23,7 @@ Requires-Python: ~=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: aws-cdk-lib<3.0.0,>=2.174.1
+Requires-Dist: aws-cdk-lib<3.0.0,>=2.175.0
 Requires-Dist: constructs<11.0.0,>=10.0.0
 Requires-Dist: jsii<2.0.0,>=1.104.0
 Requires-Dist: publication>=0.0.3
@@ -655,3 +655,21 @@ SubnetV2.from_subnet_v2_attributes(self, "ImportedSubnet",
 ```
 
 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.
+
+### Tagging VPC and its components
+
+By 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');`.
+
+For example, if the `vpcName` is set to `TestVpc`, the following code will add a tag to the VPC with `key: Name` and `value: TestVpc`.
+
+```python
+vpc = VpcV2(self, "VPC-integ-test-tag",
+    primary_address_block=IpAddresses.ipv4("10.1.0.0/16"),
+    enable_dns_hostnames=True,
+    enable_dns_support=True,
+    vpc_name="CDKintegTestVPC"
+)
+
+# Add custom tags if needed
+Tags.of(vpc).add("Environment", "Production")
+```

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0}/README.md

@@ -624,3 +624,21 @@ SubnetV2.from_subnet_v2_attributes(self, "ImportedSubnet",
 ```
 
 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.
+
+### Tagging VPC and its components
+
+By 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');`.
+
+For example, if the `vpcName` is set to `TestVpc`, the following code will add a tag to the VPC with `key: Name` and `value: TestVpc`.
+
+```python
+vpc = VpcV2(self, "VPC-integ-test-tag",
+    primary_address_block=IpAddresses.ipv4("10.1.0.0/16"),
+    enable_dns_hostnames=True,
+    enable_dns_support=True,
+    vpc_name="CDKintegTestVPC"
+)
+
+# Add custom tags if needed
+Tags.of(vpc).add("Environment", "Production")
+```

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0}/setup.py

@@ -5,7 +5,7 @@ kwargs = json.loads(
     """
 {
     "name": "aws-cdk.aws-ec2-alpha",
-    "version": "2.174.1.a0",
+    "version": "2.175.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.174.1-alpha.0.jsii.tgz"
+            "aws-ec2-alpha@2.175.0-alpha.0.jsii.tgz"
         ],
         "aws_cdk.aws_ec2_alpha": [
             "py.typed"
@@ -34,7 +34,7 @@ kwargs = json.loads(
     },
     "python_requires": "~=3.8",
     "install_requires": [
-        "aws-cdk-lib>=2.174.1, <3.0.0",
+        "aws-cdk-lib>=2.175.0, <3.0.0",
         "constructs>=10.0.0, <11.0.0",
         "jsii>=1.104.0, <2.0.0",
         "publication>=0.0.3",

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0}/src/aws_cdk/aws_ec2_alpha/__init__.py

@@ -625,6 +625,24 @@ SubnetV2.from_subnet_v2_attributes(self, "ImportedSubnet",
 ```
 
 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.
+
+### Tagging VPC and its components
+
+By 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');`.
+
+For example, if the `vpcName` is set to `TestVpc`, the following code will add a tag to the VPC with `key: Name` and `value: TestVpc`.
+
+```python
+vpc = VpcV2(self, "VPC-integ-test-tag",
+    primary_address_block=IpAddresses.ipv4("10.1.0.0/16"),
+    enable_dns_hostnames=True,
+    enable_dns_support=True,
+    vpc_name="CDKintegTestVPC"
+)
+
+# Add custom tags if needed
+Tags.of(vpc).add("Environment", "Production")
+```
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -746,18 +764,24 @@ class AwsServiceName(enum.Enum):
 @jsii.data_type(
     jsii_type="@aws-cdk/aws-ec2-alpha.EgressOnlyInternetGatewayOptions",
     jsii_struct_bases=[],
-    name_mapping={"destination": "destination", "subnets": "subnets"},
+    name_mapping={
+        "destination": "destination",
+        "egress_only_internet_gateway_name": "egressOnlyInternetGatewayName",
+        "subnets": "subnets",
+    },
 )
 class EgressOnlyInternetGatewayOptions:
     def __init__(
         self,
         *,
         destination: typing.Optional[builtins.str] = None,
+        egress_only_internet_gateway_name: typing.Optional[builtins.str] = None,
         subnets: typing.Optional[typing.Sequence[typing.Union[_aws_cdk_aws_ec2_ceddda9d.SubnetSelection, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''(experimental) Options to define EgressOnlyInternetGateway for VPC.
 
         :param destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
+        :param egress_only_internet_gateway_name: (experimental) The resource name of the egress-only internet gateway. Provided name will be used for tagging Default: - no name tag associated and provisioned without a resource name
         :param subnets: (experimental) List of subnets where route to EGW will be added. Default: - no route created
 
         :stability: experimental
@@ -791,10 +815,13 @@ class EgressOnlyInternetGatewayOptions:
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__47cf639398ded64820e35dac43908a70a34ddc76a3ed35cc0c24357b0e01f48d)
             check_type(argname="argument destination", value=destination, expected_type=type_hints["destination"])
+            check_type(argname="argument egress_only_internet_gateway_name", value=egress_only_internet_gateway_name, expected_type=type_hints["egress_only_internet_gateway_name"])
             check_type(argname="argument subnets", value=subnets, expected_type=type_hints["subnets"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if destination is not None:
             self._values["destination"] = destination
+        if egress_only_internet_gateway_name is not None:
+            self._values["egress_only_internet_gateway_name"] = egress_only_internet_gateway_name
         if subnets is not None:
             self._values["subnets"] = subnets
 
@@ -809,6 +836,19 @@ class EgressOnlyInternetGatewayOptions:
         result = self._values.get("destination")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def egress_only_internet_gateway_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) The resource name of the egress-only internet gateway.
+
+        Provided name will be used for tagging
+
+        :default: - no name tag associated and provisioned without a resource name
+
+        :stability: experimental
+        '''
+        result = self._values.get("egress_only_internet_gateway_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def subnets(
         self,
@@ -1116,6 +1156,7 @@ class IIpamScopeBase(typing_extensions.Protocol):
         *,
         address_family: AddressFamily,
         aws_service: typing.Optional[AwsServiceName] = None,
+        ipam_pool_name: typing.Optional[builtins.str] = None,
         ipv4_provisioned_cidrs: typing.Optional[typing.Sequence[builtins.str]] = None,
         locale: typing.Optional[builtins.str] = None,
         public_ip_source: typing.Optional["IpamPoolPublicIpSource"] = None,
@@ -1125,6 +1166,7 @@ class IIpamScopeBase(typing_extensions.Protocol):
         :param id: -
         :param address_family: (experimental) addressFamily - The address family of the pool (ipv4 or ipv6).
         :param aws_service: (experimental) Limits which service in AWS that the pool can be used in. "ec2", for example, allows users to use space for Elastic IP addresses and VPCs. Default: - required in case of an IPv6, throws an error if not provided.
+        :param ipam_pool_name: (experimental) IPAM Pool resource name to be used for tagging. Default: - autogenerated by CDK if not provided
         :param ipv4_provisioned_cidrs: (experimental) Information about the CIDRs provisioned to the pool. Default: - No CIDRs are provisioned
         :param locale: (experimental) The locale (AWS Region) of the pool. Should be one of the IPAM operating region. Only resources in the same Region as the locale of the pool can get IP address allocations from the pool. You can only allocate a CIDR for a VPC, for example, from an IPAM pool that shares a locale with the VPC’s Region. Note that once you choose a Locale for a pool, you cannot modify it. If you choose an AWS Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error. Default: - Current operating region of IPAM
         :param public_ip_source: (experimental) The IP address source for pools in the public scope. Only used for IPv6 address Only allowed values to this are 'byoip' or 'amazon' Default: amazon
@@ -1176,6 +1218,7 @@ class _IIpamScopeBaseProxy:
         *,
         address_family: AddressFamily,
         aws_service: typing.Optional[AwsServiceName] = None,
+        ipam_pool_name: typing.Optional[builtins.str] = None,
         ipv4_provisioned_cidrs: typing.Optional[typing.Sequence[builtins.str]] = None,
         locale: typing.Optional[builtins.str] = None,
         public_ip_source: typing.Optional["IpamPoolPublicIpSource"] = None,
@@ -1185,6 +1228,7 @@ class _IIpamScopeBaseProxy:
         :param id: -
         :param address_family: (experimental) addressFamily - The address family of the pool (ipv4 or ipv6).
         :param aws_service: (experimental) Limits which service in AWS that the pool can be used in. "ec2", for example, allows users to use space for Elastic IP addresses and VPCs. Default: - required in case of an IPv6, throws an error if not provided.
+        :param ipam_pool_name: (experimental) IPAM Pool resource name to be used for tagging. Default: - autogenerated by CDK if not provided
         :param ipv4_provisioned_cidrs: (experimental) Information about the CIDRs provisioned to the pool. Default: - No CIDRs are provisioned
         :param locale: (experimental) The locale (AWS Region) of the pool. Should be one of the IPAM operating region. Only resources in the same Region as the locale of the pool can get IP address allocations from the pool. You can only allocate a CIDR for a VPC, for example, from an IPAM pool that shares a locale with the VPC’s Region. Note that once you choose a Locale for a pool, you cannot modify it. If you choose an AWS Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error. Default: - Current operating region of IPAM
         :param public_ip_source: (experimental) The IP address source for pools in the public scope. Only used for IPv6 address Only allowed values to this are 'byoip' or 'amazon' Default: amazon
@@ -1197,6 +1241,7 @@ class _IIpamScopeBaseProxy:
         options = PoolOptions(
             address_family=address_family,
             aws_service=aws_service,
+            ipam_pool_name=ipam_pool_name,
             ipv4_provisioned_cidrs=ipv4_provisioned_cidrs,
             locale=locale,
             public_ip_source=public_ip_source,
@@ -1568,11 +1613,22 @@ class IVpcV2(_aws_cdk_aws_ec2_ceddda9d.IVpc, typing_extensions.Protocol):
         '''
         ...
 
+    @builtins.property
+    @jsii.member(jsii_name="vpcName")
+    def vpc_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) VpcName to be used for tagging its components.
+
+        :stability: experimental
+        :attribute: true
+        '''
+        ...
+
     @jsii.member(jsii_name="addEgressOnlyInternetGateway")
     def add_egress_only_internet_gateway(
         self,
         *,
         destination: typing.Optional[builtins.str] = None,
+        egress_only_internet_gateway_name: typing.Optional[builtins.str] = None,
         subnets: typing.Optional[typing.Sequence[typing.Union[_aws_cdk_aws_ec2_ceddda9d.SubnetSelection, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''(experimental) Add an Egress only Internet Gateway to current VPC.
@@ -1581,6 +1637,7 @@ class IVpcV2(_aws_cdk_aws_ec2_ceddda9d.IVpc, typing_extensions.Protocol):
         For more information, see the {@link https://docs.aws.amazon.com/vpc/latest/userguide/egress-only-internet-gateway-basics.html}.
 
         :param destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
+        :param egress_only_internet_gateway_name: (experimental) The resource name of the egress-only internet gateway. Provided name will be used for tagging Default: - no name tag associated and provisioned without a resource name
         :param subnets: (experimental) List of subnets where route to EGW will be added. Default: - no route created
 
         :stability: experimental
@@ -1591,6 +1648,7 @@ class IVpcV2(_aws_cdk_aws_ec2_ceddda9d.IVpc, typing_extensions.Protocol):
     def add_internet_gateway(
         self,
         *,
+        internet_gateway_name: typing.Optional[builtins.str] = None,
         ipv4_destination: typing.Optional[builtins.str] = None,
         ipv6_destination: typing.Optional[builtins.str] = None,
     ) -> None:
@@ -1598,6 +1656,7 @@ class IVpcV2(_aws_cdk_aws_ec2_ceddda9d.IVpc, typing_extensions.Protocol):
 
         For more information, see the {@link https://docs.aws.amazon.com/vpc/latest/userguide/vpc-igw-internet-access.html}.
 
+        :param internet_gateway_name: (experimental) The resource name of the internet gateway. Provided name will be used for tagging Default: - provisioned without a resource name
         :param ipv4_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '0.0.0.0' all Ipv4 traffic
         :param ipv6_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
 
@@ -1769,11 +1828,22 @@ class _IVpcV2Proxy(
         '''
         return typing.cast(typing.Optional[typing.List[IVPCCidrBlock]], jsii.get(self, "secondaryCidrBlock"))
 
+    @builtins.property
+    @jsii.member(jsii_name="vpcName")
+    def vpc_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) VpcName to be used for tagging its components.
+
+        :stability: experimental
+        :attribute: true
+        '''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "vpcName"))
+
     @jsii.member(jsii_name="addEgressOnlyInternetGateway")
     def add_egress_only_internet_gateway(
         self,
         *,
         destination: typing.Optional[builtins.str] = None,
+        egress_only_internet_gateway_name: typing.Optional[builtins.str] = None,
         subnets: typing.Optional[typing.Sequence[typing.Union[_aws_cdk_aws_ec2_ceddda9d.SubnetSelection, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''(experimental) Add an Egress only Internet Gateway to current VPC.
@@ -1782,12 +1852,15 @@ class _IVpcV2Proxy(
         For more information, see the {@link https://docs.aws.amazon.com/vpc/latest/userguide/egress-only-internet-gateway-basics.html}.
 
         :param destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
+        :param egress_only_internet_gateway_name: (experimental) The resource name of the egress-only internet gateway. Provided name will be used for tagging Default: - no name tag associated and provisioned without a resource name
         :param subnets: (experimental) List of subnets where route to EGW will be added. Default: - no route created
 
         :stability: experimental
         '''
         options = EgressOnlyInternetGatewayOptions(
-            destination=destination, subnets=subnets
+            destination=destination,
+            egress_only_internet_gateway_name=egress_only_internet_gateway_name,
+            subnets=subnets,
         )
 
         return typing.cast(None, jsii.invoke(self, "addEgressOnlyInternetGateway", [options]))
@@ -1796,6 +1869,7 @@ class _IVpcV2Proxy(
     def add_internet_gateway(
         self,
         *,
+        internet_gateway_name: typing.Optional[builtins.str] = None,
         ipv4_destination: typing.Optional[builtins.str] = None,
         ipv6_destination: typing.Optional[builtins.str] = None,
     ) -> None:
@@ -1803,6 +1877,7 @@ class _IVpcV2Proxy(
 
         For more information, see the {@link https://docs.aws.amazon.com/vpc/latest/userguide/vpc-igw-internet-access.html}.
 
+        :param internet_gateway_name: (experimental) The resource name of the internet gateway. Provided name will be used for tagging Default: - provisioned without a resource name
         :param ipv4_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '0.0.0.0' all Ipv4 traffic
         :param ipv6_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
 
@@ -1811,7 +1886,9 @@ class _IVpcV2Proxy(
         :stability: experimental
         '''
         options = InternetGatewayOptions(
-            ipv4_destination=ipv4_destination, ipv6_destination=ipv6_destination
+            internet_gateway_name=internet_gateway_name,
+            ipv4_destination=ipv4_destination,
+            ipv6_destination=ipv6_destination,
         )
 
         return typing.cast(None, jsii.invoke(self, "addInternetGateway", [options]))
@@ -2050,6 +2127,7 @@ class InternetGateway(
     jsii_type="@aws-cdk/aws-ec2-alpha.InternetGatewayOptions",
     jsii_struct_bases=[],
     name_mapping={
+        "internet_gateway_name": "internetGatewayName",
         "ipv4_destination": "ipv4Destination",
         "ipv6_destination": "ipv6Destination",
     },
@@ -2058,11 +2136,13 @@ class InternetGatewayOptions:
     def __init__(
         self,
         *,
+        internet_gateway_name: typing.Optional[builtins.str] = None,
         ipv4_destination: typing.Optional[builtins.str] = None,
         ipv6_destination: typing.Optional[builtins.str] = None,
     ) -> None:
         '''(experimental) Options to define InternetGateway for VPC.
 
+        :param internet_gateway_name: (experimental) The resource name of the internet gateway. Provided name will be used for tagging Default: - provisioned without a resource name
         :param ipv4_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '0.0.0.0' all Ipv4 traffic
         :param ipv6_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
 
@@ -2087,14 +2167,30 @@ class InternetGatewayOptions:
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__1767be14586e30c26bcd910b9753aae1720568db2bf09fbf8dd100e10ab1fc09)
+            check_type(argname="argument internet_gateway_name", value=internet_gateway_name, expected_type=type_hints["internet_gateway_name"])
             check_type(argname="argument ipv4_destination", value=ipv4_destination, expected_type=type_hints["ipv4_destination"])
             check_type(argname="argument ipv6_destination", value=ipv6_destination, expected_type=type_hints["ipv6_destination"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if internet_gateway_name is not None:
+            self._values["internet_gateway_name"] = internet_gateway_name
         if ipv4_destination is not None:
             self._values["ipv4_destination"] = ipv4_destination
         if ipv6_destination is not None:
             self._values["ipv6_destination"] = ipv6_destination
 
+    @builtins.property
+    def internet_gateway_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) The resource name of the internet gateway.
+
+        Provided name will be used for tagging
+
+        :default: - provisioned without a resource name
+
+        :stability: experimental
+        '''
+        result = self._values.get("internet_gateway_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def ipv4_destination(self) -> typing.Optional[builtins.str]:
         '''(experimental) Destination Ipv6 address for EGW route.
@@ -2527,6 +2623,18 @@ class Ipam(
         '''
         return typing.cast(typing.List[IIpamScopeBase], jsii.get(self, "scopes"))
 
+    @builtins.property
+    @jsii.member(jsii_name="ipamName")
+    def ipam_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) IPAM name to be used for tagging.
+
+        :default: no tag specified
+
+        :stability: experimental
+        :attribute: IpamName
+        '''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "ipamName"))
+
 
 @jsii.data_type(
     jsii_type="@aws-cdk/aws-ec2-alpha.IpamOptions",
@@ -3129,6 +3237,16 @@ class NatGateway(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @builtins.property
+    @jsii.member(jsii_name="natGatewayId")
+    def nat_gateway_id(self) -> builtins.str:
+        '''(experimental) Id of the NatGateway.
+
+        :stability: experimental
+        :attribute: true
+        '''
+        return typing.cast(builtins.str, jsii.get(self, "natGatewayId"))
+
     @builtins.property
     @jsii.member(jsii_name="resource")
     def resource(self) -> _aws_cdk_aws_ec2_ceddda9d.CfnNatGateway:
@@ -3651,6 +3769,7 @@ class NatGatewayProps(NatGatewayOptions):
     name_mapping={
         "address_family": "addressFamily",
         "aws_service": "awsService",
+        "ipam_pool_name": "ipamPoolName",
         "ipv4_provisioned_cidrs": "ipv4ProvisionedCidrs",
         "locale": "locale",
         "public_ip_source": "publicIpSource",
@@ -3662,6 +3781,7 @@ class PoolOptions:
         *,
         address_family: AddressFamily,
         aws_service: typing.Optional[AwsServiceName] = None,
+        ipam_pool_name: typing.Optional[builtins.str] = None,
         ipv4_provisioned_cidrs: typing.Optional[typing.Sequence[builtins.str]] = None,
         locale: typing.Optional[builtins.str] = None,
         public_ip_source: typing.Optional[IpamPoolPublicIpSource] = None,
@@ -3670,6 +3790,7 @@ class PoolOptions:
 
         :param address_family: (experimental) addressFamily - The address family of the pool (ipv4 or ipv6).
         :param aws_service: (experimental) Limits which service in AWS that the pool can be used in. "ec2", for example, allows users to use space for Elastic IP addresses and VPCs. Default: - required in case of an IPv6, throws an error if not provided.
+        :param ipam_pool_name: (experimental) IPAM Pool resource name to be used for tagging. Default: - autogenerated by CDK if not provided
         :param ipv4_provisioned_cidrs: (experimental) Information about the CIDRs provisioned to the pool. Default: - No CIDRs are provisioned
         :param locale: (experimental) The locale (AWS Region) of the pool. Should be one of the IPAM operating region. Only resources in the same Region as the locale of the pool can get IP address allocations from the pool. You can only allocate a CIDR for a VPC, for example, from an IPAM pool that shares a locale with the VPC’s Region. Note that once you choose a Locale for a pool, you cannot modify it. If you choose an AWS Region for locale that has not been configured as an operating Region for the IPAM, you'll get an error. Default: - Current operating region of IPAM
         :param public_ip_source: (experimental) The IP address source for pools in the public scope. Only used for IPv6 address Only allowed values to this are 'byoip' or 'amazon' Default: amazon
@@ -3718,6 +3839,7 @@ class PoolOptions:
             type_hints = typing.get_type_hints(_typecheckingstub__60b5a95424fdb1e7fb6ae3da82efaf806f125de298a951d9b7f9b24181fd5c41)
             check_type(argname="argument address_family", value=address_family, expected_type=type_hints["address_family"])
             check_type(argname="argument aws_service", value=aws_service, expected_type=type_hints["aws_service"])
+            check_type(argname="argument ipam_pool_name", value=ipam_pool_name, expected_type=type_hints["ipam_pool_name"])
             check_type(argname="argument ipv4_provisioned_cidrs", value=ipv4_provisioned_cidrs, expected_type=type_hints["ipv4_provisioned_cidrs"])
             check_type(argname="argument locale", value=locale, expected_type=type_hints["locale"])
             check_type(argname="argument public_ip_source", value=public_ip_source, expected_type=type_hints["public_ip_source"])
@@ -3726,6 +3848,8 @@ class PoolOptions:
         }
         if aws_service is not None:
             self._values["aws_service"] = aws_service
+        if ipam_pool_name is not None:
+            self._values["ipam_pool_name"] = ipam_pool_name
         if ipv4_provisioned_cidrs is not None:
             self._values["ipv4_provisioned_cidrs"] = ipv4_provisioned_cidrs
         if locale is not None:
@@ -3757,6 +3881,17 @@ class PoolOptions:
         result = self._values.get("aws_service")
         return typing.cast(typing.Optional[AwsServiceName], result)
 
+    @builtins.property
+    def ipam_pool_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) IPAM Pool resource name to be used for tagging.
+
+        :default: - autogenerated by CDK if not provided
+
+        :stability: experimental
+        '''
+        result = self._values.get("ipam_pool_name")
+        return typing.cast(typing.Optional[builtins.str], result)
+
     @builtins.property
     def ipv4_provisioned_cidrs(self) -> typing.Optional[typing.List[builtins.str]]:
         '''(experimental) Information about the CIDRs provisioned to the pool.
@@ -4117,12 +4252,14 @@ class RouteTable(
         id: builtins.str,
         destination: builtins.str,
         target: "RouteTargetType",
+        route_name: typing.Optional[builtins.str] = None,
     ) -> None:
         '''(experimental) Adds a new custom route to the route table.
 
         :param id: -
         :param destination: The IPv4 or IPv6 CIDR block used for the destination match.
         :param target: The gateway or endpoint targeted by the route.
+        :param route_name: The resource name of the route.
 
         :stability: experimental
         '''
@@ -4131,7 +4268,8 @@ class RouteTable(
             check_type(argname="argument id", value=id, expected_type=type_hints["id"])
             check_type(argname="argument destination", value=destination, expected_type=type_hints["destination"])
             check_type(argname="argument target", value=target, expected_type=type_hints["target"])
-        return typing.cast(None, jsii.invoke(self, "addRoute", [id, destination, target]))
+            check_type(argname="argument route_name", value=route_name, expected_type=type_hints["route_name"])
+        return typing.cast(None, jsii.invoke(self, "addRoute", [id, destination, target, route_name]))
 
     @builtins.property
     @jsii.member(jsii_name="resource")
@@ -6428,11 +6566,13 @@ class VpcV2Base(
         self,
         *,
         destination: typing.Optional[builtins.str] = None,
+        egress_only_internet_gateway_name: typing.Optional[builtins.str] = None,
         subnets: typing.Optional[typing.Sequence[typing.Union[_aws_cdk_aws_ec2_ceddda9d.SubnetSelection, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''(experimental) Adds a new Egress Only Internet Gateway to this VPC and defines a new route to the route table of given subnets.
 
         :param destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
+        :param egress_only_internet_gateway_name: (experimental) The resource name of the egress-only internet gateway. Provided name will be used for tagging Default: - no name tag associated and provisioned without a resource name
         :param subnets: (experimental) List of subnets where route to EGW will be added. Default: - no route created
 
         :default: - in case of no input subnets, no route is created
@@ -6440,7 +6580,9 @@ class VpcV2Base(
         :stability: experimental
         '''
         options = EgressOnlyInternetGatewayOptions(
-            destination=destination, subnets=subnets
+            destination=destination,
+            egress_only_internet_gateway_name=egress_only_internet_gateway_name,
+            subnets=subnets,
         )
 
         return typing.cast(None, jsii.invoke(self, "addEgressOnlyInternetGateway", [options]))
@@ -6544,11 +6686,13 @@ class VpcV2Base(
     def add_internet_gateway(
         self,
         *,
+        internet_gateway_name: typing.Optional[builtins.str] = None,
         ipv4_destination: typing.Optional[builtins.str] = None,
         ipv6_destination: typing.Optional[builtins.str] = None,
     ) -> None:
         '''(experimental) Adds a new Internet Gateway to this VPC.
 
+        :param internet_gateway_name: (experimental) The resource name of the internet gateway. Provided name will be used for tagging Default: - provisioned without a resource name
         :param ipv4_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '0.0.0.0' all Ipv4 traffic
         :param ipv6_destination: (experimental) Destination Ipv6 address for EGW route. Default: - '::/0' all Ipv6 traffic
 
@@ -6557,7 +6701,9 @@ class VpcV2Base(
         :stability: experimental
         '''
         options = InternetGatewayOptions(
-            ipv4_destination=ipv4_destination, ipv6_destination=ipv6_destination
+            internet_gateway_name=internet_gateway_name,
+            ipv4_destination=ipv4_destination,
+            ipv6_destination=ipv6_destination,
         )
 
         return typing.cast(None, jsii.invoke(self, "addInternetGateway", [options]))
@@ -6940,6 +7086,16 @@ class VpcV2Base(
         '''
         ...
 
+    @builtins.property
+    @jsii.member(jsii_name="vpcName")
+    @abc.abstractmethod
+    def vpc_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) VpcName to be used for tagging its components.
+
+        :stability: experimental
+        '''
+        ...
+
     @builtins.property
     @jsii.member(jsii_name="vpnGatewayId")
     def vpn_gateway_id(self) -> typing.Optional[builtins.str]:
@@ -7064,6 +7220,15 @@ class _VpcV2BaseProxy(
         '''
         return typing.cast(typing.Optional[typing.List[IVPCCidrBlock]], jsii.get(self, "secondaryCidrBlock"))
 
+    @builtins.property
+    @jsii.member(jsii_name="vpcName")
+    def vpc_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) VpcName to be used for tagging its components.
+
+        :stability: experimental
+        '''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "vpcName"))
+
 # Adding a "__jsii_proxy_class__(): typing.Type" function to the abstract class
 typing.cast(typing.Any, VpcV2Base).__jsii_proxy_class__ = lambda : _VpcV2BaseProxy
 
@@ -7613,6 +7778,16 @@ class VpcV2(
         '''
         return typing.cast(typing.Optional[typing.List[IVPCCidrBlock]], jsii.get(self, "secondaryCidrBlock"))
 
+    @builtins.property
+    @jsii.member(jsii_name="vpcName")
+    def vpc_name(self) -> typing.Optional[builtins.str]:
+        '''(experimental) VpcName to be used for tagging its components.
+
+        :stability: experimental
+        :attribute: true
+        '''
+        return typing.cast(typing.Optional[builtins.str], jsii.get(self, "vpcName"))
+
 
 __all__ = [
     "AddressFamily",
@@ -7674,6 +7849,7 @@ publication.publish()
 def _typecheckingstub__47cf639398ded64820e35dac43908a70a34ddc76a3ed35cc0c24357b0e01f48d(
     *,
     destination: typing.Optional[builtins.str] = None,
+    egress_only_internet_gateway_name: typing.Optional[builtins.str] = None,
     subnets: typing.Optional[typing.Sequence[typing.Union[_aws_cdk_aws_ec2_ceddda9d.SubnetSelection, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -7701,6 +7877,7 @@ def _typecheckingstub__1ab59e34a032c2ecbc5b1f46184e5eafc041fe87fd1c685e9d6723df4
     *,
     address_family: AddressFamily,
     aws_service: typing.Optional[AwsServiceName] = None,
+    ipam_pool_name: typing.Optional[builtins.str] = None,
     ipv4_provisioned_cidrs: typing.Optional[typing.Sequence[builtins.str]] = None,
     locale: typing.Optional[builtins.str] = None,
     public_ip_source: typing.Optional[IpamPoolPublicIpSource] = None,
@@ -7736,6 +7913,7 @@ def _typecheckingstub__a1ed9b26ff938b529db1af6f12978e1aa57b9cdaf5a5c589675cf7b8f
 
 def _typecheckingstub__1767be14586e30c26bcd910b9753aae1720568db2bf09fbf8dd100e10ab1fc09(
     *,
+    internet_gateway_name: typing.Optional[builtins.str] = None,
     ipv4_destination: typing.Optional[builtins.str] = None,
     ipv6_destination: typing.Optional[builtins.str] = None,
 ) -> None:
@@ -7868,6 +8046,7 @@ def _typecheckingstub__60b5a95424fdb1e7fb6ae3da82efaf806f125de298a951d9b7f9b2418
     *,
     address_family: AddressFamily,
     aws_service: typing.Optional[AwsServiceName] = None,
+    ipam_pool_name: typing.Optional[builtins.str] = None,
     ipv4_provisioned_cidrs: typing.Optional[typing.Sequence[builtins.str]] = None,
     locale: typing.Optional[builtins.str] = None,
     public_ip_source: typing.Optional[IpamPoolPublicIpSource] = None,
@@ -7911,6 +8090,7 @@ def _typecheckingstub__920d6a12797cd2ad571157da68e37100c7d72b72ff09fd42451a65b73
     id: builtins.str,
     destination: builtins.str,
     target: RouteTargetType,
+    route_name: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0}/src/aws_cdk/aws_ec2_alpha/_jsii/__init__.py

@@ -33,9 +33,9 @@ import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
     "@aws-cdk/aws-ec2-alpha",
-    "2.174.1-alpha.0",
+    "2.175.0-alpha.0",
     __name__[0:-6],
-    "aws-ec2-alpha@2.174.1-alpha.0.jsii.tgz",
+    "aws-ec2-alpha@2.175.0-alpha.0.jsii.tgz",
 )
 
 __all__ = [

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0/src/aws_cdk.aws_ec2_alpha.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-cdk.aws-ec2-alpha
-Version: 2.174.1a0
+Version: 2.175.0a0
 Summary: The CDK construct library for VPC V2
 Home-page: https://github.com/aws/aws-cdk
 Author: Amazon Web Services
@@ -23,7 +23,7 @@ Requires-Python: ~=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: aws-cdk-lib<3.0.0,>=2.174.1
+Requires-Dist: aws-cdk-lib<3.0.0,>=2.175.0
 Requires-Dist: constructs<11.0.0,>=10.0.0
 Requires-Dist: jsii<2.0.0,>=1.104.0
 Requires-Dist: publication>=0.0.3
@@ -655,3 +655,21 @@ SubnetV2.from_subnet_v2_attributes(self, "ImportedSubnet",
 ```
 
 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.
+
+### Tagging VPC and its components
+
+By 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');`.
+
+For example, if the `vpcName` is set to `TestVpc`, the following code will add a tag to the VPC with `key: Name` and `value: TestVpc`.
+
+```python
+vpc = VpcV2(self, "VPC-integ-test-tag",
+    primary_address_block=IpAddresses.ipv4("10.1.0.0/16"),
+    enable_dns_hostnames=True,
+    enable_dns_support=True,
+    vpc_name="CDKintegTestVPC"
+)
+
+# Add custom tags if needed
+Tags.of(vpc).add("Environment", "Production")
+```

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0}/src/aws_cdk.aws_ec2_alpha.egg-info/SOURCES.txt

@@ -12,4 +12,4 @@ src/aws_cdk.aws_ec2_alpha.egg-info/top_level.txt
 src/aws_cdk/aws_ec2_alpha/__init__.py
 src/aws_cdk/aws_ec2_alpha/py.typed
 src/aws_cdk/aws_ec2_alpha/_jsii/__init__.py
-src/aws_cdk/aws_ec2_alpha/_jsii/aws-ec2-alpha@2.174.1-alpha.0.jsii.tgz
+src/aws_cdk/aws_ec2_alpha/_jsii/aws-ec2-alpha@2.175.0-alpha.0.jsii.tgz

{aws_cdk_aws_ec2_alpha-2.174.1a0 → aws_cdk_aws_ec2_alpha-2.175.0a0}/src/aws_cdk.aws_ec2_alpha.egg-info/requires.txt

@@ -1,4 +1,4 @@
-aws-cdk-lib<3.0.0,>=2.174.1
+aws-cdk-lib<3.0.0,>=2.175.0
 constructs<11.0.0,>=10.0.0
 jsii<2.0.0,>=1.104.0
 publication>=0.0.3