Record Sets - Update

Referenz

Dienst:: DNS

API-Version:: 2018-09-01

Aktualisiert einen Datensatz in einer privaten DNS-Zone.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
privateZoneName	path	True	string	Der Name der privaten DNS-Zone (ohne endenden Punkt).
recordType	path	True	RecordType	Der Typ des DNS-Eintrags in diesem Datensatzsatz.
relativeRecordSetName	path	True	string	Der Name des Datensatzsatzes relativ zum Namen der Zone.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string	Ruft Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
If-Match		string	Das ETag des Datensatzsatzes. Lassen Sie diesen Wert aus, um den aktuellen Datensatzsatz immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Anforderungstext

Name	Typ	Beschreibung
etag	string	Das ETag des Datensatzsatzes.
properties.aRecords	ARecord[]	Die Liste der A-Datensätze im Datensatzsatz.
properties.aaaaRecords	AaaaRecord[]	Die Liste der AAAA-Einträge im Datensatzsatz.
properties.cnameRecord	CnameRecord	Der CNAME-Eintrag im Datensatzsatz.
properties.metadata	object	Die Metadaten, die dem Datensatzsatz zugeordnet sind.
properties.mxRecords	MxRecord[]	Die Liste der MX-Einträge im Datensatzsatz.
properties.ptrRecords	PtrRecord[]	Die Liste der PTR-Datensätze im Datensatzsatz.
properties.soaRecord	SoaRecord	Der SOA-Eintrag im Datensatzsatz.
properties.srvRecords	SrvRecord[]	Die Liste der SRV-Einträge im Datensatzsatz.
properties.ttl	integer (int64)	Die TTL (Time-to-Live) der Datensätze im Datensatzsatz.
properties.txtRecords	TxtRecord[]	Die Liste der TXT-Einträge im Datensatzsatz.

Antworten

Name	Typ	Beschreibung
200 OK	RecordSet	Der Datensatzsatz wurde aktualisiert.
Other Status Codes	CloudError	Standardantwort. Sie wird gemäß der Fehlerdefinition deserialisiert.

Beispiele

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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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

Beispielanforderung

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"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 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"
        ]
      }
    ]
  }
}

Definitionen

Name	Beschreibung
AaaaRecord	Ein AAAA-Eintrag.
ARecord	Ein Datensatz.
CloudError	Eine Fehlerantwort des Diensts.
CloudErrorBody	Eine Fehlerantwort des Diensts.
CnameRecord	Ein CNAME-Eintrag.
MxRecord	Ein MX-Eintrag.
PtrRecord	Ein PTR-Eintrag.
RecordSet	Beschreibt einen DNS-Eintragssatz (eine Sammlung von DNS-Einträgen mit demselben Namen und Typ) in einer privaten DNS-Zone.
RecordType	Der Typ des DNS-Eintrags in diesem Datensatzsatz.
SoaRecord	Ein SOA-Eintrag.
SrvRecord	Ein SRV-Eintrag.
TxtRecord	Ein TXT-Eintrag.

AaaaRecord

Objekt

Ein AAAA-Eintrag.

Name	Typ	Beschreibung
ipv6Address	string	Die IPv6-Adresse dieses AAAA-Eintrags.

ARecord

Objekt

Ein Datensatz.

Name	Typ	Beschreibung
ipv4Address	string	Die IPv4-Adresse dieses A-Eintrags.

CloudError

Objekt

Eine Fehlerantwort des Diensts.

Name	Typ	Beschreibung
error	CloudErrorBody	Cloudfehlertext.

CloudErrorBody

Objekt

Eine Fehlerantwort des Diensts.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
details	CloudErrorBody[]	Eine Liste mit zusätzlichen Details zum Fehler.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
target	string	Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

CnameRecord

Objekt

Ein CNAME-Eintrag.

Name	Typ	Beschreibung
cname	string	Der kanonische Name für diesen CNAME-Eintrag.

MxRecord

Objekt

Ein MX-Eintrag.

