Eliminare un registro di schemi

L'eliminazione di un registro di schemi è un'azione irreversibile. Tutti gli argomenti, gli schemi e le versioni contenuti nel registro vengono eliminati definitivamente. Prima di procedere, assicurati che nessun client Kafka attivo si basi su questo registro.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per eliminare un registro degli schemi, chiedi all'amministratore di concederti il ruolo IAM Managed Kafka Schema Registry Editor (roles/managedkafka.schemaRegistryEditor) nell'istanza del registro degli schemi. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eliminare un registro di schema. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per eliminare un registro degli schemi sono necessarie le seguenti autorizzazioni:

  • Concedi la seguente autorizzazione al registro degli schemi: managedkafka.schemaRegistries.delete
  • Concedi la seguente autorizzazione agli utenti della console per elencare i registri degli schemi: managedkafka.schemaRegistries.list
  • Concedi la seguente autorizzazione agli utenti della console per ottenere i dettagli del registro degli schemi: managedkafka.schemaRegistries.get

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Il ruolo di livello superiore Managed Kafka Schema Registry Admin (roles/managedkafka.schemaRegistryAdmin) include anche queste autorizzazioni.

Per saperne di più sui ruoli predefiniti disponibili per Managed Service per Apache Kafka, consulta la documentazione sul controllo dell'accesso.

Eliminare un registro di schemi

Per eliminare definitivamente un registro degli schemi e tutti i relativi contenuti:

Console

  1. Nella console Google Cloud , vai alla pagina Registri di schemi.

    Vai ai registri di schemi

    Viene visualizzato un elenco dei registri di schema nel tuo progetto.

  2. Fai clic sul nome del registro degli schemi che vuoi eliminare.
  3. Nella pagina Dettagli del registro degli schemi, fai clic sul pulsante Elimina.
  4. Conferma l'eliminazione quando ti viene richiesto.

gcloud

  1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

    gcloud init

    Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  2. Utilizza il comando gcloud beta managed-kafka schema-registries delete:

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

Sostituisci quanto segue:

  • SCHEMA_REGISTRY_ID (obbligatorio): l'ID del registro dello schema da eliminare.
  • LOCATION (obbligatorio): la regione Google Cloud in cui si trova il registro degli schemi.

Ad esempio, per eliminare un registro di schema denominato testRegistry nella regione us-central1, esegui questo comando:

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

API

Effettua una richiesta DELETE all'URI della risorsa specifica del registro degli schemi che vuoi eliminare.

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

Sostituisci quanto segue:

  • PROJECT_ID (obbligatorio): l'ID del tuo progetto Google Cloud.
  • SCHEMA_REGISTRY_ID (obbligatorio): l'ID del registro dello schema da eliminare.
  • LOCATION (obbligatorio): la regione Google Cloud in cui si trova il registro degli schemi.

Se la richiesta riesce e il registro degli schemi viene eliminato, l'API restituisce in genere un codice di stato 200 OK con un corpo JSON vuoto che indica il completamento di un'operazione a lunga esecuzione o la risorsa dell'operazione stessa.

Se il registro di schema specificato non esiste, ricevi un errore 404 Not Found.

Se non disponi delle autorizzazioni, ricevi un errore 403 Forbidden.

Passaggi successivi

Apache Kafka® è un marchio registrato di Apache Software Foundation o delle sue consociate negli Stati Uniti e/o in altri paesi.