github.com/nevins-b/terraform@v0.3.8-0.20170215184714-bbae22007d5a/website/source/docs/providers/ns1/r/record.html.markdown (about)

     1  ---
     2  layout: "ns1"
     3  page_title: "NS1: ns1_record"
     4  sidebar_current: "docs-ns1-resource-record"
     5  description: |-
     6    Provides a NS1 Record resource.
     7  ---
     8  
     9  # ns1\_record
    10  
    11  Provides a NS1 Record resource. This can be used to create, modify, and delete records.
    12  
    13  ## Example Usage
    14  
    15  ```
    16  resource "ns1_zone" "tld" {
    17    zone = "terraform.example"
    18  }
    19  
    20  resource "ns1_record" "www" {
    21    zone = "${ns1_zone.tld.id}"
    22    domain = "www.${ns1_zone.tld.zone}"
    23    type = "CNAME"
    24    ttl = 60
    25  
    26    answers = {
    27      answer = ["sub1.${ns1_zone.tld.zone}"]
    28    }
    29    answer = {
    30      answer = ["sub2.${ns1_zone.tld.zone}"]
    31    }
    32  
    33    filters = {
    34      filter = "select_first_n"
    35      config = {N=1}
    36    }
    37  }
    38  ```
    39  
    40  ## Argument Reference
    41  
    42  The following arguments are supported:
    43  
    44  * `zone` - (Required) The zone the record belongs to.
    45  * `domain` - (Required) The records' domain.
    46  * `type` - (Required) The records' RR type.
    47  * `ttl` - (Optional) The records' time to live.
    48  * `link` - (Optional) The target record to link to. This means this record is a 'linked' record, and it inherits all properties from its target.
    49  * `use_client_subnet` - (Optional) Whether to use EDNS client subnet data when available(in filter chain).
    50  * `answers` - (Optional) The list of the RDATA fields for the records' specified type. Answers are documented below. 
    51  * `filters` - (Optional) The list of NS1 filters for the record(order matters). Filters are documented below.
    52  
    53  Answers (`answers`) support the following:
    54  
    55  * `answer` - (Required) List of RDATA fields.
    56  * `region` - (Required) The region this answer belongs to.
    57  
    58  Filters (`filters`) support the following:
    59  
    60  * `filter` - (Required) The type of filter.
    61  * `disabled` - (Required) Determines whether the filter is applied in the filter chain.
    62  * `config` - (Required) The filters' configuration. Simple key/value pairs determined by the filter type.