Formato de registros (JSON)

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 (.) nos campos rrdatas para serem nomes DNS totalmente qualificados.

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 (.) nos campos rrdatas para serem nomes DNS totalmente qualificados.

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 rrdatas precisa terminar com um ponto (.) para ser um nome de DNS totalmente qualificado.

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 (.) nos campos rrdatas para serem nomes DNS totalmente qualificados.

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 10.0.1.2 para o nome do host server.example.com, que pode ser definido na zona gerenciada denominada 0.10.in-addr.arpa.

SOA

Registro de início da autoridade, que especifica informações autoritativas sobre uma zona de DNS. Um registro de recurso SOA é gerado para você ao criar sua zona gerenciada. É possível modificar o registro conforme necessário.

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 (.) nos campos rrdatas para serem nomes DNS totalmente qualificados.

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 (.) nos campos rrdatas para serem nomes DNS totalmente qualificados.

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 TXT consiste em uma lista de strings de caracteres [RFC 1035] (em inglês). No formato do arquivo da zona, você grava como uma sequência de strings separadas por espaços em branco. Cada string pode ter aspas ou não. Se uma das suas strings tiver um espaço em branco incorporado, você precisará usar o formato com aspas. Por exemplo:


{
  "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 TXT que contém uma única string de caracteres com espaços internos.

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