Propriedades do tópico

As propriedades do tópico Pub/Sub são as caraterísticas de um tópico. Pode definir propriedades de tópicos quando cria ou atualiza um tópico.

Este documento descreve as diferentes propriedades de tópicos que pode definir para um tópico.

Antes de começar

Propriedades de tópicos comuns

Quando cria um tópico, tem de especificar várias opções para configurar o tópico. Algumas destas propriedades são comuns a todos os tipos de tópicos e são abordadas nas secções seguintes.

Adicione uma subscrição predefinida

Adiciona uma subscrição predefinida ao tópico Pub/Sub. Pode criar outra subscrição para o tópico depois de o tópico ser criado. A subscrição predefinida tem as seguintes propriedades:

  • ID da subscrição de -sub
  • Tipo de fornecimento de extração
  • Duração da retenção de mensagens de sete dias
  • Expiração 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 tem de seguir. Um esquema é um contrato entre o publicador e o subscritor que o Pub/Sub aplica.

Os esquemas de tópicos ajudam a padronizar os tipos de mensagens e as autorizações para que possam ser consumidos por diferentes equipas na sua organização. O Pub/Sub cria uma autoridade central para os tipos de mensagens e as autorizações. Para criar um tópico com esquema, consulte o artigo Crie e faça a gestão de esquemas.

Duração da retenção de mensagens

Especifica o período durante o qual o tópico Pub/Sub retém mensagens após a publicação. Após a duração da retenção de mensagens, o Pub/Sub pode rejeitar a mensagem, independentemente do respetivo estado de confirmação. As taxas de armazenamento de mensagens são cobradas pelo armazenamento de todas as mensagens publicadas no tópico.

  • Predefinição = Não ativado
  • Valor mínimo = 10 minutos
  • Valor máximo = 31 dias

Use uma chave de encriptação gerida pelo cliente (CMEK)

Especifica se o tópico está encriptado com uma CMEK. O Pub/Sub encripta as mensagens com Google-owned and Google-managed encryption keys por predefinição. Se especificar esta opção, o Pub/Sub usa o padrão de encriptação em envelope com CMEK. Nesta abordagem, o Cloud KMS não encripta as mensagens. Em alternativa, o Cloud KMS encripta as chaves de encriptação de dados (DEKs) que o Pub/Sub cria para cada tópico.

O Pub/Sub encripta as mensagens com a DEK mais recente que foi gerada para o tópico. O Pub/Sub descifra as mensagens pouco antes de serem entregues aos subscritores.

Para mais informações sobre como criar uma chave, consulte o artigo Configure a encriptação de mensagens.

Transformações de mensagens únicas (SMTs)

Especifica modificações simples aos atributos e dados das mensagens diretamente no Pub/Sub. Isto permite a limpeza, a filtragem ou a conversão de formato dos dados antes de as mensagens serem publicadas no tópico.

Para mais informações, consulte Vista geral dos SMTs e Crie um tópico com SMTs.

O que se segue?