github.com/koding/terraform@v0.6.4-0.20170608090606-5d7e0339779d/website/source/docs/providers/aws/r/default_vpc_dhcp_options.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_default_vpc_dhcp_options"
     4  sidebar_current: "docs-aws-resource-default-vpc-dhcp-options"
     5  description: |-
     6    Manage the default VPC DHCP Options resource.
     7  ---
     8  
     9  #  aws\_default\_vpc\_dhcp\_options
    10  
    11  Provides a resource to manage the [default AWS DHCP Options Set](http://docs.aws.amazon.com/AmazonVPC/latest/UserGuide/VPC_DHCP_Options.html#AmazonDNS)
    12  in the current region.
    13  
    14  Each AWS region comes with a default set of DHCP options.
    15  **This is an advanced resource**, and has special caveats to be aware of when
    16  using it. Please read this document in its entirety before using this resource.
    17  
    18  The `aws_default_vpc_dhcp_options` behaves differently from normal resources, in that
    19  Terraform does not _create_ this resource, but instead "adopts" it
    20  into management. 
    21  
    22  ## Example Usage
    23  
    24  Basic usage with tags:
    25  
    26  ```
    27  resource "aws_default_vpc_dhcp_options" "default" {
    28  	tags {
    29  		Name = "Default DHCP Option Set"
    30  	}
    31  }
    32  ```
    33  
    34  ## Argument Reference
    35  
    36  The arguments of an `aws_default_vpc_dhcp_options` differ slightly from `aws_vpc_dhcp_options`  resources.
    37  Namely, the `domain_name`, `domain_name_servers` and `ntp_servers` arguments are computed.
    38  The following arguments are still supported: 
    39  
    40  * `netbios_name_servers` - (Optional) List of NETBIOS name servers.
    41  * `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).
    42  * `tags` - (Optional) A mapping of tags to assign to the resource.
    43  
    44  ### Removing `aws_default_vpc_dhcp_options` from your configuration
    45  
    46  The `aws_default_vpc_dhcp_options` resource allows you to manage a region's default DHCP Options Set,
    47  but Terraform cannot destroy it. Removing this resource from your configuration
    48  will remove it from your statefile and management, but will not destroy the DHCP Options Set.
    49  You can resume managing the DHCP Options Set via the AWS Console.
    50  
    51  ## Attributes Reference
    52  
    53  The following attributes are exported:
    54  
    55  * `id` - The ID of the DHCP Options Set.