Microsoft.Network privateDnsZones/MX

Definizione di risorsa Bicep

Il tipo di risorsa privateDnsZones/MX può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/privateDnsZones/MX, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Network/privateDnsZones/MX@2024-06-01' = {
  parent: resourceSymbolicName
  etag: 'string'
  name: 'string'
  properties: {
    aaaaRecords: [
      {
        ipv6Address: 'string'
      }
    ]
    aRecords: [
      {
        ipv4Address: 'string'
      }
    ]
    cnameRecord: {
      cname: 'string'
    }
    metadata: {
      {customized property}: 'string'
    }
    mxRecords: [
      {
        exchange: 'string'
        preference: int
      }
    ]
    ptrRecords: [
      {
        ptrdname: 'string'
      }
    ]
    soaRecord: {
      email: 'string'
      expireTime: int
      host: 'string'
      minimumTtl: int
      refreshTime: int
      retryTime: int
      serialNumber: int
    }
    srvRecords: [
      {
        port: int
        priority: int
        target: 'string'
        weight: int
      }
    ]
    ttl: int
    txtRecords: [
      {
        value: [
          'string'
        ]
      }
    ]
  }
}

Valori delle proprietà

Microsoft.Network/privateDnsZones/MX

Nome Descrizione Valore
etag ETag del set di record. corda
nome Nome della risorsa stringa (obbligatorio)
genitore In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre.

Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.		 Nome simbolico per la risorsa di tipo: privateDnsZones
proprietà Proprietà del set di record. RecordSetProperties

AaaaRecord

Nome Descrizione Valore
ipv6Address Indirizzo IPv6 di questo record AAAA. corda

ARecord

Nome Descrizione Valore
ipv4Address Indirizzo IPv4 del record A. corda

CnameRecord

Nome Descrizione Valore
cname (nome canonico) Nome canonico per questo record CNAME. corda

MxRecord

Nome Descrizione Valore
sostituzione Nome di dominio dell'host di posta per questo record MX. corda
preferenza Valore di preferenza per questo record MX. Int

PtrRecord

Nome Descrizione Valore
ptrdname Nome di dominio di destinazione PTR per questo record PTR. corda

RecordSetProperties

Nome Descrizione Valore
aaaaRecords Elenco di record AAAA nel set di record. AaaaRecord[]
aRecords Elenco di record A nel set di record. ARecord[]
cnameRecord Record CNAME nel set di record. CnameRecord
metadati Metadati collegati al set di record. RecordSetPropertiesMetadata
mxRecords Elenco di record MX nel set di record. MxRecord[]
ptrRecords Elenco di record PTR nel set di record. ptrRecord[]
soaRecord Record SOA nel set di record. SoaRecord
srvRecords Elenco di record SRV nel set di record. SrvRecord []
Ttl Durata (TTL) dei record nel set di record. Int
txtRecords Elenco di record TXT nel set di record. TxtRecord[]

RecordSetPropertiesMetadata

Nome Descrizione Valore

SoaRecord

Nome Descrizione Valore
E-mail Contatto di posta elettronica per questo record SOA. corda
expireTime Ora di scadenza per questo record SOA. Int
ospite Nome di dominio del server dei nomi autorevole per questo record SOA. corda
minimumTtl Valore minimo per questo record SOA. Per convenzione, questa operazione viene utilizzata per determinare la durata negativa della memorizzazione nella cache. Int
refreshTime Valore di aggiornamento per questo record SOA. Int
retryTime Tempo di ripetizione dei tentativi per questo record SOA. Int
numero di serie Numero di serie per questo record SOA. Int

SrvRecord

Nome Descrizione Valore
porto Valore della porta per questo record SRV. Int
priorità Valore di priorità per questo record SRV. Int
bersaglio Nome di dominio di destinazione per questo record SRV. corda
peso Valore di peso per questo record SRV. Int

TxtRecord

Nome Descrizione Valore
valore Valore di testo del record TXT. string[]

Esempi di utilizzo

Esempi bicep

Un esempio di base di distribuzione di Private DNS Zones MX.

param resourceName string = 'acctest0001'

resource privateDnsZone 'Microsoft.Network/privateDnsZones@2018-09-01' = {
  name: '${resourceName}.com'
  location: 'global'
}

