Record Sets - List By Type

Service:

DNS

API-versie:

2018-09-01

Geeft een lijst weer van de recordsets van een opgegeven type in een privé-DNS-zone.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
privateZoneName	path	True	string	De naam van de privé-DNS-zone (zonder afsluitpunt).
recordType	path	True	RecordType	Het type recordsets dat moet worden opgesomd.
resourceGroupName	path	True	string	De naam van de resourcegroep.
subscriptionId	path	True	string	Hiermee haalt u abonnementsreferenties op die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
api-version	query	True	string	Client-API-versie.
$recordsetnamesuffix	query		string	Het achtervoegsellabel van de naam van de recordset die moet worden gebruikt om de opsomming van de recordset te filteren. Als deze parameter is opgegeven, bevat de geretourneerde opsomming alleen records die eindigen op '.'.
$top	query		integer (int32)	Het maximum aantal recordsets dat moet worden geretourneerd. Als dit niet is opgegeven, worden maximaal 100 recordsets geretourneerd.

Antwoorden

Name	Type	Description
200 OK	RecordSetListResult	Succes.
Other Status Codes	CloudError	Standaardantwoord. Deze wordt gedeserialiseerd volgens de foutdefinitie.

Voorbeelden

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
AaaaRecord	Een AAAA-record.
ARecord	Een A-record.
CloudError	Een foutreactie van de service.
CloudErrorBody	Een foutreactie van de service.
CnameRecord	Een CNAME-record.
MxRecord	Een MX-record.
PtrRecord	Een PTR-record.
RecordSet	Beschrijft een DNS-recordset (een verzameling DNS-records met dezelfde naam en hetzelfde type) in een privé-DNS-zone.
RecordSetListResult	Het antwoord op een recordsetlijstbewerking.
RecordType	Het type recordsets dat moet worden opgesomd.
SoaRecord	Een SOA-record.
SrvRecord	Een SRV-record.
TxtRecord	Een TXT-record.

AaaaRecord

Object

Een AAAA-record.

Name	Type	Description
ipv6Address	string	Het IPv6-adres van deze AAAA-record.

ARecord

Object

Een A-record.

Name	Type	Description
ipv4Address	string	Het IPv4-adres van deze A-record.

CloudError

Object

Een foutreactie van de service.

Name	Type	Description
error	CloudErrorBody	Hoofdtekst van cloudfout.

CloudErrorBody

Object

Een foutreactie van de service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	CloudErrorBody[]	Een lijst met aanvullende informatie over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

CnameRecord

Object

Een CNAME-record.

Name	Type	Description
cname	string	De canonieke naam voor deze CNAME-record.

MxRecord

Object

Een MX-record.

Name	Type	Description
exchange	string	De domeinnaam van de e-mailhost voor deze MX-record.
preference	integer (int32)	De voorkeurswaarde voor deze MX-record.

PtrRecord

Object

Een PTR-record.

Name	Type	Description
ptrdname	string	De PTR-doeldomeinnaam voor deze PTR-record.

RecordSet

Object

Beschrijft een DNS-recordset (een verzameling DNS-records met dezelfde naam en hetzelfde type) in een privé-DNS-zone.

Name	Type	Description
etag	string	De ETag van de recordset.
id	string	De id van de recordset.
name	string	De naam van de recordset.
properties.aRecords	ARecord[]	De lijst met A-records in de recordset.
properties.aaaaRecords	AaaaRecord[]	De lijst met AAAA-records in de recordset.
properties.cnameRecord	CnameRecord	De CNAME-record in de recordset.
properties.fqdn	string	Volledig gekwalificeerde domeinnaam van de recordset.
properties.isAutoRegistered	boolean	Wordt de recordset automatisch geregistreerd in de privé-DNS-zone via een koppeling naar een virtueel netwerk?
properties.metadata	object	De metagegevens die zijn gekoppeld aan de recordset.
properties.mxRecords	MxRecord[]	De lijst met MX-records in de recordset.
properties.ptrRecords	PtrRecord[]	De lijst met PTR-records in de recordset.
properties.soaRecord	SoaRecord	De SOA-record in de recordset.
properties.srvRecords	SrvRecord[]	De lijst met SRV-records in de recordset.
properties.ttl	integer (int64)	De TTL (time-to-live) van de records in de recordset.
properties.txtRecords	TxtRecord[]	De lijst met TXT-records in de recordset.
type	string	Het type van de recordset.

RecordSetListResult

Object

Het antwoord op een recordsetlijstbewerking.

Name	Type	Description
nextLink	string	Het vervolgtoken voor de volgende pagina met resultaten.
value	RecordSet[]	Informatie over de recordsets in het antwoord.

RecordType

Inventarisatie

Het type recordsets dat moet worden opgesomd.

Waarde	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

Een SOA-record.

Name	Type	Description
email	string	De e-mailcontactpersoon voor deze SOA-record.
expireTime	integer (int64)	De verlooptijd voor deze SOA-record.
host	string	De domeinnaam van de gezaghebbende naamserver voor deze SOA-record.
minimumTtl	integer (int64)	De minimumwaarde voor deze SOA-record. Dit wordt standaard gebruikt om de negatieve cacheduur te bepalen.
refreshTime	integer (int64)	De vernieuwingswaarde voor deze SOA-record.
retryTime	integer (int64)	De tijd voor opnieuw proberen voor deze SOA-record.
serialNumber	integer (int64)	Het serienummer voor deze SOA-record.

SrvRecord

Object

Een SRV-record.

Name	Type	Description
port	integer (int32)	De poortwaarde voor deze SRV-record.
priority	integer (int32)	De prioriteitswaarde voor deze SRV-record.
target	string	De doeldomeinnaam voor deze SRV-record.
weight	integer (int32)	De gewichtswaarde voor deze SRV-record.

TxtRecord

Object

Een TXT-record.

Name	Type	Description
value	string[]	De tekstwaarde van deze TXT-record.