---
layout: "vcd"
page_title: "vCloudDirector: vcd_network"
sidebar_current: "docs-vcd-resource-network"
description: |-
  Provides a vCloud Director VDC Network. This can be used to create, modify, and delete internal networks for vApps to connect.
---

# vcd\_network

Provides a vCloud Director VDC Network. This can be used to create,
modify, and delete internal networks for vApps to connect.

## Example Usage

```
resource "vcd_network" "net" {
	name = "my-net"
	edge_gateway = "Edge Gateway Name"
	gateway = "10.10.0.1"

	dhcp_pool {
		start_address = "10.10.0.2"
		end_address = "10.10.0.100"
	}

	static_ip_pool {
		start_address = "10.10.0.152"
		end_address = "10.10.0.254"
	}

}
```

## Argument Reference

The following arguments are supported:

* `name` - (Required) A unique name for the network
* `edge_gateway` - (Required) The name of the edge gateway
* `netmask` - (Optional) The netmask for the new network. Defaults to `255.255.255.0`
* `gateway` (Required) The gateway for this network
* `dns1` - (Optional) First DNS server to use. Defaults to `8.8.8.8`
* `dns2` - (Optional) Second DNS server to use. Defaults to `8.8.4.4`
* `dns_suffix` - (Optional) A FQDN for the virtual machines on this network
* `dhcp_pool` - (Optional) A range of IPs to issue to virtual machines that don't
  have a static IP; see [IP Pools](#ip-pools) below for details.
* `static_ip_pool` - (Optional) A range of IPs permitted to be used as static IPs for
  virtual machines; see [IP Pools](#ip-pools) below for details.

<a id="ip-pools"></a>
## IP Pools

Network interfaces support the following attributes:

* `start_address` - (Required) The first address in the IP Range
* `end_address` - (Required) The final address in the IP Range