NAME
    gcloud beta domains registrations configure dns - configure DNS settings of
        a Cloud Domains registration

SYNOPSIS
    gcloud beta 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
    (BETA) 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 example.com,
    run:

        $ gcloud beta domains registrations configure dns example.com

    To use Cloud DNS managed-zone example-zone for example.com, run:

        $ gcloud beta 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 example-zone for example.com and
    enable DNSSEC, run:

        $ gcloud beta domains registrations configure dns example.com \
            --cloud-dns-zone=example-zone --no-disable-dnssec

    To change DNS settings for example.com according to information from a YAML
    file dns_settings.yaml, run:

        $ gcloud beta domains registrations configure dns example.com \
            --dns-settings-from-file=dns_settings.yaml

    To disable DNSSEC, run:

        $ gcloud beta 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.

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.

    At most one of these can be specified:

         --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
    This command is currently in beta and might change without notice. These
    variants are also available:

        $ gcloud domains registrations configure dns

        $ gcloud alpha domains registrations configure dns