Name	Typ	Beschreibung
exchange	string	Der Domänenname des E-Mail-Hosts für diesen MX-Eintrag.
preference	integer (int32)	Der Einstellungswert für diesen MX-Eintrag.

PtrRecord

Objekt

Ein PTR-Eintrag.

Name	Typ	Beschreibung
ptrdname	string	Der PTR-Zieldomänenname für diesen PTR-Eintrag.

RecordSet

Objekt

Beschreibt einen DNS-Eintragssatz (eine Sammlung von DNS-Einträgen mit demselben Namen und Typ) in einer privaten DNS-Zone.

Name	Typ	Beschreibung
etag	string	Das ETag des Datensatzsatzes.
id	string	Die ID des Datensatzsatzes.
name	string	Der Name des Datensatzsatzes.
properties.aRecords	ARecord[]	Die Liste der A-Datensätze im Datensatzsatz.
properties.aaaaRecords	AaaaRecord[]	Die Liste der AAAA-Einträge im Datensatzsatz.
properties.cnameRecord	CnameRecord	Der CNAME-Eintrag im Datensatzsatz.
properties.fqdn	string	Vollqualifizierter Domänenname des Datensatzsatzes.
properties.isAutoRegistered	boolean	Wird der Datensatzsatz automatisch in der privaten DNS-Zone über eine virtuelle Netzwerkverbindung registriert?
properties.metadata	object	Die Metadaten, die dem Datensatzsatz zugeordnet sind.
properties.mxRecords	MxRecord[]	Die Liste der MX-Einträge im Datensatzsatz.
properties.ptrRecords	PtrRecord[]	Die Liste der PTR-Datensätze im Datensatzsatz.
properties.soaRecord	SoaRecord	Der SOA-Eintrag im Datensatzsatz.
properties.srvRecords	SrvRecord[]	Die Liste der SRV-Einträge im Datensatzsatz.
properties.ttl	integer (int64)	Die TTL (Time-to-Live) der Datensätze im Datensatzsatz.
properties.txtRecords	TxtRecord[]	Die Liste der TXT-Einträge im Datensatzsatz.
type	string	Der Typ des Datensatzsatzes.

RecordType

Enumeration

Der Typ des DNS-Eintrags in diesem Datensatzsatz.

Wert	Beschreibung
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objekt

Ein SOA-Eintrag.

Name	Typ	Beschreibung
email	string	Der E-Mail-Kontakt für diesen SOA-Eintrag.
expireTime	integer (int64)	Die Ablaufzeit für diesen SOA-Eintrag.
host	string	Der Domänenname des autoritativen Namensservers für diesen SOA-Eintrag.
minimumTtl	integer (int64)	Der Mindestwert für diesen SOA-Eintrag. In der Konvention wird dies verwendet, um die negative Zwischenspeicherungsdauer zu bestimmen.
refreshTime	integer (int64)	Der Aktualisierungswert für diesen SOA-Eintrag.
retryTime	integer (int64)	Die Wiederholungszeit für diesen SOA-Eintrag.
serialNumber	integer (int64)	Die Seriennummer für diesen SOA-Eintrag.

SrvRecord

Objekt

Ein SRV-Eintrag.

Name	Typ	Beschreibung
port	integer (int32)	Der Portwert für diesen SRV-Eintrag.
priority	integer (int32)	Der Prioritätswert für diesen SRV-Eintrag.
target	string	Der Zieldomänenname für diesen SRV-Eintrag.
weight	integer (int32)	Der Gewichtungswert für diesen SRV-Eintrag.

TxtRecord

Objekt

Ein TXT-Eintrag.

Name	Typ	Beschreibung
value	string[]	Der Textwert dieses TXT-Eintrags.

Freigeben über

Record Sets - Update

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Beispiele

PATCH Private DNS Zone A Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone AAAA Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone CNAME Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone MX Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone PTR Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone SOA Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone SRV Record Set

Beispielanforderung

Beispiel für eine Antwort

PATCH Private DNS Zone TXT Record Set

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord