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 updateMask is "customDns.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 updateMask is "customDns". //
This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
validateOnly
boolean
Validate the request without actually updating the DNS settings.
Response body
If successful, the response body contains an instance of Operation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-30 UTC."],[[["\u003cp\u003eThis webpage details how to update a \u003ccode\u003eRegistration\u003c/code\u003e's DNS settings using a POST request to the Google Domains API.\u003c/p\u003e\n"],["\u003cp\u003eThe required URL format is \u003ccode\u003ePOST https://domains.googleapis.com/v1/{registration=projects/*/locations/*/registrations/*}:configureDnsSettings\u003c/code\u003e, utilizing gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eUpdating DNS settings requires specifying the \u003ccode\u003eregistration\u003c/code\u003e path parameter, in the format \u003ccode\u003eprojects/*/locations/*/registrations/*\u003c/code\u003e, and authorization via the \u003ccode\u003edomains.registrations.configureDns\u003c/code\u003e IAM permission.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain \u003ccode\u003ednsSettings\u003c/code\u003e, \u003ccode\u003eupdateMask\u003c/code\u003e (to specify fields to update), and an optional \u003ccode\u003evalidateOnly\u003c/code\u003e boolean field.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful updates will return an \u003ccode\u003eOperation\u003c/code\u003e instance, and the operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.registrations.configureDnsSettings\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates a `Registration`'s DNS settings.\n\n### HTTP request\n\n`POST https://domains.googleapis.com/v1/{registration=projects/*/locations/*/registrations/*}:configureDnsSettings`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/domains/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](https://cloud.google.com/docs/authentication/)."]]
