pulumi-alicloud-kotlin/com.pulumi.alicloud.vpc.kotlin/NatGatewayArgs

NatGatewayArgs

data class NatGatewayArgs(val accessMode: Output<NatGatewayAccessModeArgs>? = null, val deletionProtection: Output<Boolean>? = null, val description: Output<String>? = null, val dryRun: Output<Boolean>? = null, val eipBindMode: Output<String>? = null, val force: Output<Boolean>? = null, val icmpReplyEnabled: Output<Boolean>? = null, val instanceChargeType: Output<String>? = null, val internetChargeType: Output<String>? = null, val name: Output<String>? = null, val natGatewayName: Output<String>? = null, val natType: Output<String>? = null, val networkType: Output<String>? = null, val paymentType: Output<String>? = null, val period: Output<Int>? = null, val privateLinkEnabled: Output<Boolean>? = null, val specification: Output<String>? = null, val tags: Output<Map<String, String>>? = null, val vpcId: Output<String>? = null, val vswitchId: Output<String>? = null) : ConvertibleToJava<NatGatewayArgs>

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 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: When you create an enhanced NAT gateway for the first time, the system automatically creates the service-linked role AliyunServiceRoleForNatgw. Then, the system attaches the permission policy AliyunServiceRolePolicyForNatgw to the role. This allows the NAT gateway to access other resources on Alibaba Cloud. For more information, see Service-linked roles. NOTE: After you create an enhanced Internet NAT gateway, a route entry is automatically added to the route table of the VPC. The destination CIDR block of the route entry is 0.0.0.0/0 and the next hop is the NAT gateway. This ensures that traffic is routed to the NAT gateway. NOTE: Available since v1.37.0.

Example Usage

