Supprimer un registre de schémas

La suppression d'un registre de schémas est une action irréversible. Tous les sujets, schémas et versions contenus dans le registre sont définitivement supprimés. Avant de continuer, assurez-vous qu'aucun client Kafka actif ne repose sur ce registre.

Rôles et autorisations nécessaires

Pour obtenir les autorisations nécessaires pour supprimer un registre de schémas, demandez à votre administrateur de vous accorder le rôle IAM Éditeur du registre de schémas Kafka géré (roles/managedkafka.schemaRegistryEditor) sur l'instance de registre de schémas. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations nécessaires pour supprimer un registre de schémas. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour supprimer un registre de schémas :

  • Accordez l'autorisation suivante sur le registre de schémas : managedkafka.schemaRegistries.delete
  • Accordez l'autorisation suivante aux utilisateurs de la console pour qu'ils puissent lister les registres de schémas : managedkafka.schemaRegistries.list
  • Accordez l'autorisation suivante aux utilisateurs de la console pour qu'ils puissent obtenir des informations sur le registre de schémas : managedkafka.schemaRegistries.get

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Le rôle de niveau supérieur Administrateur du registre de schémas Managed Kafka (roles/managedkafka.schemaRegistryAdmin) inclut également ces autorisations.

Pour en savoir plus sur les rôles prédéfinis disponibles pour Managed Service pour Apache Kafka, consultez la documentation sur le contrôle des accès.

Supprimer un registre de schémas

Pour supprimer définitivement un registre de schémas et tout son contenu, procédez comme suit :

Console

  1. Dans la console Google Cloud , accédez à la page Registres de schémas.

    Accéder aux registres de schémas

    La liste des registres de schémas de votre projet s'affiche.

  2. Cliquez sur le nom du registre de schémas que vous souhaitez supprimer.
  3. Sur la page Détails du registre de schémas, cliquez sur le bouton Supprimer.
  4. Confirmez la suppression lorsque vous y êtes invité.

gcloud

  1. Installez la Google Cloud CLI. Une fois que la Google Cloud CLI est installée, initialisez-la en exécutant la commande suivante : 

    gcloud init

    Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  2. Exécutez la commande gcloud beta managed-kafka schema-registries delete :

    gcloud beta managed-kafka schema-registries delete SCHEMA_REGISTRY_ID \
    --location=LOCATION \

Remplacez les éléments suivants :

  • SCHEMA_REGISTRY_ID (obligatoire) : ID du registre de schémas que vous souhaitez supprimer.
  • LOCATION (obligatoire) : région Google Cloud dans laquelle se trouve le registre de schémas.

Par exemple, pour supprimer un registre de schémas nommé testRegistry dans la région us-central1, exécutez la commande suivante :

gcloud beta managed-kafka schema-registries delete testRegistry \
    --location=us-central1

API

Envoyez une requête DELETE à l'URI de ressource spécifique du registre de schémas que vous souhaitez supprimer.

DELETE https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID

Remplacez les éléments suivants :

  • PROJECT_ID (obligatoire) : ID de votre projet Google Cloud.
  • SCHEMA_REGISTRY_ID (obligatoire) : ID du registre de schémas que vous souhaitez supprimer.
  • LOCATION (obligatoire) : région Google Cloud dans laquelle se trouve le registre de schémas.

Si la requête aboutit et que le registre de schémas est supprimé, l'API renvoie généralement un code d'état 200 OK avec un corps JSON vide indiquant la fin d'une opération de longue durée ou la ressource d'opération elle-même.

Si le registre de schéma spécifié n'existe pas, vous recevez une erreur 404 Not Found.

Si vous ne disposez pas des autorisations nécessaires, vous recevrez une erreur 403 Forbidden.

Étape suivante

Apache Kafka® est une marque déposée d'Apache Software Foundation ou de ses filiales aux États-Unis et/ou dans d'autres pays.