Propriedades do tópico

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

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