Enables you to manage DNS MX Records within Azure DNS.
resource "azurerm_resource_group" "example" {
name = "example-resources"
location = "West Europe"
}
resource "azurerm_dns_zone" "example" {
name = "mydomain.com"
resource_group_name = azurerm_resource_group.example.name
}
resource "azurerm_dns_mx_record" "example" {
name = "test"
zone_name = azurerm_dns_zone.example.name
resource_group_name = azurerm_resource_group.example.name
ttl = 300
record {
preference = 10
exchange = "mail1.contoso.com"
}
record {
preference = 20
exchange = "mail2.contoso.com"
}
tags = {
Environment = "Production"
}
}
The following arguments are supported:
name
- (Optional) The name of the DNS MX Record. Defaults to @
(root). Changing this forces a new resource to be created.
resource_group_name
- (Required) Specifies the resource group where the DNS Zone (parent resource) exists. Changing this forces a new resource to be created.
zone_name
- (Required) Specifies the DNS Zone where the resource exists. Changing this forces a new resource to be created.
ttl
- (Required) The Time To Live (TTL) of the DNS record in seconds.
record
- (Required) A list of values that make up the MX record. Each record
block supports fields documented below.
tags
- (Optional) A mapping of tags to assign to the resource.
The record
block supports:
preference
- (Required) String representing the "preferenceā value of the MX records. Records with lower preference value take priority.
exchange
- (Required) The mail server responsible for the domain covered by the MX record.
In addition to the Arguments listed above - the following Attributes are exported:
id
- The DNS MX Record ID.
fqdn
- The FQDN of the DNS MX Record.
The timeouts
block allows you to specify timeouts for certain actions:
create
- (Defaults to 30 minutes) Used when creating the DNS MX Record.
update
- (Defaults to 30 minutes) Used when updating the DNS MX Record.
read
- (Defaults to 5 minutes) Used when retrieving the DNS MX Record.
delete
- (Defaults to 30 minutes) Used when deleting the DNS MX Record.
MX records can be imported using the resource id
, e.g.
terraform import azurerm_dns_mx_record.example /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/mygroup1/providers/Microsoft.Network/dnsZones/zone1/MX/myrecord1