github.com/armen/terraform@v0.5.2-0.20150529052519-caa8117a08f1/website/source/docs/providers/aws/r/vpc_dhcp_options.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_vpc_dhcp_options"
     4  sidebar_current: "docs-aws-resource-vpc-dhcp-options"
     5  description: |-
     6    Provides a VPC DHCP Options resource.
     7  ---
     8  
     9  # aws\_vpc\_dhcp\_options
    10  
    11  Provides a VPC DHCP Options resource.
    12  
    13  ## Example Usage
    14  
    15  Basic usage:
    16  
    17  ```
    18  resource "aws_vpc_dhcp_options" "dns_resolver" {
    19  	domain_name_servers = ["8.8.8.8", "8.8.4.4"]
    20  }
    21  ```
    22  
    23  Full usage:
    24  
    25  ```
    26  resource "aws_vpc_dhcp_options" "foo" {
    27  	domain_name = "service.consul"
    28  	domain_name_servers = ["127.0.0.1", "10.0.0.2"]
    29  	ntp_servers = ["127.0.0.1"]
    30  	netbios_name_servers = ["127.0.0.1"]
    31  	netbios_node_type = 2
    32  
    33  	tags {
    34  		Name = "foo-name"
    35  	}
    36  }
    37  ```
    38  
    39  ## Argument Reference
    40  
    41  The following arguments are supported:
    42  
    43  * `domain_name` - (Optional) the suffix domain name to use by default when resolving non Fully Qualified Domain Names. In other words, this is what ends up being the `search` value in the `/etc/resolv.conf` file.
    44  * `domain_name_servers` - (Optional) List of name servers to configure in `/etc/resolv.conf`.
    45  * `ntp_servers` - (Optional) List of NTP servers to configure.
    46  * `netbios_name_servers` - (Optional) List of NETBIOS name servers.
    47  * `netbios_node_type` - (Optional) The NetBIOS node type (1, 2, 4, or 8). AWS recommends to specify 2 since broadcast and multicast are not supported in their network. For more information about these node types, see [RFC 2132](http://www.ietf.org/rfc/rfc2132.txt).
    48  * `tags` - (Optional) A mapping of tags to assign to the resource.
    49  
    50  ## Remarks
    51  * Notice that all arguments are optional but you have to specify at least one argument.
    52  * `domain_name_servers`, `netbios_name_servers`, `ntp_servers` are limited by AWS to maximum four servers only.
    53  * To actually use the DHCP Options Set you need to associate it to a VPC using [`aws_vpc_dhcp_options_association`](/docs/providers/aws/r/vpc_dhcp_options_association.html).
    54  * If you delete a DHCP Options Set, all VPCs using it will be associated to AWS's `default` DHCP Option Set.
    55  
    56  ## Attributes Reference
    57  
    58  The following attributes are exported:
    59  
    60  * `id` - The ID of the DHCP Options Set.
    61  
    62  ## Known Issues
    63  * https://github.com/awslabs/aws-sdk-go/issues/210
    64  
    65  You can find more technical documentation about DHCP Options Set in the
    66  official [AWS User Guide](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_DHCP_Options.html).