Most gcloud lake commands require a location. You can specify
the location by using the --location flag.
Required roles
To update a data zone, 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 data zone, you must be granted IAM role that contains
the dataplex.zones.update 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.
Only one update job is supported at a time, and each job can have multiple
property updates. You can use the data zone while it's being updated.
You can update the following data zone parameters:
When the update succeeds, the data zone automatically enters active state. If it
fails, then the data zone is rolled back to its previous healthy state.
Delete a zone
You might want to delete your data zone if your configurations, such as
data zone name or type are incorrect and can't be changed.
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 provides instructions on how to update or delete an existing Dataplex zone within a lake.\u003c/p\u003e\n"],["\u003cp\u003eUpdating a zone allows for changes to its display name, description, labels, and discovery settings, and requires specific IAM permissions such as \u003ccode\u003edataplex.lakes.create\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDeleting a zone requires the prior removal of all assets within it and the \u003ccode\u003edataplex.zones.update\u003c/code\u003e IAM permission, noting that this action is irreversible.\u003c/p\u003e\n"],["\u003cp\u003eUpdates to a zone can be performed through the Google Cloud console or using the \u003ccode\u003elakes.zones.patch\u003c/code\u003e REST method, while deletions use the console or \u003ccode\u003elakes.zones.delete\u003c/code\u003e REST method.\u003c/p\u003e\n"],["\u003cp\u003eBefore updating or deleting any zones, make sure the required roles are correctly assigned to your user or service account, such as the Dataplex Administrator or Dataplex Editor.\u003c/p\u003e\n"]]],[],null,["# Manage a zone\n\nThis page explains how to update or delete an existing Dataplex Universal Catalog\nzone in a lake.\n\nBefore you begin\n----------------\n\n- If you haven't done so already, [add a zone](/dataplex/docs/add-zone).\n\n- Most `gcloud lake` commands require a location. You can specify\n the location by using the `--location` flag.\n\n### Required roles\n\n- To update a data zone, you must be granted the IAM role that\n contains the `dataplex.lakes.create` permission. For example,\n Dataplex Administrator (`roles/dataplex.admin`) or Dataplex Editor\n `roles/dataplex.editor` IAM role.\n\n- To delete a data zone, you must be granted IAM role that contains\n the `dataplex.zones.update` 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\nUpdate a zone\n-------------\n\nOnly one update job is supported at a time, and each job can have multiple\nproperty updates. You can use the data zone while it's being updated.\nYou can update the following data zone parameters:\n\n- Display name\n- Description\n- Labels\n- [Discovery settings](/dataplex/docs/discover-data#discovery-configuration)\n\n| **Note:** You must recreate a data zone if you want to change data zone parameters that can't be updated.\n\nTo update a data zone, 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'd like to update. The lake page for that lake opens.\n\n3. On the **Zones** tab, click the data zone name of the data zone you'd\n like to update. The data zone page for that data zone opens.\n\n4. At the top of the page, click **Edit** . The **Edit zone** dialog opens.\n\n5. Choose the updated data zone parameter values.\n\n6. Click **Save** to update the data zone.\n\n7. Verify that you have returned to the data zone page, and that your updated\n data zone is active.\n\n### REST\n\nTo update a zone, use the [lakes.zones.patch](/dataplex/docs/reference/rest/v1/projects.locations.lakes.zones/patch)\nmethod.\n\nWhen the update succeeds, the data zone automatically enters active state. If it\nfails, then the data zone is rolled back to its previous healthy state.\n\nDelete a zone\n-------------\n\n| **Note:** Before you delete a Dataplex Universal Catalog zone, you must delete all assets in that zone.\n\nYou might want to delete your data zone if your configurations, such as\ndata zone name or type are incorrect and can't be changed.\n**Caution:** Deletion is irreversible. After you delete data zones, you can't restore them. However, you can create new Dataplex Universal Catalog data zones. \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 a zone from. The lake page for that lake opens.\n\n3. On the **Zones** tab, select the data zone by checking the box to the left of\n the data zone name.\n\n4. Click **Delete Zone**.\n\n5. To confirm the deletion, click **Delete**.\n\n You can also delete your data zone on the data zone page.\n6. On the **Dataplex Universal Catalog** page, click the lake name of the lake\n you want to delete a data zone from. The lake page for that lake opens.\n\n7. On the **Zones** tab, click the data zone name of the data zone you\n want to delete.\n\n8. Click **Delete**.\n\n9. On the dialog, click **Delete** to confirm the deletion.\n\n10. Verify that you have returned to the lake page, and that your deleted data\n zone no longer appears in the data zone list.\n\n### REST\n\nTo delete a zone, use the [lakes.zones.delete](/dataplex/docs/reference/rest/v1/projects.locations.lakes.zones/delete)\nmethod.\n\nAll deletions are immediate.\n\nWhat's next\n-----------\n\n- Learn more about [managing data assets](/dataplex/docs/manage-assets)."]]
