As propriedades do tópico do Pub/Sub são as características de um tópico. É possível definir propriedades de tópicos ao criar ou atualizar um tópico.
Este documento descreve as diferentes propriedades de tópico que podem ser definidas.
Antes de começar
- Saiba mais sobre tópicos e o fluxo de trabalho de publicação de mensagens.
- Crie um tópico.
Propriedades de tópicos comuns
Ao criar um tópico, você precisa especificar várias opções para configurá-lo. Algumas dessas propriedades são comuns a todos os tipos de assuntos e são discutidas nas próximas seções.
Adicione uma assinatura padrão
Adiciona uma assinatura padrão ao tópico do Pub/Sub. É possível criar outra assinatura para o tópico após a criação dele. A assinatura padrão tem as seguintes propriedades:
- ID da assinatura:
-sub
- Tipo de entrega pull
- Duração da retenção de mensagens de sete dias
- Expira após 31 dias de inatividade
- Prazo de confirmação de 10 segundos
- Política de repetição imediata
Esquema
Um esquema é um formato que o campo de dados da mensagem precisa seguir. Um esquema é um contrato entre o editor e o assinante que o Pub/Sub aplica.
Os esquemas de tópicos ajudam a padronizar os tipos de mensagem e as permissões para que sejam consumidos por diferentes equipes na organização. O Pub/Sub cria uma autoridade central para tipos de mensagem e permissões. Para criar um tópico com esquema, consulte Criar e gerenciar esquemas.
Duração da retenção da mensagem
Especifica por quanto tempo o tópico do Pub/Sub retém as mensagens após a publicação. Após a duração da retenção de mensagens, o Pub/Sub pode descartar a mensagem, independentemente do estado de confirmação. As tarifas de armazenamento de mensagens são cobradas pelo armazenamento de todas as mensagens publicadas no tópico.
- Padrão: não ativada
- Valor mínimo = 10 minutos
- Valor máximo = 31 dias
Use uma chave de criptografia gerenciada pelo cliente (CMEK)
Especifica se o tópico é criptografado com um CMEK. O Pub/Sub criptografa mensagens com chaves de propriedade e gerenciadas pelo Google por padrão. Se você especificar essa opção, o Pub/Sub vai usar o padrão de criptografia de envelope com o CMEK. Nessa abordagem, o Cloud KMS não criptografa as mensagens. Em vez disso, o Cloud KMS criptografa as chaves de criptografia de dados (DEKs, na sigla em inglês) que o Pub/Sub cria para cada tópico.
O Pub/Sub criptografa as mensagens usando a DEK mais recente gerada para o tópico. O Pub/Sub descriptografa as mensagens pouco antes de elas serem entregues aos assinantes.
Para mais informações sobre como criar uma chave, consulte Configurar a criptografia de mensagens.
A seguir
- Crie uma assinatura de pull.
- Crie uma assinatura de push.
- Crie uma assinatura do BigQuery.
- Crie uma assinatura do Cloud Storage.