pulumi-alicloud 3.73.0a1736850863__py3-none-any.whl → 3.74.0__py3-none-any.whl

pulumi_alicloud/vpc/ipv4_cidr_block.py

@@ -19,77 +19,136 @@ __all__ = ['Ipv4CidrBlockArgs', 'Ipv4CidrBlock']
 @pulumi.input_type
 class Ipv4CidrBlockArgs:
     def __init__(__self__, *,
-                 secondary_cidr_block: pulumi.Input[str],
-                 vpc_id: pulumi.Input[str]):
+                 vpc_id: pulumi.Input[str],
+                 ipv4_ipam_pool_id: Optional[pulumi.Input[str]] = None,
+                 secondary_cidr_block: Optional[pulumi.Input[str]] = None,
+                 secondary_cidr_mask: Optional[pulumi.Input[int]] = None):
         """
         The set of arguments for constructing a Ipv4CidrBlock resource.
-        :param pulumi.Input[str] secondary_cidr_block: The IPv4 CIDR block. Take note of the following requirements:
-               * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-               * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-               * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-               * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
         :param pulumi.Input[str] vpc_id: The ID of the VPC.
+        :param pulumi.Input[str] ipv4_ipam_pool_id: The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        :param pulumi.Input[str] secondary_cidr_block: Additional network segment information.
+        :param pulumi.Input[int] secondary_cidr_mask: Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+               
+               > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
         """
-        pulumi.set(__self__, "secondary_cidr_block", secondary_cidr_block)
         pulumi.set(__self__, "vpc_id", vpc_id)
+        if ipv4_ipam_pool_id is not None:
+            pulumi.set(__self__, "ipv4_ipam_pool_id", ipv4_ipam_pool_id)
+        if secondary_cidr_block is not None:
+            pulumi.set(__self__, "secondary_cidr_block", secondary_cidr_block)
+        if secondary_cidr_mask is not None:
+            pulumi.set(__self__, "secondary_cidr_mask", secondary_cidr_mask)
+
+    @property
+    @pulumi.getter(name="vpcId")
+    def vpc_id(self) -> pulumi.Input[str]:
+        """
+        The ID of the VPC.
+        """
+        return pulumi.get(self, "vpc_id")
+
+    @vpc_id.setter
+    def vpc_id(self, value: pulumi.Input[str]):
+        pulumi.set(self, "vpc_id", value)
+
+    @property
+    @pulumi.getter(name="ipv4IpamPoolId")
+    def ipv4_ipam_pool_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        """
+        return pulumi.get(self, "ipv4_ipam_pool_id")
+
+    @ipv4_ipam_pool_id.setter
+    def ipv4_ipam_pool_id(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "ipv4_ipam_pool_id", value)
 
     @property
     @pulumi.getter(name="secondaryCidrBlock")
-    def secondary_cidr_block(self) -> pulumi.Input[str]:
+    def secondary_cidr_block(self) -> Optional[pulumi.Input[str]]:
         """
-        The IPv4 CIDR block. Take note of the following requirements:
-        * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-        * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-        * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-        * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
+        Additional network segment information.
         """
         return pulumi.get(self, "secondary_cidr_block")
 
     @secondary_cidr_block.setter
-    def secondary_cidr_block(self, value: pulumi.Input[str]):
+    def secondary_cidr_block(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "secondary_cidr_block", value)
 
     @property
-    @pulumi.getter(name="vpcId")
-    def vpc_id(self) -> pulumi.Input[str]:
+    @pulumi.getter(name="secondaryCidrMask")
+    def secondary_cidr_mask(self) -> Optional[pulumi.Input[int]]:
         """
-        The ID of the VPC.
+        Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+
+        > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
         """
-        return pulumi.get(self, "vpc_id")
+        return pulumi.get(self, "secondary_cidr_mask")
 
-    @vpc_id.setter
-    def vpc_id(self, value: pulumi.Input[str]):
-        pulumi.set(self, "vpc_id", value)
+    @secondary_cidr_mask.setter
+    def secondary_cidr_mask(self, value: Optional[pulumi.Input[int]]):
+        pulumi.set(self, "secondary_cidr_mask", value)
 
 
 @pulumi.input_type
 class _Ipv4CidrBlockState:
     def __init__(__self__, *,
+                 ipv4_ipam_pool_id: Optional[pulumi.Input[str]] = None,
+                 region_id: Optional[pulumi.Input[str]] = None,
                  secondary_cidr_block: Optional[pulumi.Input[str]] = None,
+                 secondary_cidr_mask: Optional[pulumi.Input[int]] = None,
                  vpc_id: Optional[pulumi.Input[str]] = None):
         """
         Input properties used for looking up and filtering Ipv4CidrBlock resources.
