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

# POST /v1/{+parent}/lakes

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

Creates a lake resource.

## Path parameters

- `parent` string, required

## Query parameters

- `lakeId` string
- `validateOnly` boolean

## Request body

- GoogleCloudDataplexV1Lake — A lake is a centralized repository for managing enterprise data across the organization distributed across many cloud projects, and stored in a variety of storage services such as Google Cloud Storage and BigQuery. The resources attached to a lake are referred to as managed resources. Data within these managed resources can be structured or unstructured. A lake provides data admins with tools to organize, secure and manage their data at scale, and provides data scientists and data engineers an integrated experience to easily search, discover, analyze and transform data and associated metadata.
  - `uid` string — Output only. System generated globally unique ID for the lake. This ID will be different if the lake is deleted and re-created with the same name.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'CREATING' | 'DELETING' | 'ACTION_REQUIRED' — Output only. Current state of the lake.
  - `updateTime` string, google-datetime — Output only. The time when the lake was last updated.
  - `createTime` string, google-datetime — Output only. The time when the lake was created.
  - `displayName` string — Optional. User friendly display name.
  - `metastore` GoogleCloudDataplexV1LakeMetastore — Settings to manage association of Dataproc Metastore with a lake.
    - `service` string — Optional. A relative reference to the Dataproc Metastore (https://cloud.google.com/dataproc-metastore/docs) service associated with the lake: projects/{project_id}/locations/{location_id}/services/{service_id}
  - `labels` object — Optional. User-defined labels for the lake.
  - `serviceAccount` string — Output only. Service account associated with this lake. This service account must be authorized to access or operate on resources managed by the lake.
  - `metastoreStatus` GoogleCloudDataplexV1LakeMetastoreStatus — Status of Lake and Dataproc Metastore service instance association.
    - `updateTime` string, google-datetime — Last update time of the metastore status of the lake.
    - `endpoint` string — The URI of the endpoint used to access the Metastore service.
    - `state` 'STATE_UNSPECIFIED' | 'NONE' | 'READY' | 'UPDATING' | 'ERROR' — Current state of association.
    - `message` string — Additional information about the current status.
  - `name` string — Output only. The relative resource name of the lake, of the form: projects/{project_number}/locations/{location_id}/lakes/{lake_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.
  - `description` string — Optional. Description of the lake.

## 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)