Ajouter, mettre à jour et supprimer des enregistrements

Console

1. Dans Google Cloud Console, accédez à la page Zones Cloud DNS.

   Accéder aux zones Cloud DNS

2. Cliquez sur le nom de la zone gérée à laquelle vous souhaitez ajouter l'enregistrement.

3. Sur la page Détails de la zone, cliquez sur Ajouter un jeu d'enregistrements standard.

4. Sur la page Créer un jeu d'enregistrements, saisissez le sous-domaine de la zone DNS dans le champ Nom DNS, par exemple mail. Le point final est automatiquement ajouté.

   Pour créer un enregistrement DNS générique, saisissez un astérisque (par exemple *.example.com).

   Le symbole @ ne crée pas automatiquement un enregistrement racine. Pour créer un enregistrement de ressources au niveau de l'apex du domaine, laissez le champ Nom DNS vide.

5. Sélectionnez le type d'enregistrement de la ressource (par exemple, MX).

6. Dans le champ TTL, saisissez une valeur numérique correspondant à la durée de vie (Time To Live) de l'enregistrement de la ressource, c'est-à-dire le délai pendant lequel il peut être mis en cache. Cette valeur doit être un entier positif.

7. Dans le menu Unité TTL, sélectionnez l'unité de temps (par exemple, minutes).

8. Selon le type d'enregistrement de ressource que vous avez sélectionné, remplissez les champs restants.

9. Pour saisir des informations supplémentaires, cliquez sur Ajouter un élément.

10. Cliquez sur Créer.

gcloud

Pour ajouter un jeu d'enregistrements de ressources, utilisez la commande gcloud dns record-sets create:

gcloud dns record-sets create RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Remplacez les éléments suivants :

• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RR_DATA : valeur arbitraire associée au jeu d'enregistrements de ressources (par exemple, 198.51.100.5). Vous pouvez également saisir plusieurs valeurs, rrdata1 rrdata2 rrdata3 (par exemple, 198.51.100.5 10.2.3.4…)
• TTL : valeur TTL (Time To Live) exprimée en secondes mise en cache par le résolveur de ce jeu d'enregistrements de ressources (par exemple, 30)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.

API

Pour ajouter un jeu d'enregistrements de ressources, utilisez la méthode resourceRecordSets.create:

POST https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
{
    "name": RRSET_NAME,
    "type": RRSET_TYPE,
    "ttl": TTL,
    "rrdatas": [[RR_DATA_1, RR_DATA_2]]
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.
• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)
• TTL : valeur TTL (Time To Live) exprimée en secondes mise en cache par le résolveur de ce jeu d'enregistrements de ressources (par exemple, 30)
• RR_DATA : valeur arbitraire associée au jeu d'enregistrements de ressources (par exemple, 198.51.100.5). Vous pouvez également saisir plusieurs valeurs, rrdata1 rrdata2 rrdata3 (par exemple, 198.51.100.5 10.2.3.4…)

Terraform

resource "google_dns_managed_zone" "parent_zone" {
  name        = "sample-zone"
  dns_name    = "sample-zone.hashicorptest.com."
  description = "Test Description"
}

resource "google_dns_record_set" "default" {
  managed_zone = google_dns_managed_zone.parent_zone.name
  name         = "test-record.sample-zone.hashicorptest.com."
  type         = "A"
  rrdatas      = ["10.0.0.1", "10.1.0.1"]
  ttl          = 86400
}

gcloud

1. Pour lancer une transaction, utilisez la commande gcloud dns record-sets transaction start:

   gcloud dns record-sets transaction start \
      --zone=MANAGED_ZONE
   

   Remplacez MANAGED_ZONE par le nom de la zone gérée dont vous souhaitez gérer les jeux d'enregistrements de ressources (par exemple, my-zone-name).

