This page describes how to add, update, and delete resource record sets.
To view the list of supported resource record types, see Supported resource record types.
Before you begin
Create a managed zone. Complete the prerequisites for creating a managed zone and create a managed zone.
Select a supported resource record type. Choose a resource record type for your resource record set.
Add a resource record set
To add a resource record set, follow these steps:
Console
In the Google Cloud console, go to the Cloud DNS zones page.
Click the name of the managed zone that you want to add the record to.
On the Zone details page, click Add standard.
On the Create record set page, in the DNS name field, enter the subdomain of the DNS zone—for example,
mail
. The trailing dot is automatically added at the end.To create a wildcard DNS record, enter an asterisk—for example,
*.example.com
.The at sign (@) does not automatically create an apex record. To create a resource record at the domain apex, leave the DNS name field blank.
Select the Resource record type—for example,
MX
.In the TTL field, enter a numeric value for the resource record's time to live, which is the amount of time that it can be cached. This value must be a positive integer.
From the TTL unit menu, select the unit of time—for example,
minutes
.Depending on the resource record type that you have selected, populate the remaining fields.
To enter additional information, click Add item.
Click Create.
gcloud
To add a resource record set, use the
gcloud dns record-sets create
command:
gcloud dns record-sets create RRSET_NAME \ --rrdatas=RR_DATA \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE
Replace the following:
RRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RR_DATA
: an arbitrary value associated with the resource record set—for example,198.51.100.5
; you can also enter multiple values,rrdata1
rrdata2
rrdata3
—for example,198.51.100.5
10.2.3.4
...TTL
: the TTL in seconds that the resolver caches this resource record set—for example,30
RRSET_TYPE
: the resource record type of this resource record set—for example,A
.MANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffix
API
To add a resource record set, use the
resourceRecordSets.create
method
method:
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]] }
Replace the following:
PROJECT_ID
: the ID of the projectMANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffixRRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RRSET_TYPE
: the resource record type of this resource record set—for example,A
TTL
: the TTL in seconds that the resolver caches this resource record set—for example,30
RR_DATA
: an arbitrary value associated with the resource record set—for example,198.51.100.5
; you can also enter multiple values,rrdata1
rrdata2
rrdata3
—for example,198.51.100.5
10.2.3.4
...
Terraform
Add a collection of resource record sets in a transaction
You can add multiple resource record sets by creating a transaction that specifies the changes. A transaction is a group of one or more DNS record changes that must be applied as a unit. The entire transaction either succeeds or fails, ensuring your data is never left in an inconsistent state. You can create a transaction only by using the gcloud CLI or the Cloud DNS API.
To create a transaction, follow these steps:
gcloud
To start a transaction, use the
gcloud dns record-sets transaction start
command:gcloud dns record-sets transaction start \ --zone=MANAGED_ZONE
Replace
MANAGED_ZONE
with the name of the managed zone whose resource record sets you want to manage—for example,my-zone-name
.To add a resource record set as part of a transaction, use the
gcloud dns record-sets transaction add
command:gcloud dns record-sets transaction add RR_DATA \ --name=DNS_NAME \ --ttl=TTL \ --type=RECORD_TYPE \ --zone=MANAGED_ZONE
Replace the following:
RR_DATA
: an arbitrary value associated with the resource record set—for example,198.51.100.5
; you can also enter multiple values,rrdata1
rrdata2
rrdata3
—for example,198.51.100.5
10.2.3.4
...DNS_NAME
: the DNS or domain name of the record set to add—for example,test.example.com
TTL
: the time to live (TTL) for the record set in number of seconds—for example,300
RECORD_TYPE
: the record type—for example,A
.MANAGED_ZONE
: the name of the managed zone whose resource record sets you want to manage—for example,my-zone-name
To execute the transaction, use the
gcloud dns record-sets transaction execute
command:gcloud dns record-sets transaction execute \ --zone=MANAGED_ZONE
To add a wildcard transaction, use the
gcloud dns record-sets transaction add
command:gcloud dns record-sets transaction add \ --zone=MANAGED_ZONE \ --name=WILDCARD_DNS_NAME \ --type=RECORD_TYPE \ --ttl=TTL
Replace the following:
MANAGED_ZONE
: the name of the managed zone whose resource record sets you want to manage—for example,my-zone-name
WILDCARD_DNS_NAME
: the DNS or domain name of the resource record set that you want to add—for example,*.example.com.
(note the trailing dot)RECORD_TYPE
: the record type—for example,CNAME
.TTL
: the TTL for the record set in number of seconds—for example,300
API
To create a transaction with new resource record sets, use the
changes.create
method:
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 ] } ] }
Replace the following:
PROJECT_ID
: your project IDMANAGED_ZONE
: your managed zone name or IDDNS_NAME
: the DNS or domain name of the record set—for example,test.example.com.
(note the trailing dot)RECORD_TYPE
: the record typeTTL
: the time to live (TTL) for the record set in number of seconds—for example,30
RR_DATA
: an arbitrary value associated with the resource record set—for example,198.51.100.5
; you can also enter multiple values,rrdata1
rrdata2
rrdata3
—for example,198.51.100.5
10.2.3.4
...
To deliver email to your domain, you must add MX
records to your zone. If you
use Google Workspace as your Simple Mail Transfer Protocol (SMTP) provider, see
the Set up Google Workspace MX
records support page. Otherwise,
use the MX
record details from your provider and follow the setup
process described for Google Workspace.
View resource record sets for a zone
To view resource record sets for a zone, follow these steps:
Console
In the Google Cloud console, go to the Cloud DNS page.
On the Zones tab, click the zone for which you want to view the resource record sets.
The Zone details page shows the details of all the resource record sets in that zone.
gcloud
To view the DNS records for your zone, use the
gcloud dns record-sets list
command:
gcloud dns record-sets list \ --zone="ZONE_NAME"
Replace ZONE_NAME
with the name of a DNS zone in
your project.
The command outputs the JSON response for the resource record set for the first 100 records. You can specify these additional parameters:
--limit
: maximum number of record sets to list--name
: only list resource record sets with this exact domain name--type
: only list records of this type; if present, the--name
parameter must also be present
API
To view the DNS records for your zone, use the
resourceRecordSets.list
method:
GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONErrsets
Replace the following:
PROJECT_ID
: the ID of the projectMANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffix
View details of a resource record set
This procedure assumes that you have already created a resource record set within the managed Cloud DNS zone.
To view the details of an existing resource record set, follow these steps:
Console
In the Google Cloud console, go to the Cloud DNS zones page.
Click the zone that contains the resource record set.
Click the resource record set for which you want to view the details.
The Resource record set details page displays the details of the resource record set.
gcloud
To view the details of an existing resource record set, use the
gcloud dns record-sets describe
command:
gcloud dns record-sets describe RRSET_NAME \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE
Replace the following:
RRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RRSET_TYPE
: the resource record type of this resource record set—for example,A
.MANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffix
API
To get the details of an existing resource record set, use the
resourceRecordSets.get
method:
GET https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
Replace the following:
PROJECT_ID
: the ID of the projectMANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffixRRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RRSET_TYPE
: the record type of this resource record set—for example,A
.
Update a resource record set
To modify a record set, follow these steps:
Console
To apply a partial update to an existing resource record set, follow these steps:
In the Google Cloud console, go to the Cloud DNS zones page.
Click the zone for which you want to update the resource record set.
On the Zone details page, next to the resource record set that you want to update, click editEdit.
After making the necessary updates, click Save.
gcloud
To apply a partial update to an existing resource record set, use the
gcloud dns record-sets update
command:
gcloud dns record-sets update RRSET_NAME \ --rrdatas=RR_DATA \ --ttl=TTL \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE
Replace the following:
RRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RR_DATA
: an arbitrary value associated with the resource record set—for example,198.51.100.5
; you can also enter multiple values,rrdata1
rrdata2
rrdata3
—for example,198.51.100.5
10.2.3.4
...TTL
: the TTL in seconds that the resolver caches this resource record set—for example,30
RRSET_TYPE
: the resource record type of this resource record set—for example,A
.MANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffix
API
To apply a partial update to an existing resource record set, use
the resourceRecordSets.patch
method:
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"] } }
Replace the following:
PROJECT_ID
: the ID of the projectMANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffixRRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RRSET_TYPE
: the resource record type of this resource record set—for example,A
.TTL
: the TTL in seconds that the resolver caches this resource record set—for example,30
RR_DATA
: an arbitrary value associated with the resource record set—for example,198.51.100.5
; you can also enter multiple values,rrdata1
rrdata2
rrdata3
—for example,198.51.100.5
10.2.3.4
...
Delete resource record sets
When you delete resource record sets, their DNS records are permanently removed; they cannot be recovered. To prevent losing your DNS records, export the resource record sets before deletion. For information about how to export resource record sets, see Import and export resource record sets.
Cloud DNS public zones are authoritative, and the name server (NS
) and
start of authority (SOA
) record types are located at the zone apex, which is the
root of that domain. Cloud DNS automatically creates NS
and SOA
records at the zone apex. These records can't be deleted by using the Cloud DNS API
and are automatically deleted when the zone is deleted. For more information,
see RFC 1034.
To delete resource record sets, follow these steps:
Console
In the Google Cloud console, go to the Cloud DNS page.
Records for the zone are listed on the Zone details page.
To delete resource record sets in a zone, click the name of the zone.
Next to the resource record sets that you want to delete, select the checkbox.
Click Delete record sets.
gcloud
To delete an existing resource record set, use the
gcloud dns record-sets delete
command:
gcloud dns record-sets delete RRSET_NAME \ --type=RRSET_TYPE \ --zone=MANAGED_ZONE
Replace the following:
RRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RRSET_TYPE
: the resource record type of this resource record set—for example,A
.MANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffix
API
To delete an existing resource record set, use the
resourceRecordSets.delete
method:
DELETE https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
Replace the following:
PROJECT_ID
: the ID of the projectMANAGED_ZONE
: the managed zone that this resource record set is affiliated with—for example,my-zone-name
; the name of this resource record set must have the DNS name of the managed zone as its suffixRRSET_NAME
: the DNS name that matches the incoming queries with this zone's DNS name as its suffix—for example,test.example.com
RRSET_TYPE
: the resource record type of this resource record set—for example,A
.
Import and export resource record sets
To copy resource record sets into and out of a managed zone, you can use import
and
export
commands. You can import from and export to either the BIND zone file
format or the YAML file format.
gcloud
To import a resource record set, use the
dns record-sets import
command:gcloud dns record-sets import -z=ZONE_NAME
If you want to specify the file format of the zone file, use the previous command with the
--zone-file-format
flag. If you omit the flag, you must provide a YAML format zone file.Replace
ZONE_NAME
with a new name for your zone.When you use the
gcloud dns record-sets import
command with the--replace-origin-ns
flag, it replaces the NS records for the zone with the NS records specified in the zone file. These records must match the name servers assigned by Cloud DNS to host the zone. They must also match theNS
records specified in the parent (delegating) zone. By default, Cloud DNS does not overwriteNS
records. If you use this flag, you must verify that theNS
records are correct.When you import record sets as a BIND zone-formatted file, remove the at sign (@) that denotes the zone's apex. In the BIND zone-formatted file, for a DNS name like
example.com
, the at sign (@) refers toexample.com.
. However, in Cloud DNS, the at sign (@) is treated literally when defining record names. To create a resource record set for the zone's apex in Cloud DNS, use the full domain name—for example,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.
To import your zone files, add a trailing dot (
.
) to the end of any domain names that must be fully qualified.
To export a resource record set, use the
dns record-sets export
command. To specify that the resource record sets are exported into a BIND zone-formatted file, use the--zone-file-format
flag. For example: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
If you omit the
--zone-file-format
flag,export
exports the resource record set into a YAML-formatted records file:gcloud dns record-sets export example.zone -z=examplezonename
For example:
--- 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 supports the
ALIAS
record type, which isn't a standard DNS record type and isn't supported inBIND
. If you're exporting resource record sets toBIND
,ALIAS
records are skipped. If a zone has a routing policy, it is exported as a record with empty resource record data (rrdata).
Supported resource record types
For record type | Enter |
---|---|
A |
The host's numeric address, in IPv4 dotted decimal format. The
|
AAAA |
The host's numeric IP address, in IPv6 hexadecimal format. The
|
ALIAS ([Preview](/products#product-launch-stages)) |
The canonical name to resolve for incoming address queries—for
example, |
CAA |
The certificate authorities that are authorized to issue certificates
for this domain—for example,
Create a |
CNAME |
The DNS alias for an
You can also use the
Sometimes, a name server responds with the |
DNSKEY |
The DNSSEC public key that the resolvers use to verify the
authenticity of records using ZSK and KSK
keys—for example,
You can only add this record type in a public and DNSSEC-enabled zone
that is in the |
DS |
The DNSSEC key fingerprint for a secure delegated zone—for
example, You can only add this record type in a public zone. This record type does not activate DNSSEC for a delegated zone unless you enable (and activate) DNSSEC for this zone. DNSSEC is not enabled by default for zones. |
HTTPS , SVCB |
The service priority ( |
IPSECVPNKEY |
The IPsec public VPN key. The You can only add this record type in a public zone. |
MX |
A preference number and DNS name of a mail exchange server that
receives emails on behalf of your domain. SMTP servers prefer servers
with lower preference numbers. For example: Ensure that there is a space between the preference number and the
DNS name. The MX record that you enter must end with a period or
dot ( You can create multiple records with different priorities to configure backup mail servers or use the same priority to distribute the load across multiple mail servers. For example, to direct your email to your Google Workspace account, enter the following:
|
NAPTR |
The name authority pointer rules used for mapping Uniform Resource
Names (URN) by Dynamic Delegation Discovery System (DDDS)
applications—for example,
The |
NS |
The DNS name of the authoritative name server that provides DNS
services for your domain or subdomain. Your |
PTR |
The Fully Qualified Domain Name (FQDN) or the canonical name of the
domain that maps to an IP address—for example,
The |
SPF |
The |
SRV |
The data that specifies the location, that is, the hostname and
port number, of servers for a particular service—for example,
For more information, see RFC 2782. |
SSHFP |
The SSH server algorithm number, fingerprint type number, and key
fingerprint—for example,
Use this record type only if you have enabled DNSSEC for this zone. |
TLSA |
The DNS-based Authentication of Named Entities (DANE) TLSA Certificate Association information.
A TLSA record contains
information used to validate X.509 certificates
(such as certificates used by HTTPS) without depending on one of a
preconfigured set of certificate authorities (CAs) signing them—for example,
Use this record type only if you have enabled DNSSEC for this zone. |
TXT |
Text data, which can contain arbitrary text and can also be used to define machine-readable data, such as security or abuse prevention information. A TXT record may contain one or more text strings; the
maximum length of each
string is 255 characters. If your record data is more than 255
bytes, divide your record into 255-byte strings and enclose each
string in quotation marks—for example,
Mail agents and other software agents concatenate multiple strings. Enclose each string in quotation marks—for example, Each TXT record has a 1000-character limit. If you need to increase this limit, contact Google Cloud support. |
What's next
- To get information about
gcloud
commands for resource record sets, seegcloud dns record-sets
. - To check the status of
gcloud
or API operations, see Monitor DNS propagation. - To find solutions for common issues that you might encounter when using Cloud DNS, see Troubleshooting.
- To get an overview of Cloud DNS, see Cloud DNS overview.