-        :param pulumi.Input[str] secondary_cidr_block: The IPv4 CIDR block. Take note of the following requirements:
-               * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-               * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-               * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-               * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
+        :param pulumi.Input[str] ipv4_ipam_pool_id: The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        :param pulumi.Input[str] region_id: The ID of the region where the VPC resides.
+        :param pulumi.Input[str] secondary_cidr_block: Additional network segment information.
+        :param pulumi.Input[int] secondary_cidr_mask: Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+               
+               > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
         :param pulumi.Input[str] vpc_id: The ID of the VPC.
         """
+        if ipv4_ipam_pool_id is not None:
+            pulumi.set(__self__, "ipv4_ipam_pool_id", ipv4_ipam_pool_id)
+        if region_id is not None:
+            pulumi.set(__self__, "region_id", region_id)
         if secondary_cidr_block is not None:
             pulumi.set(__self__, "secondary_cidr_block", secondary_cidr_block)
+        if secondary_cidr_mask is not None:
+            pulumi.set(__self__, "secondary_cidr_mask", secondary_cidr_mask)
         if vpc_id is not None:
             pulumi.set(__self__, "vpc_id", vpc_id)
 
+    @property
+    @pulumi.getter(name="ipv4IpamPoolId")
+    def ipv4_ipam_pool_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        """
+        return pulumi.get(self, "ipv4_ipam_pool_id")
+
+    @ipv4_ipam_pool_id.setter
+    def ipv4_ipam_pool_id(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "ipv4_ipam_pool_id", value)
+
+    @property
+    @pulumi.getter(name="regionId")
+    def region_id(self) -> Optional[pulumi.Input[str]]:
+        """
+        The ID of the region where the VPC resides.
+        """
+        return pulumi.get(self, "region_id")
+
+    @region_id.setter
+    def region_id(self, value: Optional[pulumi.Input[str]]):
+        pulumi.set(self, "region_id", value)
+
     @property
     @pulumi.getter(name="secondaryCidrBlock")
     def secondary_cidr_block(self) -> Optional[pulumi.Input[str]]:
         """
-        The IPv4 CIDR block. Take note of the following requirements:
-        * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-        * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-        * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-        * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
+        Additional network segment information.
         """
         return pulumi.get(self, "secondary_cidr_block")
 
@@ -97,6 +156,20 @@ class _Ipv4CidrBlockState:
     def secondary_cidr_block(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "secondary_cidr_block", value)
 
+    @property
+    @pulumi.getter(name="secondaryCidrMask")
+    def secondary_cidr_mask(self) -> Optional[pulumi.Input[int]]:
+        """
+        Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+
+        > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
+        """
+        return pulumi.get(self, "secondary_cidr_mask")
+
+    @secondary_cidr_mask.setter
+    def secondary_cidr_mask(self, value: Optional[pulumi.Input[int]]):
+        pulumi.set(self, "secondary_cidr_mask", value)
+
     @property
     @pulumi.getter(name="vpcId")
     def vpc_id(self) -> Optional[pulumi.Input[str]]:
