github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/azurerm/r/dns_zone.html.markdown (about)

     1  ---
     2  layout: "azurerm"
     3  page_title: "Azure Resource Manager: azurerm_dns_zone"
     4  sidebar_current: "docs-azurerm-resource-dns-zone"
     5  description: |-
     6    Create a DNS Zone.
     7  ---
     8  
     9  # azurerm\_dns\_zone
    10  
    11  Enables you to manage DNS zones within Azure DNS. These zones are hosted on Azure's name servers to which you can delegate the zone from the parent domain.
    12  
    13  ## Example Usage
    14  
    15  ```hcl
    16  resource "azurerm_resource_group" "test" {
    17    name     = "acceptanceTestResourceGroup1"
    18    location = "West US"
    19  }
    20  
    21  resource "azurerm_dns_zone" "test" {
    22    name                = "mydomain.com"
    23    resource_group_name = "${azurerm_resource_group.test.name}"
    24  }
    25  ```
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `name` - (Required) The name of the DNS Zone. Must be a valid domain name.
    31  
    32  * `resource_group_name` - (Required) Specifies the resource group where the resource exists. Changing this forces a new resource to be created.
    33  
    34  * `tags` - (Optional) A mapping of tags to assign to the resource.
    35  
    36  ## Attributes Reference
    37  
    38  The following attributes are exported:
    39  
    40  * `id` - The DNS Zone ID.
    41  * `max_number_of_record_sets` - (Optional) Maximum number of Records in the zone. Defaults to `1000`.
    42  * `number_of_record_sets` - (Optional) The number of records already in the zone.
    43  * `name_servers` - (Optional) A list of values that make up the NS record for the zone.
    44  
    45  
    46  ## Import
    47  
    48  DNS Zones can be imported using the `resource id`, e.g.
    49  
    50  ```
    51  terraform import azurerm_dns_zone.zone1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/dnsZones/zone1
    52  ```