---
title: "POST /v1/{+parent}/dnsZones"
method: POST
path: "/v1/{+parent}/dnsZones"
tags: ["organizations"]
---

# POST /v1/{+parent}/dnsZones

`POST /v1/{+parent}/dnsZones`

Creates a new DNS zone.

## Path parameters

- `parent` string, required

## Query parameters

- `dnsZoneId` string

## Request body

- GoogleCloudApigeeV1DnsZone — A DNS zone is a resource under an Apigee organization that is used to create a DNS peering with Apigee's network. DNS peering will let Apigee instances resolve the hostnames created in a peered network.
  - `peeringConfig` GoogleCloudApigeeV1DnsZonePeeringConfig — Fields for DNS PEERING zone.
    - `targetProjectId` string — Required. The ID of the project that contains the producer VPC network.
    - `targetNetworkId` string — Required. The VPC network where the records for that private DNS zone's namespace are available. Apigee will be performing DNS peering with this VPC network.
  - `domain` string — Required. The domain name for hosts in this private zone, for instance "example.com.".
  - `updateTime` string, google-datetime — Output only. The time that this resource was updated on the server.
  - `name` string — Identifier. Unique name for the resource. Defined by the server Format: "organizations/{organization}/dnsZones/{dns_zone}".
  - `createTime` string, google-datetime — Output only. The time that this resource was created on the server.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'UPDATING' — Output only. State of the DNS Peering. Values other than `ACTIVE` mean the resource is not ready to use.
  - `description` string — Required. Description of the resource. String of at most 1024 characters associated with this resource for the user's convenience.

## Response `200`

Successful response

---

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