Basic usage

  • create enhanced nat gateway

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "tf_example";
const _default = alicloud.vpc.getEnhancedNatAvailableZones({});
const defaultNetwork = new alicloud.vpc.Network("default", {
    vpcName: name,
    cidrBlock: "10.0.0.0/8",
});
const defaultSwitch = new alicloud.vpc.Switch("default", {
    vswitchName: name,
    zoneId: _default.then(_default => _default.zones?.[0]?.zoneId),
    cidrBlock: "10.10.0.0/20",
    vpcId: defaultNetwork.id,
});
const defaultNatGateway = new alicloud.vpc.NatGateway("default", {
    vpcId: defaultNetwork.id,
    natGatewayName: name,
    paymentType: "PayAsYouGo",
    vswitchId: defaultSwitch.id,
    natType: "Enhanced",
});
Content copied to clipboard
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")
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var config = new Config();
    var name = config.Get("name") ?? "tf_example";
    var @default = AliCloud.Vpc.GetEnhancedNatAvailableZones.Invoke();
    var defaultNetwork = new AliCloud.Vpc.Network("default", new()
    {
        VpcName = name,
        CidrBlock = "10.0.0.0/8",
    });
    var defaultSwitch = new AliCloud.Vpc.Switch("default", new()
    {
        VswitchName = name,
        ZoneId = @default.Apply(@default => @default.Apply(getEnhancedNatAvailableZonesResult => getEnhancedNatAvailableZonesResult.Zones[0]?.ZoneId)),
        CidrBlock = "10.10.0.0/20",
        VpcId = defaultNetwork.Id,
    });
    var defaultNatGateway = new AliCloud.Vpc.NatGateway("default", new()
    {
        VpcId = defaultNetwork.Id,
        NatGatewayName = name,
        PaymentType = "PayAsYouGo",
        VswitchId = defaultSwitch.Id,
        NatType = "Enhanced",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "tf_example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		_default, err := vpc.GetEnhancedNatAvailableZones(ctx, &vpc.GetEnhancedNatAvailableZonesArgs{}, nil)
		if err != nil {
			return err
		}
		defaultNetwork, err := vpc.NewNetwork(ctx, "default", &vpc.NetworkArgs{
			VpcName:   pulumi.String(name),
			CidrBlock: pulumi.String("10.0.0.0/8"),
		})
		if err != nil {
			return err
		}
		defaultSwitch, err := vpc.NewSwitch(ctx, "default", &vpc.SwitchArgs{
			VswitchName: pulumi.String(name),
			ZoneId:      pulumi.String(_default.Zones[0].ZoneId),
			CidrBlock:   pulumi.String("10.10.0.0/20"),
			VpcId:       defaultNetwork.ID(),
		})
		if err != nil {
			return err
		}
		_, err = vpc.NewNatGateway(ctx, "default", &vpc.NatGatewayArgs{
			VpcId:          defaultNetwork.ID(),
			NatGatewayName: pulumi.String(name),
			PaymentType:    pulumi.String("PayAsYouGo"),
			VswitchId:      defaultSwitch.ID(),
			NatType:        pulumi.String("Enhanced"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.vpc.VpcFunctions;
import com.pulumi.alicloud.vpc.inputs.GetEnhancedNatAvailableZonesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.vpc.NatGateway;
import com.pulumi.alicloud.vpc.NatGatewayArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("tf_example");
        final var default = VpcFunctions.getEnhancedNatAvailableZones(GetEnhancedNatAvailableZonesArgs.builder()
            .build());
        var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()
            .vpcName(name)
            .cidrBlock("10.0.0.0/8")
            .build());
        var defaultSwitch = new Switch("defaultSwitch", SwitchArgs.builder()
            .vswitchName(name)
            .zoneId(default_.zones()[0].zoneId())
            .cidrBlock("10.10.0.0/20")
            .vpcId(defaultNetwork.id())
            .build());
        var defaultNatGateway = new NatGateway("defaultNatGateway", NatGatewayArgs.builder()
            .vpcId(defaultNetwork.id())
            .natGatewayName(name)
            .paymentType("PayAsYouGo")
            .vswitchId(defaultSwitch.id())
            .natType("Enhanced")
            .build());
    }
}
Content copied to clipboard
configuration:
  name:
    type: string
    default: tf_example
resources:
  defaultNetwork:
    type: alicloud:vpc:Network
    name: default
    properties:
      vpcName: ${name}
      cidrBlock: 10.0.0.0/8
  defaultSwitch:
    type: alicloud:vpc:Switch
    name: default
    properties:
      vswitchName: ${name}
      zoneId: ${default.zones[0].zoneId}
      cidrBlock: 10.10.0.0/20
      vpcId: ${defaultNetwork.id}
  defaultNatGateway:
    type: alicloud:vpc:NatGateway
    name: default
    properties:
      vpcId: ${defaultNetwork.id}
      natGatewayName: ${name}
      paymentType: PayAsYouGo
      vswitchId: ${defaultSwitch.id}
      natType: Enhanced
variables:
  default:
    fn::invoke:
      function: alicloud:vpc:getEnhancedNatAvailableZones
      arguments: {}
Content copied to clipboard

  • transform nat from Normal to Enhanced

NOTE: You must set nat_type to Enhanced and set vswitch_id.

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const config = new pulumi.Config();
const name = config.get("name") || "tf-example";
const _default = alicloud.vpc.getEnhancedNatAvailableZones({});
const defaultNetwork = new alicloud.vpc.Network("default", {
    vpcName: name,
    cidrBlock: "10.0.0.0/8",
});
const defaultSwitch = new alicloud.vpc.Switch("default", {
    vswitchName: name,
    zoneId: _default.then(_default => _default.zones?.[0]?.zoneId),
    cidrBlock: "10.10.0.0/20",
    vpcId: defaultNetwork.id,
});
const defaultNatGateway = new alicloud.vpc.NatGateway("default", {
    vpcId: defaultNetwork.id,
    natGatewayName: name,
    vswitchId: defaultSwitch.id,
    natType: "Enhanced",
});
Content copied to clipboard
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")
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var config = new Config();
    var name = config.Get("name") ?? "tf-example";
    var @default = AliCloud.Vpc.GetEnhancedNatAvailableZones.Invoke();
    var defaultNetwork = new AliCloud.Vpc.Network("default", new()
    {
        VpcName = name,
        CidrBlock = "10.0.0.0/8",
    });
    var defaultSwitch = new AliCloud.Vpc.Switch("default", new()
    {
        VswitchName = name,
        ZoneId = @default.Apply(@default => @default.Apply(getEnhancedNatAvailableZonesResult => getEnhancedNatAvailableZonesResult.Zones[0]?.ZoneId)),
        CidrBlock = "10.10.0.0/20",
        VpcId = defaultNetwork.Id,
    });
    var defaultNatGateway = new AliCloud.Vpc.NatGateway("default", new()
    {
        VpcId = defaultNetwork.Id,
        NatGatewayName = name,
        VswitchId = defaultSwitch.Id,
        NatType = "Enhanced",
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/vpc"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "tf-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		_default, err := vpc.GetEnhancedNatAvailableZones(ctx, &vpc.GetEnhancedNatAvailableZonesArgs{}, nil)
		if err != nil {
			return err
		}
		defaultNetwork, err := vpc.NewNetwork(ctx, "default", &vpc.NetworkArgs{
			VpcName:   pulumi.String(name),
			CidrBlock: pulumi.String("10.0.0.0/8"),
		})
		if err != nil {
			return err
		}
		defaultSwitch, err := vpc.NewSwitch(ctx, "default", &vpc.SwitchArgs{
			VswitchName: pulumi.String(name),
			ZoneId:      pulumi.String(_default.Zones[0].ZoneId),
			CidrBlock:   pulumi.String("10.10.0.0/20"),
			VpcId:       defaultNetwork.ID(),
		})
		if err != nil {
			return err
		}
		_, err = vpc.NewNatGateway(ctx, "default", &vpc.NatGatewayArgs{
			VpcId:          defaultNetwork.ID(),
			NatGatewayName: pulumi.String(name),
			VswitchId:      defaultSwitch.ID(),
			NatType:        pulumi.String("Enhanced"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.vpc.VpcFunctions;
import com.pulumi.alicloud.vpc.inputs.GetEnhancedNatAvailableZonesArgs;
import com.pulumi.alicloud.vpc.Network;
import com.pulumi.alicloud.vpc.NetworkArgs;
import com.pulumi.alicloud.vpc.Switch;
import com.pulumi.alicloud.vpc.SwitchArgs;
import com.pulumi.alicloud.vpc.NatGateway;
import com.pulumi.alicloud.vpc.NatGatewayArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("tf-example");
        final var default = VpcFunctions.getEnhancedNatAvailableZones(GetEnhancedNatAvailableZonesArgs.builder()
            .build());
        var defaultNetwork = new Network("defaultNetwork", NetworkArgs.builder()
            .vpcName(name)
            .cidrBlock("10.0.0.0/8")
            .build());
        var defaultSwitch = new Switch("defaultSwitch", SwitchArgs.builder()
            .vswitchName(name)
            .zoneId(default_.zones()[0].zoneId())
            .cidrBlock("10.10.0.0/20")
            .vpcId(defaultNetwork.id())
            .build());
        var defaultNatGateway = new NatGateway("defaultNatGateway", NatGatewayArgs.builder()
            .vpcId(defaultNetwork.id())
            .natGatewayName(name)
            .vswitchId(defaultSwitch.id())
            .natType("Enhanced")
            .build());
    }
}
Content copied to clipboard
configuration:
  name:
    type: string
    default: tf-example
resources:
  defaultNetwork:
    type: alicloud:vpc:Network
    name: default
    properties:
      vpcName: ${name}
      cidrBlock: 10.0.0.0/8
  defaultSwitch:
    type: alicloud:vpc:Switch
    name: default
    properties:
      vswitchName: ${name}
      zoneId: ${default.zones[0].zoneId}
      cidrBlock: 10.10.0.0/20
      vpcId: ${defaultNetwork.id}
  defaultNatGateway:
    type: alicloud:vpc:NatGateway
    name: default
    properties:
      vpcId: ${defaultNetwork.id}
      natGatewayName: ${name}
      vswitchId: ${defaultSwitch.id}
      natType: Enhanced
variables:
  default:
    fn::invoke:
      function: alicloud:vpc:getEnhancedNatAvailableZones
      arguments: {}
Content copied to clipboard

Import

Nat gateway can be imported using the id, e.g.

$ pulumi import alicloud:vpc/natGateway:NatGateway example <id>
Content copied to clipboard

Constructors

Link copied to clipboard
constructor(accessMode: Output<NatGatewayAccessModeArgs>? = null, deletionProtection: Output<Boolean>? = null, description: Output<String>? = null, dryRun: Output<Boolean>? = null, eipBindMode: Output<String>? = null, force: Output<Boolean>? = null, icmpReplyEnabled: Output<Boolean>? = null, instanceChargeType: Output<String>? = null, internetChargeType: Output<String>? = null, name: Output<String>? = null, natGatewayName: Output<String>? = null, natType: Output<String>? = null, networkType: Output<String>? = null, paymentType: Output<String>? = null, period: Output<Int>? = null, privateLinkEnabled: Output<Boolean>? = null, specification: Output<String>? = null, tags: Output<Map<String, String>>? = null, vpcId: Output<String>? = null, vswitchId: Output<String>? = null)

Properties

Link copied to clipboard
val accessMode: Output<NatGatewayAccessModeArgs>? = null

The access mode for reverse access to the VPC NAT gateway. See access_mode below.

Link copied to clipboard
val deletionProtection: Output<Boolean>? = null

Whether enable the deletion protection or not. Default value: false.

Link copied to clipboard
val description: Output<String>? = null

Description of the nat gateway, This description can have a string of 2 to 256 characters, It cannot begin with http:// or https://. Defaults to null.

Link copied to clipboard
val dryRun: Output<Boolean>? = null

Specifies whether to only precheck this request. Default value: false.

Link copied to clipboard
val eipBindMode: Output<String>? = null

The EIP binding mode of the NAT gateway. Default value: MULTI_BINDED. Valid values:

Link copied to clipboard
val force: Output<Boolean>? = null

Specifies whether to forcefully delete the NAT gateway.

Link copied to clipboard
val icmpReplyEnabled: Output<Boolean>? = null

Specifies whether to enable ICMP retrieval. Default value: true. Valid values:

Link copied to clipboard
val instanceChargeType: Output<String>? = null

Field instance_charge_type has been deprecated from provider version 1.121.0. New field payment_type instead.

Link copied to clipboard
val internetChargeType: Output<String>? = null

The internet charge type. Valid values PayByLcu. The PayByLcu is only support enhanced NAT. NOTE: From version 1.137.0, internet_charge_type cannot be set to PayBySpec.

Link copied to clipboard
val name: Output<String>? = null

Field name has been deprecated from provider version 1.121.0. New field nat_gateway_name instead.

Link copied to clipboard
val natGatewayName: Output<String>? = null

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.

Link copied to clipboard
val natType: Output<String>? = null

The type of NAT gateway. Valid values: Enhanced. NOTE: From version 1.137.0, nat_type cannot be set to Normal.

Link copied to clipboard
val networkType: Output<String>? = null

Indicates the type of the created NAT gateway. Valid values internet and intranet. internet: Internet NAT Gateway. intranet: VPC NAT Gateway.

Link copied to clipboard
val paymentType: Output<String>? = null

The billing method of the NAT gateway. Valid values are PayAsYouGo. Default to PayAsYouGo.

Link copied to clipboard
val period: Output<Int>? = null

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.

Link copied to clipboard
val privateLinkEnabled: Output<Boolean>? = null

Specifies whether to enable PrivateLink. Default value: false. Valid values:

Link copied to clipboard
val specification: Output<String>? = null

The specification of the nat gateway. Valid values are Small, Middle and Large. Effective when internet_charge_type is PayBySpec and network_type is internet. Details refer to Nat Gateway Specification.

Link copied to clipboard
val tags: Output<Map<String, String>>? = null

The tags of NAT gateway.

Link copied to clipboard
val vpcId: Output<String>? = null

The VPC ID.

Link copied to clipboard
val vswitchId: Output<String>? = null

The id of VSwitch.

Functions

Link copied to clipboard
open override fun toJava(): NatGatewayArgs