terraform-provider-stackitp.../docs/resources/network.md
Alexander Dahmen 721e10a02f
chore(examples): Add import examples for all resources (#939)
* chore(examples): Add import examples for all resources

Signed-off-by: Alexander Dahmen <alexander.dahmen@inovex.de>

* Add guide: How to import resources

Signed-off-by: Alexander Dahmen <alexander.dahmen@inovex.de>

---------

Signed-off-by: Alexander Dahmen <alexander.dahmen@inovex.de>
2025-08-08 14:03:27 +02:00

3.6 KiB

page_title subcategory description
stackit_network Resource - stackit Network resource schema. Must have a region specified in the provider configuration.

stackit_network (Resource)

Network resource schema. Must have a region specified in the provider configuration.

Example Usage

resource "stackit_network" "example_with_name" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name       = "example-with-name"
}

resource "stackit_network" "example_routed_network" {
  project_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name       = "example-routed-network"
  labels = {
    "key" = "value"
  }
  routed = true
}

resource "stackit_network" "example_non_routed_network" {
  project_id         = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  name               = "example-non-routed-network"
  ipv4_nameservers   = ["1.2.3.4", "5.6.7.8"]
  ipv4_prefix_length = 24
  ipv4_gateway       = "10.1.2.3"
  ipv4_prefix        = "10.1.2.0/24"
  labels = {
    "key" = "value"
  }
  routed = false
}

# Only use the import statement, if you want to import an existing network
# Note: There will be a conflict which needs to be resolved manually.
# These attributes cannot be configured together: [ipv4_prefix,ipv4_prefix_length,ipv4_gateway]
import {
  to = stackit_network.import-example
  id = "${var.project_id},${var.network_id}"
}

Schema

Required

  • name (String) The name of the network.
  • project_id (String) STACKIT project ID to which the network is associated.

Optional

  • ipv4_gateway (String) The IPv4 gateway of a network. If not specified, the first IP of the network will be assigned as the gateway.
  • ipv4_nameservers (List of String) The IPv4 nameservers of the network.
  • ipv4_prefix (String) The IPv4 prefix of the network (CIDR).
  • ipv4_prefix_length (Number) The IPv4 prefix length of the network.
  • ipv6_gateway (String) The IPv6 gateway of a network. If not specified, the first IP of the network will be assigned as the gateway.
  • ipv6_nameservers (List of String) The IPv6 nameservers of the network.
  • ipv6_prefix (String) The IPv6 prefix of the network (CIDR).
  • ipv6_prefix_length (Number) The IPv6 prefix length of the network.
  • labels (Map of String) Labels are key-value string pairs which can be attached to a resource container
  • nameservers (List of String, Deprecated) The nameservers of the network. This field is deprecated and will be removed soon, use ipv4_nameservers to configure the nameservers for IPv4.
  • no_ipv4_gateway (Boolean) If set to true, the network doesn't have a gateway.
  • no_ipv6_gateway (Boolean) If set to true, the network doesn't have a gateway.
  • region (String) Can only be used when experimental "network" is set. The resource region. If not defined, the provider region is used.
  • routed (Boolean) If set to true, the network is routed and therefore accessible from other networks.
  • routing_table_id (String) Can only be used when experimental "network" is set. The ID of the routing table associated with the network.

Read-Only

  • id (String) Terraform's internal resource ID. It is structured as "project_id,network_id".
  • ipv4_prefixes (List of String) The IPv4 prefixes of the network.
  • ipv6_prefixes (List of String) The IPv6 prefixes of the network.
  • network_id (String) The network ID.
  • prefixes (List of String, Deprecated) The prefixes of the network. This field is deprecated and will be removed soon, use ipv4_prefixes to read the prefixes of the IPv4 networks.
  • public_ip (String) The public IP of the network.