2. Pour ajouter un jeu d'enregistrements de ressources dans le cadre d'une transaction, utilisez la commande gcloud dns record-sets transaction add:

   gcloud dns record-sets transaction add RR_DATA \
      --name=DNS_NAME \
      --ttl=TTL \
      --type=RECORD_TYPE \
      --zone=MANAGED_ZONE
   

   Remplacez les éléments suivants :

   • RR_DATA : valeur arbitraire associée au jeu d'enregistrements de ressources (par exemple, 198.51.100.5). Vous pouvez également saisir plusieurs valeurs, rrdata1 rrdata2 rrdata3, par exemple, 198.51.100.5 10.2.3.4…
   • DNS_NAME : nom DNS ou nom de domaine du jeu d'enregistrements à ajouter (par exemple, test.example.com)
   • TTL : valeur TTL (Time To Live) du jeu d'enregistrements exprimée en nombre de secondes (par exemple, 300)
   • RECORD_TYPE : type d'enregistrement (par exemple, A)
   • MANAGED_ZONE: nom de la zone gérée dont vous souhaitez gérer les jeux d'enregistrements de ressources (par exemple, my-zone-name)

3. Pour exécuter la transaction, utilisez la commande gcloud dns record-sets transaction execute:

   gcloud dns record-sets transaction execute \
      --zone=MANAGED_ZONE
   

4. Pour ajouter une transaction générique, exécutez la commande gcloud dns record-sets transaction add:

   gcloud dns record-sets transaction add \
      --zone=MANAGED_ZONE \
      --name=WILDCARD_DNS_NAME \
      --type=RECORD_TYPE \
      --ttl=TTL
   

   Remplacez les éléments suivants :

   • MANAGED_ZONE: nom de la zone gérée dont vous souhaitez gérer les jeux d'enregistrements de ressources (par exemple, my-zone-name)
   • WILDCARD_DNS_NAME: nom DNS ou nom de domaine du jeu d'enregistrements de ressources que vous souhaitez ajouter, par exemple *.example.com. (notez le point final)
   • RECORD_TYPE : type d'enregistrement (par exemple, CNAME)
   • TTL : valeur TTL (Time To Live) du jeu d'enregistrements exprimée en nombre de secondes (par exemple, 300)

API

Pour créer une transaction avec de nouveaux jeux d'enregistrements de ressources, utilisez la méthode changes.create:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/changes

{
  "deletions": []
  "additions": [
    {
      "name": DNS_NAME,
      "type": RECORD_TYPE,
      "ttl": TTL,
      "rrdatas": [
        RR_DATA
      ]
    }
  ]
}

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet
• MANAGED_ZONE : nom ou ID de votre zone gérée
• DNS_NAME : nom DNS ou nom de domaine du jeu d'enregistrements, par exemple, test.example.com. (notez le point final)
• RECORD_TYPE : type d'enregistrement
• TTL : valeur TTL (Time To Live) du jeu d'enregistrements exprimée en nombre de secondes, par exemple, 30
• RR_DATA : valeur arbitraire associée au jeu d'enregistrements de ressources (par exemple, 198.51.100.5). Vous pouvez également saisir plusieurs valeurs, rrdata1 rrdata2 rrdata3 (par exemple, 198.51.100.5 10.2.3.4…)

Console

1. Dans Google Cloud Console, accédez à la page Cloud DNS.

   Accéder à Cloud DNS

2. Dans l'onglet Zones, cliquez sur la zone pour laquelle vous souhaitez afficher les jeux d'enregistrements de ressources.

   La page Détails de la zone affiche les détails de tous les jeux d'enregistrements de ressources de cette zone.

gcloud

Pour afficher les enregistrements DNS de votre zone, utilisez la commande gcloud dns record-sets list:

gcloud dns record-sets list \
   --zone="ZONE_NAME"

Remplacez ZONE_NAME par le nom d'une zone DNS dans votre projet :

La commande génère la réponse JSON pour le jeu d'enregistrements de ressources pour les 100 premiers enregistrements. Vous pouvez spécifier les paramètres supplémentaires suivants :

