Azure DNS MX Record

This page shows how to write Terraform and Azure Resource Manager for DNS MX Record and write them securely.

azurerm_dns_mx_record (Terraform)

The MX Record in DNS can be configured in Terraform with the resource name azurerm_dns_mx_record. The following sections describe 10 examples of how to use the resource and its parameters.

Example Usage from GitHub

dns_mx_record_test.tf#L15
resource "azurerm_dns_mx_record" "over1B" {
  name                = "test"
  zone_name           = azurerm_dns_zone.example.name
  resource_group_name = azurerm_resource_group.example.name
  ttl                 = 300

mx_record.tf#L22
resource "azurerm_dns_mx_record" "mx_record_public_with_zone" {
  count               = var.create_dns_zone ? (var.public_dns_zone ? 1 : 0) : 0

  zone_name           = var.zone_name
  resource_group_name = var.resource_group_name

resource_dns_mx_record.tf#L1
resource "azurerm_dns_mx_record" "dns_mx_record" {
  zone_name           = azurerm_dns_zone.dns_zone.name
  resource_group_name = azurerm_resource_group.resource_group.name
  ttl                 = var.default_ttl

  record {
dns_mx_record_test.tf#L15
resource "azurerm_dns_mx_record" "over1B" {
  name                = "test"
  zone_name           = azurerm_dns_zone.example.name
  resource_group_name = azurerm_resource_group.example.name
  ttl                 = 300

mx_record.tf#L1
resource "azurerm_dns_mx_record" "this" {
  for_each = { for record in var.mx_recordsets :
    record.name => record
  }

  resource_group_name = lower(lower(var.resource_group_name))
record_mx.tf#L1
resource "azurerm_dns_mx_record" "mx" {
  for_each = try(var.records.mx, {})

  name                = each.value.name
  zone_name           = var.zone_name
  resource_group_name = var.resource_group_name
record_mx.tf#L1
resource "azurerm_dns_mx_record" "mx" {
  for_each = try(var.records.mx, {})

  name                = each.value.name
  zone_name           = var.zone_name
  resource_group_name = var.resource_group_name
dns_reifnir.tf#L13
resource "azurerm_dns_mx_record" "google_apps" {
  zone_name           = azurerm_dns_zone.reifnir_com.name
  resource_group_name = azurerm_resource_group.dns.name
  ttl                 = 60

  record {
main.tf#L2
resource "azurerm_dns_mx_record" "DNSMXRecord" {

# references: https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/dns_mx_record

  name                  = var.dns_mx_record_name
  zone_name             = var.dns_zone_name
record_mx.tf#L1
resource "azurerm_dns_mx_record" "mx" {
  for_each = try(var.records.mx, {})

  name                = each.value.name
  zone_name           = var.zone_name
  resource_group_name = var.resource_group_name

Review your Terraform file for Azure best practices

Shisho Cloud, our free checker to make sure your Terraform configuration follows best practices, is available (beta).

Parameters

Explanation in Terraform Registry

Enables you to manage DNS MX Records within Azure DNS.

Microsoft.Network/dnszones/MX (Azure Resource Manager)

The dnszones/MX in Microsoft.Network can be configured in Azure Resource Manager with the resource name Microsoft.Network/dnszones/MX. The following sections describe how to use the resource and its parameters.

Example Usage from GitHub

MXRecords.json#L16
            "type": "Microsoft.Network/dnszones/MX",
            "name": "[concat(parameters('DNSObj').dnsZoneName, '/', parameters('DNSObj').MXRecords[copyIndex()].name)]",
            "apiVersion": "2018-05-01",
            "copy": {
                "name": "obj",
                "count": "[length(parameters('DNSObj').MXRecords)]"
MXRecords.json#L16
            "type": "Microsoft.Network/dnszones/MX",
            "name": "[concat(parameters('DNSObj').dnsZoneName, '/', parameters('DNSObj').MXRecords[copyIndex()].name)]",
            "apiVersion": "2018-05-01",
            "copy": {
                "name": "obj",
                "count": "[length(parameters('DNSObj').MXRecords)]"
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [
mail.json#L45
        "type": "Microsoft.Network/dnszones/MX",
        "name": "[concat(parameters('dnsZoneName'),'/','@')]",
        "apiVersion": "2016-04-01",
        "properties": {
            "TTL": "[parameters('ttl')]",
            "MXRecords": [{
mail.json#L48
      "type": "Microsoft.Network/dnszones/MX",
      "name": "[concat(parameters('dnsZoneName'),'/','@')]",
      "apiVersion": "2016-04-01",
      "properties": {
        "TTL": "[parameters('ttl')]",
        "MXRecords": [

Frequently asked questions

What is Azure DNS MX Record?

Azure DNS MX Record is a resource for DNS of Microsoft Azure. Settings can be wrote in Terraform.

Where can I find the example code for the Azure DNS MX Record?

For Terraform, the gilyas/infracost, scalair/terraform-azurerm-dns and cbchalmers/Azure-SaaS-DNS-Public-Zone-M365-Records source code examples are useful. See the Terraform Example section for further details.

For Azure Resource Manager, the canada-ca/accelerators_accelerateurs-azure, canada-ca/accelerators_accelerateurs-azure and RTmtfiallos/ABCDS-AKS-NAT-AGIC source code examples are useful. See the Azure Resource Manager Example section for further details.