Schema-Registry löschen

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, um die Berechtigungen zu 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 für die Schemaregistrierung: managedkafka.schemaRegistries.delete
  • Gewähren Sie Konsolennutzern die folgende Berechtigung, um Schemaregister aufzulisten: managedkafka.schemaRegistries.list
  • Gewähren Sie Konsolennutzern die folgende Berechtigung, damit sie Details zur Schemaregistrierung abrufen können: managedkafka.schemaRegistries.get

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Die übergeordnete Rolle Managed Kafka Schema Registry Admin (roles/managedkafka.schemaRegistryAdmin) enthält diese Berechtigungen ebenfalls.

Weitere Informationen zu den vordefinierten Rollen, die für Managed Service for Apache Kafka verfügbar sind, finden Sie in der Dokumentation zur Zugriffssteuerung.

Schema-Registry löschen

So löschen Sie eine Schemaregistrierung und ihren gesamten Inhalt endgültig:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Schema-Registries auf.

    Zu Schema-Registries

    Eine Liste der Schemaregistrierungen in Ihrem Projekt wird angezeigt.

  2. Klicken Sie auf den Namen der Schemaregistrierung, die Sie löschen möchten.
  3. Klicken Sie auf der Seite Schema Registry-Details auf die Schaltfläche Löschen.
  4. Bestätigen Sie den Löschvorgang, wenn Sie dazu aufgefordert werden.

gcloud

  1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

    gcloud init

    Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  2. Führen Sie den Befehl gcloud beta managed-kafka schema-registries delete aus:

    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 Schemaregistry mit dem Namen 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 über die erforderlichen Berechtigungen verfügen, wird der Fehler 403 Forbidden ausgegeben.

Nächste Schritte

Apache Kafka® ist eine eingetragene Marke der Apache Software Foundation oder ihrer Tochtergesellschaften in den USA und/oder anderen Ländern.