# REST Resource: services.projects.global.networks.dnsZones

- [Resource: GetDnsZoneResponse](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#GetDnsZoneResponse)
  - [JSON representation](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#GetDnsZoneResponse.SCHEMA_REPRESENTATION)
- [DnsZone](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#DnsZone)
  - [JSON representation](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#DnsZone.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#METHODS_SUMMARY)

## Resource: GetDnsZoneResponse

Represents managed DNS zones created in the shared Producer host and consumer projects.

| JSON representation |
|---|
| ``` { "producerPrivateZone": { object (`https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#DnsZone`) }, "consumerPeeringZone": { object (`https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#DnsZone`) } } ``` |

| Fields ||
|---|---|
| `producerPrivateZone` | ``object (`https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#DnsZone`)`` The private DNS zone created in the shared producer host project. |
| `consumerPeeringZone` | ``object (`https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones#DnsZone`)`` The DNS peering zone created in the consumer project. |

## DnsZone

Represents a DNS zone resource.

| JSON representation |
|---|
| ``` { "name": string, "dnsSuffix": string } ``` |

| Fields ||
|---|---|
| `name` | `string` User assigned name for this resource. Must be unique within the project. 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. |
| `dnsSuffix` | `string` The DNS name suffix of this zone e.g. `example.com.`. Cloud DNS requires that a DNS suffix ends with a trailing dot. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/services.projects.global.networks.dnsZones/get` | Service producers can use this method to retrieve a DNS zone in the shared producer host project and the matching peering zones in consumer project |
| ### `https://docs.cloud.google.com/service-infrastructure/docs/service-networking/reference/rest/v1/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. |