Das Löschen einer Schema-Registry kann nicht rückgängig gemacht werden. Alle im Register enthaltenen Themen, Schemas und Versionen werden endgültig gelöscht. Achten Sie darauf, dass keine aktiven Kafka-Clients auf diese Registry angewiesen sind, bevor Sie fortfahren.
Erforderliche Rollen und Berechtigungen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Managed Kafka Schema Registry Editor (roles/managedkafka.schemaRegistryEditor) für die Schemaregisterinstanz zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Löschen eines Schemaregisters benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierte Rolle enthält die Berechtigungen, die zum Löschen einer Schemaregistrierung erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind zum Löschen einer Schemaregistrierung erforderlich:
-
Gewähren Sie die folgende Berechtigung in der Schemaregistrierung:
managedkafka.schemaRegistries.delete -
Gewähren Sie Konsolennutzern die folgende Berechtigung, um Schemaregister aufzulisten:
managedkafka.schemaRegistries.list -
Gewähren Sie Konsolennutzern die folgende Berechtigung, um Details zur Schemaregistrierung abzurufen:
managedkafka.schemaRegistries.get
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Schema-Registry löschen
So löschen Sie eine Schemaregistrierung und ihren gesamten Inhalt endgültig:
Console
- Rufen Sie in der Google Cloud Console die Seite Schema-Registries auf.
Eine Liste der Schemaregister in Ihrem Projekt wird angezeigt.
- Klicken Sie auf den Namen der Schemaregistrierung, die Sie löschen möchten.
- Klicken Sie auf der Seite Details zur Schemaregistrierung auf den Button Löschen.
- Bestätigen Sie den Löschvorgang, wenn Sie dazu aufgefordert werden.
gcloud
-
Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl:
gcloud initWenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
Führen Sie den Befehl
gcloud beta managed-kafka schema-registries deleteaus:gcloud beta managed-kafka schema-registries delete SCHEMA_REGISTRY_ID \ --location=LOCATION \
Ersetzen Sie Folgendes:
SCHEMA_REGISTRY_ID(erforderlich): die ID der Schemaregistrierung, die Sie löschen möchten.LOCATION(erforderlich): die Google Cloud-Region, in der sich die Schemaregistrierung befindet.
Wenn Sie beispielsweise eine Schemaregistrierung namens testRegistry in der Region us-central1 löschen möchten, führen Sie den folgenden Befehl aus:
gcloud beta managed-kafka schema-registries delete testRegistry \ --location=us-central1
API
Senden Sie eine DELETE-Anfrage an den spezifischen Ressourcen-URI der Schemaregistrierung, die Sie löschen möchten.
DELETE https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID
Ersetzen Sie Folgendes:
PROJECT_ID(erforderlich): Ihre Google Cloud-Projekt-ID.SCHEMA_REGISTRY_ID(erforderlich): die ID der Schemaregistrierung, die Sie löschen möchten.LOCATION(erforderlich): die Google Cloud-Region, in der sich die Schemaregistrierung befindet.
Wenn die Anfrage erfolgreich ist und die Schemaregistrierung gelöscht wird, gibt die API in der Regel den Statuscode 200 OK mit einem leeren JSON-Body zurück, der den Abschluss eines Vorgangs mit langer Ausführungszeit oder die Vorgangsressource selbst angibt.
Wenn die angegebene Schema-Registry nicht vorhanden ist, wird ein 404 Not Found-Fehler ausgegeben.
Wenn Sie nicht die erforderlichen Berechtigungen haben, erhalten Sie den Fehler 403 Forbidden.