Neste documento, descrevemos como excluir um tópico do Pub/Sub. Para excluir um tópico, use o console do Google Cloud, a CLI do Google, a biblioteca de cliente ou a API Pub/Sub.
Antes de começar
- Saiba mais sobre tópicos e o fluxo de trabalho de publicação de mensagens.
- Crie um tópico.
Papéis e permissões necessárias
Para receber as permissões necessárias para excluir tópicos e gerenciá-los,
peça ao administrador para conceder a você o
papel de Editor do Pub/Sub(roles/pubsub.editor
)
do IAM no seu tópico ou projeto.
Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.
Esse papel predefinido contém as permissões necessárias para excluir tópicos e gerenciá-los. Para conferir 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 tópicos e gerenciá-los:
-
Criar um tópico:
pubsub.topics.create
-
Excluir um tópico:
pubsub.topics.delete
-
Remover uma assinatura de um tópico:
pubsub.topics.detachSubscription
-
Acessar um tema:
pubsub.topics.get
-
Listar um tópico:
pubsub.topics.list
-
Publicar em um tópico:
pubsub.topics.publish
-
Atualizar um tópico:
pubsub.topics.update
-
Consiga a política do IAM para um tópico:
pubsub.topics.getIamPolicy
-
Configure a política do IAM para um tópico:
pubsub.topics.setIamPolicy
Talvez você também consiga receber essas permissões com papéis personalizados ou outros papéis predefinidos.
É possível configurar o controle de acesso no nível do projeto e no nível de recurso individual. É possível criar uma assinatura em um projeto e anexá-la a um tópico localizado em outro projeto. Verifique se você tem as permissões necessárias para cada projeto.
Excluir um tópico
Quando você exclui um tópico, as assinaturas dele não são excluídas. O backlog de mensagens da assinatura fica disponível para os assinantes. Depois que um tópico é excluído, as assinaturas dele ficam com o nome de tópico _deleted-topic_
. Se você tentar criar um tópico com o mesmo nome daquele que acabou de excluir, um breve erro será exibido por um breve período.
Console
No Console do Google Cloud, acesse a página Tópicos do Pub/Sub.
Selecione um tópico e clique em
Mais ações.Clique em Excluir.
A janela Excluir tópico é exibida.
Digite
delete
e clique em Excluir.
gcloud
-
No Console do Google Cloud, ative o Cloud Shell.
Na parte inferior do Console do Google Cloud, uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.
-
Para excluir um tópico, use o comando
gcloud pubsub topics delete
:gcloud pubsub topics delete TOPIC_ID
REST
Para excluir um tópico, use o
método
projects.topics.delete
:
Solicitação:
A solicitação precisa ser autenticada com um token de acesso no cabeçalho Authorization
. Para conseguir um token de acesso para o Application Default Credentials: gcloud auth application-default print-access-token
.
DELETE https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
Em que:
Resposta:
Se a solicitação for bem-sucedida, a resposta será um objeto JSON vazio.
C++
Antes de testar esta amostra, siga as instruções de configuração de C++ no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C++.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
C#
Antes de testar esta amostra, siga as instruções de configuração de C# no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub C#.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Go
Antes de testar esta amostra, siga as instruções de configuração de Go no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Go.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Java
Antes de testar esta amostra, siga as instruções de configuração de Java no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Java.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Node.js
Node.js
PHP
Antes de testar esta amostra, siga as instruções de configuração de PHP no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub PHP.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Python
Antes de testar esta amostra, siga as instruções de configuração de Python no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Python.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
Ruby
Antes de testar esta amostra, siga as instruções de configuração de Ruby no Guia de início rápido do Pub/Sub usando bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Pub/Sub Ruby.
Para se autenticar no Pub/Sub, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.
A seguir
Escolha o tipo de assinatura do tópico.
Crie uma assinatura para seu tópico: pull, push ou BigQuery.
Crie ou modifique um tópico com a gcloud CLI.
Crie ou modifique um tópico com APIs REST.