Für die meisten gcloud lake-Befehle ist ein Speicherort erforderlich. Sie können den Speicherort mit dem Flag --location angeben.
Erforderliche Rollen
Zum Aktualisieren einer Datenzone benötigen Sie die IAM-Rolle mit der Berechtigung dataplex.lakes.create. Zum Beispiel die IAM-Rolle „Dataplex Administrator“ (roles/dataplex.admin) oder „Dataplex Editor“ (roles/dataplex.editor).
Zum Löschen einer Datenzone benötigen Sie eine IAM-Rolle mit der Berechtigung dataplex.zones.update. Beispiel: Dataplex Administrator (roles/dataplex.admin) oder Dataplex Editor (roles/dataplex.editor) IAM-Rolle.
Mit den Legacy-Rollen roles/owner und roles/editor können Sie Nutzern oder Gruppen auch Berechtigungen zum Aktualisieren und Löschen erteilen.
Es wird nur ein Aktualisierungsjob gleichzeitig unterstützt. Jeder Job kann mehrere Property-Aktualisierungen enthalten. Sie können die Datenzone verwenden, während sie aktualisiert wird.
Sie können die folgenden Parameter für Datenzonen aktualisieren:
Klicken Sie auf der Seite Dataplex Universal Catalog auf den Namen des Lakes, den Sie aktualisieren möchten. Die Lake-Seite für diesen Lake wird geöffnet.
Klicken Sie auf dem Tab Zonen auf den Namen der Datenzone, die Sie aktualisieren möchten. Die Seite „Datenzone“ für diese Datenzone wird geöffnet.
Klicken Sie oben auf der Seite auf Bearbeiten. Das Dialogfeld Zone bearbeiten wird geöffnet.
Wählen Sie die aktualisierten Parameterwerte für die Datenzone aus.
Klicken Sie auf Speichern, um die Datenzone zu aktualisieren.
Prüfen Sie, ob Sie zur Seite „Datenzone“ zurückgekehrt sind und Ihre aktualisierte Datenzone aktiv ist.
REST
Verwenden Sie zum Aktualisieren einer Zone die Methode lakes.zones.patch.
Wenn die Aktualisierung erfolgreich ist, wechselt die Datenzone automatisch in den aktiven Status. Schlägt sie fehl, wird die Datenzone auf ihren vorherigen fehlerfreien Zustand zurückgesetzt.
Zone löschen
Sie möchten die Datenzone möglicherweise löschen, wenn Ihre Konfigurationen (z. B. Datenzonenname oder -typ) falsch sind und nicht geändert werden können.
Console
Rufen Sie in der Google Cloud Console die Seite „Dataplex Universal Catalog“ auf.
Klicken Sie auf der Seite Dataplex Universal Catalog auf den Namen des Lakes, aus dem Sie eine Zone löschen möchten. Die Lake-Seite für diesen Lake wird geöffnet.
Klicken Sie auf dem Tab Zonen auf das Kästchen links neben dem Namen der Datenzone, um sie auszuwählen.
Klicken Sie auf Zone löschen.
Klicken Sie zum Bestätigen auf Löschen.
Sie können Ihre Datenzone auch auf der Seite „Datenzone“ löschen.
Klicken Sie auf der Seite Dataplex Universal Catalog auf den Namen des Lakes, aus dem Sie eine Datenzone löschen möchten. Die Lake-Seite für diesen Lake wird geöffnet.
Klicken Sie auf dem Tab Zonen auf den Namen der Datenzone, die Sie löschen möchten.
Klicken Sie auf Löschen.
Klicken Sie im Dialogfeld auf Löschen, um den Löschvorgang zu bestätigen.
Vergewissern Sie sich, dass Sie zur Seite „Lake“ zurückgekehrt sind und die gelöschte Datenzone nicht mehr in der Liste der Datenzonen angezeigt wird.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-19 (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)."]]
