主题属性

Pub/Sub 主题属性是指主题的特征。 您可以在创建或更新主题时设置主题属性。

本文档介绍了您可以为主题设置的不同主题属性。

准备工作

常见主题属性

创建主题时，您必须指定多个选项来设置主题。其中一些属性是所有类型的主题共有的，将在下文中进行讨论。

添加默认订阅

向 Pub/Sub 主题添加默认订阅。创建主题后，您可以为该主题创建其他订阅。默认订阅具有以下属性：

  • -sub 的订阅 ID
  • 拉取传送类型
  • 消息保留时长为 7 天
  • 在处于非活跃状态 31 天后过期
  • 10 秒的确认时限
  • 立即重试政策

架构

架构是消息数据字段必须遵循的格式。架构是发布者与订阅者之间的一份合约，Pub/Sub 会强制执行该合约。

主题架构有助于标准化消息类型和权限，以便组织中的不同团队使用这些消息。Pub/Sub 会为消息类型和权限创建一个中央授权机构。如需创建具有架构的主题，请参阅创建和管理架构。

消息保留时长

指定 Pub/Sub 主题在发布后保留消息的时间。超过消息保留时长之后，Pub/Sub 可以随意舍弃消息，无论其确认状态为何。会对发布到主题的所有消息收取消息存储费用。

  • 默认值 = 未启用
  • 最小值 = 10 分钟
  • 最大值 = 31 天

使用客户管理的加密密钥 (CMEK)

指定主题是否已使用 CMEK 加密。默认情况下，Pub/Sub 使用 Google-owned and Google-managed encryption keys 加密消息。如果您指定此选项，Pub/Sub 将通过 CMEK 使用信封加密模式。在此方法中，Cloud KMS 不会对消息进行加密。Cloud KMS 会加密 Pub/Sub 为每个主题创建的数据加密密钥 (DEK)。

Pub/Sub 会使用系统为相应主题生成的最新 DEK 对消息进行加密。在消息即将传送给订阅者之前，Pub/Sub 会对消息进行解密。

如需详细了解如何创建密钥，请参阅配置消息加密。

单条消息转换 (SMT)

用于指定直接在 Pub/Sub 内对消息属性和数据进行轻量级修改。这样，在将消息发布到主题之前，可以先进行数据清理、过滤或格式转换。

如需了解详情，请参阅 SMT 概览和创建包含 SMT 的主题。

后续步骤