Method: services.projects.global.networks.dnsZones.list

* Service producers can use this method to retrieve a list of available DNS zones in the shared producer host project and the matching peering zones in the consumer project.

HTTP request

GET https://servicenetworking.googleapis.com/v1/{parent=services/*/projects/*/global/networks/*}/dnsZones:list

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Parent resource identifying the connection that owns this collection of DNS zones in the format services/{service}/projects/{project}/global/networks/{network} Service: The service that is managing connectivity for the service producer's organization. For Google services that support this functionality, this value is servicenetworking.googleapis.com. Projects: the consumer project containing the consumer network. Network: The consumer network accessible from the tenant project.

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

  • servicenetworking.services.listDnsZones

Request body

The request body must be empty.

Response body

Represents all DNS zones in the shared producer host project and the matching peering zones in the consumer project.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "dnsZonePairs": [
    {
      object (DnsZonePair)
    }
  ]
}
Fields
dnsZonePairs[]

object (DnsZonePair)

All pairs of private DNS zones in the shared producer host project and the matching peering zones in the consumer project..

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/service.management
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

DnsZonePair

  • Represents a pair of private and peering DNS zone resources. *
JSON representation 
{
  "producerPrivateZone": {
    object (DnsZone)
  },
  "consumerPeeringZone": {
    object (DnsZone)
  }
}
Fields
producerPrivateZone

object (DnsZone)

The private DNS zone in the shared producer host project.
consumerPeeringZone

object (DnsZone)

The DNS peering zone in the consumer project.