- NAME
-
- gcloud domains registrations configure dns - configure DNS settings of a Cloud Domains registration
- SYNOPSIS
-
-
gcloud domains registrations configure dns
REGISTRATION
[--validate-only
] [--cloud-dns-zone
=CLOUD_DNS_ZONE
|--dns-settings-from-file
=DNS_SETTINGS_FILE_NAME
|--name-servers
=NAME_SERVER
,…,[…] |--use-google-domains-dns
] [--async
] [--disable-dnssec
] [--unsafe-dns-update
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
Configure DNS settings of a Cloud Domains registration.
In most cases, this command is used for changing the authoritative name servers and DNSSEC options for the given domain. However, advanced options like glue records are available.
- EXAMPLES
-
To start an interactive flow to configure DNS settings for
, run:example.com
gcloud domains registrations configure dns example.com
To use Cloud DNS managed-zone
forexample-zone
, run:example.com
gcloud domains registrations configure dns example.com --cloud-dns-zone=example-zone
DNSSEC will not be enabled as it may not be safe to enable it (e.g. when the Cloud DNS managed-zone was signed less than 24h ago).
To use a signed Cloud DNS managed-zone
forexample-zone
and enable DNSSEC, run:example.com
gcloud domains registrations configure dns example.com --cloud-dns-zone=example-zone --no-disable-dnssec
To change DNS settings for
according to information from a YAML fileexample.com
, run:dns_settings.yaml
gcloud domains registrations configure dns example.com --dns-settings-from-file=dns_settings.yaml
To disable DNSSEC, run:
gcloud domains registrations configure dns example.com --disable-dnssec
- POSITIONAL ARGUMENTS
-
-
Registration resource - The domain registration to configure DNS settings for.
This represents a Cloud resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.
To set the
project
attribute:-
provide the argument
registration
on the command line with a fully specified name; -
provide the argument
--project
on the command line; -
set the property
core/project
.
To set the
location
attribute:-
provide the argument
registration
on the command line with a fully specified name; - location is always global.
This must be specified.
REGISTRATION
-
ID of the registration or fully qualified identifier for the registration.
To set the
registration
attribute:-
provide the argument
registration
on the command line.
-
provide the argument
-
provide the argument
-
Registration resource - The domain registration to configure DNS settings for.
This represents a Cloud resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.
- COMMONLY USED FLAGS
-
--validate-only
- Don't actually configure DNS settings of the registration. Only validate arguments.
-
Set the authoritative name servers for the given domain.
Warning: Do not change name servers if ds_records is non-empty. Clear ds_records first by calling this command with the --disable-dnssec flag, and wait 24 hours before changing name servers. Otherwise your domain may stop serving.
--cloud-dns-zone
=CLOUD_DNS_ZONE
-
The name of the Cloud DNS managed-zone to set as the name server for the domain.
If it's in the same project, you can use short name. If not, use the full
resource name, e.g.:
--cloud-dns-zone=projects/example-project/managedZones/example-zone.
--dns-settings-from-file
=DNS_SETTINGS_FILE_NAME
-
A YAML file containing the required DNS settings. If specified, its content will
replace the values currently used in the registration resource. If the file is
missing some of the dns_settings fields, those fields will be cleared.
Examples of file contents:
googleDomainsDns: dsState: DS_RECORDS_PUBLISHED glueRecords: - hostName: ns1.example.com ipv4Addresses: - 8.8.8.8 - hostName: ns2.example.com ipv4Addresses: - 8.8.8.8
customDns: nameServers: - new.ns1.com - new.ns2.com dsRecords: - keyTag: 24 algorithm: RSASHA1 digestType: SHA256 digest: 2e1cfa82b035c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d - keyTag: 42 algorithm: RSASHA1 digestType: SHA256 digest: 2e1cfa82bf35c26cbbbdae632cea070514eb8b773f616aaeaf668e2f0be8f10d
--name-servers
=NAME_SERVER
,…,[…]- List of DNS name servers for the domain.
--use-google-domains-dns
-
(DEPRECATED) Use free name servers provided by Google Domains.
The --use-google-domains-dns option is deprecated; See https://cloud.google.com/domains/docs/deprecations/feature-deprecations.
- OTHER FLAGS
-
--async
- Return immediately, without waiting for the operation in progress to complete.
--disable-dnssec
- Use this flag to disable DNSSEC, or to skip enabling it when switching to a Cloud DNS Zone or Google Domains nameservers.
--unsafe-dns-update
-
(DEPRECATED) Use this flag to allow DNS changes that may make your domain stop
serving.
The --unsafe-dns-update option is deprecated. To complete an unsafe DNS operation first disable DNSSEC, then change name servers, then (optionally) enable DNSSEC.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--flags-file
,--flatten
,--format
,--help
,--impersonate-service-account
,--log-http
,--project
,--quiet
,--trace-token
,--user-output-enabled
,--verbosity
.Run
$ gcloud help
for details. - NOTES
-
These variants are also available:
gcloud alpha domains registrations configure dns
gcloud beta domains registrations configure dns
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-04-23 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]
{
"last_modified": "Last updated 2024-04-23 UTC.",
"state": ""
}