Propriedades do tópico

As propriedades do tópico do Pub/Sub são as características de um tópico. É possível definir as propriedades do tópico ao criar ou atualizar um tópico.

Este documento descreve as diferentes propriedades de tópico que podem ser definidas para um tópico.

Antes de começar

Propriedades de tema comum

Ao criar um tópico, é necessário especificar várias opções para configurá-lo. Algumas dessas propriedades são comuns a todos os tipos de tópicos 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 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
  • 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 mensagens e as permissões para que possam ser consumidos por diferentes equipes na sua organização. O Pub/Sub cria uma autoridade central para tipos de mensagens 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 ativado
  • Valor mínimo = 10 minutos
  • Valor máximo = 31 dias

Use uma chave de criptografia gerenciada pelo cliente (CMEK)

Especifica se o tópico está criptografado com uma CMEK. O Pub/Sub criptografa mensagens com Google-owned and Google-managed encryption keys por padrão. Se você especificar essa opção, o Pub/Sub usará o padrão de criptografia de envelope com 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 que foi 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.

Transformações de mensagens únicas (SMTs)

Especifica modificações leves nos atributos e dados das mensagens diretamente no Pub/Sub. Isso permite a limpeza de dados, filtragem ou conversão de formato antes que as mensagens sejam publicadas no tópico.

Para mais informações, consulte Visão geral das SMTs e Criar um tópico com SMTs.

A seguir