Format des enregistrements (JSON)

Cette page présente les formats JSON pour différents types d'enregistrements Cloud DNS. Pour commencer à utiliser Cloud DNS, consultez la page Démarrage rapide associée.

Types d'enregistrements DNS pris en charge

Cloud DNS accepte les types d'enregistrements suivants :

Type d'enregistrement Description
A

Enregistrement d'adresse utilisé pour faire correspondre un nom d'hôte à une adresse IPv4.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "1.2.3.4"
  ],
  "ttl": 86400,
  "type": "A"
}
AAAA

Enregistrement d'adresse IPv6 utilisé pour faire correspondre un nom d'hôte à une adresse IPv6.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "2607:f8b0:400a:801::1005"
  ],
  "ttl": 86400,
  "type": "AAAA"
}
CNAME

Enregistrement de nom canonique utilisé pour les noms d'alias.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "mail.example.com.",
  "rrdatas": [
      "example.com."
  ],
  "ttl": 86400,
  "type": "CNAME"
}

Notez que les noms d'hôte spécifiés dans les champs rrdatas doivent se terminer par des points (.) afin de correspondre à des noms DNS complets.

MX

Enregistrement Mail Exchange utilisé pour router des requêtes vers des serveurs de messagerie.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "10 mail.example.com.",
      "20 mail2.example.com."
  ],
  "ttl": 86400,
  "type": "MX"
}

Notez que les noms d'hôte spécifiés dans les champs rrdatas doivent se terminer par des points (.) afin de correspondre à des noms DNS complets.

NAPTR

Enregistrement de pointeur d'autorité de nommage, défini par le document RFC 3403.

Exemple de représentation du jeu d'enregistrements de ressources :


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

Notez que la valeur dans le champ de "remplacement" final de chaque rrdatas doit se terminer par un point (.) afin de correspondre à un nom DNS complet.

Ce type d'enregistrement pose plusieurs problèmes liés aux échappements. Les guillemets intégrés doivent être échappés dans JSON, comme le montre l'exemple ci-dessus. En outre, le champ "regexp" contient fréquemment des caractères de type "barre oblique inverse". Il est nécessaire de les échapper deux fois : une première fois comme requis par le format de fichier de zone et à nouveau comme requis par le format JSON. Ainsi, l'exemple proposé dans la section 6.1 du document RFC 3403 serait représenté dans l'API JSON de la façon suivante :


{
  "kind": "dns#resourceRecordSet",
  "name": "cid.urn.arpa.",
  "rrdatas": [
      "100 10 \"\" \"\" \"!^urn:cid:.+@([^\\\\.]+\\\\.)(.*)$!\\\\2!i\" ."
  ],
  "ttl": 300,
  "type": "NAPTR"
}
NS

Enregistrement du serveur de noms déléguant une zone DNS à un serveur primaire.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
      "ns-cloud1.googledomains.com."
  ],
  "ttl": 86400,
  "type": "NS"
}

Notez que les noms d'hôte spécifiés dans les champs rrdatas doivent se terminer par des points (.) afin de correspondre à des noms DNS complets.

PTR

Enregistrement de pointeur, souvent utilisé pour les recherches DNS inversées.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "2.1.0.10.in-addr.arpa.",
  "rrdatas": [
    "server.example.com."
  ],
  "ttl": 60,
  "type": "PTR"
}

Cet enregistrement crée un mappage entre l'adresse 10.0.1.2 et le nom d'hôte server.example.com, qui peut être défini dans la zone gérée nommée 0.10.in-addr.arpa.

SOA

Début de l'enregistrement d'autorité spécifiant les informations primaires relatives à une zone DNS. Un enregistrement de ressource SOA est généré pour vous lorsque vous créez votre zone gérée. Vous pouvez le modifier si nécessaire.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "ns-cloud1.googledomains.com. dns-admin.google.com. 1 21600 3600 1209600 300"
  ],
  "ttl": 21600,
  "type": "SOA"
}

Notez que les noms d'hôte spécifiés dans les champs rrdatas doivent se terminer par des points (.) afin de correspondre à des noms DNS complets.

SPF

Enregistrement Sender Policy Framework utilisé dans les systèmes de validation des e-mails.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "v=spf1 mx:example.com -all"
  ],
  "ttl": 21600,
  "type": "SPF"
}
SRV

Enregistrement de localisateur de service utilisé par certains protocoles de voix sur IP et de messagerie instantanée, ainsi que par d'autres applications.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "sip.example.com.",
  "rrdatas": [
    "0 5 5060 sip.example.com."
  ],
  "ttl": 21600,
  "type": "SRV"
}

Notez que les noms d'hôte spécifiés dans les champs rrdatas doivent se terminer par des points (.) afin de correspondre à des noms DNS complets.

TXT

Enregistrement de texte pouvant contenir du texte arbitraire et permettant de définir des données exploitables par un ordinateur, telles que des informations de sécurité ou de prévention des abus.

Exemple de représentation du jeu d'enregistrements de ressources :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "google-site-verification=xxxxxxxxxxxxYYYYYYXXX"
  ],
  "ttl": 21600,
  "type": "TXT"
}

Un enregistrement TXT est composé d'une suite de chaînes de caractères (RFC 1035). Dans le format de fichier de zone, vous devez l'écrire sous la forme d'une séquence de chaînes séparées par des espaces. Chaque chaîne peut être précédée et suivie de guillemets ou non. Si l'une de vos chaînes contient des espaces, vous devez utiliser la forme "entre guillemets", par exemple :


{
  "kind": "dns#resourceRecordSet",
  "name": "example.com.",
  "rrdatas": [
    "\"v=spf1 include:_spf.google.com ~all\""
  ],
  "ttl": 21600,
  "type": "TXT"
}

Le jeu d'enregistrements de ressources ci-dessus est constitué d'un seul enregistrement de ressource TXT. Ce dernier contient une chaîne de caractères unique incluant des espaces.

Enregistrements DNS wildcard (zones génériques)

Les enregistrements wildcard sont compatibles avec tous les types d'enregistrements, à l'exception des enregistrements NS. Par exemple, vous pouvez mapper tous les sous-domaines avec l'adresse IP 1.2.3.4 à l'aide de la requête Change suivante :

{
"additions": [
    {
      "kind": "dns#resourceRecordSet",
      "name": "*.example.com.",
      "rrdatas": [
        "1.2.3.4"
       ],
       "ttl": 21600,
       "type": "A"
    }
]
}

Étapes suivantes