Nesta página, você verá os formatos JSON para vários tipos de registro do Cloud DNS. Para começar a usar o Cloud DNS, consulte o Início rápido.
Tipos de registro DNS compatíveis
O Cloud DNS aceita os seguintes tipos de registro:
Tipo de registro | Descrição |
---|---|
A |
Registro de endereço, usado para mapear um nome de host a um endereço IPv4. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "1.2.3.4" ], "ttl": 86400, "type": "A" } |
AAAA |
Registro de endereço IPv6, usado para mapear um nome de host a um endereço IPv6. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "2607:f8b0:400a:801::1005" ], "ttl": 86400, "type": "AAAA" } |
CNAME |
Registro de nome canônico, usado para especificar nomes de alias. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "mail.example.com.", "rrdatas": [ "example.com." ], "ttl": 86400, "type": "CNAME" } Observe que os nomes de host precisam terminar com pontos ( |
MX |
Registro de troca de e-mails, usado no roteamento de solicitações para servidores de e-mail. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "10 mail.example.com.", "20 mail2.example.com." ], "ttl": 86400, "type": "MX" } Observe que os nomes de host precisam terminar com pontos ( |
NAPTR |
Registro PTR da autoridade de nomenclatura, definido pela referência RFC 3403 (em inglês). Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "2.1.2.1.5.5.5.0.7.7.1.e164.arpa.", "rrdatas": [ "100 10 \"u\" \"sip+E2U\" \"!^.*$!sip:information@foo.se!i\" .", "102 10 \"u\" \"smtp+E2U\" \"!^.*$!mailto:information@foo.se!i\" ." ], "ttl": 300, "type": "NAPTR" } Observe que o valor no campo "substituição" final de cada Esse tipo de registro gera vários problemas de escape. Aspas inclusas precisam ser escapadas para uso no JSON, conforme demonstrado acima. Além disso, o campo "regexp" frequentemente contém barras invertidas, que precisam de um escape duplo: uma vez conforme exigido pelo formato do arquivo de zona e uma segunda vez conforme exigido pelo formato JSON. Para demonstrar isso, o exemplo da referência RFC 3403, seção 6.1, seria representado na JSON API como: { "kind": "dns#resourceRecordSet", "name": "cid.urn.arpa.", "rrdatas": [ "100 10 \"\" \"\" \"!^urn:cid:.+@([^\\\\.]+\\\\.)(.*)$!\\\\2!i\" ." ], "ttl": 300, "type": "NAPTR" } |
NS |
Registro do servidor de nomes, que delega uma zona DNS a um servidor autoritativo. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "ns-cloud1.googledomains.com." ], "ttl": 86400, "type": "NS" } Observe que os nomes de host precisam terminar com pontos ( |
PTR |
Registro PTR, muitas vezes usado para buscas DNS reversas. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "2.1.0.10.in-addr.arpa.", "rrdatas": [ "server.example.com." ], "ttl": 60, "type": "PTR" } Cria um mapeamento a partir do endereço |
SOA |
Registro de início da autoridade, que especifica informações autoritativas sobre uma zona de DNS. Um registro de recurso Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "ns-cloud1.googledomains.com. dns-admin.google.com. 1 21600 3600 1209600 300" ], "ttl": 21600, "type": "SOA" } Observe que os nomes de host precisam terminar com pontos ( |
SPF |
Registro do framework da política do remetente, usado em sistemas de validação de e-mail. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "v=spf1 mx:example.com -all" ], "ttl": 21600, "type": "SPF" } |
SRV |
Registro de localizador de serviço, usado por alguns serviços de voz sobre IP, protocolos de mensagens instantâneas e outros aplicativos. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "sip.example.com.", "rrdatas": [ "0 5 5060 sip.example.com." ], "ttl": 21600, "type": "SRV" } Observe que os nomes de host precisam terminar com pontos ( |
TXT |
Registro de texto, que pode conter texto arbitrário e ser usado para definir dados legíveis por máquina, como informações de segurança ou para prevenção de abusos. Exemplo da representação do conjunto de registros de recursos: { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "google-site-verification=xxxxxxxxxxxxYYYYYYXXX" ], "ttl": 21600, "type": "TXT" }
O registro { "kind": "dns#resourceRecordSet", "name": "example.com.", "rrdatas": [ "\"v=spf1 include:_spf.google.com ~all\"" ], "ttl": 21600, "type": "TXT" } O conjunto de registros de recursos precedente consiste de um único registro de recursos |
Registros DNS curinga
Registros curinga são compatíveis com todos os tipos de registro, exceto os NS
.
Por exemplo, para mapear todos os subdomínios no endereço IP 1.2.3.4
, use a solicitação Change
a seguir:
{ "additions": [ { "kind": "dns#resourceRecordSet", "name": "*.example.com.", "rrdatas": [ "1.2.3.4" ], "ttl": 21600, "type": "A" } ] }
Próximas etapas
- Como gerenciar registros explica como usar esses formatos.
- Confira na Visão geral como eles se encaixam no framework geral.