No Pub/Sub, um tópico é um recurso nomeado que representa um feed de mensagens. É necessário criar um tópico para poder publicar ou assinar. O Pub/Sub é compatível com dois tipos de tópicos: um padrão e um de importação.
Este documento descreve como criar um tópico padrão do Pub/Sub. Para saber mais sobre um tópico de importação e como criar um, consulte Sobre tópicos de importação.
Para criar um tópico, use o console Google Cloud , a Google Cloud CLI, a biblioteca de cliente ou a API Pub/Sub.
Antes de começar
Saiba mais sobre o serviço do Pub/Sub e a terminologia dele.
Saiba mais sobre o processo de publicação.
Papéis e permissões necessárias
Para receber as permissões necessárias
para criar um tópico,
peça ao administrador para conceder a você o
papel do IAM de Editor do Pub/Sub(roles/pubsub.editor)
no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém as permissões necessárias para criar um tópico. 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 criar um tópico:
-
Conceda esta permissão para criar um tópico no projeto:
pubsub.topics.create
Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.
É possível configurar o controle de acesso no nível do projeto e no nível do 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.
Propriedades de um tópico
Ao criar ou atualizar um tópico, você precisa especificar as propriedades dele.
Adicione uma assinatura padrão
Adiciona uma assinatura padrão ao tópico do Pub/Sub. Você pode criar outra assinatura para o tópico depois que ele for criado. A assinatura padrão tem as seguintes propriedades:
- ID da assinatura de
-sub - Tipo de entrega pull
- Duração da retenção de mensagens de sete dias
- Expiração após 31 dias de inatividade
- Prazo de confirmação de recebimento de 10 segundos