Questa pagina descrive come aggiungere, aggiornare ed eliminare set di record delle risorse.
Per visualizzare l'elenco dei tipi di record di risorse supportati, consulta Tipi di record di risorse supportati.
Prima di iniziare
Crea una zona gestita. Completa i prerequisiti per la creazione di una zona gestita e crea una zona gestita.
Seleziona un tipo di record di risorse supportato. Scegli un tipo di record di risorse per il tuo insieme di record di risorse.
Aggiungi un set di record di risorse
Per aggiungere un insieme di record di risorse:
Console
Nella console Google Cloud, vai alla pagina Zone Cloud DNS.
Fai clic sul nome della zona gestita a cui vuoi aggiungere il record.
Nella pagina Dettagli zona, fai clic su Aggiungi standard.
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.
Seleziona il Tipo di record risorsa, ad esempio
MX
.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.
Nel menu Unità TTL, seleziona l'unità di tempo, ad esempio
minutes
.A seconda del tipo di record di risorse selezionato, compila i campi rimanenti.
Per inserire ulteriori informazioni, fai clic su Aggiungi elemento.
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 esempiotest.example.com
RR_DATA
: un valore arbitrario associato al set di record delle risorse, ad esempio198.51.100.5
. Puoi anche inserire più valori,rrdata1
rrdata2
rrdata3
, ad esempio198.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 esempio30
RRSET_TYPE
: il tipo di record di risorse di questo insieme di record di risorse, ad esempioA
.MANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-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 progettoMANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-zone-name
; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestitaRRSET_NAME
: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempiotest.example.com
RRSET_TYPE
: il tipo di record di risorse di questo set di record di risorse, ad esempioA
TTL
: il TTL in secondi per cui il resolver memorizza nella cache questo set di record di risorse, ad esempio30
RR_DATA
: un valore arbitrario associato al set di record delle risorse, ad esempio198.51.100.5
. Puoi anche inserire più valori,rrdata1
rrdata2
rrdata3
, ad esempio198.51.100.5
10.2.3.4
…
Terraform
Aggiungere 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à. L'intera transazione riesce o non riesce, garantendo che i dati non rimangano mai in uno stato incoerente. Puoi creare una transazione solo utilizzando l'interfaccia a riga di comando gcloud o l'API Cloud DNS.
Per creare una transazione:
gcloud
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 esempiomy-zone-name
.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 esempio198.51.100.5
. Puoi anche inserire più valori,rrdata1
rrdata2
rrdata3
, ad esempio198.51.100.5
10.2.3.4
...DNS_NAME
: il nome DNS o di dominio del set di record da aggiungere, ad esempiotest.example.com
TTL
: il durata (TTL) per il record impostato in numero di secondi, ad esempio300
RECORD_TYPE
: il tipo di record, ad esempioA
.MANAGED_ZONE
: il nome della zona gestita di cui vuoi gestire i set di record di risorse, ad esempiomy-zone-name
Per eseguire la transazione, utilizza il comando
gcloud dns record-sets transaction execute
:gcloud dns record-sets transaction execute \ --zone=MANAGED_ZONE
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 esempiomy-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 esempioCNAME
.TTL
: il TTL per il set di record in numero di secondi, ad esempio300
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 progettoMANAGED_ZONE
: il nome o l'ID della zona gestitaDNS_NAME
: il nome DNS o di dominio dell'insieme di record, ad esempiotest.example.com.
(nota il punto finale)RECORD_TYPE
: il tipo di recordTTL
: il valore durata (TTL) per il set di record in numero di secondi, ad esempio30
RR_DATA
: un valore arbitrario associato al set di record delle risorse, ad esempio198.51.100.5
. Puoi anche inserire più valori,rrdata1
rrdata2
rrdata3
, ad esempio198.51.100.5
10.2.3.4
…
Per inviare le email al tuo dominio, devi aggiungere record MX
alla tua zona. Se utilizzi Google Workspace come provider SMTP (Simple Mail Transfer Protocol), consulta la pagina di assistenza Configurare i record MX
di Google Workspace. In caso contrario,
utilizza i dettagli del record MX
del tuo provider e segui la procedura di configurazione
descritta per Google Workspace.
Visualizzare i set di record di risorse per una zona
Per visualizzare gli insiemi di record di risorse per una zona:
Console
Nella console Google Cloud, vai alla pagina Cloud DNS.
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 progettoMANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-zone-name
; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestita
Visualizza i dettagli di un set di record di risorse
Questa procedura presuppone che tu abbia già creato un insieme di record di risorse nella zona Cloud DNS gestita.
Per visualizzare i dettagli di un insieme di record di risorse esistente:
Console
Nella console Google Cloud, vai alla pagina Zone Cloud DNS.
Fai clic sulla zona che contiene il set di record di risorse.
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 esempiotest.example.com
RRSET_TYPE
: il tipo di record di risorse di questo insieme di record di risorse, ad esempioA
.MANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-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 progettoMANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-zone-name
; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestitaRRSET_NAME
: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempiotest.example.com
RRSET_TYPE
: il tipo di record di questo insieme di record di risorse, ad esempioA
.
Aggiornare un set di record di risorse
Per modificare un insieme di record:
Console
Per applicare un aggiornamento parziale a un insieme di record di risorse esistente:
Nella console Google Cloud, vai alla pagina Zone Cloud DNS.
Fai clic sulla zona per cui vuoi aggiornare il set di record di risorse.
Nella pagina Dettagli zona, accanto al set di record di risorse che vuoi aggiornare, fai clic su editModifica.
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 esempiotest.example.com
RR_DATA
: un valore arbitrario associato al set di record delle risorse, ad esempio198.51.100.5
. Puoi anche inserire più valori,rrdata1
rrdata2
rrdata3
, ad esempio198.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 esempio30
RRSET_TYPE
: il tipo di record di risorse di questo insieme di record di risorse, ad esempioA
.MANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-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 progettoMANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-zone-name
; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestitaRRSET_NAME
: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempiotest.example.com
RRSET_TYPE
: il tipo di record di risorse di questo insieme di record di risorse, ad esempioA
.TTL
: il TTL in secondi per cui il resolver memorizza nella cache questo set di record di risorse, ad esempio30
RR_DATA
: un valore arbitrario associato al set di record delle risorse, ad esempio198.51.100.5
. Puoi anche inserire più valori,rrdata1
rrdata2
rrdata3
, ad esempio198.51.100.5
10.2.3.4
…
Eliminare i set di record di risorse
Quando elimini i set di record di risorse, i relativi record DNS vengono rimossi definitivamente e non possono essere recuperati. Per evitare di perdere i record DNS, esporta i set di record di risorse prima dell'eliminazione. Per informazioni su come esportare i set di record di risorse, consulta Importare ed esportare set di record di risorse.
Cloud DNS crea automaticamente i record NS
e SOA
all'apice della zona. Questi record non possono essere eliminati utilizzando l'API Cloud DNS
e vengono eliminati automaticamente quando viene eliminata la zona. Per ulteriori informazioni, consulta la RFC 1034.
Per eliminare i set di record di risorse:
Console
Nella console Google Cloud, vai alla pagina Cloud DNS.
I record per la zona sono elencati nella pagina Dettagli zona.
Per eliminare i set di record di risorse in una zona, fai clic sul nome della zona.
Seleziona la casella di controllo accanto ai set di record di risorse che vuoi eliminare.
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 esempiotest.example.com
RRSET_TYPE
: il tipo di record di risorse di questo insieme di record di risorse, ad esempioA
.MANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-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 progettoMANAGED_ZONE
: la zona gestita a cui è affiliato questo set di record di risorse, ad esempiomy-zone-name
; il nome di questo set di record di risorse deve avere come suffisso il nome DNS della zona gestitaRRSET_NAME
: il nome DNS che corrisponde alle query in entrata con il nome DNS di questa zona come suffisso, ad esempiotest.example.com
RRSET_TYPE
: il tipo di record di risorse di questo insieme di record di risorse, ad esempioA
.
Importare ed esportare set di record di risorse
Per copiare insiemi di record di risorse in e da una zona gestita, puoi utilizzare i comandi import
e
export
. Puoi importare ed esportare nel formato file zona BIND o nel formato file YAML.
gcloud
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 recordNS
specificati nella zona principale (di delega). Per impostazione predefinita, Cloud DNS non sovrascrive i recordNS
. Se utilizzi questo flag, devi verificare che i recordNS
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 aexample.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 esempioexample.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.
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 inBIND
. Se esporti set di record di risorse inBIND
, i recordALIAS
vengono ignorati. Se una zona ha un criterio di routing, viene esportata come record con dati del record di risorse (rrdata) vuoti.
Tipi di record di risorse supportati
Per il tipo di record | Invio |
---|---|
A |
L'indirizzo numerico dell'host in formato decimale puntato IPv4. Il
tipo di record |
AAAA |
L'indirizzo IP numerico dell'host in formato esadecimale IPv6. Il
tipo di record |
ALIAS ([Preview](/products#product-launch-stages)) |
Il nome canonico da risolvere per le query sugli indirizzi in entrata, ad esempio |
CNAME |
L'alias DNS per un record
Puoi anche utilizzare il tipo di record
A volte, un server dei nomi risponde con il record |
HTTPS , SVCB |
La priorità del servizio ( |
MX |
Un numero di preferenza e il nome DNS di un server MX (Mail Exchange) che
riceve le email per conto del tuo dominio. I server SMTP preferiscono i server
con numeri di preferenza più bassi. Ad esempio: Assicurati che tra il numero della preferenza e il
nome DNS sia presente uno spazio. Il record MX inserito deve terminare con un punto ( Puoi creare più record con priorità diverse per configurare i server di posta di backup o utilizzare la stessa priorità per distribuire il carico su più server di posta. Ad esempio, per indirizzare l'email al tuo account Google Workspace, inserisci quanto segue:
|
NS |
Il nome DNS del server dei nomi autorevole che fornisce servizi DNS per il tuo dominio o sottodominio. I record |
SPF |
Il tipo di set di record di risorse |
SRV |
I dati che specificano la posizione, ovvero il nome host e il numero di porta, dei server per un determinato servizio, ad esempio Per ulteriori informazioni, consulta RFC 2782. |
SSHFP |
Il numero dell'algoritmo del server SSH, il numero del tipo di impronta digitale e l'impronta digitale della chiave, ad esempio
Utilizza questo tipo di record solo se hai attivato DNSSEC per questa zona. |
TXT |
Dati di testo, che possono contenere testo arbitrario e possono essere utilizzati anche per definire dati leggibili dalla macchina, ad esempio informazioni sulla sicurezza o sulla prevenzione degli abusi. Un record TXT può contenere una o più stringhe di testo. La lunghezza massima di ogni
stringa è 255 caratteri. Se i dati del record sono superiori a 255
byte, dividi il record in stringhe di 255 byte e racchiudi ogni
stringa tra virgolette, ad esempio
Gli agenti di posta e altri agenti software concatenano più stringhe. Racchiudi ogni stringa tra virgolette, ad esempio Ogni record TXT ha un limite di 1000 caratteri. Se hai bisogno di aumentare questo limite, contatta l'assistenza Google Cloud. |
Passaggi successivi
- Per informazioni sui comandi
gcloud
per i set di record di risorse, consultagcloud dns record-sets
. - Per controllare lo stato delle operazioni
gcloud
o API, consulta Monitora la propagazione DNS. - Per trovare soluzioni ai problemi comuni che potresti riscontrare durante l'utilizzo di Cloud DNS, consulta la sezione Risoluzione dei problemi.
- Per una panoramica di Cloud DNS, consulta la panoramica di Cloud DNS.