Record Sets - Update

Referencia

Szolgáltatás:: DNS

API-verzió:: 2018-09-01

Frissíti a privát DNS-zónán belüli rekordhalmazt.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}/{relativeRecordSetName}?api-version=2018-09-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
privateZoneName	path	True	string	A privát DNS-zóna neve (megszüntető pont nélkül).
recordType	path	True	RecordType	A dns-rekord típusa ebben a rekordhalmazban.
relativeRecordSetName	path	True	string	A rekordhalmaz neve a zóna nevéhez viszonyítva.
resourceGroupName	path	True	string	Az erőforráscsoport neve.
subscriptionId	path	True	string	Lekéri az előfizetés hitelesítő adatait, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés azonosítója minden szolgáltatáshíváshoz az URI részét képezi.
api-version	query	True	string	Ügyfél API-verziója.

Kérelem fejléce

Name	Kötelező	Típus	Description
If-Match		string	A rekordhalmaz ETagje. Hagyja ki ezt az értéket, hogy mindig felülírja az aktuális rekordhalmazt. Adja meg az utolsóként látott ETag értéket, hogy megakadályozza az egyidejű módosítások véletlen felülírását.

Kérelem törzse

Name	Típus	Description
etag	string	A rekordhalmaz ETagje.
properties.aRecords	ARecord[]	A rekordhalmaz A rekordjainak listája.
properties.aaaaRecords	AaaaRecord[]	A rekordhalmaz AAAA rekordjainak listája.
properties.cnameRecord	CnameRecord	A rekordhalmaz CNAME rekordja.
properties.metadata	object	A rekordhalmazhoz csatolt metaadatok.
properties.mxRecords	MxRecord[]	A rekordhalmaz MX rekordjainak listája.
properties.ptrRecords	PtrRecord[]	A rekordhalmaz PTR-rekordjainak listája.
properties.soaRecord	SoaRecord	Az SOA rekord a rekordhalmazban.
properties.srvRecords	SrvRecord[]	A rekordhalmaz SRV rekordjainak listája.
properties.ttl	integer (int64)	A rekordhalmaz rekordjainak TTL-je (élettartam).
properties.txtRecords	TxtRecord[]	A rekordhalmaz TXT rekordjainak listája.

Válaszok

Name	Típus	Description
200 OK	RecordSet	A rekordhalmaz frissült.
Other Status Codes	CloudError	Alapértelmezett válasz. A hibadefiníciónak megfelelően deszerializálja.

Példák

PATCH Private DNS Zone A Record Set

PATCH Private DNS Zone AAAA Record Set

PATCH Private DNS Zone CNAME Record Set

PATCH Private DNS Zone MX Record Set

PATCH Private DNS Zone PTR Record Set

PATCH Private DNS Zone SOA Record Set

PATCH Private DNS Zone SRV Record Set

PATCH Private DNS Zone TXT Record Set

PATCH Private DNS Zone A Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recordA?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recorda",
  "type": "Microsoft.Network/privateDnsZones/A",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recorda.privatezone1.com.",
    "isAutoRegistered": false,
    "aRecords": [
      {
        "ipv4Address": "1.2.3.4"
      }
    ]
  }
}

PATCH Private DNS Zone AAAA Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordAAAA?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordaaaa",
  "type": "Microsoft.Network/privateDnsZones/AAAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordaaaa.privatezone1.com.",
    "isAutoRegistered": false,
    "aaaaRecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

PATCH Private DNS Zone CNAME Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordCNAME?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordcname",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordcname",
  "type": "Microsoft.Network/privateDnsZones/CNAME",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordcname.privatezone1.com.",
    "isAutoRegistered": false,
    "cnameRecord": {
      "cname": "contoso.com"
    }
  }
}

PATCH Private DNS Zone MX Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordMX?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordmx",
  "type": "Microsoft.Network/privateDnsZones/MX",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordmx.privatezone1.com.",
    "isAutoRegistered": false,
    "mxRecords": [
      {
        "preference": 0,
        "exchange": "mail.privatezone1.com"
      }
    ]
  }
}

PATCH Private DNS Zone PTR Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/privateDnsZones/PTR",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa.",
    "isAutoRegistered": false,
    "ptrRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

PATCH Private DNS Zone SOA Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/privateDnsZones/SOA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "privatezone1.com.",
    "isAutoRegistered": false,
    "soaRecord": {
      "host": "azureprivatedns.net",
      "email": "azureprivatedns-hostmaster.microsoft.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTtl": 300
    }
  }
}

PATCH Private DNS Zone SRV Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordSRV?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordsrv",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordsrv",
  "type": "Microsoft.Network/privateDnsZones/SRV",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordsrv.privatezone1.com.",
    "isAutoRegistered": false,
    "srvRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

PATCH Private DNS Zone TXT Record Set

Mintakérelem

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordTXT?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordtxt",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordtxt",
  "type": "Microsoft.Network/privateDnsZones/TXT",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordtxt.privatezone1.com.",
    "isAutoRegistered": false,
    "txtRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