• --limit : nombre maximal de jeux d'enregistrements à répertorier
• --name: ne répertorie que les jeux d'enregistrements de ressources portant ce nom de domaine
• --type : ne répertorie que les enregistrements de ce type. Si ce paramètre est présent, le paramètre --name doit également être spécifié.

API

Pour afficher les enregistrements DNS de votre zone, utilisez la méthode resourceRecordSets.list:

GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONErrsets

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.

Console

1. Dans Google Cloud Console, accédez à la page Zones Cloud DNS.

   Accéder aux zones Cloud DNS

2. Cliquez sur la zone contenant le jeu d'enregistrements de ressources.

3. Cliquez sur le jeu d'enregistrements de ressources dont vous souhaitez afficher les détails.

   La page Détails du jeu d'enregistrements de ressources affiche les détails du jeu d'enregistrements de ressources.

gcloud

Pour afficher les détails d'un jeu d'enregistrements de ressources existant, utilisez la commande gcloud dns record-sets describe:

gcloud dns record-sets describe RRSET_NAME \
  --type=RRSET_TYPE \
  --zone=MANAGED_ZONE

Remplacez les éléments suivants :

• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.

API

Pour obtenir les détails d'un jeu d'enregistrements de ressources existant, utilisez la méthode resourceRecordSets.get:

GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.
• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RRSET_TYPE: type d'enregistrement de ce jeu d'enregistrements de ressources (par exemple, A)

Console

Pour appliquer une mise à jour partielle à un jeu d'enregistrements de ressources existant, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Zones Cloud DNS.

   Accéder aux zones Cloud DNS

2. Cliquez sur la zone pour laquelle vous souhaitez mettre à jour le jeu d'enregistrements de ressources.

3. Sur la page Détails de la zone, à côté du jeu d'enregistrements de ressources que vous souhaitez mettre à jour, cliquez sur editModifier.

4. Après avoir effectué les mises à jour nécessaires, cliquez sur Enregistrer.

gcloud

Pour appliquer une mise à jour partielle à un jeu d'enregistrements de ressources existant, utilisez la commande gcloud dns record-sets update:

gcloud dns record-sets update RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Remplacez les éléments suivants :

• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RR_DATA : valeur arbitraire associée au jeu d'enregistrements de ressources (par exemple, 198.51.100.5). Vous pouvez également saisir plusieurs valeurs, rrdata1 rrdata2 rrdata3 (par exemple, 198.51.100.5 10.2.3.4…)
• TTL : valeur TTL (Time To Live) exprimée en secondes mise en cache par le résolveur de ce jeu d'enregistrements de ressources (par exemple, 30)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.

API

Pour appliquer une mise à jour partielle à un jeu d'enregistrements de ressources existant, utilisez la méthode resourceRecordSets.patch:

PATCH https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
{
  "ttl": TTL,
  "rrdatas": RR_DATA,
  "update_mask": {
      "paths": ["rrset.ttl", "rrset.rrdatas"]
  }
}

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.
• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)
• TTL : valeur TTL (Time To Live) exprimée en secondes mise en cache par le résolveur de ce jeu d'enregistrements de ressources (par exemple, 30)
• RR_DATA : valeur arbitraire associée au jeu d'enregistrements de ressources (par exemple, 198.51.100.5). Vous pouvez également saisir plusieurs valeurs, rrdata1 rrdata2 rrdata3 (par exemple, 198.51.100.5 10.2.3.4…)

Console

1. Dans la console Google Cloud, accédez à la page Cloud DNS.

   Accéder aux zones Cloud DNS

   Les enregistrements de la zone sont répertoriés sur la page Détails de la zone.

2. Pour supprimer des jeux d'enregistrements de ressources dans une zone, cliquez sur le nom de la zone.

3. Cochez la case à côté des ensembles d'enregistrements de ressources que vous souhaitez supprimer.

4. Cliquez sur Supprimer les jeux d'enregistrements.

gcloud

Pour supprimer un jeu d'enregistrements de ressources existant, exécutez la commande gcloud dns record-sets delete:

gcloud dns record-sets delete RRSET_NAME \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Remplacez les éléments suivants :

• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.

API

Pour supprimer un jeu d'enregistrements de ressources existant, utilisez la méthode resourceRecordSets.delete:

DELETE https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet
• MANAGED_ZONE : zone gérée à laquelle ce jeu d'enregistrements de ressources est associé, par exemple my-zone-name. Le nom de ce jeu d'enregistrements de ressources doit porter le nom DNS de la zone gérée en tant que suffixe.
• RRSET_NAME : nom DNS correspondant aux requêtes entrantes avec le nom DNS de cette zone en tant que suffixe (par exemple, test.example.com)
• RRSET_TYPE : type d'enregistrement de ressources de ce jeu d'enregistrements de ressources (par exemple, A)

gcloud

1. Pour importer un jeu d'enregistrements de ressources, utilisez la commande dns record-sets import:

   gcloud dns record-sets import -z=ZONE_NAME
   

   Si vous souhaitez spécifier le format de fichier du fichier de zone, utilisez la commande précédente avec l'option --zone-file-format. Si vous omettez l'option, vous devez fournir un fichier de zone au format YAML.

   Remplacez ZONE_NAME par un nouveau nom pour votre zone.

   • Lorsque vous exécutez la commande gcloud dns record-sets import avec l'indicateur --replace-origin-ns, elle remplace les enregistrements NS de la zone par les enregistrements NS spécifiés dans le fichier de zone. Ces enregistrements doivent correspondre aux serveurs de noms attribués par Cloud DNS pour héberger la zone. Ils doivent également correspondre aux enregistrements NS spécifiés dans la zone parente (délégation). Par défaut, Cloud DNS ne remplace pas les enregistrements NS. Si vous utilisez cette option, vous devez vérifier que les enregistrements NS sont corrects.

   • Lorsque vous importez des jeux d'enregistrements au format de zone BIND, supprimez le signe @ qui indique l'apex de la zone. Dans le fichier au format de zone BIND, pour un nom DNS tel que example.com, le signe @ fait référence à example.com.. Toutefois, dans Cloud DNS, le signe @ est traité littéralement lors de la définition des noms d'enregistrement. Pour créer un jeu d'enregistrements de ressources pour l'apex de la zone dans Cloud DNS, utilisez le nom de domaine complet (par exemple, example.com.).

     in.smtp              IN MX 5 gmail-smtp-in.l.google.com
     in.smtp.example.com. IN MX 5 gmail-smtp-in.l.google.com.example.com.
     

     Pour importer vos fichiers de zone, ajoutez un point final (.) à la fin de tous les noms de domaine qui doivent être qualifiés.

2. Pour exporter un jeu d'enregistrements de ressources, utilisez la commande dns record-sets export. Pour spécifier l'exportation des jeux d'enregistrements de ressources dans un fichier au format de zone BIND, utilisez l'option --zone-file-format. Exemple :

   example.com. 21600 IN NS ns-gcp-private.googledomains.com.
   example.com. 21600 IN SOA ns-gcp-private.googledomains.com.
   cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   host1.example.com. 300 IN A 192.0.2.91
   

   Si vous omettez l'option --zone-file-format, export exporte le jeu d'enregistrements de ressources dans un fichier d'enregistrements au format YAML:

   gcloud dns record-sets export example.zone -z=examplezonename
   

   Exemple :

   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com.
   ttl: 21600
   type: NS
   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com. cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   ttl: 21600
   type: SOA
   ---
   kind: dns#resourceRecordSet
   name: host1.example.com.
   rrdatas:
   - 192.0.2.91
   ttl: 300
   type: A
   
   

   Cloud DNS accepte le type d'enregistrement ALIAS, qui n'est pas un type d'enregistrement DNS standard et n'est pas compatible avec BIND. Si vous exportez des jeux d'enregistrements de ressources vers BIND, les enregistrements ALIAS sont ignorés. Si une zone comporte une stratégie de routage, elle est exportée en tant qu'enregistrement avec des données d'enregistrement de ressources (rrdata) vides.