unifi.Network
Explore with Pulumi AI
unifi.Network
manages WAN/LAN/VLAN networks.
Example Usage
using System.Collections.Generic;
using Pulumi;
using Unifi = Pulumiverse.Unifi;
return await Deployment.RunAsync(() =>
{
var config = new Config();
var vlanId = config.GetNumber("vlanId") ?? 10;
var vlan = new Unifi.Network("vlan", new()
{
Purpose = "corporate",
Subnet = "10.0.0.1/24",
VlanId = vlanId,
DhcpStart = "10.0.0.6",
DhcpStop = "10.0.0.254",
DhcpEnabled = true,
});
var wan = new Unifi.Network("wan", new()
{
Purpose = "wan",
WanNetworkgroup = "WAN",
WanType = "pppoe",
WanIp = "192.168.1.1",
WanEgressQos = 1,
WanUsername = "username",
XWanPassword = "password",
});
});
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
"github.com/pulumiverse/pulumi-unifi/sdk/go/unifi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
cfg := config.New(ctx, "")
vlanId := float64(10)
if param := cfg.GetFloat64("vlanId"); param != 0 {
vlanId = param
}
_, err := unifi.NewNetwork(ctx, "vlan", &unifi.NetworkArgs{
Purpose: pulumi.String("corporate"),
Subnet: pulumi.String("10.0.0.1/24"),
VlanId: pulumi.Float64(vlanId),
DhcpStart: pulumi.String("10.0.0.6"),
DhcpStop: pulumi.String("10.0.0.254"),
DhcpEnabled: pulumi.Bool(true),
})
if err != nil {
return err
}
_, err = unifi.NewNetwork(ctx, "wan", &unifi.NetworkArgs{
Purpose: pulumi.String("wan"),
WanNetworkgroup: pulumi.String("WAN"),
WanType: pulumi.String("pppoe"),
WanIp: pulumi.String("192.168.1.1"),
WanEgressQos: pulumi.Int(1),
WanUsername: pulumi.String("username"),
XWanPassword: pulumi.String("password"),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.unifi.Network;
import com.pulumi.unifi.NetworkArgs;
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 vlanId = config.get("vlanId").orElse(10);
var vlan = new Network("vlan", NetworkArgs.builder()
.purpose("corporate")
.subnet("10.0.0.1/24")
.vlanId(vlanId)
.dhcpStart("10.0.0.6")
.dhcpStop("10.0.0.254")
.dhcpEnabled(true)
.build());
var wan = new Network("wan", NetworkArgs.builder()
.purpose("wan")
.wanNetworkgroup("WAN")
.wanType("pppoe")
.wanIp("192.168.1.1")
.wanEgressQos(1)
.wanUsername("username")
.xWanPassword("password")
.build());
}
}
import pulumi
import pulumiverse_unifi as unifi
config = pulumi.Config()
vlan_id = config.get_float("vlanId")
if vlan_id is None:
vlan_id = 10
vlan = unifi.Network("vlan",
purpose="corporate",
subnet="10.0.0.1/24",
vlan_id=vlan_id,
dhcp_start="10.0.0.6",
dhcp_stop="10.0.0.254",
dhcp_enabled=True)
wan = unifi.Network("wan",
purpose="wan",
wan_networkgroup="WAN",
wan_type="pppoe",
wan_ip="192.168.1.1",
wan_egress_qos=1,
wan_username="username",
x_wan_password="password")
import * as pulumi from "@pulumi/pulumi";
import * as unifi from "@pulumiverse/unifi";
const config = new pulumi.Config();
const vlanId = config.getNumber("vlanId") || 10;
const vlan = new unifi.Network("vlan", {
purpose: "corporate",
subnet: "10.0.0.1/24",
vlanId: vlanId,
dhcpStart: "10.0.0.6",
dhcpStop: "10.0.0.254",
dhcpEnabled: true,
});
const wan = new unifi.Network("wan", {
purpose: "wan",
wanNetworkgroup: "WAN",
wanType: "pppoe",
wanIp: "192.168.1.1",
wanEgressQos: 1,
wanUsername: "username",
xWanPassword: "password",
});
configuration:
vlanId:
type: number
default: 10
resources:
vlan:
type: unifi:Network
properties:
purpose: corporate
subnet: 10.0.0.1/24
vlanId: ${vlanId}
dhcpStart: 10.0.0.6
dhcpStop: 10.0.0.254
dhcpEnabled: true
wan:
type: unifi:Network
properties:
purpose: wan
wanNetworkgroup: WAN
wanType: pppoe
wanIp: 192.168.1.1
wanEgressQos: 1
wanUsername: username
xWanPassword: password
Create Network Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Network(name: string, args: NetworkArgs, opts?: CustomResourceOptions);
@overload
def Network(resource_name: str,
args: NetworkArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Network(resource_name: str,
opts: Optional[ResourceOptions] = None,
purpose: Optional[str] = None,
ipv6_ra_enable: Optional[bool] = None,
wan_networkgroup: Optional[str] = None,
dhcp_relay_enabled: Optional[bool] = None,
dhcp_start: Optional[str] = None,
dhcp_stop: Optional[str] = None,
dhcp_v6_dns: Optional[Sequence[str]] = None,
dhcp_v6_dns_auto: Optional[bool] = None,
dhcp_v6_enabled: Optional[bool] = None,
dhcp_v6_lease: Optional[int] = None,
dhcp_v6_start: Optional[str] = None,
dhcp_v6_stop: Optional[str] = None,
dhcpd_boot_enabled: Optional[bool] = None,
dhcpd_boot_filename: Optional[str] = None,
dhcpd_boot_server: Optional[str] = None,
ipv6_pd_stop: Optional[str] = None,
igmp_snooping: Optional[bool] = None,
internet_access_enabled: Optional[bool] = None,
intra_network_access_enabled: Optional[bool] = None,
ipv6_interface_type: Optional[str] = None,
ipv6_pd_interface: Optional[str] = None,
ipv6_pd_prefixid: Optional[str] = None,
ipv6_pd_start: Optional[str] = None,
domain_name: Optional[str] = None,
dhcp_lease: Optional[int] = None,
subnet: Optional[str] = None,
ipv6_ra_priority: Optional[str] = None,
ipv6_ra_valid_lifetime: Optional[int] = None,
ipv6_static_subnet: Optional[str] = None,
name: Optional[str] = None,
network_group: Optional[str] = None,
dhcp_enabled: Optional[bool] = None,
site: Optional[str] = None,
ipv6_ra_preferred_lifetime: Optional[int] = None,
vlan_id: Optional[int] = None,
wan_dhcp_v6_pd_size: Optional[int] = None,
wan_dns: Optional[Sequence[str]] = None,
wan_egress_qos: Optional[int] = None,
wan_gateway: Optional[str] = None,
wan_gateway_v6: Optional[str] = None,
wan_ip: Optional[str] = None,
wan_ipv6: Optional[str] = None,
wan_netmask: Optional[str] = None,
dhcp_dns: Optional[Sequence[str]] = None,
wan_prefixlen: Optional[int] = None,
wan_type: Optional[str] = None,
wan_type_v6: Optional[str] = None,
wan_username: Optional[str] = None,
x_wan_password: Optional[str] = None)
func NewNetwork(ctx *Context, name string, args NetworkArgs, opts ...ResourceOption) (*Network, error)
public Network(string name, NetworkArgs args, CustomResourceOptions? opts = null)
public Network(String name, NetworkArgs args)
public Network(String name, NetworkArgs args, CustomResourceOptions options)
type: unifi:Network
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 NetworkArgs
- 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 NetworkArgs
- 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 NetworkArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args NetworkArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args NetworkArgs
- 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 networkResource = new Unifi.Network("networkResource", new()
{
Purpose = "string",
Ipv6RaEnable = false,
WanNetworkgroup = "string",
DhcpRelayEnabled = false,
DhcpStart = "string",
DhcpStop = "string",
DhcpV6Dns = new[]
{
"string",
},
DhcpV6DnsAuto = false,
DhcpV6Enabled = false,
DhcpV6Lease = 0,
DhcpV6Start = "string",
DhcpV6Stop = "string",
DhcpdBootEnabled = false,
DhcpdBootFilename = "string",
DhcpdBootServer = "string",
Ipv6PdStop = "string",
IgmpSnooping = false,
InternetAccessEnabled = false,
IntraNetworkAccessEnabled = false,
Ipv6InterfaceType = "string",
Ipv6PdInterface = "string",
Ipv6PdPrefixid = "string",
Ipv6PdStart = "string",
DomainName = "string",
DhcpLease = 0,
Subnet = "string",
Ipv6RaPriority = "string",
Ipv6RaValidLifetime = 0,
Ipv6StaticSubnet = "string",
Name = "string",
NetworkGroup = "string",
DhcpEnabled = false,
Site = "string",
Ipv6RaPreferredLifetime = 0,
VlanId = 0,
WanDhcpV6PdSize = 0,
WanDns = new[]
{
"string",
},
WanEgressQos = 0,
WanGateway = "string",
WanGatewayV6 = "string",
WanIp = "string",
WanIpv6 = "string",
WanNetmask = "string",
DhcpDns = new[]
{
"string",
},
WanPrefixlen = 0,
WanType = "string",
WanTypeV6 = "string",
WanUsername = "string",
XWanPassword = "string",
});
example, err := unifi.NewNetwork(ctx, "networkResource", &unifi.NetworkArgs{
Purpose: pulumi.String("string"),
Ipv6RaEnable: pulumi.Bool(false),
WanNetworkgroup: pulumi.String("string"),
DhcpRelayEnabled: pulumi.Bool(false),
DhcpStart: pulumi.String("string"),
DhcpStop: pulumi.String("string"),
DhcpV6Dns: pulumi.StringArray{
pulumi.String("string"),
},
DhcpV6DnsAuto: pulumi.Bool(false),
DhcpV6Enabled: pulumi.Bool(false),
DhcpV6Lease: pulumi.Int(0),
DhcpV6Start: pulumi.String("string"),
DhcpV6Stop: pulumi.String("string"),
DhcpdBootEnabled: pulumi.Bool(false),
DhcpdBootFilename: pulumi.String("string"),
DhcpdBootServer: pulumi.String("string"),
Ipv6PdStop: pulumi.String("string"),
IgmpSnooping: pulumi.Bool(false),
InternetAccessEnabled: pulumi.Bool(false),
IntraNetworkAccessEnabled: pulumi.Bool(false),
Ipv6InterfaceType: pulumi.String("string"),
Ipv6PdInterface: pulumi.String("string"),
Ipv6PdPrefixid: pulumi.String("string"),
Ipv6PdStart: pulumi.String("string"),
DomainName: pulumi.String("string"),
DhcpLease: pulumi.Int(0),
Subnet: pulumi.String("string"),
Ipv6RaPriority: pulumi.String("string"),
Ipv6RaValidLifetime: pulumi.Int(0),
Ipv6StaticSubnet: pulumi.String("string"),
Name: pulumi.String("string"),
NetworkGroup: pulumi.String("string"),
DhcpEnabled: pulumi.Bool(false),
Site: pulumi.String("string"),
Ipv6RaPreferredLifetime: pulumi.Int(0),
VlanId: pulumi.Int(0),
WanDhcpV6PdSize: pulumi.Int(0),
WanDns: pulumi.StringArray{
pulumi.String("string"),
},
WanEgressQos: pulumi.Int(0),
WanGateway: pulumi.String("string"),
WanGatewayV6: pulumi.String("string"),
WanIp: pulumi.String("string"),
WanIpv6: pulumi.String("string"),
WanNetmask: pulumi.String("string"),
DhcpDns: pulumi.StringArray{
pulumi.String("string"),
},
WanPrefixlen: pulumi.Int(0),
WanType: pulumi.String("string"),
WanTypeV6: pulumi.String("string"),
WanUsername: pulumi.String("string"),
XWanPassword: pulumi.String("string"),
})
var networkResource = new Network("networkResource", NetworkArgs.builder()
.purpose("string")
.ipv6RaEnable(false)
.wanNetworkgroup("string")
.dhcpRelayEnabled(false)
.dhcpStart("string")
.dhcpStop("string")
.dhcpV6Dns("string")
.dhcpV6DnsAuto(false)
.dhcpV6Enabled(false)
.dhcpV6Lease(0)
.dhcpV6Start("string")
.dhcpV6Stop("string")
.dhcpdBootEnabled(false)
.dhcpdBootFilename("string")
.dhcpdBootServer("string")
.ipv6PdStop("string")
.igmpSnooping(false)
.internetAccessEnabled(false)
.intraNetworkAccessEnabled(false)
.ipv6InterfaceType("string")
.ipv6PdInterface("string")
.ipv6PdPrefixid("string")
.ipv6PdStart("string")
.domainName("string")
.dhcpLease(0)
.subnet("string")
.ipv6RaPriority("string")
.ipv6RaValidLifetime(0)
.ipv6StaticSubnet("string")
.name("string")
.networkGroup("string")
.dhcpEnabled(false)
.site("string")
.ipv6RaPreferredLifetime(0)
.vlanId(0)
.wanDhcpV6PdSize(0)
.wanDns("string")
.wanEgressQos(0)
.wanGateway("string")
.wanGatewayV6("string")
.wanIp("string")
.wanIpv6("string")
.wanNetmask("string")
.dhcpDns("string")
.wanPrefixlen(0)
.wanType("string")
.wanTypeV6("string")
.wanUsername("string")
.xWanPassword("string")
.build());
network_resource = unifi.Network("networkResource",
purpose="string",
ipv6_ra_enable=False,
wan_networkgroup="string",
dhcp_relay_enabled=False,
dhcp_start="string",
dhcp_stop="string",
dhcp_v6_dns=["string"],
dhcp_v6_dns_auto=False,
dhcp_v6_enabled=False,
dhcp_v6_lease=0,
dhcp_v6_start="string",
dhcp_v6_stop="string",
dhcpd_boot_enabled=False,
dhcpd_boot_filename="string",
dhcpd_boot_server="string",
ipv6_pd_stop="string",
igmp_snooping=False,
internet_access_enabled=False,
intra_network_access_enabled=False,
ipv6_interface_type="string",
ipv6_pd_interface="string",
ipv6_pd_prefixid="string",
ipv6_pd_start="string",
domain_name="string",
dhcp_lease=0,
subnet="string",
ipv6_ra_priority="string",
ipv6_ra_valid_lifetime=0,
ipv6_static_subnet="string",
name="string",
network_group="string",
dhcp_enabled=False,
site="string",
ipv6_ra_preferred_lifetime=0,
vlan_id=0,
wan_dhcp_v6_pd_size=0,
wan_dns=["string"],
wan_egress_qos=0,
wan_gateway="string",
wan_gateway_v6="string",
wan_ip="string",
wan_ipv6="string",
wan_netmask="string",
dhcp_dns=["string"],
wan_prefixlen=0,
wan_type="string",
wan_type_v6="string",
wan_username="string",
x_wan_password="string")
const networkResource = new unifi.Network("networkResource", {
purpose: "string",
ipv6RaEnable: false,
wanNetworkgroup: "string",
dhcpRelayEnabled: false,
dhcpStart: "string",
dhcpStop: "string",
dhcpV6Dns: ["string"],
dhcpV6DnsAuto: false,
dhcpV6Enabled: false,
dhcpV6Lease: 0,
dhcpV6Start: "string",
dhcpV6Stop: "string",
dhcpdBootEnabled: false,
dhcpdBootFilename: "string",
dhcpdBootServer: "string",
ipv6PdStop: "string",
igmpSnooping: false,
internetAccessEnabled: false,
intraNetworkAccessEnabled: false,
ipv6InterfaceType: "string",
ipv6PdInterface: "string",
ipv6PdPrefixid: "string",
ipv6PdStart: "string",
domainName: "string",
dhcpLease: 0,
subnet: "string",
ipv6RaPriority: "string",
ipv6RaValidLifetime: 0,
ipv6StaticSubnet: "string",
name: "string",
networkGroup: "string",
dhcpEnabled: false,
site: "string",
ipv6RaPreferredLifetime: 0,
vlanId: 0,
wanDhcpV6PdSize: 0,
wanDns: ["string"],
wanEgressQos: 0,
wanGateway: "string",
wanGatewayV6: "string",
wanIp: "string",
wanIpv6: "string",
wanNetmask: "string",
dhcpDns: ["string"],
wanPrefixlen: 0,
wanType: "string",
wanTypeV6: "string",
wanUsername: "string",
xWanPassword: "string",
});
type: unifi:Network
properties:
dhcpDns:
- string
dhcpEnabled: false
dhcpLease: 0
dhcpRelayEnabled: false
dhcpStart: string
dhcpStop: string
dhcpV6Dns:
- string
dhcpV6DnsAuto: false
dhcpV6Enabled: false
dhcpV6Lease: 0
dhcpV6Start: string
dhcpV6Stop: string
dhcpdBootEnabled: false
dhcpdBootFilename: string
dhcpdBootServer: string
domainName: string
igmpSnooping: false
internetAccessEnabled: false
intraNetworkAccessEnabled: false
ipv6InterfaceType: string
ipv6PdInterface: string
ipv6PdPrefixid: string
ipv6PdStart: string
ipv6PdStop: string
ipv6RaEnable: false
ipv6RaPreferredLifetime: 0
ipv6RaPriority: string
ipv6RaValidLifetime: 0
ipv6StaticSubnet: string
name: string
networkGroup: string
purpose: string
site: string
subnet: string
vlanId: 0
wanDhcpV6PdSize: 0
wanDns:
- string
wanEgressQos: 0
wanGateway: string
wanGatewayV6: string
wanIp: string
wanIpv6: string
wanNetmask: string
wanNetworkgroup: string
wanPrefixlen: 0
wanType: string
wanTypeV6: string
wanUsername: string
xWanPassword: string
Network Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The Network resource accepts the following input properties:
- Purpose string
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - Dhcp
Dns List<string> - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- Dhcp
Enabled bool - Specifies whether DHCP is enabled or not on this network.
- Dhcp
Lease int - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - Dhcp
Relay boolEnabled - Specifies whether DHCP relay is enabled or not on this network.
- Dhcp
Start string - The IPv4 address where the DHCP range of addresses starts.
- Dhcp
Stop string - The IPv4 address where the DHCP range of addresses stops.
- Dhcp
V6Dns List<string> - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - Dhcp
V6Dns boolAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - Dhcp
V6Enabled bool - Enable stateful DHCPv6 for static configuration.
- Dhcp
V6Lease int - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - Dhcp
V6Start string - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcp
V6Stop string - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcpd
Boot boolEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- Dhcpd
Boot stringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- Dhcpd
Boot stringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- Domain
Name string - The domain name of this network.
- Igmp
Snooping bool - Specifies whether IGMP snooping is enabled or not.
- Internet
Access boolEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - Intra
Network boolAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - Ipv6Interface
Type string - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - Ipv6Pd
Interface string - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - Ipv6Pd
Prefixid string - Specifies the IPv6 Prefix ID.
- Ipv6Pd
Start string - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Pd
Stop string - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Ra
Enable bool - Specifies whether to enable router advertisements or not.
- Ipv6Ra
Preferred intLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - Ipv6Ra
Priority string - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- Ipv6Ra
Valid intLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - Ipv6Static
Subnet string - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - Name string
- The name of the network.
- Network
Group string - The group of the network. Defaults to
LAN
. - Site string
- The name of the site to associate the network with.
- Subnet string
- The subnet of the network. Must be a valid CIDR address.
- Vlan
Id int - The VLAN ID of the network.
- Wan
Dhcp intV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- Wan
Dns List<string> - DNS servers IPs of the WAN.
- Wan
Egress intQos - Specifies the WAN egress quality of service. Defaults to
0
. - Wan
Gateway string - The IPv4 gateway of the WAN.
- Wan
Gateway stringV6 - The IPv6 gateway of the WAN.
- Wan
Ip string - The IPv4 address of the WAN.
- Wan
Ipv6 string - The IPv6 address of the WAN.
- Wan
Netmask string - The IPv4 netmask of the WAN.
- Wan
Networkgroup string - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - Wan
Prefixlen int - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- Wan
Type string - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - Wan
Type stringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - Wan
Username string - Specifies the IPV4 WAN username.
- XWan
Password string - Specifies the IPV4 WAN password.
- Purpose string
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - Dhcp
Dns []string - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- Dhcp
Enabled bool - Specifies whether DHCP is enabled or not on this network.
- Dhcp
Lease int - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - Dhcp
Relay boolEnabled - Specifies whether DHCP relay is enabled or not on this network.
- Dhcp
Start string - The IPv4 address where the DHCP range of addresses starts.
- Dhcp
Stop string - The IPv4 address where the DHCP range of addresses stops.
- Dhcp
V6Dns []string - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - Dhcp
V6Dns boolAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - Dhcp
V6Enabled bool - Enable stateful DHCPv6 for static configuration.
- Dhcp
V6Lease int - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - Dhcp
V6Start string - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcp
V6Stop string - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcpd
Boot boolEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- Dhcpd
Boot stringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- Dhcpd
Boot stringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- Domain
Name string - The domain name of this network.
- Igmp
Snooping bool - Specifies whether IGMP snooping is enabled or not.
- Internet
Access boolEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - Intra
Network boolAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - Ipv6Interface
Type string - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - Ipv6Pd
Interface string - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - Ipv6Pd
Prefixid string - Specifies the IPv6 Prefix ID.
- Ipv6Pd
Start string - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Pd
Stop string - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Ra
Enable bool - Specifies whether to enable router advertisements or not.
- Ipv6Ra
Preferred intLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - Ipv6Ra
Priority string - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- Ipv6Ra
Valid intLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - Ipv6Static
Subnet string - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - Name string
- The name of the network.
- Network
Group string - The group of the network. Defaults to
LAN
. - Site string
- The name of the site to associate the network with.
- Subnet string
- The subnet of the network. Must be a valid CIDR address.
- Vlan
Id int - The VLAN ID of the network.
- Wan
Dhcp intV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- Wan
Dns []string - DNS servers IPs of the WAN.
- Wan
Egress intQos - Specifies the WAN egress quality of service. Defaults to
0
. - Wan
Gateway string - The IPv4 gateway of the WAN.
- Wan
Gateway stringV6 - The IPv6 gateway of the WAN.
- Wan
Ip string - The IPv4 address of the WAN.
- Wan
Ipv6 string - The IPv6 address of the WAN.
- Wan
Netmask string - The IPv4 netmask of the WAN.
- Wan
Networkgroup string - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - Wan
Prefixlen int - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- Wan
Type string - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - Wan
Type stringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - Wan
Username string - Specifies the IPV4 WAN username.
- XWan
Password string - Specifies the IPV4 WAN password.
- purpose String
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - dhcp
Dns List<String> - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp
Enabled Boolean - Specifies whether DHCP is enabled or not on this network.
- dhcp
Lease Integer - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp
Relay BooleanEnabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp
Start String - The IPv4 address where the DHCP range of addresses starts.
- dhcp
Stop String - The IPv4 address where the DHCP range of addresses stops.
- dhcp
V6Dns List<String> - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp
V6Dns BooleanAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp
V6Enabled Boolean - Enable stateful DHCPv6 for static configuration.
- dhcp
V6Lease Integer - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp
V6Start String - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp
V6Stop String - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd
Boot BooleanEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd
Boot StringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd
Boot StringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- domain
Name String - The domain name of this network.
- igmp
Snooping Boolean - Specifies whether IGMP snooping is enabled or not.
- internet
Access BooleanEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra
Network BooleanAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6Interface
Type String - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6Pd
Interface String - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6Pd
Prefixid String - Specifies the IPv6 Prefix ID.
- ipv6Pd
Start String - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Pd
Stop String - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Ra
Enable Boolean - Specifies whether to enable router advertisements or not.
- ipv6Ra
Preferred IntegerLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6Ra
Priority String - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6Ra
Valid IntegerLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6Static
Subnet String - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name String
- The name of the network.
- network
Group String - The group of the network. Defaults to
LAN
. - site String
- The name of the site to associate the network with.
- subnet String
- The subnet of the network. Must be a valid CIDR address.
- vlan
Id Integer - The VLAN ID of the network.
- wan
Dhcp IntegerV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan
Dns List<String> - DNS servers IPs of the WAN.
- wan
Egress IntegerQos - Specifies the WAN egress quality of service. Defaults to
0
. - wan
Gateway String - The IPv4 gateway of the WAN.
- wan
Gateway StringV6 - The IPv6 gateway of the WAN.
- wan
Ip String - The IPv4 address of the WAN.
- wan
Ipv6 String - The IPv6 address of the WAN.
- wan
Netmask String - The IPv4 netmask of the WAN.
- wan
Networkgroup String - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan
Prefixlen Integer - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan
Type String - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan
Type StringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan
Username String - Specifies the IPV4 WAN username.
- x
Wan StringPassword - Specifies the IPV4 WAN password.
- purpose string
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - dhcp
Dns string[] - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp
Enabled boolean - Specifies whether DHCP is enabled or not on this network.
- dhcp
Lease number - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp
Relay booleanEnabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp
Start string - The IPv4 address where the DHCP range of addresses starts.
- dhcp
Stop string - The IPv4 address where the DHCP range of addresses stops.
- dhcp
V6Dns string[] - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp
V6Dns booleanAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp
V6Enabled boolean - Enable stateful DHCPv6 for static configuration.
- dhcp
V6Lease number - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp
V6Start string - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp
V6Stop string - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd
Boot booleanEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd
Boot stringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd
Boot stringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- domain
Name string - The domain name of this network.
- igmp
Snooping boolean - Specifies whether IGMP snooping is enabled or not.
- internet
Access booleanEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra
Network booleanAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6Interface
Type string - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6Pd
Interface string - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6Pd
Prefixid string - Specifies the IPv6 Prefix ID.
- ipv6Pd
Start string - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Pd
Stop string - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Ra
Enable boolean - Specifies whether to enable router advertisements or not.
- ipv6Ra
Preferred numberLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6Ra
Priority string - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6Ra
Valid numberLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6Static
Subnet string - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name string
- The name of the network.
- network
Group string - The group of the network. Defaults to
LAN
. - site string
- The name of the site to associate the network with.
- subnet string
- The subnet of the network. Must be a valid CIDR address.
- vlan
Id number - The VLAN ID of the network.
- wan
Dhcp numberV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan
Dns string[] - DNS servers IPs of the WAN.
- wan
Egress numberQos - Specifies the WAN egress quality of service. Defaults to
0
. - wan
Gateway string - The IPv4 gateway of the WAN.
- wan
Gateway stringV6 - The IPv6 gateway of the WAN.
- wan
Ip string - The IPv4 address of the WAN.
- wan
Ipv6 string - The IPv6 address of the WAN.
- wan
Netmask string - The IPv4 netmask of the WAN.
- wan
Networkgroup string - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan
Prefixlen number - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan
Type string - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan
Type stringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan
Username string - Specifies the IPV4 WAN username.
- x
Wan stringPassword - Specifies the IPV4 WAN password.
- purpose str
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - dhcp_
dns Sequence[str] - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp_
enabled bool - Specifies whether DHCP is enabled or not on this network.
- dhcp_
lease int - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp_
relay_ boolenabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp_
start str - The IPv4 address where the DHCP range of addresses starts.
- dhcp_
stop str - The IPv4 address where the DHCP range of addresses stops.
- dhcp_
v6_ Sequence[str]dns - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp_
v6_ booldns_ auto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp_
v6_ boolenabled - Enable stateful DHCPv6 for static configuration.
- dhcp_
v6_ intlease - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp_
v6_ strstart - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp_
v6_ strstop - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd_
boot_ boolenabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd_
boot_ strfilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd_
boot_ strserver - Specifies the IPv4 address of a TFTP server to network boot from.
- domain_
name str - The domain name of this network.
- igmp_
snooping bool - Specifies whether IGMP snooping is enabled or not.
- internet_
access_ boolenabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra_
network_ boolaccess_ enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6_
interface_ strtype - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6_
pd_ strinterface - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6_
pd_ strprefixid - Specifies the IPv6 Prefix ID.
- ipv6_
pd_ strstart - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6_
pd_ strstop - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6_
ra_ boolenable - Specifies whether to enable router advertisements or not.
- ipv6_
ra_ intpreferred_ lifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6_
ra_ strpriority - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6_
ra_ intvalid_ lifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6_
static_ strsubnet - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name str
- The name of the network.
- network_
group str - The group of the network. Defaults to
LAN
. - site str
- The name of the site to associate the network with.
- subnet str
- The subnet of the network. Must be a valid CIDR address.
- vlan_
id int - The VLAN ID of the network.
- wan_
dhcp_ intv6_ pd_ size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan_
dns Sequence[str] - DNS servers IPs of the WAN.
- wan_
egress_ intqos - Specifies the WAN egress quality of service. Defaults to
0
. - wan_
gateway str - The IPv4 gateway of the WAN.
- wan_
gateway_ strv6 - The IPv6 gateway of the WAN.
- wan_
ip str - The IPv4 address of the WAN.
- wan_
ipv6 str - The IPv6 address of the WAN.
- wan_
netmask str - The IPv4 netmask of the WAN.
- wan_
networkgroup str - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan_
prefixlen int - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan_
type str - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan_
type_ strv6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan_
username str - Specifies the IPV4 WAN username.
- x_
wan_ strpassword - Specifies the IPV4 WAN password.
- purpose String
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - dhcp
Dns List<String> - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp
Enabled Boolean - Specifies whether DHCP is enabled or not on this network.
- dhcp
Lease Number - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp
Relay BooleanEnabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp
Start String - The IPv4 address where the DHCP range of addresses starts.
- dhcp
Stop String - The IPv4 address where the DHCP range of addresses stops.
- dhcp
V6Dns List<String> - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp
V6Dns BooleanAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp
V6Enabled Boolean - Enable stateful DHCPv6 for static configuration.
- dhcp
V6Lease Number - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp
V6Start String - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp
V6Stop String - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd
Boot BooleanEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd
Boot StringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd
Boot StringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- domain
Name String - The domain name of this network.
- igmp
Snooping Boolean - Specifies whether IGMP snooping is enabled or not.
- internet
Access BooleanEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra
Network BooleanAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6Interface
Type String - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6Pd
Interface String - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6Pd
Prefixid String - Specifies the IPv6 Prefix ID.
- ipv6Pd
Start String - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Pd
Stop String - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Ra
Enable Boolean - Specifies whether to enable router advertisements or not.
- ipv6Ra
Preferred NumberLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6Ra
Priority String - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6Ra
Valid NumberLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6Static
Subnet String - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name String
- The name of the network.
- network
Group String - The group of the network. Defaults to
LAN
. - site String
- The name of the site to associate the network with.
- subnet String
- The subnet of the network. Must be a valid CIDR address.
- vlan
Id Number - The VLAN ID of the network.
- wan
Dhcp NumberV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan
Dns List<String> - DNS servers IPs of the WAN.
- wan
Egress NumberQos - Specifies the WAN egress quality of service. Defaults to
0
. - wan
Gateway String - The IPv4 gateway of the WAN.
- wan
Gateway StringV6 - The IPv6 gateway of the WAN.
- wan
Ip String - The IPv4 address of the WAN.
- wan
Ipv6 String - The IPv6 address of the WAN.
- wan
Netmask String - The IPv4 netmask of the WAN.
- wan
Networkgroup String - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan
Prefixlen Number - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan
Type String - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan
Type StringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan
Username String - Specifies the IPV4 WAN username.
- x
Wan StringPassword - Specifies the IPV4 WAN password.
Outputs
All input properties are implicitly available as output properties. Additionally, the Network 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 Network Resource
Get an existing Network 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?: NetworkState, opts?: CustomResourceOptions): Network
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
dhcp_dns: Optional[Sequence[str]] = None,
dhcp_enabled: Optional[bool] = None,
dhcp_lease: Optional[int] = None,
dhcp_relay_enabled: Optional[bool] = None,
dhcp_start: Optional[str] = None,
dhcp_stop: Optional[str] = None,
dhcp_v6_dns: Optional[Sequence[str]] = None,
dhcp_v6_dns_auto: Optional[bool] = None,
dhcp_v6_enabled: Optional[bool] = None,
dhcp_v6_lease: Optional[int] = None,
dhcp_v6_start: Optional[str] = None,
dhcp_v6_stop: Optional[str] = None,
dhcpd_boot_enabled: Optional[bool] = None,
dhcpd_boot_filename: Optional[str] = None,
dhcpd_boot_server: Optional[str] = None,
domain_name: Optional[str] = None,
igmp_snooping: Optional[bool] = None,
internet_access_enabled: Optional[bool] = None,
intra_network_access_enabled: Optional[bool] = None,
ipv6_interface_type: Optional[str] = None,
ipv6_pd_interface: Optional[str] = None,
ipv6_pd_prefixid: Optional[str] = None,
ipv6_pd_start: Optional[str] = None,
ipv6_pd_stop: Optional[str] = None,
ipv6_ra_enable: Optional[bool] = None,
ipv6_ra_preferred_lifetime: Optional[int] = None,
ipv6_ra_priority: Optional[str] = None,
ipv6_ra_valid_lifetime: Optional[int] = None,
ipv6_static_subnet: Optional[str] = None,
name: Optional[str] = None,
network_group: Optional[str] = None,
purpose: Optional[str] = None,
site: Optional[str] = None,
subnet: Optional[str] = None,
vlan_id: Optional[int] = None,
wan_dhcp_v6_pd_size: Optional[int] = None,
wan_dns: Optional[Sequence[str]] = None,
wan_egress_qos: Optional[int] = None,
wan_gateway: Optional[str] = None,
wan_gateway_v6: Optional[str] = None,
wan_ip: Optional[str] = None,
wan_ipv6: Optional[str] = None,
wan_netmask: Optional[str] = None,
wan_networkgroup: Optional[str] = None,
wan_prefixlen: Optional[int] = None,
wan_type: Optional[str] = None,
wan_type_v6: Optional[str] = None,
wan_username: Optional[str] = None,
x_wan_password: Optional[str] = None) -> Network
func GetNetwork(ctx *Context, name string, id IDInput, state *NetworkState, opts ...ResourceOption) (*Network, error)
public static Network Get(string name, Input<string> id, NetworkState? state, CustomResourceOptions? opts = null)
public static Network get(String name, Output<String> id, NetworkState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- 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.
- Dhcp
Dns List<string> - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- Dhcp
Enabled bool - Specifies whether DHCP is enabled or not on this network.
- Dhcp
Lease int - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - Dhcp
Relay boolEnabled - Specifies whether DHCP relay is enabled or not on this network.
- Dhcp
Start string - The IPv4 address where the DHCP range of addresses starts.
- Dhcp
Stop string - The IPv4 address where the DHCP range of addresses stops.
- Dhcp
V6Dns List<string> - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - Dhcp
V6Dns boolAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - Dhcp
V6Enabled bool - Enable stateful DHCPv6 for static configuration.
- Dhcp
V6Lease int - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - Dhcp
V6Start string - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcp
V6Stop string - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcpd
Boot boolEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- Dhcpd
Boot stringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- Dhcpd
Boot stringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- Domain
Name string - The domain name of this network.
- Igmp
Snooping bool - Specifies whether IGMP snooping is enabled or not.
- Internet
Access boolEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - Intra
Network boolAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - Ipv6Interface
Type string - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - Ipv6Pd
Interface string - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - Ipv6Pd
Prefixid string - Specifies the IPv6 Prefix ID.
- Ipv6Pd
Start string - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Pd
Stop string - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Ra
Enable bool - Specifies whether to enable router advertisements or not.
- Ipv6Ra
Preferred intLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - Ipv6Ra
Priority string - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- Ipv6Ra
Valid intLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - Ipv6Static
Subnet string - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - Name string
- The name of the network.
- Network
Group string - The group of the network. Defaults to
LAN
. - Purpose string
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - Site string
- The name of the site to associate the network with.
- Subnet string
- The subnet of the network. Must be a valid CIDR address.
- Vlan
Id int - The VLAN ID of the network.
- Wan
Dhcp intV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- Wan
Dns List<string> - DNS servers IPs of the WAN.
- Wan
Egress intQos - Specifies the WAN egress quality of service. Defaults to
0
. - Wan
Gateway string - The IPv4 gateway of the WAN.
- Wan
Gateway stringV6 - The IPv6 gateway of the WAN.
- Wan
Ip string - The IPv4 address of the WAN.
- Wan
Ipv6 string - The IPv6 address of the WAN.
- Wan
Netmask string - The IPv4 netmask of the WAN.
- Wan
Networkgroup string - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - Wan
Prefixlen int - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- Wan
Type string - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - Wan
Type stringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - Wan
Username string - Specifies the IPV4 WAN username.
- XWan
Password string - Specifies the IPV4 WAN password.
- Dhcp
Dns []string - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- Dhcp
Enabled bool - Specifies whether DHCP is enabled or not on this network.
- Dhcp
Lease int - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - Dhcp
Relay boolEnabled - Specifies whether DHCP relay is enabled or not on this network.
- Dhcp
Start string - The IPv4 address where the DHCP range of addresses starts.
- Dhcp
Stop string - The IPv4 address where the DHCP range of addresses stops.
- Dhcp
V6Dns []string - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - Dhcp
V6Dns boolAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - Dhcp
V6Enabled bool - Enable stateful DHCPv6 for static configuration.
- Dhcp
V6Lease int - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - Dhcp
V6Start string - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcp
V6Stop string - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- Dhcpd
Boot boolEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- Dhcpd
Boot stringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- Dhcpd
Boot stringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- Domain
Name string - The domain name of this network.
- Igmp
Snooping bool - Specifies whether IGMP snooping is enabled or not.
- Internet
Access boolEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - Intra
Network boolAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - Ipv6Interface
Type string - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - Ipv6Pd
Interface string - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - Ipv6Pd
Prefixid string - Specifies the IPv6 Prefix ID.
- Ipv6Pd
Start string - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Pd
Stop string - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - Ipv6Ra
Enable bool - Specifies whether to enable router advertisements or not.
- Ipv6Ra
Preferred intLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - Ipv6Ra
Priority string - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- Ipv6Ra
Valid intLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - Ipv6Static
Subnet string - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - Name string
- The name of the network.
- Network
Group string - The group of the network. Defaults to
LAN
. - Purpose string
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - Site string
- The name of the site to associate the network with.
- Subnet string
- The subnet of the network. Must be a valid CIDR address.
- Vlan
Id int - The VLAN ID of the network.
- Wan
Dhcp intV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- Wan
Dns []string - DNS servers IPs of the WAN.
- Wan
Egress intQos - Specifies the WAN egress quality of service. Defaults to
0
. - Wan
Gateway string - The IPv4 gateway of the WAN.
- Wan
Gateway stringV6 - The IPv6 gateway of the WAN.
- Wan
Ip string - The IPv4 address of the WAN.
- Wan
Ipv6 string - The IPv6 address of the WAN.
- Wan
Netmask string - The IPv4 netmask of the WAN.
- Wan
Networkgroup string - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - Wan
Prefixlen int - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- Wan
Type string - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - Wan
Type stringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - Wan
Username string - Specifies the IPV4 WAN username.
- XWan
Password string - Specifies the IPV4 WAN password.
- dhcp
Dns List<String> - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp
Enabled Boolean - Specifies whether DHCP is enabled or not on this network.
- dhcp
Lease Integer - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp
Relay BooleanEnabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp
Start String - The IPv4 address where the DHCP range of addresses starts.
- dhcp
Stop String - The IPv4 address where the DHCP range of addresses stops.
- dhcp
V6Dns List<String> - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp
V6Dns BooleanAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp
V6Enabled Boolean - Enable stateful DHCPv6 for static configuration.
- dhcp
V6Lease Integer - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp
V6Start String - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp
V6Stop String - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd
Boot BooleanEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd
Boot StringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd
Boot StringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- domain
Name String - The domain name of this network.
- igmp
Snooping Boolean - Specifies whether IGMP snooping is enabled or not.
- internet
Access BooleanEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra
Network BooleanAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6Interface
Type String - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6Pd
Interface String - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6Pd
Prefixid String - Specifies the IPv6 Prefix ID.
- ipv6Pd
Start String - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Pd
Stop String - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Ra
Enable Boolean - Specifies whether to enable router advertisements or not.
- ipv6Ra
Preferred IntegerLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6Ra
Priority String - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6Ra
Valid IntegerLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6Static
Subnet String - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name String
- The name of the network.
- network
Group String - The group of the network. Defaults to
LAN
. - purpose String
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - site String
- The name of the site to associate the network with.
- subnet String
- The subnet of the network. Must be a valid CIDR address.
- vlan
Id Integer - The VLAN ID of the network.
- wan
Dhcp IntegerV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan
Dns List<String> - DNS servers IPs of the WAN.
- wan
Egress IntegerQos - Specifies the WAN egress quality of service. Defaults to
0
. - wan
Gateway String - The IPv4 gateway of the WAN.
- wan
Gateway StringV6 - The IPv6 gateway of the WAN.
- wan
Ip String - The IPv4 address of the WAN.
- wan
Ipv6 String - The IPv6 address of the WAN.
- wan
Netmask String - The IPv4 netmask of the WAN.
- wan
Networkgroup String - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan
Prefixlen Integer - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan
Type String - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan
Type StringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan
Username String - Specifies the IPV4 WAN username.
- x
Wan StringPassword - Specifies the IPV4 WAN password.
- dhcp
Dns string[] - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp
Enabled boolean - Specifies whether DHCP is enabled or not on this network.
- dhcp
Lease number - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp
Relay booleanEnabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp
Start string - The IPv4 address where the DHCP range of addresses starts.
- dhcp
Stop string - The IPv4 address where the DHCP range of addresses stops.
- dhcp
V6Dns string[] - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp
V6Dns booleanAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp
V6Enabled boolean - Enable stateful DHCPv6 for static configuration.
- dhcp
V6Lease number - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp
V6Start string - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp
V6Stop string - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd
Boot booleanEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd
Boot stringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd
Boot stringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- domain
Name string - The domain name of this network.
- igmp
Snooping boolean - Specifies whether IGMP snooping is enabled or not.
- internet
Access booleanEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra
Network booleanAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6Interface
Type string - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6Pd
Interface string - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6Pd
Prefixid string - Specifies the IPv6 Prefix ID.
- ipv6Pd
Start string - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Pd
Stop string - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Ra
Enable boolean - Specifies whether to enable router advertisements or not.
- ipv6Ra
Preferred numberLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6Ra
Priority string - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6Ra
Valid numberLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6Static
Subnet string - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name string
- The name of the network.
- network
Group string - The group of the network. Defaults to
LAN
. - purpose string
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - site string
- The name of the site to associate the network with.
- subnet string
- The subnet of the network. Must be a valid CIDR address.
- vlan
Id number - The VLAN ID of the network.
- wan
Dhcp numberV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan
Dns string[] - DNS servers IPs of the WAN.
- wan
Egress numberQos - Specifies the WAN egress quality of service. Defaults to
0
. - wan
Gateway string - The IPv4 gateway of the WAN.
- wan
Gateway stringV6 - The IPv6 gateway of the WAN.
- wan
Ip string - The IPv4 address of the WAN.
- wan
Ipv6 string - The IPv6 address of the WAN.
- wan
Netmask string - The IPv4 netmask of the WAN.
- wan
Networkgroup string - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan
Prefixlen number - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan
Type string - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan
Type stringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan
Username string - Specifies the IPV4 WAN username.
- x
Wan stringPassword - Specifies the IPV4 WAN password.
- dhcp_
dns Sequence[str] - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp_
enabled bool - Specifies whether DHCP is enabled or not on this network.
- dhcp_
lease int - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp_
relay_ boolenabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp_
start str - The IPv4 address where the DHCP range of addresses starts.
- dhcp_
stop str - The IPv4 address where the DHCP range of addresses stops.
- dhcp_
v6_ Sequence[str]dns - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp_
v6_ booldns_ auto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp_
v6_ boolenabled - Enable stateful DHCPv6 for static configuration.
- dhcp_
v6_ intlease - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp_
v6_ strstart - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp_
v6_ strstop - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd_
boot_ boolenabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd_
boot_ strfilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd_
boot_ strserver - Specifies the IPv4 address of a TFTP server to network boot from.
- domain_
name str - The domain name of this network.
- igmp_
snooping bool - Specifies whether IGMP snooping is enabled or not.
- internet_
access_ boolenabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra_
network_ boolaccess_ enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6_
interface_ strtype - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6_
pd_ strinterface - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6_
pd_ strprefixid - Specifies the IPv6 Prefix ID.
- ipv6_
pd_ strstart - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6_
pd_ strstop - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6_
ra_ boolenable - Specifies whether to enable router advertisements or not.
- ipv6_
ra_ intpreferred_ lifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6_
ra_ strpriority - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6_
ra_ intvalid_ lifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6_
static_ strsubnet - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name str
- The name of the network.
- network_
group str - The group of the network. Defaults to
LAN
. - purpose str
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - site str
- The name of the site to associate the network with.
- subnet str
- The subnet of the network. Must be a valid CIDR address.
- vlan_
id int - The VLAN ID of the network.
- wan_
dhcp_ intv6_ pd_ size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan_
dns Sequence[str] - DNS servers IPs of the WAN.
- wan_
egress_ intqos - Specifies the WAN egress quality of service. Defaults to
0
. - wan_
gateway str - The IPv4 gateway of the WAN.
- wan_
gateway_ strv6 - The IPv6 gateway of the WAN.
- wan_
ip str - The IPv4 address of the WAN.
- wan_
ipv6 str - The IPv6 address of the WAN.
- wan_
netmask str - The IPv4 netmask of the WAN.
- wan_
networkgroup str - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan_
prefixlen int - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan_
type str - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan_
type_ strv6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan_
username str - Specifies the IPV4 WAN username.
- x_
wan_ strpassword - Specifies the IPV4 WAN password.
- dhcp
Dns List<String> - Specifies the IPv4 addresses for the DNS server to be returned from the DHCP server. Leave blank to disable this feature.
- dhcp
Enabled Boolean - Specifies whether DHCP is enabled or not on this network.
- dhcp
Lease Number - Specifies the lease time for DHCP addresses in seconds. Defaults to
86400
. - dhcp
Relay BooleanEnabled - Specifies whether DHCP relay is enabled or not on this network.
- dhcp
Start String - The IPv4 address where the DHCP range of addresses starts.
- dhcp
Stop String - The IPv4 address where the DHCP range of addresses stops.
- dhcp
V6Dns List<String> - Specifies the IPv6 addresses for the DNS server to be returned from the DHCP server. Used if
dhcp_v6_dns_auto
is set tofalse
. - dhcp
V6Dns BooleanAuto - Specifies DNS source to propagate. If set
false
the entries indhcp_v6_dns
are used, the upstream entries otherwise Defaults totrue
. - dhcp
V6Enabled Boolean - Enable stateful DHCPv6 for static configuration.
- dhcp
V6Lease Number - Specifies the lease time for DHCPv6 addresses in seconds. Defaults to
86400
. - dhcp
V6Start String - Start address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcp
V6Stop String - End address of the DHCPv6 range. Used in static DHCPv6 configuration.
- dhcpd
Boot BooleanEnabled - Toggles on the DHCP boot options. Should be set to true when you want to have dhcpdbootfilename, and dhcpdbootserver to take effect.
- dhcpd
Boot StringFilename - Specifies the file to PXE boot from on the dhcpdbootserver.
- dhcpd
Boot StringServer - Specifies the IPv4 address of a TFTP server to network boot from.
- domain
Name String - The domain name of this network.
- igmp
Snooping Boolean - Specifies whether IGMP snooping is enabled or not.
- internet
Access BooleanEnabled - Specifies whether this network should be allowed to access the internet or not. Defaults to
true
. - intra
Network BooleanAccess Enabled - Specifies whether this network should be allowed to access other local networks or not. Defaults to
true
. - ipv6Interface
Type String - Specifies which type of IPv6 connection to use. Must be one of either
static
,pd
, ornone
. Defaults tonone
. - ipv6Pd
Interface String - Specifies which WAN interface to use for IPv6 PD. Must be one of either
wan
orwan2
. - ipv6Pd
Prefixid String - Specifies the IPv6 Prefix ID.
- ipv6Pd
Start String - Start address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Pd
Stop String - End address of the DHCPv6 range. Used if
ipv6_interface_type
is set topd
. - ipv6Ra
Enable Boolean - Specifies whether to enable router advertisements or not.
- ipv6Ra
Preferred NumberLifetime - Lifetime in which the address can be used. Address becomes deprecated afterwards. Must be lower than or equal to
ipv6_ra_valid_lifetime
Defaults to14400
. - ipv6Ra
Priority String - IPv6 router advertisement priority. Must be one of either
high
,medium
, orlow
- ipv6Ra
Valid NumberLifetime - Total lifetime in which the address can be used. Must be equal to or greater than
ipv6_ra_preferred_lifetime
. Defaults to86400
. - ipv6Static
Subnet String - Specifies the static IPv6 subnet when
ipv6_interface_type
is 'static'. - name String
- The name of the network.
- network
Group String - The group of the network. Defaults to
LAN
. - purpose String
- The purpose of the network. Must be one of
corporate
,guest
,wan
, orvlan-only
. - site String
- The name of the site to associate the network with.
- subnet String
- The subnet of the network. Must be a valid CIDR address.
- vlan
Id Number - The VLAN ID of the network.
- wan
Dhcp NumberV6Pd Size - Specifies the IPv6 prefix size to request from ISP. Must be between 48 and 64.
- wan
Dns List<String> - DNS servers IPs of the WAN.
- wan
Egress NumberQos - Specifies the WAN egress quality of service. Defaults to
0
. - wan
Gateway String - The IPv4 gateway of the WAN.
- wan
Gateway StringV6 - The IPv6 gateway of the WAN.
- wan
Ip String - The IPv4 address of the WAN.
- wan
Ipv6 String - The IPv6 address of the WAN.
- wan
Netmask String - The IPv4 netmask of the WAN.
- wan
Networkgroup String - Specifies the WAN network group. Must be one of either
WAN
,WAN2
orWAN_LTE_FAILOVER
. - wan
Prefixlen Number - The IPv6 prefix length of the WAN. Must be between 1 and 128.
- wan
Type String - Specifies the IPV4 WAN connection type. Must be one of either
disabled
,static
,dhcp
, orpppoe
. - wan
Type StringV6 - Specifies the IPV6 WAN connection type. Must be one of either
disabled
,static
, ordhcpv6
. - wan
Username String - Specifies the IPV4 WAN username.
- x
Wan StringPassword - Specifies the IPV4 WAN password.
Import
import from provider configured site
$ pulumi import unifi:index/network:Network mynetwork 5dc28e5e9106d105bdc87217
import from another site
$ pulumi import unifi:index/network:Network mynetwork bfa2l6i7:5dc28e5e9106d105bdc87217
import network by name
$ pulumi import unifi:index/network:Network mynetwork name=LAN
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- unifi pulumiverse/pulumi-unifi
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
unifi
Terraform Provider.