github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/dnsimple/r/record.html.markdown (about)

     1  ---
     2  layout: "dnsimple"
     3  page_title: "DNSimple: dnsimple_record"
     4  sidebar_current: "docs-dnsimple-resource-record"
     5  description: |-
     6    Provides a DNSimple record resource.
     7  ---
     8  
     9  # dnsimple\_record
    10  
    11  Provides a DNSimple record resource.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  # Add a record to the root domain
    17  resource "dnsimple_record" "foobar" {
    18    domain = "${var.dnsimple_domain}"
    19    name   = ""
    20    value  = "192.168.0.11"
    21    type   = "A"
    22    ttl    = 3600
    23  }
    24  ```
    25  
    26  ```hcl
    27  # Add a record to a sub-domain
    28  resource "dnsimple_record" "foobar" {
    29    domain = "${var.dnsimple_domain}"
    30    name   = "terraform"
    31    value  = "192.168.0.11"
    32    type   = "A"
    33    ttl    = 3600
    34  }
    35  ```
    36  
    37  ## Argument Reference
    38  
    39  The following arguments are supported:
    40  
    41  * `domain` - (Required) The domain to add the record to
    42  * `name` - (Required) The name of the record
    43  * `value` - (Required) The value of the record
    44  * `type` - (Required) The type of the record
    45  * `ttl` - (Optional) The TTL of the record
    46  * `priority` - (Optional) The priority of the record - only useful for some record types
    47  
    48  
    49  ## Attributes Reference
    50  
    51  The following attributes are exported:
    52  
    53  * `id` - The record ID
    54  * `name` - The name of the record
    55  * `value` - The value of the record
    56  * `type` - The type of the record
    57  * `ttl` - The TTL of the record
    58  * `priority` - The priority of the record
    59  * `domain_id` - The domain ID of the record
    60  * `hostname` - The FQDN of the record
    61  
    62  ## Import
    63  
    64  DNSimple resources can be imported using their domain name and numeric ID, e.g.
    65  
    66  ```
    67  $ terraform import dnsimple_record.resource_name example.com_1234
    68  ```
    69  
    70  The numeric ID can be found in the URL when editing a record on the dnsimple web dashboard.