Definicja zasobu Bicep
Typ zasobu privateDnsZones/TXT można wdrożyć przy użyciu operacji docelowych:
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Przykłady użycia
Przykłady Bicep
Podstawowy przykład wdrażania prywatnego rekordu TXT DNS.
param location string = 'westeurope'
param resourceName string = 'acctest0001'
resource privateDnsZone 'Microsoft.Network/privateDnsZones@2018-09-01' = {
name: '${resourceName}.com'
location: 'global'
}
resource tXT 'Microsoft.Network/privateDnsZones/TXT@2018-09-01' = {
name: resourceName
parent: privateDnsZone
properties: {
metadata: {}
ttl: 300
txtRecords: [
{
value: [
'Quick brown fox'
]
}
{
value: [
'A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text.....'
'.A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text....'
'..A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......'
]
}
]
}
}
Moduły zweryfikowane na platformie Azure
Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.
Aby utworzyć zasób Microsoft.Network/privateDnsZones/TXT, dodaj następujący element Bicep do szablonu.
resource symbolicname 'Microsoft.Network/privateDnsZones/TXT@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'
]
}
]
}
}
Wartości właściwości
Microsoft.Network/privateDnsZones/TXT
| Nazwa |
Opis |
Wartość |
| Znacznik ETAG |
Element ETag zestawu rekordów. |
ciąg |
| nazwa |
Nazwa zasobu |
ciąg (wymagany) |
| nadrzędny |
W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.
Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym. |
Nazwa symboliczna zasobu typu: privateDnsZones |
| Właściwości |
Właściwości zestawu rekordów. |
Właściwości zestawu rekordów |
Rekord AaaaRekord
| Nazwa |
Opis |
Wartość |
| Adres ipv6 |
Adres IPv6 tego rekordu AAAA. |
ciąg |
Przewód ARecord
| Nazwa |
Opis |
Wartość |
| Adres ipv4 |
Adres IPv4 tego rekordu A. |
ciąg |
Rekord CnameRecord
| Nazwa |
Opis |
Wartość |
| cname |
Nazwa kanoniczna dla tego rekordu CNAME. |
ciąg |
Rekord MX
| Nazwa |
Opis |
Wartość |
| wymieniać |
Nazwa domeny hosta poczty dla tego rekordu MX. |
ciąg |
| preferencja |
Wartość preferencji dla tego rekordu MX. |
Int |
Rekord Ptr
| Nazwa |
Opis |
Wartość |
| ptrdname (nazwa_ptrd) |
Nazwa domeny docelowej PTR dla tego rekordu PTR. |
ciąg |
Właściwości zestawu rekordów
| Nazwa |
Opis |
Wartość |
| aaaaRekordy |
Lista rekordów usługi AAAA w zestawie rekordów. |
AaaaRekord[] |
| aRekordy |
Lista rekordów A w zestawie rekordów. |
ARecord [] |
| Rekord cnameRecord |
Rekord CNAME w zestawie rekordów. |
Rekord CnameRecord |
| metadane |
Metadane dołączone do zestawu rekordów. |
RecordSetPropertiesMetadata |
| Rekordy mxRecords |
Lista rekordów MX w zestawie rekordów. |
MxRekord[] |
| ptrRekordy |
Lista rekordów PTR w zestawie rekordów. |
Rekord Ptr[] |
| soaRecord (rekord soa) |
Rekord SOA w zestawie rekordów. |
SoaRecord |
| Rekordy srvRecords |
Lista rekordów SRV w zestawie rekordów. |
SrvRecord [] |
| Ttl |
Czas wygaśnięcia (czas wygaśnięcia) rekordów w zestawie rekordów. |
Int |
| txtRekordy |
Lista rekordów TXT w zestawie rekordów. |
Rekord Txt[] |
SoaRecord (Rekord Soa)
| Nazwa |
Opis |
Wartość |
| e-mail |
Kontakt e-mail dla tego rekordu SOA. |
ciąg |
| Czas wygaśnięcia |
Czas wygaśnięcia tego rekordu SOA. |
Int |
| gospodarz |
Nazwa domeny serwera nazw autorytatywnych dla tego rekordu SOA. |
ciąg |
| minimalny czas wygaśnięcia |
Minimalna wartość tego rekordu SOA. Zgodnie z konwencją służy do określania ujemnego czasu trwania buforowania. |
Int |
| refreshTime (czas odświeżania) |
Wartość odświeżania dla tego rekordu SOA. |
Int |
| retryTime (czas próby) |
Czas ponawiania próby dla tego rekordu SOA. |
Int |
| numer seryjny |
Numer seryjny dla tego rekordu SOA. |
Int |
Rekord SrvRecord
| Nazwa |
Opis |
Wartość |
| port |
Wartość portu dla tego rekordu SRV. |
Int |
| priorytet |
Wartość priorytetu dla tego rekordu SRV. |
Int |
| miejsce docelowe |
Nazwa domeny docelowej dla tego rekordu SRV. |
ciąg |
| ciężar |
Wartość wagi dla tego rekordu SRV. |
Int |
Rekord Txt
| Nazwa |
Opis |
Wartość |
| wartość |
Wartość tekstowa tego rekordu TXT. |
ciąg znakowy[] |
Definicja zasobu szablonu usługi ARM
Typ zasobu privateDnsZones/TXT można wdrożyć przy użyciu operacji docelowych:
Przykłady użycia
Aby utworzyć zasób Microsoft.Network/privateDnsZones/TXT, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.Network/privateDnsZones/TXT",
"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" ]
}
]
}
}
Wartości właściwości
Microsoft.Network/privateDnsZones/TXT
| Nazwa |
Opis |
Wartość |
| apiVersion (wersja interfejsu api) |
Wersja interfejsu API |
'2024-06-01' |
| Znacznik ETAG |
Element ETag zestawu rekordów. |
ciąg |
| nazwa |
Nazwa zasobu |
ciąg (wymagany) |
| Właściwości |
Właściwości zestawu rekordów. |
Właściwości zestawu rekordów |
| typ |
Typ zasobu |
"Microsoft.Network/privateDnsZones/TXT" |
Rekord AaaaRekord
| Nazwa |
Opis |
Wartość |
| Adres ipv6 |
Adres IPv6 tego rekordu AAAA. |
ciąg |
Przewód ARecord
| Nazwa |
Opis |
Wartość |
| Adres ipv4 |
Adres IPv4 tego rekordu A. |
ciąg |
Rekord CnameRecord
| Nazwa |
Opis |
Wartość |
| cname |
Nazwa kanoniczna dla tego rekordu CNAME. |
ciąg |
Rekord MX
| Nazwa |
Opis |
Wartość |
| wymieniać |
Nazwa domeny hosta poczty dla tego rekordu MX. |
ciąg |
| preferencja |
Wartość preferencji dla tego rekordu MX. |
Int |
Rekord Ptr
| Nazwa |
Opis |
Wartość |
| ptrdname (nazwa_ptrd) |
Nazwa domeny docelowej PTR dla tego rekordu PTR. |
ciąg |
Właściwości zestawu rekordów
| Nazwa |
Opis |
Wartość |
| aaaaRekordy |
Lista rekordów usługi AAAA w zestawie rekordów. |
AaaaRekord[] |
| aRekordy |
Lista rekordów A w zestawie rekordów. |
ARecord [] |
| Rekord cnameRecord |
Rekord CNAME w zestawie rekordów. |
Rekord CnameRecord |
| metadane |
Metadane dołączone do zestawu rekordów. |
RecordSetPropertiesMetadata |
| Rekordy mxRecords |
Lista rekordów MX w zestawie rekordów. |
MxRekord[] |
| ptrRekordy |
Lista rekordów PTR w zestawie rekordów. |
Rekord Ptr[] |
| soaRecord (rekord soa) |
Rekord SOA w zestawie rekordów. |
SoaRecord |
| Rekordy srvRecords |
Lista rekordów SRV w zestawie rekordów. |
SrvRecord [] |
| Ttl |
Czas wygaśnięcia (czas wygaśnięcia) rekordów w zestawie rekordów. |
Int |
| txtRekordy |
Lista rekordów TXT w zestawie rekordów. |
Rekord Txt[] |
SoaRecord (Rekord Soa)
| Nazwa |
Opis |
Wartość |
| e-mail |
Kontakt e-mail dla tego rekordu SOA. |
ciąg |
| Czas wygaśnięcia |
Czas wygaśnięcia tego rekordu SOA. |
Int |
| gospodarz |
Nazwa domeny serwera nazw autorytatywnych dla tego rekordu SOA. |
ciąg |
| minimalny czas wygaśnięcia |
Minimalna wartość tego rekordu SOA. Zgodnie z konwencją służy do określania ujemnego czasu trwania buforowania. |
Int |
| refreshTime (czas odświeżania) |
Wartość odświeżania dla tego rekordu SOA. |
Int |
| retryTime (czas próby) |
Czas ponawiania próby dla tego rekordu SOA. |
Int |
| numer seryjny |
Numer seryjny dla tego rekordu SOA. |
Int |
Rekord SrvRecord
| Nazwa |
Opis |
Wartość |
| port |
Wartość portu dla tego rekordu SRV. |
Int |
| priorytet |
Wartość priorytetu dla tego rekordu SRV. |
Int |
| miejsce docelowe |
Nazwa domeny docelowej dla tego rekordu SRV. |
ciąg |
| ciężar |
Wartość wagi dla tego rekordu SRV. |
Int |
Rekord Txt
| Nazwa |
Opis |
Wartość |
| wartość |
Wartość tekstowa tego rekordu TXT. |
ciąg znakowy[] |
Typ zasobu privateDnsZones/TXT można wdrożyć przy użyciu operacji docelowych:
-
Grupy zasobów Listę zmienionych właściwości w każdej wersji API można znaleźć w dzienniku zmian.
Przykłady użycia
Podstawowy przykład wdrażania prywatnego rekordu TXT DNS.
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" "TXT" {
type = "Microsoft.Network/privateDnsZones/TXT@2018-09-01"
parent_id = azapi_resource.privateDnsZone.id
name = var.resource_name
body = {
properties = {
metadata = {
}
ttl = 300
txtRecords = [
{
value = [
"Quick brown fox",
]
},
{
value = [
"A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text.....",
".A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text....",
"..A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......A long text......",
]
},
]
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
Aby utworzyć zasób Microsoft.Network/privateDnsZones/TXT, dodaj następujący program Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/privateDnsZones/TXT@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"
]
}
]
}
}
}
Wartości właściwości
Microsoft.Network/privateDnsZones/TXT
| Nazwa |
Opis |
Wartość |
| Znacznik ETAG |
Element ETag zestawu rekordów. |
ciąg |
| nazwa |
Nazwa zasobu |
ciąg (wymagany) |
| parent_id (identyfikator rodzica) |
Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. |
Identyfikator zasobu typu: privateDnsZones |
| Właściwości |
Właściwości zestawu rekordów. |
Właściwości zestawu rekordów |
| typ |
Typ zasobu |
"Microsoft.Network/privateDnsZones/TXT@2024-06-01" |
Rekord AaaaRekord
| Nazwa |
Opis |
Wartość |
| Adres ipv6 |
Adres IPv6 tego rekordu AAAA. |
ciąg |
Przewód ARecord
| Nazwa |
Opis |
Wartość |
| Adres ipv4 |
Adres IPv4 tego rekordu A. |
ciąg |
Rekord CnameRecord
| Nazwa |
Opis |
Wartość |
| cname |
Nazwa kanoniczna dla tego rekordu CNAME. |
ciąg |
Rekord MX
| Nazwa |
Opis |
Wartość |
| wymieniać |
Nazwa domeny hosta poczty dla tego rekordu MX. |
ciąg |
| preferencja |
Wartość preferencji dla tego rekordu MX. |
Int |
Rekord Ptr
| Nazwa |
Opis |
Wartość |
| ptrdname (nazwa_ptrd) |
Nazwa domeny docelowej PTR dla tego rekordu PTR. |
ciąg |
Właściwości zestawu rekordów
| Nazwa |
Opis |
Wartość |
| aaaaRekordy |
Lista rekordów usługi AAAA w zestawie rekordów. |
AaaaRekord[] |
| aRekordy |
Lista rekordów A w zestawie rekordów. |
ARecord [] |
| Rekord cnameRecord |
Rekord CNAME w zestawie rekordów. |
Rekord CnameRecord |
| metadane |
Metadane dołączone do zestawu rekordów. |
RecordSetPropertiesMetadata |
| Rekordy mxRecords |
Lista rekordów MX w zestawie rekordów. |
MxRekord[] |
| ptrRekordy |
Lista rekordów PTR w zestawie rekordów. |
Rekord Ptr[] |
| soaRecord (rekord soa) |
Rekord SOA w zestawie rekordów. |
SoaRecord |
| Rekordy srvRecords |
Lista rekordów SRV w zestawie rekordów. |
SrvRecord [] |
| Ttl |
Czas wygaśnięcia (czas wygaśnięcia) rekordów w zestawie rekordów. |
Int |
| txtRekordy |
Lista rekordów TXT w zestawie rekordów. |
Rekord Txt[] |
SoaRecord (Rekord Soa)
| Nazwa |
Opis |
Wartość |
| e-mail |
Kontakt e-mail dla tego rekordu SOA. |
ciąg |
| Czas wygaśnięcia |
Czas wygaśnięcia tego rekordu SOA. |
Int |
| gospodarz |
Nazwa domeny serwera nazw autorytatywnych dla tego rekordu SOA. |
ciąg |
| minimalny czas wygaśnięcia |
Minimalna wartość tego rekordu SOA. Zgodnie z konwencją służy do określania ujemnego czasu trwania buforowania. |
Int |
| refreshTime (czas odświeżania) |
Wartość odświeżania dla tego rekordu SOA. |
Int |
| retryTime (czas próby) |
Czas ponawiania próby dla tego rekordu SOA. |
Int |
| numer seryjny |
Numer seryjny dla tego rekordu SOA. |
Int |
Rekord SrvRecord
| Nazwa |
Opis |
Wartość |
| port |
Wartość portu dla tego rekordu SRV. |
Int |
| priorytet |
Wartość priorytetu dla tego rekordu SRV. |
Int |
| miejsce docelowe |
Nazwa domeny docelowej dla tego rekordu SRV. |
ciąg |
| ciężar |
Wartość wagi dla tego rekordu SRV. |
Int |
Rekord Txt
| Nazwa |
Opis |
Wartość |
| wartość |
Wartość tekstowa tego rekordu TXT. |
ciąg znakowy[] |