Aggiungi, aggiorna ed elimina record

Questa pagina descrive come aggiungere, aggiornare ed eliminare set di record di risorse.

Per visualizzare l'elenco dei tipi di record di risorse supportati, consulta Tipi di record di risorse supportati.

Prima di iniziare

  1. Crea una zona gestita. Completa i prerequisiti per la creazione di una zona gestita e creane una.

  2. Seleziona un tipo di record di risorse supportato. Scegli un tipo di record di risorse per il tuo set di record di risorse.

Aggiungi un set di record di risorse

Per aggiungere un set di record di risorse, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina delle zone Cloud DNS.

    Vai alle zone Cloud DNS

  2. Fai clic sul nome della zona gestita a cui vuoi aggiungere il record.

  3. Nella pagina Dettagli zona, fai clic su Aggiungi standard.

  4. Nella pagina Crea set di record, nel campo Nome DNS, inserisci il sottodominio della zona DNS, ad esempio mail. Il punto finale viene aggiunto automaticamente alla fine.

    Per creare un record DNS jolly, inserisci un asterisco, ad esempio *.example.com.

    Il simbolo @ non crea automaticamente un record nell'apex. Per creare un record di risorse nell'apex del dominio, lascia vuoto il campo Nome DNS.

  5. Seleziona il Tipo di record di risorse, ad esempio MX.

  6. Nel campo TTL, inserisci un valore numerico per la durata del record di risorse, ovvero per quanto tempo può essere memorizzato nella cache. Questo valore deve essere un numero intero positivo.

  7. Nel menu Unità TTL, seleziona l'unità di tempo, ad esempio minutes.

  8. A seconda del tipo di record di risorse selezionato, compila i campi rimanenti.

  9. Per inserire ulteriori informazioni, fai clic su Aggiungi elemento.

  10. Fai clic su Crea.

gcloud

Per aggiungere un set di record di risorse, utilizza il comando gcloud dns record-sets create:

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

Sostituisci quanto segue:

  • RRSET_NAME: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempio test.example.com
  • RR_DATA: un valore arbitrario associato al set di record di risorse, ad esempio 198.51.100.5; puoi anche inserire più valori, rrdata1, rrdata2, rrdata3, ad esempio 198.51.100.5, 10.2.3.4…
  • TTL: il TTL in secondi in cui il resolver memorizza nella cache questo set di record di risorse, ad esempio 30
  • RRSET_TYPE: il tipo di record di risorse di questo set di record di risorse, ad esempio A
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso

API

Per aggiungere un set di record di risorse, utilizza il metodo 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 ]
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso
  • RRSET_NAME: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempio test.example.com
  • RRSET_TYPE: il tipo di record di risorse di questo set di record di risorse, ad esempio A
  • TTL: il TTL in secondi in cui il resolver memorizza nella cache questo set di record di risorse, ad esempio 30
  • RR_DATA: un valore arbitrario associato al set di record di risorse, ad esempio "198.51.100.5"; puoi anche inserire più valori in un elenco separato da virgole, ad esempio "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
}

Aggiungi una raccolta di set di record di risorse in una transazione

Puoi aggiungere più set di record di risorse creando una transazione che specifichi le modifiche. Una transazione è un gruppo di una o più modifiche ai record DNS che devono essere applicate come unità. La transazione va a buon fine oppure non riesce nella sua interezza, garantendo che i dati non vengano mai lasciati in uno stato incoerente. Puoi creare una transazione solo utilizzando gcloud CLI o l'API Cloud DNS.

Per creare una transazione, segui questi passaggi:

gcloud

  1. Per avviare una transazione, utilizza il comando gcloud dns record-sets transaction start:

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

    Sostituisci MANAGED_ZONE con il nome della zona gestita di cui vuoi gestire i set di record di risorse, ad esempio my-zone-name.

  2. Per aggiungere un set di record di risorse nell'ambito di una transazione, utilizza il comando 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

    Sostituisci quanto segue:

    • RR_DATA: un valore arbitrario associato al set di record di risorse, ad esempio 198.51.100.5; puoi anche inserire più valori, rrdata1, rrdata2, rrdata3, ad esempio 198.51.100.5, 10.2.3.4…
    • DNS_NAME: il nome DNS o di dominio del set di record da aggiungere, ad esempio test.example.com
    • TTL: la durata (TTL) del set di record in secondi, ad esempio 300
    • RECORD_TYPE: il tipo di record, ad esempio A
    • MANAGED_ZONE: il nome della zona gestita di cui vuoi gestire i set di record di risorse, ad esempio my-zone-name

  3. Per eseguire la transazione, utilizza il comando gcloud dns record-sets transaction execute:

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

  4. Per aggiungere una transazione jolly, utilizza il comando gcloud dns record-sets transaction add:

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

    Sostituisci quanto segue:

    • MANAGED_ZONE: il nome della zona gestita di cui vuoi gestire i set di record di risorse, ad esempio my-zone-name
    • WILDCARD_DNS_NAME: il nome DNS o di dominio del set di record di risorse che vuoi aggiungere, ad esempio *.example.com. (nota il punto finale)
    • RECORD_TYPE: il tipo di record, ad esempio CNAME
    • TTL: il TTL per il set di record in secondi, ad esempio 300