Definíciók

Name	Description
AaaaRecord	AAAA rekord.
ARecord	Egy A rekord.
CloudError	Hibaválasz a szolgáltatástól.
CloudErrorBody	Hibaválasz a szolgáltatástól.
CnameRecord	CNAME rekord.
MxRecord	Egy MX rekord.
PtrRecord	PTR rekord.
RecordSet	Egy DNS-rekordkészletet (azonos nevű és típusú DNS-rekordokat tartalmazó gyűjtemény) ír le egy privát DNS-zónában.
RecordType	A dns-rekord típusa ebben a rekordhalmazban.
SoaRecord	SOA-rekord.
SrvRecord	Egy SRV rekord.
TxtRecord	TXT rekord.

AaaaRecord

Objektum

AAAA rekord.

Name	Típus	Description
ipv6Address	string	Az AAAA rekord IPv6-címe.

ARecord

Objektum

Egy A rekord.

Name	Típus	Description
ipv4Address	string	Az A rekord IPv4-címe.

CloudError

Objektum

Hibaválasz a szolgáltatástól.

Name	Típus	Description
error	CloudErrorBody	Felhőbeli hibatörzs.

CloudErrorBody

Objektum

Hibaválasz a szolgáltatástól.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.

CnameRecord

Objektum

CNAME rekord.

Name	Típus	Description
cname	string	A CNAME rekord canonical neve.

MxRecord

Objektum

Egy MX rekord.

Name	Típus	Description
exchange	string	Az MX rekord levelezési állomásának tartományneve.
preference	integer (int32)	Az MX rekord beállítási értéke.

PtrRecord

Objektum

PTR rekord.

Name	Típus	Description
ptrdname	string	A PTR-rekord PTR-céltartományneve.

RecordSet

Objektum

Egy DNS-rekordkészletet (azonos nevű és típusú DNS-rekordokat tartalmazó gyűjtemény) ír le egy privát DNS-zónában.

Name	Típus	Description
etag	string	A rekordhalmaz ETagje.
id	string	A rekordhalmaz azonosítója.
name	string	A rekordhalmaz neve.
properties.aRecords	ARecord[]	A rekordhalmaz A rekordjainak listája.
properties.aaaaRecords	AaaaRecord[]	A rekordhalmaz AAAA rekordjainak listája.
properties.cnameRecord	CnameRecord	A rekordhalmaz CNAME rekordja.
properties.fqdn	string	A rekordhalmaz teljes tartományneve.
properties.isAutoRegistered	boolean	A rekordhalmaz automatikusan regisztrálva van a privát DNS-zónában egy virtuális hálózati kapcsolaton keresztül?
properties.metadata	object	A rekordhalmazhoz csatolt metaadatok.
properties.mxRecords	MxRecord[]	A rekordhalmaz MX rekordjainak listája.
properties.ptrRecords	PtrRecord[]	A rekordhalmaz PTR-rekordjainak listája.
properties.soaRecord	SoaRecord	Az SOA rekord a rekordhalmazban.
properties.srvRecords	SrvRecord[]	A rekordhalmaz SRV rekordjainak listája.
properties.ttl	integer (int64)	A rekordhalmaz rekordjainak TTL-je (élettartam).
properties.txtRecords	TxtRecord[]	A rekordhalmaz TXT rekordjainak listája.
type	string	A rekordhalmaz típusa.

RecordType

Enumerálás

A dns-rekord típusa ebben a rekordhalmazban.

Érték	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objektum

SOA-rekord.

Name	Típus	Description
email	string	Az SOA-rekordhoz tartozó e-mail-kapcsolattartó.
expireTime	integer (int64)	Az SOA rekord lejárati ideje.
host	string	Az SOA rekord mérvadó névkiszolgálójának tartományneve.
minimumTtl	integer (int64)	Az SOA rekord minimális értéke. Konvenció szerint ez a negatív gyorsítótárazási időtartam meghatározására szolgál.
refreshTime	integer (int64)	Az SOA rekord frissítési értéke.
retryTime	integer (int64)	Az SOA rekord újrapróbálkozása.
serialNumber	integer (int64)	Az SOA rekord sorozatszáma.

SrvRecord

Objektum

Egy SRV rekord.

Name	Típus	Description
port	integer (int32)	Az SRV rekord portértéke.
priority	integer (int32)	Az SRV rekord prioritási értéke.
target	string	Az SRV rekord céltartományneve.
weight	integer (int32)	Az SRV rekord súlyértéke.

TxtRecord

Objektum

TXT rekord.

Name	Típus	Description
value	string[]	A TXT rekord szöveges értéke.

Megosztás a következőn keresztül:

Record Sets - Update

URI-paraméterek

Kérelem fejléce

Kérelem törzse

Válaszok

Példák

PATCH Private DNS Zone A Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone AAAA Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone CNAME Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone MX Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone PTR Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone SOA Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone SRV Record Set

Mintakérelem

Mintaválasz

PATCH Private DNS Zone TXT Record Set

Mintakérelem

Mintaválasz

Definíciók

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord

További források