Sebagian besar perintah gcloud lake memerlukan lokasi. Anda dapat menentukan
lokasi menggunakan flag --location.
Peran yang diperlukan
Untuk memperbarui zona data, Anda harus diberi peran IAM yang
berisi izin dataplex.lakes.create. Misalnya, peran IAM Dataplex Administrator (roles/dataplex.admin) atau Dataplex Editor roles/dataplex.editor.
Untuk menghapus zona data, Anda harus diberi peran IAM yang berisi izin dataplex.zones.update. Misalnya, peran IAM Dataplex Administrator (roles/dataplex.admin) atau Dataplex Editor (roles/dataplex.editor).
Anda juga dapat memberikan izin update dan hapus kepada pengguna atau grup
dengan menggunakan peran lama roles/owner dan roles/editor.
Hanya satu tugas update yang didukung dalam satu waktu, dan setiap tugas dapat memiliki beberapa pembaruan properti. Anda dapat menggunakan zona data saat diperbarui.
Anda dapat memperbarui parameter zona data berikut:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 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)."]]
