Record Sets - List By Type

Dienst:

DNS

API-Version:

2018-09-01

Listet die Datensatzsätze eines angegebenen Typs in einer privaten DNS-Zone auf.

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

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}/{recordType}?$top={$top}&$recordsetnamesuffix={$recordsetnamesuffix}&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 Datensatzes, der aufgezählt werden soll.
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.
$recordsetnamesuffix	query		string	Die Suffixbeschriftung des Datensatzsatzesnamens, der zum Filtern der Datensatzsatzaufzählung verwendet werden soll. Wenn dieser Parameter angegeben ist, enthält die zurückgegebene Enumeration nur Datensätze, die mit ".<recordsetnamesuffix>".
$top	query		integer (int32)	Die maximale Anzahl der zurückzugebenden Datensätze. Wenn nicht angegeben, werden bis zu 100 Datensatzsätze zurückgegeben.

Antworten

Name	Typ	Beschreibung
200 OK	RecordSetListResult	Erfolg.
Other Status Codes	CloudError	Standardantwort. Sie wird gemäß der Fehlerdefinition deserialisiert.

Beispiele

GET Private DNS Zone A Record Sets

GET Private DNS Zone AAAA Record Sets

GET Private DNS Zone CNAME Record Sets

GET Private DNS Zone MX Record Sets

GET Private DNS Zone PTR Record Sets

GET Private DNS Zone SOA Record Sets

GET Private DNS Zone SRV Record Sets

GET Private DNS Zone TXT Record Sets

GET Private DNS Zone A Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/A?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "recorda1",
      "type": "Microsoft.Network/privateDnsZones/A",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "ttl": 3600,
        "fqdn": "recorda1.privatezone1.com.",
        "isAutoRegistered": false,
        "aRecords": [
          {
            "ipv4Address": "1.2.3.4"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "recorda2",
      "type": "Microsoft.Network/privateDnsZones/A",
      "properties": {
        "ttl": 3600,
        "fqdn": "recorda2.privatezone1.com.",
        "isAutoRegistered": false,
        "aRecords": [
          {
            "ipv4Address": "5.6.7.8"
          }
        ]
      }
    }
  ]
}

GET Private DNS Zone AAAA Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/AAAA?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "recordaaaa1",
      "type": "Microsoft.Network/privateDnsZones/AAAA",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "ttl": 3600,
        "fqdn": "recordaaaa1.privatezone1.com.",
        "isAutoRegistered": false,
        "aaaaRecords": [
          {
            "ipv6Address": "::1"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "recordaaaa2",
      "type": "Microsoft.Network/privateDnsZones/AAAA",
      "properties": {
        "ttl": 3600,
        "fqdn": "recordaaaa2.privatezone1.com.",
        "isAutoRegistered": false,
        "aaaaRecords": [
          {
            "ipv6Address": "::1"
          }
        ]
      }
    }
  ]
}

GET Private DNS Zone CNAME Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "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": {
          "key1": "value1"
        },
        "ttl": 3600,
        "fqdn": "recordcname.privatezone1.com.",
        "isAutoRegistered": false,
        "cnameRecord": {
          "cname": "contoso.com"
        }
      }
    }
  ]
}

GET Private DNS Zone MX Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/MX?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx1",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "recordmx1",
      "type": "Microsoft.Network/privateDnsZones/MX",
      "properties": {
        "metadata": {
          "key1": "value1"
        },
        "ttl": 3600,
        "fqdn": "recordmx1.privatezone1.com.",
        "isAutoRegistered": false,
        "mxRecords": [
          {
            "preference": 0,
            "exchange": "mail.contoso1.com"
          }
        ]
      }
    },
    {
      "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx2",
      "etag": "00000000-0000-0000-0000-000000000000",
      "name": "recordmx2",
      "type": "Microsoft.Network/privateDnsZones/MX",
      "properties": {
        "ttl": 3600,
        "fqdn": "recordmx2.privatezone1.com.",
        "isAutoRegistered": false,
        "mxRecords": [
          {
            "preference": 0,
            "exchange": "mail.contoso2.com"
          }
        ]
      }
    }
  ]
}

GET Private DNS Zone PTR Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/PTR?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "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": {
          "key1": "value1"
        },
        "ttl": 3600,
        "fqdn": "1.0.0.127.in-addr.arpa.",
        "isAutoRegistered": false,
        "ptrRecords": [
          {
            "ptrdname": "localhost"
          }
        ]
      }
    }
  ]
}

GET Private DNS Zone SOA Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "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": {
          "key1": "value1"
        },
        "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
        }
      }
    }
  ]
}

GET Private DNS Zone SRV Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/SRV?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "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": {
          "key1": "value1"
        },
        "ttl": 3600,
        "fqdn": "recordsrv.privatezone1.com.",
        "isAutoRegistered": false,
        "srvRecords": [
          {
            "priority": 0,
            "weight": 10,
            "port": 80,
            "target": "contoso.com"
          }
        ]
      }
    }
  ]
}

GET Private DNS Zone TXT Record Sets

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "nextLink": "https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/TXT?api-version=2018-09-01&$skipToken=skipToken",
  "value": [
    {
      "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": {
          "key1": "value1"
        },
        "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.
RecordSetListResult	Die Antwort auf einen Datensatzsatzlistenvorgang.
RecordType	Der Typ des Datensatzes, der aufgezählt werden soll.
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.

RecordSetListResult

Objekt

Die Antwort auf einen Datensatzsatzlistenvorgang.

Name	Typ	Beschreibung
nextLink	string	Das Fortsetzungstoken für die nächste Seite der Ergebnisse.
value	RecordSet[]	Informationen zu den Datensatzsätzen in der Antwort.

RecordType

Enumeration

Der Typ des Datensatzes, der aufgezählt werden soll.

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.