---
title: "POST /v1/{+registration}:configureDnsSettings"
method: POST
path: "/v1/{+registration}:configureDnsSettings"
tags: ["projects"]
---

# POST /v1/{+registration}:configureDnsSettings

`POST /v1/{+registration}:configureDnsSettings`

Updates a `Registration`'s DNS settings.

## Path parameters

- `registration` string, required

## Request body

- ConfigureDnsSettingsRequest — Request for the `ConfigureDnsSettings` method.
  - `validateOnly` boolean — Validate the request without actually updating the DNS settings.
  - `dnsSettings` DnsSettings — Defines the DNS configuration of a `Registration`, including name servers, DNSSEC, and glue records.
    - `googleDomainsDns` GoogleDomainsDns — Deprecated: For more information, see [Cloud Domains feature deprecation](https://cloud.google.com/domains/docs/deprecations/feature-deprecations). Configuration for using the free DNS zone provided by Google Domains as a `Registration`'s `dns_provider`. You cannot configure the DNS zone itself using the API. To configure the DNS zone, go to [Google Domains](https://domains.google/).
      - `dsState` 'DS_STATE_UNSPECIFIED' | 'DS_RECORDS_UNPUBLISHED' | 'DS_RECORDS_PUBLISHED' — Required. The state of DS records for this domain. Used to enable or disable automatic DNSSEC.
      - `dsRecords` DsRecord[] — Output only. The list of DS records published for this domain. The list is automatically populated when `ds_state` is `DS_RECORDS_PUBLISHED`, otherwise it remains empty.
        - `digest` string — The digest generated from the referenced DNSKEY.
        - `keyTag` integer — The key tag of the record. Must be set in range 0 -- 65535.
        - `digestType` 'DIGEST_TYPE_UNSPECIFIED' | 'SHA1' | 'SHA256' | 'GOST3411' | 'SHA384' — The hash function used to generate the digest of the referenced DNSKEY.
        - `algorithm` 'ALGORITHM_UNSPECIFIED' | 'RSAMD5' | 'DH' | 'DSA' | 'ECC' | 'RSASHA1' | 'DSANSEC3SHA1' | 'RSASHA1NSEC3SHA1' | 'RSASHA256' | 'RSASHA512' | 'ECCGOST' | 'ECDSAP256SHA256' | 'ECDSAP384SHA384' | 'ED25519' | 'ED448' | 'INDIRECT' | 'PRIVATEDNS' | 'PRIVATEOID' — The algorithm used to generate the referenced DNSKEY.
      - `nameServers` string[] — Output only. A list of name servers that store the DNS zone for this domain. Each name server is a domain name, with Unicode domain names expressed in Punycode format. This field is automatically populated with the name servers assigned to the Google Domains DNS zone.
    - `googleDomainsRedirectsDataAvailable` boolean — Output only. Indicates if this `Registration` has configured one of the following deprecated Google Domains DNS features: * Domain forwarding (HTTP `301` and `302` response status codes), * Email forwarding. See https://cloud.google.com/domains/docs/deprecations/feature-deprecations for more details. If any of these features is enabled call the `RetrieveGoogleDomainsForwardingConfig` method to get details about the feature's configuration. A forwarding configuration might not work correctly if required DNS records are not present in the domain's authoritative DNS Zone.
    - `glueRecords` GlueRecord[] — The list of glue records for this `Registration`. Commonly empty.
      - `hostName` string — Required. Domain name of the host in Punycode format.
      - `ipv4Addresses` string[] — List of IPv4 addresses corresponding to this host in the standard decimal format (e.g. `198.51.100.1`). At least one of `ipv4_address` and `ipv6_address` must be set.
      - `ipv6Addresses` string[] — List of IPv6 addresses corresponding to this host in the standard hexadecimal format (e.g. `2001:db8::`). At least one of `ipv4_address` and `ipv6_address` must be set.
    - `customDns` CustomDns — Configuration for an arbitrary DNS provider.
      - `dsRecords` DsRecord[] — The list of DS records for this domain, which are used to enable DNSSEC. The domain's DNS provider can provide the values to set here. If this field is empty, DNSSEC is disabled.
        - `digest` string — The digest generated from the referenced DNSKEY.
        - `keyTag` integer — The key tag of the record. Must be set in range 0 -- 65535.
        - `digestType` 'DIGEST_TYPE_UNSPECIFIED' | 'SHA1' | 'SHA256' | 'GOST3411' | 'SHA384' — The hash function used to generate the digest of the referenced DNSKEY.
        - `algorithm` 'ALGORITHM_UNSPECIFIED' | 'RSAMD5' | 'DH' | 'DSA' | 'ECC' | 'RSASHA1' | 'DSANSEC3SHA1' | 'RSASHA1NSEC3SHA1' | 'RSASHA256' | 'RSASHA512' | 'ECCGOST' | 'ECDSAP256SHA256' | 'ECDSAP384SHA384' | 'ED25519' | 'ED448' | 'INDIRECT' | 'PRIVATEDNS' | 'PRIVATEOID' — The algorithm used to generate the referenced DNSKEY.
      - `nameServers` string[] — Required. A list of name servers that store the DNS zone for this domain. Each name server is a domain name, with Unicode domain names expressed in Punycode format.
  - `updateMask` string, google-fieldmask — Required. The field mask describing which fields to update as a comma-separated list. For example, if only the name servers are being updated for an existing Custom DNS configuration, the `update_mask` is `"custom_dns.name_servers"`. When changing the DNS provider from one type to another, pass the new provider's field name as part of the field mask. For example, when changing from a Google Domains DNS configuration to a Custom DNS configuration, the `update_mask` is `"custom_dns"`. //

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/domains.md) · [All operations](https://skmtc.net/google/apis/domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/domains/versions/96ed971a98da/schema)