Ajouter, mettre à jour et supprimer des enregistrements

Cette page explique comment ajouter, modifier et supprimer des jeux d'enregistrements de ressources.

Pour afficher la liste des types d'enregistrements de ressources compatibles, consultez Types d'enregistrements de ressources compatibles.

Avant de commencer

  1. Créez une zone gérée. Remplissez les conditions préalables à la création d'une zone gérée et créez-en une.

  2. Sélectionnez un type d'enregistrement de ressources compatible. Choisissez un type d'enregistrement de ressources pour votre jeu d'enregistrements de ressources.

Ajouter un jeu d'enregistrements de ressources

Pour ajouter un jeu d'enregistrements de ressources, procédez comme suit :

Console

  1. Dans la console Google Cloud , 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 d'enregistrement apex. 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 créer 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://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
{
    "name": "RRSET_NAME",
    "type": "RRSET_TYPE",
    "ttl": TTL,
    "rrdatas": [ RR_DATA ]
}

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 dans une liste d'éléments séparés par une virgule (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
}

Ajouter une collection de jeux d'enregistrements de ressources dans une transaction

Vous pouvez ajouter plusieurs jeux d'enregistrements de ressources en créant une transaction qui spécifie les modifications. Une transaction est un groupe d'une ou plusieurs modifications d'enregistrements DNS qui doivent être appliquées en tant qu'unité. L'ensemble de la transaction ne peut que réussir ou échouer. Ainsi, vos données ne sont jamais laissées dans un état incohérent. Vous ne pouvez créer une transaction qu'à l'aide de la gcloud CLI ou de l'API Cloud DNS.

Pour créer une transaction, procédez comme suit :

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…)

Pour distribuer les e-mails vers votre domaine, vous devez ajouter des enregistrements MX à votre zone. Si vous utilisez Google Workspace comme fournisseur SMTP (Simple Mail Transfer Protocol), consultez la page d'assistance Configurer des enregistrements MX Google Workspace. Sinon, utilisez les détails des enregistrements MX de votre fournisseur et suivez la procédure de configuration décrite pour Google Workspace.

Afficher les jeux d'enregistrements de ressources pour une zone

Pour afficher les jeux d'enregistrements de ressources d'une zone, procédez comme suit :

Console

  1. Dans la console Google Cloud , 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 répertorie 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://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets

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.

Afficher les détails d'un jeu d'enregistrements de ressources

Dans cette procédure, nous partons du principe que vous avez déjà créé un jeu d'enregistrements de ressources dans la zone Cloud DNS gérée.

Pour afficher les détails d'un jeu d'enregistrements de ressources existant, procédez comme suit :

Console

  1. Dans la console Google Cloud , 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://dns.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)

Mettre à jour un jeu d'enregistrements de ressources

Pour modifier un jeu d'enregistrements, procédez comme suit :

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