Method: services.dnsZones.add

Stay organized with collections Save and categorize content based on your preferences.

Service producers can use this method to add private DNS zones in the shared producer host project and matching peering zones in the consumer project.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The service that is managing peering connectivity for a service producer's organization. For Google services that support this functionality, this value is services/

Authorization requires the following IAM permission on the specified resource parent:


Request body

The request body contains data with the following structure:

JSON representation
  "consumerNetwork": string,
  "name": string,
  "dnsSuffix": string


Required. The network that the consumer is using to connect with services. Must be in the form of projects/{project}/global/networks/{network} {project} is the project number, as in '12345' {network} is the network name.



Required. The name for both the private zone in the shared producer host project and the peering zone in the consumer project. Must be unique within both projects. The name must be 1-63 characters long, must begin with a letter, end with a letter or digit, and only contain lowercase letters, digits or dashes.



Required. The DNS name suffix for the zones e.g.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.