Auf dieser Seite wird beschrieben, wie Sie Ressourcendatensätze hinzufügen, aktualisieren und löschen.
Eine Liste der unterstützten Ressourceneintragstypen finden Sie unter DNS-Einträge – Übersicht.
Hinweise
Sie müssen eine verwaltete Zone haben oder erstellen, bevor Sie einen Ressourcendatensatz erstellen können. Eine Anleitung zum Erstellen einer verwalteten Zone, in der Sie Ihren Ressourcendatensatz erstellen können, finden Sie unter Verwaltete Zone erstellen.
Ressourceneintragssatz hinzufügen
So fügen Sie einen Ressourcendatensatz hinzu:
Console
Rufen Sie in der Google Cloud Console die Seite Cloud DNS-Zonen auf.
Klicken Sie auf den Namen der verwalteten Zone, der Sie den Eintrag hinzufügen möchten.
Klicken Sie auf der Seite Zonendetails auf Standard hinzufügen.
Geben Sie auf der Seite Eintrag erstellen im Feld DNS-Name die Subdomain der DNS-Zone ein, z. B.
mail. Der abschließende Punkt wird automatisch am Ende hinzugefügt.Geben Sie zum Erstellen eines Platzhalter-DNS-Eintrags ein Sternchen ein, z. B.
*.example.com.Durch das At-Zeichen (@) wird nicht automatisch ein Apex-Eintrag erstellt. Wenn Sie einen Ressourceneintrag am Domain-Apex erstellen möchten, lassen Sie das Feld DNS-Name leer.
Wählen Sie den Ressourceneintragstyp aus, z. B.
MX.Geben Sie im Feld TTL einen numerischen Wert für die Gültigkeitsdauer des Ressourceneintrags ein, also den Zeitraum, den er im Cache gespeichert werden kann. Dieser Wert muss eine positive Ganzzahl sein
Wählen Sie im Menü Zeiteinheit die Zeiteinheit aus, z. B.
minutes.Je nach ausgewähltem Ressourceneintragstyp füllen Sie die übrigen Felder aus.
Wenn Sie zusätzliche Informationen eingeben möchten, klicken Sie auf Element hinzufügen.
Klicken Sie auf Erstellen.
gcloud
Verwenden Sie den Befehl gcloud dns record-sets create, um einen Ressourcendatensatz hinzuzufügen:
gcloud dns record-sets create RRSET_NAME \
--rrdatas=RR_DATA \
--ttl=TTL \
--type=RRSET_TYPE \
--zone=MANAGED_ZONE
Ersetzen Sie Folgendes:
RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRR_DATAist ein beliebiger Wert, der dem Ressourceneintrag zugeordnet ist, z. B.198.51.100.5Sie können auch mehrere Werte eingeben,rrdata1rrdata2rrdata3, zum Beispiel198.51.100.510.2.3.4...TTList die TTL in Sekunden, die der Resolver diesen Ressourcendatensatz im Cache speichert, z. B.30.RRSET_TYPE: der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.A.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.
API
Verwenden Sie zum Hinzufügen eines Ressourcendatensatzes die Methode 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 ]
}
Ersetzen Sie Folgendes:
PROJECT_IDist die ID des Projekts.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRRSET_TYPEist der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.ATTList die TTL in Sekunden, die der Resolver diesen Ressourcendatensatz im Cache speichert, z. B.30.RR_DATA: ein beliebiger Wert, der dem Ressourcendatensatz zugeordnet ist, z. B."198.51.100.5". Sie können auch mehrere Werte in einer durch Kommas getrennten Liste eingeben, z. B."198.51.100.5","10.2.3.4".
Terraform
Sammlung von Ressourceneinträgen in einer Transaktion hinzufügen
Sie können mehrere Ressourcendatensätze hinzufügen, indem Sie eine Transaktion erstellen, in der die Änderungen angegeben werden. Eine Transaktion besteht aus mindestens einer Änderung oder einer Gruppe von Änderungen an DNS-Einträgen, die als Einheit angewendet werden müssen. Nur die gesamte Transaktion kann erfolgreich sein oder fehlschlagen, sodass sich Ihre Daten niemals in einem inkonsistenten Zustand befinden. Sie können eine Transaktion nur mit der gcloud CLI oder der Cloud DNS API erstellen.
So erstellen Sie eine Transaktion:
gcloud
Zum Starten einer Transaktion verwenden Sie den Befehl
gcloud dns record-sets transaction start:gcloud dns record-sets transaction start \ --zone=MANAGED_ZONE
Ersetzen Sie
MANAGED_ZONEdurch den Namen der verwalteten Zone, deren Ressourcendatensätze Sie verwalten möchten, z. B.my-zone-name.Verwenden Sie den
gcloud dns record-sets transaction add-Befehl, um einen Ressourcendatensatz als Teil einer Transaktion hinzuzufügen:gcloud dns record-sets transaction add RR_DATA \ --name=DNS_NAME \ --ttl=TTL \ --type=RECORD_TYPE \ --zone=MANAGED_ZONE
Ersetzen Sie Folgendes:
RR_DATAist ein beliebiger Wert, der dem Ressourceneintrag zugeordnet ist, z. B.198.51.100.5. Sie können auch mehrere Werte eingeben,rrdata1rrdata2rrdata3, zum Beispiel198.51.100.510.2.3.4...DNS_NAMEist der DNS- oder Domainname des hinzuzufügenden Datensatzes, z. B.test.example.com.TTList die Gültigkeitsdauer (TTL) für den Datensatz in Sekunden, z. B.300.RECORD_TYPEist der Datensatztyp, z. B.A.MANAGED_ZONE: der Name der verwalteten Zone, deren Ressourcendatensätze Sie verwalten möchten, z. B.my-zone-name
Führen Sie die Transaktion mit dem Befehl
gcloud dns record-sets transaction executeaus:gcloud dns record-sets transaction execute \ --zone=MANAGED_ZONE
Verwenden Sie zum Hinzufügen einer Platzhaltertransaktion den Befehl
gcloud dns record-sets transaction add:gcloud dns record-sets transaction add \ --zone=MANAGED_ZONE \ --name=WILDCARD_DNS_NAME \ --type=RECORD_TYPE \ --ttl=TTL
Ersetzen Sie Folgendes:
MANAGED_ZONE: der Name der verwalteten Zone, deren Ressourcendatensätze Sie verwalten möchten, z. B.my-zone-nameWILDCARD_DNS_NAMEist der DNS- oder Domainname des hinzuzufügenden Ressourcendatensatzes, z. B.*.example.com.. Beachten Sie dabei den Punkt am Ende.RECORD_TYPEist der Datensatztyp, z. B.CNAME.TTList die TTL für den Datensatz in Sekunden, z. B.300
API
Verwenden Sie zum Erstellen einer Transaktion mit neuen Ressourcendatensätzen die Methode 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
]
}
]
}
Ersetzen Sie Folgendes:
PROJECT_ID: Ihre Projekt-IDMANAGED_ZONEist der Name oder ID Ihrer verwalteten ZoneDNS_NAMEist der DNS- oder Domainname des Datensatzes, z. B.test.example.com.. Beachten Sie den Punkt am Ende).RECORD_TYPEist der DatensatztypTTList die Gültigkeitsdauer (TTL) für den Datensatz in Sekunden, z. B.30RR_DATAist ein beliebiger Wert, der dem Ressourceneintrag zugeordnet ist, z. B.198.51.100.5Sie können auch mehrere Werte eingeben,rrdata1rrdata2rrdata3, zum Beispiel198.51.100.510.2.3.4...
Damit E‑Mails an Ihre Domain zugestellt werden können, müssen Sie Ihrer Zone MX-Einträge hinzufügen. Wenn Sie Google Workspace als SMTP-Anbieter (Simple Mail Transfer Protocol) verwenden, lesen Sie den Hilfeartikel Einrichten von MX-Einträgen für Google Workspace. Verwenden Sie andernfalls die MX-Eintragdetails von Ihrem Anbieter und folgen Sie der für Google Workspace beschriebenen Einrichtung.
Ressourceneintragssätze für eine Zone ansehen
So rufen Sie Ressourcendatensätze für eine Zone auf:
Console
Rufen Sie in der Google Cloud Console die Seite Cloud DNS auf.
Klicken Sie auf dem Tab Zonen auf die Zone, für die Sie die Ressourcendatensätze ansehen möchten.
Auf der Seite Zonendetails sind die Details aller Ressourcendatensätze in dieser Zone aufgeführt.
gcloud
Verwenden Sie den Befehl gcloud dns record-sets list, um die DNS-Einträge für Ihre Zone aufzurufen:
gcloud dns record-sets list \ --zone="ZONE_NAME"
Ersetzen Sie ZONE_NAME durch den Namen einer DNS-Zone in Ihrem Projekt.
Der Befehl gibt die JSON-Antwort für den Ressourcendatensatz der ersten 100 Einträge aus. Sie können außerdem die folgenden Parameter angeben:
--limit: Maximale Anzahl der Datensätze, die aufgelistet werden sollen.--name: Nur Ressourcendatensätze mit exakt diesem Domainnamen auflisten.--type: Nur Datensätze dieses Typs auflisten; falls vorhanden, muss der Parameter--nameauch vorhanden sein.
API
So rufen Sie die DNS-Einträge für Ihre Zone mit der Methode resourceRecordSets.list auf:
GET https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
Ersetzen Sie Folgendes:
PROJECT_IDist die ID des Projekts.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.
Details eines Ressourcendatensatzes ansehen
Bei diesem Verfahren wird davon ausgegangen, dass Sie bereits einen Ressourcendatensatz in der verwalteten Cloud DNS-Zone erstellt haben.
So rufen Sie die Details eines vorhandenen Ressourcendatensatzes auf:
Console
Rufen Sie in der Google Cloud Console die Seite Cloud DNS-Zonen auf.
Klicken Sie auf die Zone, die den Ressourcendatensatz enthält.
Klicken Sie auf den Ressourcendatensatz, dessen Details Sie sich ansehen möchten.
Auf der Seite Details zum Ressourceneintragssatz werden die Details des Ressourceneintragssatzes angezeigt.
gcloud
Zum Aufrufen der Details eines vorhandenen Ressourcendatensatzes verwenden Sie den Befehl gcloud dns record-sets describe:
gcloud dns record-sets describe RRSET_NAME \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE
Ersetzen Sie Folgendes:
RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRRSET_TYPE: der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.A.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.
API
Zum Abrufen der Details eines vorhandenen Ressourcendatensatzes verwenden Sie die Methode resourceRecordSets.get:
GET https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
Ersetzen Sie Folgendes:
PROJECT_IDist die ID des Projekts.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRRSET_TYPEist der Datensatztyp dieses Ressourcendatensatzes, z. B.A.
Ressourceneintragssatz aktualisieren
So ändern Sie einen Datensatz:
Console
So wenden Sie eine partielle Aktualisierung auf einen vorhandenen Ressourcendatensatz an:
Rufen Sie in der Google Cloud Console die Seite Cloud DNS-Zonen auf.
Klicken Sie auf die Zone, für die Sie den Ressourcendatensatz aktualisieren möchten.
Klicken Sie auf der Seite Zonendetails neben dem Ressourceneintrag, den Sie ändern möchten, auf editBearbeiten.
Nachdem Sie die Änderungen vorgenommen haben, klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud dns record-sets update, um eine partielle Aktualisierung auf einen vorhandenen Ressourcendatensatz anzuwenden:
gcloud dns record-sets update RRSET_NAME \
--rrdatas=RR_DATA \
--ttl=TTL \
--type=RRSET_TYPE \
--zone=MANAGED_ZONE
Ersetzen Sie Folgendes:
RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRR_DATAist ein beliebiger Wert, der dem Ressourceneintrag zugeordnet ist, z. B.198.51.100.5Sie können auch mehrere Werte eingeben,rrdata1rrdata2rrdata3, zum Beispiel198.51.100.510.2.3.4...TTList die TTL in Sekunden, die der Resolver diesen Ressourcendatensatz im Cache speichert, z. B.30.RRSET_TYPE: der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.A.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.
API
Verwenden Sie die Methode resourceRecordSets.patch, um eine partielle Aktualisierung auf einen vorhandenen Ressourcendatensatz anzuwenden:
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"]
}
}
Ersetzen Sie Folgendes:
PROJECT_IDist die ID des Projekts.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRRSET_TYPE: der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.A.TTList die TTL in Sekunden, die der Resolver diesen Ressourcendatensatz im Cache speichert, z. B.30.RR_DATAist ein beliebiger Wert, der dem Ressourceneintrag zugeordnet ist, z. B.198.51.100.5Sie können auch mehrere Werte eingeben,rrdata1rrdata2rrdata3, zum Beispiel198.51.100.510.2.3.4...
Ressourceneinträge löschen
Wenn Sie Ressourceneinträge löschen, werden die zugehörigen DNS-Einträge endgültig entfernt und können nicht wiederhergestellt werden. Damit Ihre DNS-Einträge nicht verloren gehen, exportieren Sie die Ressourcendatensätze vor dem Löschen. Informationen zum Exportieren von Ressourcendatensatzgruppen finden Sie unter Ressourcendatensatzgruppen importieren und exportieren.
Öffentliche Cloud DNS-Zonen sind autoritativ. Die Ressourceneintragstypen „Nameserver“ (NS) und „Start of Authority“ (SOA) befinden sich an der Zonenspitze, also im Stammverzeichnis der Domain.
Cloud DNS erstellt automatisch NS- und SOA-Einträge am Zonen-Apex. Diese Einträge können nicht über die Cloud DNS API gelöscht werden. Sie werden automatisch gelöscht, wenn die Zone gelöscht wird. Weitere Informationen finden Sie unter RFC 1034.
So löschen Sie Ressourcendatensätze:
Console
Rufen Sie in der Google Cloud Console die Seite Cloud DNS auf.
Einträge für die Zone werden auf der Seite Zonendetails aufgeführt.
Wenn Sie Ressourcendatensätze in einer Zone löschen möchten, klicken Sie auf den Namen der Zone.
Klicken Sie auf das Kästchen neben den Ressourceneintragssätzen, die Sie löschen möchten.
Klicken Sie auf Datensätze löschen.
gcloud
Verwenden Sie den Befehl gcloud dns record-sets delete, um einen vorhandenen Ressourcendatensatz zu löschen:
gcloud dns record-sets delete RRSET_NAME \
--type=RRSET_TYPE \
--zone=MANAGED_ZONE
Ersetzen Sie Folgendes:
RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRRSET_TYPE: der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.A.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.
API
Verwenden Sie die Methode resourceRecordSets.delete, um einen vorhandenen Ressourcendatensatz zu löschen:
DELETE https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
Ersetzen Sie Folgendes:
PROJECT_IDist die ID des Projekts.MANAGED_ZONEist die verwaltete Zone, mit der dieser Ressourcendatensatz verknüpft ist, z. B.my-zone-name. Der Name dieses Ressourcendatensatzes muss den DNS-Namen der verwalteten Zone als Suffix haben.RRSET_NAMEist der DNS-Name, der die eingehenden Abfragen mit dem DNS-Namen dieser Zone als Suffix kennzeichnet, z. B.test.example.comRRSET_TYPE: der Ressourceneintragstyp dieses Ressourcendatensatzes, z. B.A.
Ressourceneinträge importieren und exportieren
Wenn Sie Ressourcendatensätze in eine und aus einer verwalteten Zone kopieren möchten, können Sie die Befehle import und export verwenden. Sie können entweder das BIND-Zonendateiformat oder das YAML-Dateiformat für den Import und Export verwenden.
gcloud
Verwenden Sie den
dns record-sets import-Befehl, um einen Ressourcendatensatz zu importieren:gcloud dns record-sets import -z=ZONE_NAME
Wenn Sie das Dateiformat der Zonendatei angeben möchten, verwenden Sie den vorherigen Befehl mit dem Flag
--zone-file-format. Wenn Sie das Flag weglassen, müssen Sie eine Zonendatei im YAML-Format angeben.Ersetzen Sie
ZONE_NAMEdurch einen neuen Namen für die Zone.Wenn Sie den Befehl
gcloud dns record-sets importmit dem Flag--replace-origin-nsverwenden, werden die NS-Einträge für die Zone durch die NS-Einträge ersetzt, die in der Zonendatei angegeben sind. Diese Einträge müssen mit den Nameservern übereinstimmen, die von Cloud DNS zum Hosten der Zone zugewiesen wurden. Sie müssen außerdem mit denNS-Einträgen übereinstimmen, die in der übergeordneten (delegierenden) Zone angegeben sind. Cloud DNS überschreibtNS-Einträge standardmäßig nicht. Wenn Sie dieses Flag verwenden, müssen Sie prüfen, ob dieNS-Einträge korrekt sind.Wenn Sie Datensätze als Datei im BIND-Zonenformat importieren, entfernen Sie das At-Zeichen (@), das den Apex der Zone angibt. In der BIND-Zonendatei bezieht sich das At-Zeichen (@) für einen DNS-Namen wie
example.comaufexample.com.. In Cloud DNS wird das At-Zeichen (@) jedoch beim Definieren von Eintragsnamen wörtlich behandelt. Wenn Sie in Cloud DNS einen Ressourcendatensatz für den Apex der Zone erstellen möchten, verwenden Sie den vollständigen Domainnamen, z. B.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.
Wenn Sie Ihre Zonendateien importieren möchten, fügen Sie am Ende aller Domainnamen, die vollständig qualifiziert sein müssen, einen Schlusspunkt (
.) hinzu.
Verwenden Sie den
dns record-sets export-Befehl, um einen Ressourcendatensatz zu exportieren. Mit dem Flag--zone-file-formatkönnen Sie angeben, dass die Ressourcendatensätze in eine zonenformatierte BIND-Datei exportiert werden. Beispiel: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
Wenn Sie das Flag
--zone-file-formatweglassen, exportiertexportden Ressourcendatensatz in eine Eintragsdatei im YAML-Format:gcloud dns record-sets export example.zone -z=examplezonename
Beispiel:
--- 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: ACloud DNS unterstützt den Eintragstyp
ALIAS, der kein Standard-DNS-Eintragstyp ist und inBINDnicht unterstützt wird. Wenn Sie Ressourceneinträge inBINDexportieren, werdenALIAS-Einträge übersprungen. Wenn eine Zone eine Routingrichtlinie hat, wird sie als Eintrag mit leeren Ressourceneintrag-Daten (rrdata) exportiert.
Nächste Schritte
- Informationen zu
gcloud-Befehlen für Ressourceneintragssätze finden Sie untergcloud dns record-sets. - Informationen zum Prüfen des Status von
gcloudoder API-Vorgängen finden Sie unter DNS-Weitergabe überwachen. - Informationen zu Lösungen für häufige Probleme, die bei der Verwendung von Cloud DNS auftreten können, finden Sie unter Fehlerbehebung.
- Eine Übersicht über Cloud DNS finden Sie in der Cloud DNS-Übersicht.