To update a lake, you must be granted the IAM role that contains
the dataplex.lakes.create permission. For example, Dataplex Administrator
(roles/dataplex.admin) or Dataplex Editor roles/dataplex.editor
IAM role.
To delete a lake, you must be granted IAM role that contains the
dataplex.lakes.delete permission. For example, Dataplex Administrator
(roles/dataplex.admin) or Dataplex Editor (roles/dataplex.editor)
IAM role.
You can also grant update and delete permissions to users or groups
by using the roles/owner and roles/editor legacy roles.
When the update succeeds, the lake automatically enters active state. If it
fails, then the lake is rolled back to its previous healthy state.
Delete a lake
You might want to delete your lake if your configurations are wrong and can't
be changed.
You can't delete a lake until all data zone resources under it have been deleted.
Similarly, you can't delete a data zone until all asset resources under it
have been deleted. Users given access to data through these lakes or data zones
lose access rights.
Console
In the Google Cloud console, go to the Dataplex Universal Catalog Lakes page:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis guide explains the process of viewing, updating, and deleting a Dataplex lake.\u003c/p\u003e\n"],["\u003cp\u003eTo update or delete a lake, you need specific IAM permissions, such as \u003ccode\u003edataplex.lakes.create\u003c/code\u003e for updating and \u003ccode\u003edataplex.lakes.delete\u003c/code\u003e for deleting.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a lake allows modifications to its name, description, and labels, but only one update job is supported at a time.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a lake requires first removing all data zone resources and asset resources under it, and it is an irreversible action.\u003c/p\u003e\n"],["\u003cp\u003eViewing a lake through the Google Cloud console allows you to access details like data zones, permissions, and security policy propagation issues.\u003c/p\u003e\n"]]],[],null,["# Manage a lake\n\nThis page explains how to view, update, and delete an existing\nDataplex Universal Catalog lake.\n\nBefore you begin\n----------------\n\n- If you haven't done so already, [create a lake](/dataplex/docs/create-lake).\n\n### Required roles\n\n- To update a lake, you must be granted the IAM role that contains\n the `dataplex.lakes.create` permission. For example, Dataplex Administrator\n (`roles/dataplex.admin`) or Dataplex Editor `roles/dataplex.editor`\n IAM role.\n\n- To delete a lake, you must be granted IAM role that contains the\n `dataplex.lakes.delete` permission. For example, Dataplex Administrator\n (`roles/dataplex.admin`) or Dataplex Editor (`roles/dataplex.editor`)\n IAM role.\n\nYou can also grant update and delete permissions to users or groups\nby using the `roles/owner` and `roles/editor` legacy roles.\n\nFor more information, see\n[Dataplex Universal Catalog access control with IAM](/dataplex/docs/iam-and-access-control).\n\nView a lake\n-----------\n\nTo view your Dataplex Universal Catalog lake in the Google Cloud console, follow these\nsteps:\n\n1. Go to the Dataplex Universal Catalog page.\n\n [Go to Dataplex Universal Catalog](https://console.cloud.google.com/dataplex/lakes)\n2. Click the name of the lake you want to view.\n\n3. Optional: To manage existing data zones in your lake or to add new data zones,\n click the **Zones** tab. For more information, see\n [Managing a zone](/dataplex/docs/manage-zone).\n\n4. Optional: to view lake details, such as the number of data items discovered,\n and the assets in the lake, click the **Details** tab.\n\n5. Optional: To manage lake permissions, click the **Permissions** tab.\n For more information, see [Access control with IAM](/dataplex/docs/iam-and-access-control).\n\n6. Optional: To view lake-level actions, specifically, issues around\n security policy propagation., click the **Actions** tab.\n\n View lake-level actions, specifically issues around security policy\n propagation. For more information, see [Discover data](/dataplex/docs/discover-data#other_actions).\n\nUpdate a lake\n-------------\n\nOnly one update job is supported at a time, and each job can have multiple\nproperty updates. You can still use the lake while it's being updated.\n\nYou can update the following lake parameters:\n\n- Name\n- Description\n- Labels\n\n| **Note:** You must recreate a lake if you want to change lake details that can't be updated.\n\nTo update a lake, follow these steps: \n\n### Console\n\n1. In the Google Cloud console, go to the Dataplex Universal Catalog page.\n\n [Go to Dataplex Universal Catalog](https://console.cloud.google.com/dataplex/lakes)\n2. On the **Dataplex Universal Catalog** page, click the lake name of the lake\n you want to update. The lake page for that lake opens.\n\n3. Click **Edit** . The **Edit Lake** page opens.\n\n4. Choose the updated lake parameter values.\n\n5. Click the **Save** button to update the lake.\n\n6. Verify that you have returned to the **Dataplex Universal Catalog** page, and\n that your updated lake appears in the list.\n\n### REST\n\nTo update a lake, use the [lakes.patch](/dataplex/docs/reference/rest/v1/projects.locations.lakes/patch)\nmethod.\n\nWhen the update succeeds, the lake automatically enters active state. If it\nfails, then the lake is rolled back to its previous healthy state.\n\nDelete a lake\n-------------\n\nYou might want to delete your lake if your configurations are wrong and can't\nbe changed.\n\nYou can't delete a lake until all data zone resources under it have been deleted.\nSimilarly, you can't delete a data zone until all asset resources under it\nhave been deleted. Users given access to data through these lakes or data zones\nlose access rights.\n| **Note:** When you delete a lake, your Cloud Storage buckets or BigQuery datasets aren't deleted. You must explicitly delete them if required.\n**Caution:** Deletion is irreversible. After you delete lakes, you can't restore them. However, you can create new Dataplex Universal Catalog lakes. \n\n### Console\n\n1. In the Google Cloud console, go to the Dataplex Universal Catalog page:\n\n [Go to Dataplex Universal Catalog](https://console.cloud.google.com/dataplex/lakes)\n2. On the **Dataplex Universal Catalog** page, click the lake name of the lake\n you'd like to delete. The lake page for that lake opens.\n\n3. Click **Delete** . The **Delete lake** dialog opens.\n\n4. To confirm the deletion, enter `delete`.\n\n5. Click **Delete Lake**.\n\n6. Verify that you have returned to the **Dataplex Universal Catalog** page, and\n that your deleted lake no longer appears in the list.\n\n### REST\n\nTo delete a lake, use the [lakes.delete](/dataplex/docs/reference/rest/v1/projects.locations.lakes/delete)\nmethod.\n\nDeletion might take some time to complete.\n\nWhat's next\n-----------\n\n- Learn how to [manage a zone](/dataplex/docs/manage-zone).\n- Learn how to [manage and attach buckets](/dataplex/docs/manage-buckets).\n- Learn more about [Cloud Audit Logs](/dataplex/docs/audit-logging)."]]