resource mx 'Microsoft.Network/privateDnsZones/MX@2018-09-01' = {
  parent: privateDnsZone
  name: resourceName
  properties: {
    metadata: {}
    mxRecords: [
      {
        exchange: 'mx1.contoso.com'
        preference: 10
      }
      {
        exchange: 'mx2.contoso.com'
        preference: 10
      }
    ]
    ttl: 300
  }
}

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa privateDnsZones/MX può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/privateDnsZones/MX, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Network/privateDnsZones/MX",
  "apiVersion": "2024-06-01",
  "name": "string",
  "etag": "string",
  "properties": {
    "aaaaRecords": [
      {
        "ipv6Address": "string"
      }
    ],
    "aRecords": [
      {
        "ipv4Address": "string"
      }
    ],
    "cnameRecord": {
      "cname": "string"
    },
    "metadata": {
      "{customized property}": "string"
    },
    "mxRecords": [
      {
        "exchange": "string",
        "preference": "int"
      }
    ],
    "ptrRecords": [
      {
        "ptrdname": "string"
      }
    ],
    "soaRecord": {
      "email": "string",
      "expireTime": "int",
      "host": "string",
      "minimumTtl": "int",
      "refreshTime": "int",
      "retryTime": "int",
      "serialNumber": "int"
    },
    "srvRecords": [
      {
        "port": "int",
        "priority": "int",
        "target": "string",
        "weight": "int"
      }
    ],
    "ttl": "int",
    "txtRecords": [
      {
        "value": [ "string" ]
      }
    ]
  }
}

Valori delle proprietà

Microsoft.Network/privateDnsZones/MX

Nome Descrizione Valore
apiVersion Versione dell'API '2024-06-01'
etag ETag del set di record. corda
nome Nome della risorsa stringa (obbligatorio)
proprietà Proprietà del set di record. RecordSetProperties
digitare Tipo di risorsa 'Microsoft.Network/privateDnsZones/MX'

AaaaRecord

Nome Descrizione Valore
ipv6Address Indirizzo IPv6 di questo record AAAA. corda

ARecord

Nome Descrizione Valore
ipv4Address Indirizzo IPv4 del record A. corda

CnameRecord

Nome Descrizione Valore
cname (nome canonico) Nome canonico per questo record CNAME. corda

MxRecord

Nome Descrizione Valore
sostituzione Nome di dominio dell'host di posta per questo record MX. corda
preferenza Valore di preferenza per questo record MX. Int

PtrRecord

Nome Descrizione Valore
ptrdname Nome di dominio di destinazione PTR per questo record PTR. corda

RecordSetProperties

Nome Descrizione Valore
aaaaRecords Elenco di record AAAA nel set di record. AaaaRecord[]
aRecords Elenco di record A nel set di record. ARecord[]
cnameRecord Record CNAME nel set di record. CnameRecord
metadati Metadati collegati al set di record. RecordSetPropertiesMetadata
mxRecords Elenco di record MX nel set di record. MxRecord[]
ptrRecords Elenco di record PTR nel set di record. ptrRecord[]
soaRecord Record SOA nel set di record. SoaRecord
srvRecords Elenco di record SRV nel set di record. SrvRecord []
Ttl Durata (TTL) dei record nel set di record. Int
txtRecords Elenco di record TXT nel set di record. TxtRecord[]

RecordSetPropertiesMetadata

Nome Descrizione Valore

SoaRecord

Nome Descrizione Valore
E-mail Contatto di posta elettronica per questo record SOA. corda
expireTime Ora di scadenza per questo record SOA. Int
ospite Nome di dominio del server dei nomi autorevole per questo record SOA. corda
minimumTtl Valore minimo per questo record SOA. Per convenzione, questa operazione viene utilizzata per determinare la durata negativa della memorizzazione nella cache. Int
refreshTime Valore di aggiornamento per questo record SOA. Int
retryTime Tempo di ripetizione dei tentativi per questo record SOA. Int
numero di serie Numero di serie per questo record SOA. Int

SrvRecord

Nome Descrizione Valore
porto Valore della porta per questo record SRV. Int
priorità Valore di priorità per questo record SRV. Int
bersaglio Nome di dominio di destinazione per questo record SRV. corda
peso Valore di peso per questo record SRV. Int

TxtRecord