@@ -115,11 +188,15 @@ class Ipv4CidrBlock(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
+                 ipv4_ipam_pool_id: Optional[pulumi.Input[str]] = None,
                  secondary_cidr_block: Optional[pulumi.Input[str]] = None,
+                 secondary_cidr_mask: Optional[pulumi.Input[int]] = None,
                  vpc_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        Provides a VPC Ipv4 Cidr Block resource. VPC IPv4 additional network segment.
+        Provides a VPC Ipv4 Cidr Block resource.
+
+        VPC IPv4 additional network segment.
 
         For information about VPC Ipv4 Cidr Block and how to use it, see [What is Ipv4 Cidr Block](https://www.alibabacloud.com/help/en/virtual-private-cloud/latest/associatevpccidrblock).
 
@@ -153,11 +230,11 @@ class Ipv4CidrBlock(pulumi.CustomResource):
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] secondary_cidr_block: The IPv4 CIDR block. Take note of the following requirements:
-               * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-               * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-               * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-               * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
+        :param pulumi.Input[str] ipv4_ipam_pool_id: The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        :param pulumi.Input[str] secondary_cidr_block: Additional network segment information.
+        :param pulumi.Input[int] secondary_cidr_mask: Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+               
+               > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
         :param pulumi.Input[str] vpc_id: The ID of the VPC.
         """
         ...
@@ -167,7 +244,9 @@ class Ipv4CidrBlock(pulumi.CustomResource):
                  args: Ipv4CidrBlockArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Provides a VPC Ipv4 Cidr Block resource. VPC IPv4 additional network segment.
+        Provides a VPC Ipv4 Cidr Block resource.
+
+        VPC IPv4 additional network segment.
 
         For information about VPC Ipv4 Cidr Block and how to use it, see [What is Ipv4 Cidr Block](https://www.alibabacloud.com/help/en/virtual-private-cloud/latest/associatevpccidrblock).
 
@@ -214,7 +293,9 @@ class Ipv4CidrBlock(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
+                 ipv4_ipam_pool_id: Optional[pulumi.Input[str]] = None,
                  secondary_cidr_block: Optional[pulumi.Input[str]] = None,
+                 secondary_cidr_mask: Optional[pulumi.Input[int]] = None,
                  vpc_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
@@ -225,12 +306,13 @@ class Ipv4CidrBlock(pulumi.CustomResource):
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
             __props__ = Ipv4CidrBlockArgs.__new__(Ipv4CidrBlockArgs)
 
-            if secondary_cidr_block is None and not opts.urn:
-                raise TypeError("Missing required property 'secondary_cidr_block'")
+            __props__.__dict__["ipv4_ipam_pool_id"] = ipv4_ipam_pool_id
             __props__.__dict__["secondary_cidr_block"] = secondary_cidr_block
+            __props__.__dict__["secondary_cidr_mask"] = secondary_cidr_mask
             if vpc_id is None and not opts.urn:
                 raise TypeError("Missing required property 'vpc_id'")
             __props__.__dict__["vpc_id"] = vpc_id
+            __props__.__dict__["region_id"] = None
         super(Ipv4CidrBlock, __self__).__init__(
             'alicloud:vpc/ipv4CidrBlock:Ipv4CidrBlock',
             resource_name,
@@ -241,7 +323,10 @@ class Ipv4CidrBlock(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
+            ipv4_ipam_pool_id: Optional[pulumi.Input[str]] = None,
+            region_id: Optional[pulumi.Input[str]] = None,
             secondary_cidr_block: Optional[pulumi.Input[str]] = None,
+            secondary_cidr_mask: Optional[pulumi.Input[int]] = None,
             vpc_id: Optional[pulumi.Input[str]] = None) -> 'Ipv4CidrBlock':
         """
         Get an existing Ipv4CidrBlock resource's state with the given name, id, and optional extra
@@ -250,33 +335,59 @@ class Ipv4CidrBlock(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[str] secondary_cidr_block: The IPv4 CIDR block. Take note of the following requirements:
-               * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-               * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-               * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-               * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
+        :param pulumi.Input[str] ipv4_ipam_pool_id: The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        :param pulumi.Input[str] region_id: The ID of the region where the VPC resides.
+        :param pulumi.Input[str] secondary_cidr_block: Additional network segment information.
+        :param pulumi.Input[int] secondary_cidr_mask: Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+               
+               > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
         :param pulumi.Input[str] vpc_id: The ID of the VPC.
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
         __props__ = _Ipv4CidrBlockState.__new__(_Ipv4CidrBlockState)
 
+        __props__.__dict__["ipv4_ipam_pool_id"] = ipv4_ipam_pool_id
+        __props__.__dict__["region_id"] = region_id
         __props__.__dict__["secondary_cidr_block"] = secondary_cidr_block
+        __props__.__dict__["secondary_cidr_mask"] = secondary_cidr_mask
         __props__.__dict__["vpc_id"] = vpc_id
         return Ipv4CidrBlock(resource_name, opts=opts, __props__=__props__)
 
+    @property
+    @pulumi.getter(name="ipv4IpamPoolId")
+    def ipv4_ipam_pool_id(self) -> pulumi.Output[Optional[str]]:
+        """
+        The ID of the IP Address Manager (IPAM) pool that contains IPv4 addresses.
+        """
+        return pulumi.get(self, "ipv4_ipam_pool_id")
+
+    @property
+    @pulumi.getter(name="regionId")
+    def region_id(self) -> pulumi.Output[str]:
+        """
+        The ID of the region where the VPC resides.
+        """
+        return pulumi.get(self, "region_id")
+
     @property
     @pulumi.getter(name="secondaryCidrBlock")
     def secondary_cidr_block(self) -> pulumi.Output[str]:
         """
-        The IPv4 CIDR block. Take note of the following requirements:
-        * You can specify one of the following standard IPv4 CIDR blocks or their subnets as the secondary IPv4 CIDR block: 192.168.0.0/16, 172.16.0.0/12, and 10.0.0.0/8.
-        * You can also use a custom CIDR block other than 100.64.0.0/10, 224.0.0.0/4, 127.0.0.0/8, 169.254.0.0/16, or their subnets as the secondary IPv4 CIDR block of the VPC.
-        * The CIDR block cannot start with 0. The subnet mask must be 8 to 28 bits in length.
-        * The secondary CIDR block cannot overlap with the primary CIDR block or an existing secondary CIDR block.
+        Additional network segment information.
         """
         return pulumi.get(self, "secondary_cidr_block")
 
+    @property
+    @pulumi.getter(name="secondaryCidrMask")
+    def secondary_cidr_mask(self) -> pulumi.Output[Optional[int]]:
+        """
+        Add an additional CIDR block from the IPAM address pool to the VPC by entering a mask.
+
+        > **NOTE:**  Specify the IPAM address pool to add an additional CIDR block to the VPC. Enter at least one of the SecondaryCidrBlock or SecondaryCidrMask parameters.
+        """
+        return pulumi.get(self, "secondary_cidr_mask")
+
     @property
     @pulumi.getter(name="vpcId")
     def vpc_id(self) -> pulumi.Output[str]:

pulumi_alicloud/vpc/nat_gateway.py

@@ -61,7 +61,7 @@ class NatGatewayArgs:
         :param pulumi.Input[str] nat_gateway_name: Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null.
         :param pulumi.Input[str] nat_type: The type of NAT gateway. Valid values: `Enhanced`. **NOTE:** From version 1.137.0, `nat_type` cannot be set to `Normal`.
         :param pulumi.Input[str] network_type: Indicates the type of the created NAT gateway. Valid values `internet` and `intranet`. `internet`: Internet NAT Gateway. `intranet`: VPC NAT Gateway.
-        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         :param pulumi.Input[int] period: The duration that you will buy the resource, in month. It is valid when `payment_type` is `Subscription`. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify "period" and you can do that via web console. **NOTE:** International station only supports `Subscription`.
                > **NOTE:** The attribute `period` is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running `pulumi up` will not effect the resource.
         :param pulumi.Input[bool] private_link_enabled: Specifies whether to enable PrivateLink. Default value: `false`. Valid values:
@@ -293,7 +293,7 @@ class NatGatewayArgs:
     @pulumi.getter(name="paymentType")
     def payment_type(self) -> Optional[pulumi.Input[str]]:
         """
-        The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         """
         return pulumi.get(self, "payment_type")
 
@@ -409,7 +409,7 @@ class _NatGatewayState:
         :param pulumi.Input[str] nat_gateway_name: Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null.
         :param pulumi.Input[str] nat_type: The type of NAT gateway. Valid values: `Enhanced`. **NOTE:** From version 1.137.0, `nat_type` cannot be set to `Normal`.
         :param pulumi.Input[str] network_type: Indicates the type of the created NAT gateway. Valid values `internet` and `intranet`. `internet`: Internet NAT Gateway. `intranet`: VPC NAT Gateway.
-        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         :param pulumi.Input[int] period: The duration that you will buy the resource, in month. It is valid when `payment_type` is `Subscription`. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify "period" and you can do that via web console. **NOTE:** International station only supports `Subscription`.
                > **NOTE:** The attribute `period` is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running `pulumi up` will not effect the resource.
         :param pulumi.Input[bool] private_link_enabled: Specifies whether to enable PrivateLink. Default value: `false`. Valid values:
@@ -651,7 +651,7 @@ class _NatGatewayState:
     @pulumi.getter(name="paymentType")
     def payment_type(self) -> Optional[pulumi.Input[str]]:
         """
-        The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         """
         return pulumi.get(self, "payment_type")
 
@@ -784,6 +784,75 @@ class NatGateway(pulumi.CustomResource):
                  vswitch_id: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
+        Provides a resource to create a VPC NAT Gateway.
+
+        > **NOTE:** Resource bandwidth packages will not be supported since 00:00 on November 4, 2017, and public IP can be replaced be elastic IPs.
+        If a Nat Gateway has already bought some bandwidth packages, it can not bind elastic IP and you have to submit the [work order](https://selfservice.console.aliyun.com/ticket/createIndex) to solve.
+        If you want to add public IP, you can use resource 'alicloud_eip_association' to bind several elastic IPs for one Nat Gateway.
+
+        > **NOTE:** From version 1.7.1, this resource has deprecated bandwidth packages.
+        But, in order to manage stock bandwidth packages, version 1.13.0 re-support configuring 'bandwidth_packages'.
+
+        > **NOTE:** Available since v1.37.0.
+
+        ## Example Usage
+
+        Basic usage
+
+        - create enhanced nat gateway
+
+        ```python
+        import pulumi
+        import pulumi_alicloud as alicloud
+
+        config = pulumi.Config()
+        name = config.get("name")
+        if name is None:
+            name = "tf_example"
+        default = alicloud.vpc.get_enhanced_nat_available_zones()
+        default_network = alicloud.vpc.Network("default",
+            vpc_name=name,
+            cidr_block="10.0.0.0/8")
+        default_switch = alicloud.vpc.Switch("default",
+            vswitch_name=name,
+            zone_id=default.zones[0].zone_id,
+            cidr_block="10.10.0.0/20",
+            vpc_id=default_network.id)
+        default_nat_gateway = alicloud.vpc.NatGateway("default",
+            vpc_id=default_network.id,
+            nat_gateway_name=name,
+            payment_type="PayAsYouGo",
+            vswitch_id=default_switch.id,
+            nat_type="Enhanced")
+        ```
+
+        - transform nat from Normal to Enhanced
+        > **NOTE:** You must set `nat_type` to `Enhanced` and set `vswitch_id`.
+
+        ```python
+        import pulumi
+        import pulumi_alicloud as alicloud
+
+        config = pulumi.Config()
+        name = config.get("name")
+        if name is None:
+            name = "tf-example"
+        default = alicloud.vpc.get_enhanced_nat_available_zones()
+        default_network = alicloud.vpc.Network("default",
+            vpc_name=name,
+            cidr_block="10.0.0.0/8")
+        default_switch = alicloud.vpc.Switch("default",
+            vswitch_name=name,
+            zone_id=default.zones[0].zone_id,
+            cidr_block="10.10.0.0/20",
+            vpc_id=default_network.id)
+        default_nat_gateway = alicloud.vpc.NatGateway("default",
+            vpc_id=default_network.id,
+            nat_gateway_name=name,
+            vswitch_id=default_switch.id,
+            nat_type="Enhanced")
+        ```
+
         ## Import
 
         Nat gateway can be imported using the id, e.g.
@@ -811,7 +880,7 @@ class NatGateway(pulumi.CustomResource):
         :param pulumi.Input[str] nat_gateway_name: Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null.
         :param pulumi.Input[str] nat_type: The type of NAT gateway. Valid values: `Enhanced`. **NOTE:** From version 1.137.0, `nat_type` cannot be set to `Normal`.
         :param pulumi.Input[str] network_type: Indicates the type of the created NAT gateway. Valid values `internet` and `intranet`. `internet`: Internet NAT Gateway. `intranet`: VPC NAT Gateway.
-        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         :param pulumi.Input[int] period: The duration that you will buy the resource, in month. It is valid when `payment_type` is `Subscription`. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify "period" and you can do that via web console. **NOTE:** International station only supports `Subscription`.
                > **NOTE:** The attribute `period` is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running `pulumi up` will not effect the resource.
         :param pulumi.Input[bool] private_link_enabled: Specifies whether to enable PrivateLink. Default value: `false`. Valid values:
@@ -827,6 +896,75 @@ class NatGateway(pulumi.CustomResource):
                  args: NatGatewayArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        Provides a resource to create a VPC NAT Gateway.
+
+        > **NOTE:** Resource bandwidth packages will not be supported since 00:00 on November 4, 2017, and public IP can be replaced be elastic IPs.
+        If a Nat Gateway has already bought some bandwidth packages, it can not bind elastic IP and you have to submit the [work order](https://selfservice.console.aliyun.com/ticket/createIndex) to solve.
+        If you want to add public IP, you can use resource 'alicloud_eip_association' to bind several elastic IPs for one Nat Gateway.
+
+        > **NOTE:** From version 1.7.1, this resource has deprecated bandwidth packages.
+        But, in order to manage stock bandwidth packages, version 1.13.0 re-support configuring 'bandwidth_packages'.
+
+        > **NOTE:** Available since v1.37.0.
+
+        ## Example Usage
+
+        Basic usage
+
+        - create enhanced nat gateway
+
+        ```python
+        import pulumi
+        import pulumi_alicloud as alicloud
+
+        config = pulumi.Config()
+        name = config.get("name")
+        if name is None:
+            name = "tf_example"
+        default = alicloud.vpc.get_enhanced_nat_available_zones()
+        default_network = alicloud.vpc.Network("default",
+            vpc_name=name,
+            cidr_block="10.0.0.0/8")
+        default_switch = alicloud.vpc.Switch("default",
+            vswitch_name=name,
+            zone_id=default.zones[0].zone_id,
+            cidr_block="10.10.0.0/20",
+            vpc_id=default_network.id)
+        default_nat_gateway = alicloud.vpc.NatGateway("default",
+            vpc_id=default_network.id,
+            nat_gateway_name=name,
+            payment_type="PayAsYouGo",
+            vswitch_id=default_switch.id,
+            nat_type="Enhanced")
+        ```
+
+        - transform nat from Normal to Enhanced
+        > **NOTE:** You must set `nat_type` to `Enhanced` and set `vswitch_id`.
+
+        ```python
+        import pulumi
+        import pulumi_alicloud as alicloud
+
+        config = pulumi.Config()
+        name = config.get("name")
+        if name is None:
+            name = "tf-example"
+        default = alicloud.vpc.get_enhanced_nat_available_zones()
+        default_network = alicloud.vpc.Network("default",
+            vpc_name=name,
+            cidr_block="10.0.0.0/8")
+        default_switch = alicloud.vpc.Switch("default",
+            vswitch_name=name,
+            zone_id=default.zones[0].zone_id,
+            cidr_block="10.10.0.0/20",
+            vpc_id=default_network.id)
+        default_nat_gateway = alicloud.vpc.NatGateway("default",
+            vpc_id=default_network.id,
+            nat_gateway_name=name,
+            vswitch_id=default_switch.id,
+            nat_type="Enhanced")
+        ```
+
         ## Import
 
         Nat gateway can be imported using the id, e.g.
@@ -962,7 +1100,7 @@ class NatGateway(pulumi.CustomResource):
         :param pulumi.Input[str] nat_gateway_name: Name of the nat gateway. The value can have a string of 2 to 128 characters, must contain only alphanumeric characters or hyphens, such as "-",".","_", and must not begin or end with a hyphen, and must not begin with http:// or https://. Defaults to null.
         :param pulumi.Input[str] nat_type: The type of NAT gateway. Valid values: `Enhanced`. **NOTE:** From version 1.137.0, `nat_type` cannot be set to `Normal`.
         :param pulumi.Input[str] network_type: Indicates the type of the created NAT gateway. Valid values `internet` and `intranet`. `internet`: Internet NAT Gateway. `intranet`: VPC NAT Gateway.
-        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        :param pulumi.Input[str] payment_type: The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         :param pulumi.Input[int] period: The duration that you will buy the resource, in month. It is valid when `payment_type` is `Subscription`. Valid values: [1-9, 12, 24, 36]. At present, the provider does not support modify "period" and you can do that via web console. **NOTE:** International station only supports `Subscription`.
                > **NOTE:** The attribute `period` is only used to create Subscription instance or modify the PayAsYouGo instance to Subscription. Once effect, it will not be modified that means running `pulumi up` will not effect the resource.
         :param pulumi.Input[bool] private_link_enabled: Specifies whether to enable PrivateLink. Default value: `false`. Valid values:
@@ -1124,7 +1262,7 @@ class NatGateway(pulumi.CustomResource):
     @pulumi.getter(name="paymentType")
     def payment_type(self) -> pulumi.Output[str]:
         """
-        The billing method of the NAT gateway. Valid values are `PayAsYouGo` and `Subscription`. Default to `PayAsYouGo`.
+        The billing method of the NAT gateway. Valid values are `PayAsYouGo`. Default to `PayAsYouGo`.
         """
         return pulumi.get(self, "payment_type")