Excluir um registro de esquema

A exclusão de um registro de esquema é uma ação irreversível. Todos os assuntos, esquemas e versões contidos no registro são excluídos permanentemente. Verifique se não há clientes Kafka ativos que dependam desse registro antes de continuar.

Papéis e permissões necessárias

Para ter as permissões necessárias para excluir um registro de esquema, peça ao administrador para conceder a você o papel do IAM Editor do registro de esquema do Kafka gerenciado (roles/managedkafka.schemaRegistryEditor) na instância do registro de esquema. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Este papel predefinido contém as permissões necessárias para excluir um registro de esquema. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para excluir um registro de esquema:

  • Conceda a seguinte permissão no registro de esquema: managedkafka.schemaRegistries.delete
  • Conceda a seguinte permissão para que os usuários do console listem os registros de esquema: managedkafka.schemaRegistries.list
  • Conceda a seguinte permissão para que os usuários do console recebam detalhes do registro de esquema: managedkafka.schemaRegistries.get

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Excluir um registro de esquema

Para excluir permanentemente um registro de esquema e todo o conteúdo dele, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Registros de esquema.

    Acessar registros de esquema

    Uma lista dos registros de esquema no seu projeto vai aparecer.

  2. Clique no nome do registro de esquema que você quer excluir.
  3. Na página Detalhes do registro de esquema, clique no botão Excluir.
  4. Confirme a exclusão quando solicitado.

gcloud

  1. Instale a CLI do Google Cloud. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:

    gcloud init

    Ao usar um provedor de identidade (IdP) externo, primeiro faça login na CLI gcloud com sua identidade federada.

  2. Use o comando gcloud beta managed-kafka schema-registries delete:

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

Substitua:

  • SCHEMA_REGISTRY_ID (obrigatório): o ID do registro de esquema que você quer excluir.
  • LOCATION (obrigatório): a região do Google Cloud em que o registro de esquema está localizado.

Por exemplo, para excluir um registro de esquema chamado testRegistry na região us-central1, execute o seguinte comando:

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

API

Faça uma solicitação DELETE para o URI de recurso específico do registro de esquema que você quer excluir.

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

Substitua:

  • PROJECT_ID (obrigatório): o ID do projeto do Google Cloud.
  • SCHEMA_REGISTRY_ID (obrigatório): o ID do registro de esquema que você quer excluir.
  • LOCATION (obrigatório): a região do Google Cloud em que o registro de esquema está localizado.

Se a solicitação for bem-sucedida e o registro de esquema for excluído, a API normalmente vai retornar um código de status 200 OK com um corpo JSON vazio indicando a conclusão de uma operação de longa duração ou o recurso da operação em si.

Se o registro de esquema especificado não existir, você vai receber um erro 404 Not Found.

Se você não tiver permissões, vai receber um erro 403 Forbidden.

A seguir

Apache Kafka® é uma marca registrada da The Apache Software Foundation ou afiliadas nos Estados Unidos e/ou em outros países.