Record Sets - List By Type

Referência

Serviço:: DNS

Versão da API:: 2018-09-01

Lista os conjuntos de registros de um tipo especificado em uma zona DNS privada.

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

Com parâmetros opcionais:

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
privateZoneName	path	True	string	O nome da zona DNS privada (sem um ponto de encerramento).
recordType	path	True	RecordType	O tipo de conjuntos de registros a serem enumerados.
resourceGroupName	path	True	string	O nome do grupo de recursos.
subscriptionId	path	True	string	Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.
$recordsetnamesuffix	query		string	O rótulo do sufixo do nome do conjunto de registros a ser usado para filtrar a enumeração do conjunto de registros. Se esse parâmetro for especificado, a enumeração retornada conterá apenas registros que terminam com ".".
$top	query		integer (int32)	O número máximo de conjuntos de registros a serem retornados. Se não for especificado, retornará até 100 conjuntos de registros.

Respostas

Nome	Tipo	Description
200 OK	RecordSetListResult	Êxito.
Other Status Codes	CloudError	Resposta padrão. Ele será desserializado de acordo com a definição de erro.

Exemplos

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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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"
            ]
          }
        ]
      }
    }
  ]
}

Definições

Nome	Description
AaaaRecord	Um registro AAAA.
ARecord	Um registro A.
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
CnameRecord	Um registro CNAME.
MxRecord	Um registro MX.
PtrRecord	Um registro PTR.
RecordSet	Descreve um conjunto de registros DNS (uma coleção de registros DNS com o mesmo nome e tipo) em uma zona DNS privada.
RecordSetListResult	A resposta a uma operação de lista de conjuntos de registros.
RecordType	O tipo de conjuntos de registros a serem enumerados.
SoaRecord	Um registro SOA.
SrvRecord	Um registro SRV.
TxtRecord	Um registro TXT.

AaaaRecord

Objeto

Um registro AAAA.

Nome	Tipo	Description
ipv6Address	string	O endereço IPv6 deste registro AAAA.

ARecord

Objeto

Um registro A.

Nome	Tipo	Description
ipv4Address	string	O endereço IPv4 deste registro A.

CloudError

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
error	CloudErrorBody	Corpo do erro de nuvem.

CloudErrorBody

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

CnameRecord

Objeto

Um registro CNAME.

Nome	Tipo	Description
cname	string	O nome canônico deste registro CNAME.

MxRecord

Objeto

Um registro MX.

Nome	Tipo	Description
exchange	string	O nome de domínio do host de email para este registro MX.
preference	integer (int32)	O valor de preferência para este registro MX.

PtrRecord

Objeto

Um registro PTR.

Nome	Tipo	Description
ptrdname	string	O nome de domínio de destino ptr para este registro PTR.

RecordSet

Objeto

Descreve um conjunto de registros DNS (uma coleção de registros DNS com o mesmo nome e tipo) em uma zona DNS privada.

Nome	Tipo	Description
etag	string	A ETag do conjunto de registros.
id	string	A ID do conjunto de registros.
name	string	O nome do conjunto de registros.
properties.aRecords	ARecord[]	A lista de registros A no conjunto de registros.
properties.aaaaRecords	AaaaRecord[]	A lista de registros AAAA no conjunto de registros.
properties.cnameRecord	CnameRecord	O registro CNAME no conjunto de registros.
properties.fqdn	string	Nome de domínio totalmente qualificado do conjunto de registros.
properties.isAutoRegistered	boolean	O conjunto de registros é registrado automaticamente na zona DNS privada por meio de um link de rede virtual?
properties.metadata	object	Os metadados anexados ao conjunto de registros.
properties.mxRecords	MxRecord[]	A lista de registros MX no conjunto de registros.
properties.ptrRecords	PtrRecord[]	A lista de registros PTR no conjunto de registros.
properties.soaRecord	SoaRecord	O registro SOA no conjunto de registros.
properties.srvRecords	SrvRecord[]	A lista de registros SRV no conjunto de registros.
properties.ttl	integer (int64)	A TTL (vida útil) dos registros no conjunto de registros.
properties.txtRecords	TxtRecord[]	A lista de registros TXT no conjunto de registros.
type	string	O tipo do conjunto de registros.

RecordSetListResult

Objeto

A resposta a uma operação de lista de conjuntos de registros.

Nome	Tipo	Description
nextLink	string	O token de continuação para a próxima página de resultados.
value	RecordSet[]	Informações sobre os conjuntos de registros na resposta.

RecordType

Enumeração

O tipo de conjuntos de registros a serem enumerados.

Valor	Description
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Objeto

Um registro SOA.

Nome	Tipo	Description
email	string	O contato de email para este registro SOA.
expireTime	integer (int64)	A hora de expiração deste registro SOA.
host	string	O nome de domínio do servidor de nome autoritativo para este registro SOA.
minimumTtl	integer (int64)	O valor mínimo para este registro SOA. Por convenção, isso é usado para determinar a duração negativa do cache.
refreshTime	integer (int64)	O valor de atualização para este registro SOA.
retryTime	integer (int64)	O tempo de repetição para este registro SOA.
serialNumber	integer (int64)	O número de série deste registro SOA.

SrvRecord

Objeto

Um registro SRV.

Nome	Tipo	Description
port	integer (int32)	O valor da porta para este registro SRV.
priority	integer (int32)	O valor de prioridade para este registro SRV.
target	string	O nome de domínio de destino para este registro SRV.
weight	integer (int32)	O valor de peso para este registro SRV.

TxtRecord

Objeto

Um registro TXT.

Nome	Tipo	Description
value	string[]	O valor de texto deste registro TXT.

Compartilhar via

Record Sets - List By Type

Parâmetros de URI

Respostas

Exemplos

GET Private DNS Zone A Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone AAAA Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone CNAME Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone MX Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone PTR Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone SOA Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone SRV Record Sets

Solicitação de exemplo

Resposta de exemplo

GET Private DNS Zone TXT Record Sets

Solicitação de exemplo

Resposta de exemplo

Definições

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordSetListResult

RecordType

SoaRecord

SrvRecord

TxtRecord