Aggiungere, aggiornare ed eliminare record

Console

1. Nella console Google Cloud, vai alla pagina 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, inserisci il sottodominio della zona DNS nel campo Nome 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 principale. Per creare un record di risorse all'apice del dominio, lascia vuoto il campo Nome DNS.

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

6. Nel campo TTL, inserisci un valore numerico per la durata del record della risorsa, 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 delle 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 per 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 insieme di record di risorse, ad esempio A.
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita

API

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita
• 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 per 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 delle 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…

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. 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: il durata (TTL) per il record impostato in numero di 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 con caratteri 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 delle risorse da 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 numero di 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 dell'insieme di record, ad esempio test.example.com. (nota il punto finale)
• RECORD_TYPE: il tipo di record
• TTL: il valore durata (TTL) per il set di record in numero di secondi, ad esempio 30
• RR_DATA: un valore arbitrario associato al set di record delle 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…

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 nella zona in questione.

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 delle risorse per i primi 100 record. Puoi specificare i seguenti parametri aggiuntivi:

• --limit: numero massimo di set di record 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://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONErrsets

Sostituisci quanto segue:

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

Console

1. Nella console Google Cloud, vai alla pagina 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 delle 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 insieme 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 insieme di record di risorse, ad esempio A.
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita

API

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

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita
• 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 insieme di record di risorse, ad esempio A.

Console

Per applicare un aggiornamento parziale a un insieme di record di risorse esistente:

1. Nella console Google Cloud, vai alla pagina 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 editModifica.

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

gcloud

Per applicare un aggiornamento parziale a un insieme 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 delle 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 per 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 insieme di record di risorse, ad esempio A.
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita

API

Per applicare un aggiornamento parziale a un insieme di record di risorse esistente, utilizza il metodo 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"]
  }
}

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita
• 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 insieme di record di risorse, ad esempio A.
• TTL: il TTL in secondi per 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 delle 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…

Console

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

   Vai alle zone Cloud DNS

   I record per la zona sono elencati nella pagina Dettagli zona.

2. Per eliminare i set di record di risorse in una zona, fai clic sul nome della zona.

3. Seleziona la casella di controllo accanto ai set di record di risorse che vuoi eliminare.

4. Fai clic su Elimina set di record.

gcloud

Per eliminare un set di record di risorse esistente, utilizza il comando gcloud dns record-sets delete:

gcloud dns record-sets delete 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 insieme di record di risorse, ad esempio A.
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita

API

Per eliminare un set di record di risorse esistente, utilizza il metodo resourceRecordSets.delete:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID del progetto
• MANAGED_ZONE: la zona gestita a cui è affiliato questo set di record di risorse, ad esempio my-zone-name; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita
• 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 insieme di record di risorse, ad esempio A.

gcloud

1. Per importare un insieme di record di risorse, utilizza il comando dns record-sets import:

   gcloud dns record-sets import -z=ZONE_NAME
   

   Se vuoi specificare il formato del file della zona, utilizza il comando precedente con il flag --zone-file-format. Se ometti il flag, devi fornire un file zona in formato YAML.

   Sostituisci ZONE_NAME con un nuovo nome per la zona.

   • Quando utilizzi il comando gcloud dns record-sets import con il --replace-origin-ns flag, vengono sostituiti i record NS per la zona con i record NS specificati nel file della zona. Questi record devono corrispondere ai server dei nomi assegnati da Cloud DNS per ospitare la zona. Inoltre, devono corrispondere ai record NS specificati nella zona principale (di delega). Per impostazione predefinita, Cloud DNS non sovrascrive i record NS. Se utilizzi questo flag, devi verificare che i record NS siano corretti.

   • Quando importi i set di record come file in formato zona BIND, rimuovi il segno di attribuzione (@) che indica l'apice della zona. Nel file in formato zona BIND, per un nome DNS come example.com, il simbolo @ fa riferimento a example.com.. Tuttavia, in Cloud DNS, il simbolo @ viene trattato in modo letterale quando si definiscono i nomi dei record. Per creare un set di record di risorse per l'apice della zona in Cloud DNS, utilizza il nome di dominio completo, ad esempio 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.
     

     Per importare i file zone, aggiungi un punto finale (.) alla fine di tutti i nomi di dominio che devono essere completi.

2. Per esportare un insieme di record di risorse, utilizza il comando dns record-sets export. Per specificare che i set di record di risorse devono essere esportati in un file in formato di zona BIND, utilizza il flag --zone-file-format. Ad esempio:

   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
   

   Se ometti il flag --zone-file-format, export esporta il set di record di risorse in un file di record in formato YAML:

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

   Ad esempio:

   ---
   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 supporta il tipo di record ALIAS, che non è un tipo di record DNS standard e non è supportato in BIND. Se esporti set di record di risorse in BIND, i record ALIAS vengono ignorati. Se una zona ha un criterio di routing, viene esportata come record con dati del record di risorse (rrdata) vuoti.