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.
Essa função predefinida 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.
O papel de nível superior Administrador do registro de esquema do Managed Kafka (roles/managedkafka.schemaRegistryAdmin) também inclui essas permissões.
Para mais informações sobre os papéis predefinidos disponíveis para o serviço gerenciado para Apache Kafka, consulte a documentação de controle de acesso.
Excluir um registro de esquema
Para excluir permanentemente um registro de esquema e todo o conteúdo dele, siga estas etapas:
Console
- No console do Google Cloud , acesse a página Registros de esquema.
Uma lista dos registros de esquema no seu projeto é exibida.
- Clique no nome do registro de esquema que você quer excluir.
- Na página Detalhes do registro de esquema, clique no botão Excluir.
- Confirme a exclusão quando solicitado.
gcloud
-
Instale a CLI do Google Cloud. Após a instalação, inicialize a CLI do Google Cloud executando o seguinte comando:
gcloud initAo usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
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.