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

# POST /v1/{+parent}/zones

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

Creates a zone resource within a lake.

## Path parameters

- `parent` string, required

## Query parameters

- `validateOnly` boolean
- `zoneId` string

## Request body

- GoogleCloudDataplexV1Zone — A zone represents a logical group of related assets within a lake. A zone can be used to map to organizational structure or represent stages of data readiness from raw to curated. It provides managing behavior that is shared or inherited by all contained assets.
  - `discoverySpec` GoogleCloudDataplexV1ZoneDiscoverySpec — Settings to manage the metadata discovery and publishing in a zone.
    - `schedule` string — Optional. Cron schedule (https://en.wikipedia.org/wiki/Cron) for running discovery periodically. Successive discovery runs must be scheduled at least 60 minutes apart. The default value is to run discovery every 60 minutes.To explicitly set a timezone to the cron tab, apply a prefix in the cron tab: "CRON_TZ=${IANA_TIME_ZONE}" or TZ=${IANA_TIME_ZONE}". The ${IANA_TIME_ZONE} may only be a valid string from IANA time zone database. For example, CRON_TZ=America/New_York 1 * * * *, or TZ=America/New_York 1 * * * *.
    - `includePatterns` string[] — Optional. The list of patterns to apply for selecting data to include during discovery if only a subset of the data should considered. For Cloud Storage bucket assets, these are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these are interpreted as patterns to match table names.
    - `csvOptions` GoogleCloudDataplexV1ZoneDiscoverySpecCsvOptions — Describe CSV and similar semi-structured data formats.
      - `headerRows` integer — Optional. The number of rows to interpret as header rows that should be skipped when reading data rows.
      - `delimiter` string — Optional. The delimiter being used to separate values. This defaults to ','.
      - `encoding` string — Optional. The character encoding of the data. The default is UTF-8.
      - `disableTypeInference` boolean — Optional. Whether to disable the inference of data type for CSV data. If true, all columns will be registered as strings.
    - `jsonOptions` GoogleCloudDataplexV1ZoneDiscoverySpecJsonOptions — Describe JSON data format.
      - `encoding` string — Optional. The character encoding of the data. The default is UTF-8.
      - `disableTypeInference` boolean — Optional. Whether to disable the inference of data type for Json data. If true, all columns will be registered as their primitive types (strings, number or boolean).
    - `enabled` boolean — Required. Whether discovery is enabled.
    - `excludePatterns` string[] — Optional. The list of patterns to apply for selecting data to exclude during discovery. For Cloud Storage bucket assets, these are interpreted as glob patterns used to match object names. For BigQuery dataset assets, these are interpreted as patterns to match table names.
  - `createTime` string, google-datetime — Output only. The time when the zone was created.
  - `updateTime` string, google-datetime — Output only. The time when the zone was last updated.
  - `resourceSpec` GoogleCloudDataplexV1ZoneResourceSpec — Settings for resources attached as assets within a zone.
    - `locationType` 'LOCATION_TYPE_UNSPECIFIED' | 'SINGLE_REGION' | 'MULTI_REGION' — Required. Immutable. The location type of the resources that are allowed to be attached to the assets within this zone.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'CREATING' | 'DELETING' | 'ACTION_REQUIRED' — Output only. Current state of the zone.
  - `type` 'TYPE_UNSPECIFIED' | 'RAW' | 'CURATED' — Required. Immutable. The type of the zone.
  - `uid` string — Output only. System generated globally unique ID for the zone. This ID will be different if the zone is deleted and re-created with the same name.
  - `description` string — Optional. Description of the zone.
  - `name` string — Output only. The relative resource name of the zone, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_id}/zones/{zone_id}.
  - `assetStatus` GoogleCloudDataplexV1AssetStatus — Aggregated status of the underlying assets of a lake or zone.
    - `activeAssets` integer — Number of active assets.
    - `updateTime` string, google-datetime — Last update time of the status.
    - `securityPolicyApplyingAssets` integer — Number of assets that are in process of updating the security policy on attached resources.
  - `labels` object — Optional. User defined labels for the zone.
  - `displayName` string — Optional. User friendly display name.

## Response `200`

Successful response

---

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