ionoscloud_vpn_wireguard_gateway

Creates and manages IonosCloud VPN Wireguard Gateway objects.

Overview

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

Example Usage

resource "ionoscloud_datacenter" "datacenter_example" {
  name = "datacenter_example"
  location = "de/fra"
}
resource "ionoscloud_ipblock" "ipblock_example" {
  location = "de/fra"
  size = 1
  name = "ipblock_example"
}

resource "ionoscloud_lan" "lan_example" {
  name = "lan_example"
  datacenter_id = ionoscloud_datacenter.datacenter_example.id
}

resource "ionoscloud_vpn_wireguard_gateway" "gateway" {
  location = "de/fra"
  name = "gateway_example"
  description = "description"
  private_key = "private"

  gateway_ip = ionoscloud_ipblock.ipblock_example.ips[0]
  interface_ipv4_cidr =  "192.168.1.100/24"
  connections   {
    datacenter_id   =  ionoscloud_datacenter.datacenter_example.id
    lan_id          =  ionoscloud_lan.lan_example.id
    ipv4_cidr       =  "192.168.1.108/24"
  }
  maintenance_window {
    day_of_the_week       = "Monday"
    time                  = "09:00:00"
  }
  tier = "STANDARD"
}

Argument Reference

The following arguments are supported by the vpn_wireguard_gateway resource:

• location - (Optional)[String] The location of the WireGuard Gateway. Supported locations: de/fra, de/txl, es/vit, gb/bhx, gb/lhr, us/ewr, us/las, us/mci, fr/par.

• name - (Required)[String] The name of the WireGuard Gateway.

• description - (Optional)[String] A description of the WireGuard Gateway.

• endpoint - (Optional, Block) The endpoint configuration for the WireGuard Gateway. This block supports fields documented below.

• private_key - (Required)[String] The private key for the WireGuard Gateway. To be created with the wg utility.

• gateway_ip - (Required)[String] The IP address of the WireGuard Gateway.

• interface_ipv4_cidr - (Optional)[String] The IPv4 CIDR for the WireGuard Gateway interface.

• interface_ipv6_cidr - (Optional)[String] The IPv6 CIDR for the WireGuard Gateway interface.

• connections - (Required)[Block] The connection configuration for the WireGuard Gateway. This block supports fields documented below.

  • datacenter_id - (Required)[String] The ID of the datacenter where the WireGuard Gateway is located.

  • lan_id - (Required)[String] The ID of the LAN where the WireGuard Gateway is connected.

  • ipv4_cidr - (Required)[String] The IPv4 CIDR for the WireGuard Gateway connection.

  • ipv6_cidr - (Optional)[String] The IPv6 CIDR for the WireGuard Gateway connection.

• maintenance_window - (Optional)(Computed) A weekly 4 hour-long window, during which maintenance might occur.

  • time - (Required)[string] Start of the maintenance window in UTC time.

  • day_of_the_week - (Required)[string] The name of the week day.

• tier - (Optional)(Computed)[string] Gateway performance options. See product documentation for full details. Options: STANDARD, STANDARD_HA, ENHANCED, ENHANCED_HA, PREMIUM, PREMIUM_HA.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• status - (Computed)[String] The current status of the WireGuard Gateway.

• public_key - (Computed)[String] The public key for the WireGuard Gateway.

⚠ NOTE: IONOS_API_URL_VPN can be used to set a custom API URL for the resource. location field needs to be empty, otherwise it will override the custom API URL. Setting endpoint or IONOS_API_URL does not have any effect.

Import

WireGuard Gateways can be imported using their ID:

terraform import ionoscloud_vpn_wireguard_gateway.example_gateway location:id