API

Per creare una transazione con nuovi set di record di risorse, utilizza il metodo 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
      ]
    }
  ]
}

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto
  • MANAGED_ZONE: il nome o l'ID della zona gestita
  • DNS_NAME: il nome DNS o di dominio del set di record, ad esempio test.example.com. (nota il punto finale)
  • RECORD_TYPE: il tipo di record
  • TTL: la durata (TTL) per il set di record in secondi, ad esempio 30
  • RR_DATA: un valore arbitrario associato al set di record di risorse, ad esempio 198.51.100.5; puoi anche inserire più valori, rrdata1, rrdata2, rrdata3, ad esempio 198.51.100.5, 10.2.3.4…

Per recapitare le email al tuo dominio, devi aggiungere record MX alla zona. Se utilizzi Google Workspace come provider SMTP (Simple Mail Transfer Protocol), consulta la pagina di assistenza Configura i record MX per Google Workspace. In caso contrario, utilizza i dettagli dei record MX del tuo provider e segui la procedura di configurazione descritta per Google Workspace.

Visualizza i set di record di risorse per una zona

Per visualizzare i set di record di risorse per una zona, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Cloud DNS.

    Vai a Cloud DNS

  2. Nella scheda Zone, fai clic sulla zona per cui vuoi visualizzare i set di record di risorse.

    La pagina Dettagli zona mostra i dettagli di tutti i set di record di risorse in quella zona.

gcloud

Per visualizzare i record DNS per la tua zona, utilizza il comando gcloud dns record-sets list:

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

Sostituisci ZONE_NAME con il nome di una zona DNS nel tuo progetto.

Il comando restituisce la risposta JSON per il set di record di risorse per i primi 100 record. Puoi specificare questi parametri aggiuntivi:

  • --limit: il numero massimo di record set da elencare
  • --name: elenca solo i set di record di risorse con questo nome di dominio esatto
  • --type: elenca solo i record di questo tipo; se presente, deve essere presente anche il parametro --name

API

Per visualizzare i record DNS per la tua zona, utilizza il metodo resourceRecordSets.list:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso

Visualizza i dettagli di un set di record di risorse

Questa procedura presuppone che tu abbia già creato un set di record di risorse all'interno della zona Cloud DNS gestita.

Per visualizzare i dettagli di un set di record di risorse esistente, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina delle zone Cloud DNS.

    Vai alle zone Cloud DNS

  2. Fai clic sulla zona che contiene il set di record di risorse.

  3. Fai clic sul set di record di risorse di cui vuoi visualizzare i dettagli.

    La pagina Dettagli del set di record di risorse mostra i dettagli del set di record di risorse.

gcloud

Per visualizzare i dettagli di un set di record di risorse esistente, utilizza il comando gcloud dns record-sets describe:

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

Sostituisci quanto segue:

  • RRSET_NAME: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempio test.example.com
  • RRSET_TYPE: il tipo di record di risorse di questo set di record di risorse, ad esempio A
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso

API

Per ottenere i dettagli di un set di record di risorse esistente, utilizza il metodo resourceRecordSets.get:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso
  • RRSET_NAME: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempio test.example.com
  • RRSET_TYPE: il tipo di record di questo set di record di risorse, ad esempio A.

Aggiorna un set di record di risorse

Per modificare un set di record, segui questi passaggi:

Console

Per applicare un aggiornamento parziale a un set di record di risorse esistente, segui questi passaggi:

  1. Nella console Google Cloud , vai alla pagina delle zone Cloud DNS.

    Vai alle zone Cloud DNS

  2. Fai clic sulla zona per cui vuoi aggiornare il set di record di risorse.

  3. Nella pagina Dettagli zona, accanto al set di record di risorse che vuoi aggiornare, fai clic su Modifica.

  4. Dopo aver apportato gli aggiornamenti necessari, fai clic su Salva.

gcloud

Per applicare un aggiornamento parziale a un set di record di risorse esistente, utilizza il comando gcloud dns record-sets update:

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

Sostituisci quanto segue:

  • RRSET_NAME: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempio test.example.com
  • RR_DATA: un valore arbitrario associato al set di record di risorse, ad esempio 198.51.100.5; puoi anche inserire più valori, rrdata1, rrdata2, rrdata3, ad esempio 198.51.100.5, 10.2.3.4…
  • TTL: il TTL in secondi in cui il resolver memorizza nella cache questo set di record di risorse, ad esempio 30
  • RRSET_TYPE: il tipo di record di risorse di questo set di record di risorse, ad esempio A
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso

API

Per applicare un aggiornamento parziale a un set di record di risorse esistente, utilizza il metodo resourceRecordSets.patch:

PATCH https://dns.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"]
  }
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • MANAGED_ZONE: la zona gestita a cui è associato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere il nome DNS della zona gestita come suffisso
  • RRSET_NAME: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempio test.example.com
  • RRSET_TYPE: il tipo di record di risorse di questo set di record di risorse, ad esempio A