Nome Descrizione Valore
valore Valore di testo del record TXT. string[]

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa privateDnsZones/MX può essere distribuito con operazioni destinate a:

  • Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/privateDnsZones/MX, aggiungere il comando Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/privateDnsZones/MX@2024-06-01"
  name = "string"
  parent_id = "string"
  body = {
    etag = "string"
    properties = {
      aaaaRecords = [
        {
          ipv6Address = "string"
        }
      ]
      aRecords = [
        {
          ipv4Address = "string"
        }
      ]
      cnameRecord = {
        cname = "string"
      }
      metadata = {
        {customized property} = "string"
      }
      mxRecords = [
        {
          exchange = "string"
          preference = int
        }
      ]
      ptrRecords = [
        {
          ptrdname = "string"
        }
      ]
      soaRecord = {
        email = "string"
        expireTime = int
        host = "string"
        minimumTtl = int
        refreshTime = int
        retryTime = int
        serialNumber = int
      }
      srvRecords = [
        {
          port = int
          priority = int
          target = "string"
          weight = int
        }
      ]
      ttl = int
      txtRecords = [
        {
          value = [
            "string"
          ]
        }
      ]
    }
  }
}

Valori delle proprietà

Microsoft.Network/privateDnsZones/MX

Nome Descrizione Valore
etag ETag del set di record. corda
nome Nome della risorsa stringa (obbligatorio)
parent_id ID della risorsa padre per questa risorsa. ID per la risorsa di tipo: privateDnsZones
proprietà Proprietà del set di record. RecordSetProperties
digitare Tipo di risorsa "Microsoft.Network/privateDnsZones/MX@2024-06-01"

AaaaRecord

Nome Descrizione Valore
ipv6Address Indirizzo IPv6 di questo record AAAA. corda

ARecord

Nome Descrizione Valore
ipv4Address Indirizzo IPv4 del record A. corda

CnameRecord

Nome Descrizione Valore
cname (nome canonico) Nome canonico per questo record CNAME. corda

MxRecord

Nome Descrizione Valore
sostituzione Nome di dominio dell'host di posta per questo record MX. corda
preferenza Valore di preferenza per questo record MX. Int

PtrRecord

Nome Descrizione Valore
ptrdname Nome di dominio di destinazione PTR per questo record PTR. corda

RecordSetProperties

Nome Descrizione Valore
aaaaRecords Elenco di record AAAA nel set di record. AaaaRecord[]
aRecords Elenco di record A nel set di record. ARecord[]
cnameRecord Record CNAME nel set di record. CnameRecord
metadati Metadati collegati al set di record. RecordSetPropertiesMetadata
mxRecords Elenco di record MX nel set di record. MxRecord[]
ptrRecords Elenco di record PTR nel set di record. ptrRecord[]
soaRecord Record SOA nel set di record. SoaRecord
srvRecords Elenco di record SRV nel set di record. SrvRecord []
Ttl Durata (TTL) dei record nel set di record. Int
txtRecords Elenco di record TXT nel set di record. TxtRecord[]

RecordSetPropertiesMetadata

Nome Descrizione Valore

SoaRecord

Nome Descrizione Valore
E-mail Contatto di posta elettronica per questo record SOA. corda
expireTime Ora di scadenza per questo record SOA. Int
ospite Nome di dominio del server dei nomi autorevole per questo record SOA. corda
minimumTtl Valore minimo per questo record SOA. Per convenzione, questa operazione viene utilizzata per determinare la durata negativa della memorizzazione nella cache. Int
refreshTime Valore di aggiornamento per questo record SOA. Int
retryTime Tempo di ripetizione dei tentativi per questo record SOA. Int
numero di serie Numero di serie per questo record SOA. Int

SrvRecord

Nome Descrizione Valore
porto Valore della porta per questo record SRV. Int
priorità Valore di priorità per questo record SRV. Int
bersaglio Nome di dominio di destinazione per questo record SRV. corda
peso Valore di peso per questo record SRV. Int

TxtRecord

Nome Descrizione Valore
valore Valore di testo del record TXT. string[]

Esempi di utilizzo

Esempi di Terraform

Un esempio di base di distribuzione di Private DNS Zones MX.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "privateDnsZone" {
  type                      = "Microsoft.Network/privateDnsZones@2018-09-01"
  parent_id                 = azapi_resource.resourceGroup.id
  name                      = "${var.resource_name}.com"
  location                  = "global"
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "MX" {
  type      = "Microsoft.Network/privateDnsZones/MX@2018-09-01"
  parent_id = azapi_resource.privateDnsZone.id
  name      = var.resource_name
  body = {
    properties = {
      metadata = {
      }
      mxRecords = [
        {
          exchange   = "mx1.contoso.com"
          preference = 10
        },
        {
          exchange   = "mx2.contoso.com"
          preference = 10
        },
      ]
      ttl = 300
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}
  • Last updated on