1. Packages
  2. Ionoscloud Provider
  3. API Docs
  4. VpnIpsecGateway
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

ionoscloud.VpnIpsecGateway

Explore with Pulumi AI

ionoscloud logo
ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud

    An IPSec Gateway resource manages the creation, management, and deletion of VPN IPSec Gateways within the IONOS Cloud infrastructure. This resource facilitates the creation of VPN IPSec Gateways, enabling secure connections between your network resources.

    Usage example

    import * as pulumi from "@pulumi/pulumi";
    import * as ionoscloud from "@pulumi/ionoscloud";
    
    // Basic example
    const testDatacenter = new ionoscloud.Datacenter("testDatacenter", {location: "de/fra"});
    const testLan = new ionoscloud.Lan("testLan", {
        "public": false,
        datacenterId: testDatacenter.datacenterId,
    });
    const testIpblock = new ionoscloud.Ipblock("testIpblock", {
        location: "de/fra",
        size: 1,
    });
    const example = new ionoscloud.VpnIpsecGateway("example", {
        location: "de/fra",
        gatewayIp: testIpblock.ips[0],
        version: "IKEv2",
        description: "This gateway connects site A to VDC X.",
        connections: [{
            datacenterId: testDatacenter.datacenterId,
            lanId: testLan.lanId,
            ipv4Cidr: "192.168.100.10/24",
        }],
    });
    
    import pulumi
    import pulumi_ionoscloud as ionoscloud
    
    # Basic example
    test_datacenter = ionoscloud.Datacenter("testDatacenter", location="de/fra")
    test_lan = ionoscloud.Lan("testLan",
        public=False,
        datacenter_id=test_datacenter.datacenter_id)
    test_ipblock = ionoscloud.Ipblock("testIpblock",
        location="de/fra",
        size=1)
    example = ionoscloud.VpnIpsecGateway("example",
        location="de/fra",
        gateway_ip=test_ipblock.ips[0],
        version="IKEv2",
        description="This gateway connects site A to VDC X.",
        connections=[{
            "datacenter_id": test_datacenter.datacenter_id,
            "lan_id": test_lan.lan_id,
            "ipv4_cidr": "192.168.100.10/24",
        }])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ionoscloud/v6/ionoscloud"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		// Basic example
    		testDatacenter, err := ionoscloud.NewDatacenter(ctx, "testDatacenter", &ionoscloud.DatacenterArgs{
    			Location: pulumi.String("de/fra"),
    		})
    		if err != nil {
    			return err
    		}
    		testLan, err := ionoscloud.NewLan(ctx, "testLan", &ionoscloud.LanArgs{
    			Public:       pulumi.Bool(false),
    			DatacenterId: testDatacenter.DatacenterId,
    		})
    		if err != nil {
    			return err
    		}
    		testIpblock, err := ionoscloud.NewIpblock(ctx, "testIpblock", &ionoscloud.IpblockArgs{
    			Location: pulumi.String("de/fra"),
    			Size:     pulumi.Float64(1),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = ionoscloud.NewVpnIpsecGateway(ctx, "example", &ionoscloud.VpnIpsecGatewayArgs{
    			Location: pulumi.String("de/fra"),
    			GatewayIp: testIpblock.Ips.ApplyT(func(ips []string) (string, error) {
    				return ips[0], nil
    			}).(pulumi.StringOutput),
    			Version:     pulumi.String("IKEv2"),
    			Description: pulumi.String("This gateway connects site A to VDC X."),
    			Connections: ionoscloud.VpnIpsecGatewayConnectionArray{
    				&ionoscloud.VpnIpsecGatewayConnectionArgs{
    					DatacenterId: testDatacenter.DatacenterId,
    					LanId:        testLan.LanId,
    					Ipv4Cidr:     pulumi.String("192.168.100.10/24"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Ionoscloud = Pulumi.Ionoscloud;
    
    return await Deployment.RunAsync(() => 
    {
        // Basic example
        var testDatacenter = new Ionoscloud.Datacenter("testDatacenter", new()
        {
            Location = "de/fra",
        });
    
        var testLan = new Ionoscloud.Lan("testLan", new()
        {
            Public = false,
            DatacenterId = testDatacenter.DatacenterId,
        });
    
        var testIpblock = new Ionoscloud.Ipblock("testIpblock", new()
        {
            Location = "de/fra",
            Size = 1,
        });
    
        var example = new Ionoscloud.VpnIpsecGateway("example", new()
        {
            Location = "de/fra",
            GatewayIp = testIpblock.Ips.Apply(ips => ips[0]),
            Version = "IKEv2",
            Description = "This gateway connects site A to VDC X.",
            Connections = new[]
            {
                new Ionoscloud.Inputs.VpnIpsecGatewayConnectionArgs
                {
                    DatacenterId = testDatacenter.DatacenterId,
                    LanId = testLan.LanId,
                    Ipv4Cidr = "192.168.100.10/24",
                },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ionoscloud.Datacenter;
    import com.pulumi.ionoscloud.DatacenterArgs;
    import com.pulumi.ionoscloud.Lan;
    import com.pulumi.ionoscloud.LanArgs;
    import com.pulumi.ionoscloud.Ipblock;
    import com.pulumi.ionoscloud.IpblockArgs;
    import com.pulumi.ionoscloud.VpnIpsecGateway;
    import com.pulumi.ionoscloud.VpnIpsecGatewayArgs;
    import com.pulumi.ionoscloud.inputs.VpnIpsecGatewayConnectionArgs;
    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) {
            // Basic example
            var testDatacenter = new Datacenter("testDatacenter", DatacenterArgs.builder()
                .location("de/fra")
                .build());
    
            var testLan = new Lan("testLan", LanArgs.builder()
                .public_(false)
                .datacenterId(testDatacenter.datacenterId())
                .build());
    
            var testIpblock = new Ipblock("testIpblock", IpblockArgs.builder()
                .location("de/fra")
                .size(1)
                .build());
    
            var example = new VpnIpsecGateway("example", VpnIpsecGatewayArgs.builder()
                .location("de/fra")
                .gatewayIp(testIpblock.ips().applyValue(ips -> ips[0]))
                .version("IKEv2")
                .description("This gateway connects site A to VDC X.")
                .connections(VpnIpsecGatewayConnectionArgs.builder()
                    .datacenterId(testDatacenter.datacenterId())
                    .lanId(testLan.lanId())
                    .ipv4Cidr("192.168.100.10/24")
                    .build())
                .build());
    
        }
    }
    
    resources:
      # Basic example
      testDatacenter:
        type: ionoscloud:Datacenter
        properties:
          location: de/fra
      testLan:
        type: ionoscloud:Lan
        properties:
          public: false
          datacenterId: ${testDatacenter.datacenterId}
      testIpblock:
        type: ionoscloud:Ipblock
        properties:
          location: de/fra
          size: 1
      example:
        type: ionoscloud:VpnIpsecGateway
        properties:
          location: de/fra
          gatewayIp: ${testIpblock.ips[0]}
          version: IKEv2
          description: This gateway connects site A to VDC X.
          connections:
            - datacenterId: ${testDatacenter.datacenterId}
              lanId: ${testLan.lanId}
              ipv4Cidr: 192.168.100.10/24
    

    Create VpnIpsecGateway Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new VpnIpsecGateway(name: string, args: VpnIpsecGatewayArgs, opts?: CustomResourceOptions);
    @overload
    def VpnIpsecGateway(resource_name: str,
                        args: VpnIpsecGatewayArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def VpnIpsecGateway(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        connections: Optional[Sequence[VpnIpsecGatewayConnectionArgs]] = None,
                        gateway_ip: Optional[str] = None,
                        description: Optional[str] = None,
                        location: Optional[str] = None,
                        maintenance_window: Optional[VpnIpsecGatewayMaintenanceWindowArgs] = None,
                        name: Optional[str] = None,
                        tier: Optional[str] = None,
                        timeouts: Optional[VpnIpsecGatewayTimeoutsArgs] = None,
                        version: Optional[str] = None,
                        vpn_ipsec_gateway_id: Optional[str] = None)
    func NewVpnIpsecGateway(ctx *Context, name string, args VpnIpsecGatewayArgs, opts ...ResourceOption) (*VpnIpsecGateway, error)
    public VpnIpsecGateway(string name, VpnIpsecGatewayArgs args, CustomResourceOptions? opts = null)
    public VpnIpsecGateway(String name, VpnIpsecGatewayArgs args)
    public VpnIpsecGateway(String name, VpnIpsecGatewayArgs args, CustomResourceOptions options)
    
    type: ionoscloud:VpnIpsecGateway
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args VpnIpsecGatewayArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args VpnIpsecGatewayArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args VpnIpsecGatewayArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args VpnIpsecGatewayArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args VpnIpsecGatewayArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var vpnIpsecGatewayResource = new Ionoscloud.VpnIpsecGateway("vpnIpsecGatewayResource", new()
    {
        Connections = new[]
        {
            new Ionoscloud.Inputs.VpnIpsecGatewayConnectionArgs
            {
                DatacenterId = "string",
                Ipv4Cidr = "string",
                LanId = "string",
                Ipv6Cidr = "string",
            },
        },
        GatewayIp = "string",
        Description = "string",
        Location = "string",
        MaintenanceWindow = new Ionoscloud.Inputs.VpnIpsecGatewayMaintenanceWindowArgs
        {
            DayOfTheWeek = "string",
            Time = "string",
        },
        Name = "string",
        Tier = "string",
        Timeouts = new Ionoscloud.Inputs.VpnIpsecGatewayTimeoutsArgs
        {
            Create = "string",
            Default = "string",
            Delete = "string",
            Update = "string",
        },
        Version = "string",
        VpnIpsecGatewayId = "string",
    });
    
    example, err := ionoscloud.NewVpnIpsecGateway(ctx, "vpnIpsecGatewayResource", &ionoscloud.VpnIpsecGatewayArgs{
    	Connections: ionoscloud.VpnIpsecGatewayConnectionArray{
    		&ionoscloud.VpnIpsecGatewayConnectionArgs{
    			DatacenterId: pulumi.String("string"),
    			Ipv4Cidr:     pulumi.String("string"),
    			LanId:        pulumi.String("string"),
    			Ipv6Cidr:     pulumi.String("string"),
    		},
    	},
    	GatewayIp:   pulumi.String("string"),
    	Description: pulumi.String("string"),
    	Location:    pulumi.String("string"),
    	MaintenanceWindow: &ionoscloud.VpnIpsecGatewayMaintenanceWindowArgs{
    		DayOfTheWeek: pulumi.String("string"),
    		Time:         pulumi.String("string"),
    	},
    	Name: pulumi.String("string"),
    	Tier: pulumi.String("string"),
    	Timeouts: &ionoscloud.VpnIpsecGatewayTimeoutsArgs{
    		Create:  pulumi.String("string"),
    		Default: pulumi.String("string"),
    		Delete:  pulumi.String("string"),
    		Update:  pulumi.String("string"),
    	},
    	Version:           pulumi.String("string"),
    	VpnIpsecGatewayId: pulumi.String("string"),
    })
    
    var vpnIpsecGatewayResource = new VpnIpsecGateway("vpnIpsecGatewayResource", VpnIpsecGatewayArgs.builder()
        .connections(VpnIpsecGatewayConnectionArgs.builder()
            .datacenterId("string")
            .ipv4Cidr("string")
            .lanId("string")
            .ipv6Cidr("string")
            .build())
        .gatewayIp("string")
        .description("string")
        .location("string")
        .maintenanceWindow(VpnIpsecGatewayMaintenanceWindowArgs.builder()
            .dayOfTheWeek("string")
            .time("string")
            .build())
        .name("string")
        .tier("string")
        .timeouts(VpnIpsecGatewayTimeoutsArgs.builder()
            .create("string")
            .default_("string")
            .delete("string")
            .update("string")
            .build())
        .version("string")
        .vpnIpsecGatewayId("string")
        .build());
    
    vpn_ipsec_gateway_resource = ionoscloud.VpnIpsecGateway("vpnIpsecGatewayResource",
        connections=[{
            "datacenter_id": "string",
            "ipv4_cidr": "string",
            "lan_id": "string",
            "ipv6_cidr": "string",
        }],
        gateway_ip="string",
        description="string",
        location="string",
        maintenance_window={
            "day_of_the_week": "string",
            "time": "string",
        },
        name="string",
        tier="string",
        timeouts={
            "create": "string",
            "default": "string",
            "delete": "string",
            "update": "string",
        },
        version="string",
        vpn_ipsec_gateway_id="string")
    
    const vpnIpsecGatewayResource = new ionoscloud.VpnIpsecGateway("vpnIpsecGatewayResource", {
        connections: [{
            datacenterId: "string",
            ipv4Cidr: "string",
            lanId: "string",
            ipv6Cidr: "string",
        }],
        gatewayIp: "string",
        description: "string",
        location: "string",
        maintenanceWindow: {
            dayOfTheWeek: "string",
            time: "string",
        },
        name: "string",
        tier: "string",
        timeouts: {
            create: "string",
            "default": "string",
            "delete": "string",
            update: "string",
        },
        version: "string",
        vpnIpsecGatewayId: "string",
    });
    
    type: ionoscloud:VpnIpsecGateway
    properties:
        connections:
            - datacenterId: string
              ipv4Cidr: string
              ipv6Cidr: string
              lanId: string
        description: string
        gatewayIp: string
        location: string
        maintenanceWindow:
            dayOfTheWeek: string
            time: string
        name: string
        tier: string
        timeouts:
            create: string
            default: string
            delete: string
            update: string
        version: string
        vpnIpsecGatewayId: string
    

    VpnIpsecGateway Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The VpnIpsecGateway resource accepts the following input properties:

    Connections List<VpnIpsecGatewayConnection>
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    GatewayIp string
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    Description string
    [string] The human-readable description of the IPSec Gateway.
    Location string
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    MaintenanceWindow VpnIpsecGatewayMaintenanceWindow
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    Name string
    [string] The name of the IPSec Gateway.
    Tier string
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    Timeouts VpnIpsecGatewayTimeouts
    Version string
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    VpnIpsecGatewayId string
    Connections []VpnIpsecGatewayConnectionArgs
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    GatewayIp string
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    Description string
    [string] The human-readable description of the IPSec Gateway.
    Location string
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    MaintenanceWindow VpnIpsecGatewayMaintenanceWindowArgs
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    Name string
    [string] The name of the IPSec Gateway.
    Tier string
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    Timeouts VpnIpsecGatewayTimeoutsArgs
    Version string
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    VpnIpsecGatewayId string
    connections List<VpnIpsecGatewayConnection>
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    gatewayIp String
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    description String
    [string] The human-readable description of the IPSec Gateway.
    location String
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenanceWindow VpnIpsecGatewayMaintenanceWindow
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name String
    [string] The name of the IPSec Gateway.
    tier String
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts VpnIpsecGatewayTimeouts
    version String
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpnIpsecGatewayId String
    connections VpnIpsecGatewayConnection[]
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    gatewayIp string
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    description string
    [string] The human-readable description of the IPSec Gateway.
    location string
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenanceWindow VpnIpsecGatewayMaintenanceWindow
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name string
    [string] The name of the IPSec Gateway.
    tier string
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts VpnIpsecGatewayTimeouts
    version string
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpnIpsecGatewayId string
    connections Sequence[VpnIpsecGatewayConnectionArgs]
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    gateway_ip str
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    description str
    [string] The human-readable description of the IPSec Gateway.
    location str
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenance_window VpnIpsecGatewayMaintenanceWindowArgs
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name str
    [string] The name of the IPSec Gateway.
    tier str
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts VpnIpsecGatewayTimeoutsArgs
    version str
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpn_ipsec_gateway_id str
    connections List<Property Map>
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    gatewayIp String
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    description String
    [string] The human-readable description of the IPSec Gateway.
    location String
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenanceWindow Property Map
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name String
    [string] The name of the IPSec Gateway.
    tier String
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts Property Map
    version String
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpnIpsecGatewayId String

    Outputs

    All input properties are implicitly available as output properties. Additionally, the VpnIpsecGateway resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing VpnIpsecGateway Resource

    Get an existing VpnIpsecGateway resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: VpnIpsecGatewayState, opts?: CustomResourceOptions): VpnIpsecGateway
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            connections: Optional[Sequence[VpnIpsecGatewayConnectionArgs]] = None,
            description: Optional[str] = None,
            gateway_ip: Optional[str] = None,
            location: Optional[str] = None,
            maintenance_window: Optional[VpnIpsecGatewayMaintenanceWindowArgs] = None,
            name: Optional[str] = None,
            tier: Optional[str] = None,
            timeouts: Optional[VpnIpsecGatewayTimeoutsArgs] = None,
            version: Optional[str] = None,
            vpn_ipsec_gateway_id: Optional[str] = None) -> VpnIpsecGateway
    func GetVpnIpsecGateway(ctx *Context, name string, id IDInput, state *VpnIpsecGatewayState, opts ...ResourceOption) (*VpnIpsecGateway, error)
    public static VpnIpsecGateway Get(string name, Input<string> id, VpnIpsecGatewayState? state, CustomResourceOptions? opts = null)
    public static VpnIpsecGateway get(String name, Output<String> id, VpnIpsecGatewayState state, CustomResourceOptions options)
    resources:  _:    type: ionoscloud:VpnIpsecGateway    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Connections List<VpnIpsecGatewayConnection>
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    Description string
    [string] The human-readable description of the IPSec Gateway.
    GatewayIp string
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    Location string
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    MaintenanceWindow VpnIpsecGatewayMaintenanceWindow
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    Name string
    [string] The name of the IPSec Gateway.
    Tier string
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    Timeouts VpnIpsecGatewayTimeouts
    Version string
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    VpnIpsecGatewayId string
    Connections []VpnIpsecGatewayConnectionArgs
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    Description string
    [string] The human-readable description of the IPSec Gateway.
    GatewayIp string
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    Location string
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    MaintenanceWindow VpnIpsecGatewayMaintenanceWindowArgs
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    Name string
    [string] The name of the IPSec Gateway.
    Tier string
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    Timeouts VpnIpsecGatewayTimeoutsArgs
    Version string
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    VpnIpsecGatewayId string
    connections List<VpnIpsecGatewayConnection>
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    description String
    [string] The human-readable description of the IPSec Gateway.
    gatewayIp String
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    location String
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenanceWindow VpnIpsecGatewayMaintenanceWindow
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name String
    [string] The name of the IPSec Gateway.
    tier String
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts VpnIpsecGatewayTimeouts
    version String
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpnIpsecGatewayId String
    connections VpnIpsecGatewayConnection[]
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    description string
    [string] The human-readable description of the IPSec Gateway.
    gatewayIp string
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    location string
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenanceWindow VpnIpsecGatewayMaintenanceWindow
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name string
    [string] The name of the IPSec Gateway.
    tier string
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts VpnIpsecGatewayTimeouts
    version string
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpnIpsecGatewayId string
    connections Sequence[VpnIpsecGatewayConnectionArgs]
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    description str
    [string] The human-readable description of the IPSec Gateway.
    gateway_ip str
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    location str
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenance_window VpnIpsecGatewayMaintenanceWindowArgs
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name str
    [string] The name of the IPSec Gateway.
    tier str
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts VpnIpsecGatewayTimeoutsArgs
    version str
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpn_ipsec_gateway_id str
    connections List<Property Map>
    [list] The network connection for your gateway. Note: all connections must belong to the same datacenter. Minimum items: 1. Maximum items: 10.
    description String
    [string] The human-readable description of the IPSec Gateway.
    gatewayIp String
    [string] Public IP address to be assigned to the gateway. Note: This must be an IP address in the same datacenter as the connections.
    location String
    [string] The location of the IPSec Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.
    maintenanceWindow Property Map
    (Computed) A weekly 4 hour-long window, during which maintenance might occur.
    name String
    [string] The name of the IPSec Gateway.
    tier String
    (Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.
    timeouts Property Map
    version String
    [string] The IKE version that is permitted for the VPN tunnels. Default: IKEv2. Possible values: IKEv2.
    vpnIpsecGatewayId String

    Supporting Types

    VpnIpsecGatewayConnection, VpnIpsecGatewayConnectionArgs

    DatacenterId string
    [string] The datacenter to connect your VPN Gateway to.
    Ipv4Cidr string
    [string] Describes the private ipv4 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    LanId string
    [string] The numeric LAN ID to connect your VPN Gateway to.
    Ipv6Cidr string
    [string] Describes the ipv6 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    DatacenterId string
    [string] The datacenter to connect your VPN Gateway to.
    Ipv4Cidr string
    [string] Describes the private ipv4 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    LanId string
    [string] The numeric LAN ID to connect your VPN Gateway to.
    Ipv6Cidr string
    [string] Describes the ipv6 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    datacenterId String
    [string] The datacenter to connect your VPN Gateway to.
    ipv4Cidr String
    [string] Describes the private ipv4 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    lanId String
    [string] The numeric LAN ID to connect your VPN Gateway to.
    ipv6Cidr String
    [string] Describes the ipv6 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    datacenterId string
    [string] The datacenter to connect your VPN Gateway to.
    ipv4Cidr string
    [string] Describes the private ipv4 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    lanId string
    [string] The numeric LAN ID to connect your VPN Gateway to.
    ipv6Cidr string
    [string] Describes the ipv6 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    datacenter_id str
    [string] The datacenter to connect your VPN Gateway to.
    ipv4_cidr str
    [string] Describes the private ipv4 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    lan_id str
    [string] The numeric LAN ID to connect your VPN Gateway to.
    ipv6_cidr str
    [string] Describes the ipv6 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    datacenterId String
    [string] The datacenter to connect your VPN Gateway to.
    ipv4Cidr String
    [string] Describes the private ipv4 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN
    lanId String
    [string] The numeric LAN ID to connect your VPN Gateway to.
    ipv6Cidr String
    [string] Describes the ipv6 subnet in your LAN that should be accessible by the VPN Gateway. Note: this should be the subnet already assigned to the LAN

    VpnIpsecGatewayMaintenanceWindow, VpnIpsecGatewayMaintenanceWindowArgs

    DayOfTheWeek string
    [string] The name of the week day.
    Time string
    [string] Start of the maintenance window in UTC time.
    DayOfTheWeek string
    [string] The name of the week day.
    Time string
    [string] Start of the maintenance window in UTC time.
    dayOfTheWeek String
    [string] The name of the week day.
    time String
    [string] Start of the maintenance window in UTC time.
    dayOfTheWeek string
    [string] The name of the week day.
    time string
    [string] Start of the maintenance window in UTC time.
    day_of_the_week str
    [string] The name of the week day.
    time str
    [string] Start of the maintenance window in UTC time.
    dayOfTheWeek String
    [string] The name of the week day.
    time String
    [string] Start of the maintenance window in UTC time.

    VpnIpsecGatewayTimeouts, VpnIpsecGatewayTimeoutsArgs

    Create string
    Default string
    Delete string
    Update string
    Create string
    Default string
    Delete string
    Update string
    create String
    default_ String
    delete String
    update String
    create string
    default string
    delete string
    update string
    create String
    default String
    delete String
    update String

    Import

    The resource can be imported using the location and gateway_id, for example:

    $ pulumi import ionoscloud:index/vpnIpsecGateway:VpnIpsecGateway example location:gateway_id
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    ionoscloud ionos-cloud/terraform-provider-ionoscloud
    License
    Notes
    This Pulumi package is based on the ionoscloud Terraform Provider.
    ionoscloud logo
    ionoscloud 6.7.6 published on Monday, Apr 14, 2025 by ionos-cloud