Files
terraform-provider-unifi/docs/data-sources/network.md
2021-09-09 08:33:47 -04:00

3.1 KiB

page_title, subcategory, description
page_title subcategory description
unifi_network Data Source - terraform-provider-unifi unifi_network data source can be used to retrieve settings for a network by name or ID.

unifi_network (Data Source)

unifi_network data source can be used to retrieve settings for a network by name or ID.

Example Usage

#retrieve network data by unifi network name
data "unifi_network" "lan_network" {
  name = "LAN"
}

#retrieve network data from user record
data "unifi_user" "my_device" {
  mac = "01:23:45:67:89:ab"
}
data "unifi_network" "my_network" {
  id = data.unifi_user.my_device.network_id
}

Schema

Optional

  • id (String) The ID of the network.
  • name (String) The name of the network.
  • site (String) The name of the site to associate the network with.

Read-Only

  • dhcp_dns (List of String) IPv4 addresses for the DNS server to be returned from the DHCP server.
  • dhcp_enabled (Boolean) whether DHCP is enabled or not on this network.
  • dhcp_lease (Number) lease time for DHCP addresses.
  • 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.
  • dhcpd_boot_enabled (Boolean) Toggles on the DHCP boot options. will be set to true if you have dhcpd_boot_filename, and dhcpd_boot_server set.
  • dhcpd_boot_filename (String) the file to PXE boot from on the dhcpd_boot_server.
  • dhcpd_boot_server (String) 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.
  • ipv6_interface_type (String) Specifies which type of IPv6 connection to use.
  • ipv6_pd_interface (String) Specifies which WAN interface is used for IPv6 Prefix Delegation.
  • ipv6_pd_prefixid (String) Specifies the IPv6 Prefix ID.
  • ipv6_ra_enable (Boolean) Specifies whether to enable router advertisements or not.
  • ipv6_static_subnet (String) Specifies the static IPv6 subnet (when ipv6_interface_type is 'static').
  • network_group (String) The group of the network.
  • purpose (String) The purpose of the network. One of corporate, guest, wan, or vlan-only.
  • subnet (String) The subnet of the network (CIDR address).
  • vlan_id (Number) The VLAN ID of the network.
  • wan_dns (List of String) DNS servers IPs of the WAN.
  • wan_egress_qos (Number) Specifies the WAN egress quality of service.
  • wan_gateway (String) The IPv4 gateway of the WAN.
  • wan_ip (String) The IPv4 address of the WAN.
  • wan_netmask (String) The IPv4 netmask of the WAN.
  • wan_networkgroup (String) Specifies the WAN network group. One of either WAN, WAN2 or WAN_LTE_FAILOVER.
  • wan_type (String) Specifies the IPV4 WAN connection type. One of either disabled, static, dhcp, or pppoe.
  • wan_username (String) Specifies the IPV4 WAN username.
  • x_wan_password (String) Specifies the IPV4 WAN password.