创建拉取订阅

本文档介绍如何创建拉取订阅。您可以使用 控制台、Google Cloud CLI、客户端库或 Pub/Sub API 创建拉取订阅。 Google Cloud

准备工作

• 了解订阅。
• 评估您的业务是否需要拉取订阅。
• 了解拉取订阅的工作原理。

所需角色和权限

如需获得创建拉取订阅所需的权限，请让您的管理员为您授予项目的Pub/Sub Editor (roles/pubsub.editor) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供 创建拉取订阅所需的权限。如需查看所需的确切权限，请展开所需权限部分：

所需权限

创建拉取订阅需要以下权限：

• pubsub.subscriptions.create 针对项目的权限
• pubsub.topics.attachSubscription 针对主题

您也可以使用自定义角色或其他预定义角色来获取这些权限。

跨项目订阅

如果您在一个项目中为另一个项目中的主题创建订阅，则必须对创建订阅的项目具有 pubsub.subscriptions.create 权限，并且对该主题具有 pubsub.topics.attachSubscription 权限。

拉取订阅属性

拉取订阅支持所有 常见的订阅属性。拉取订阅还支持仅传送一次 属性，下一部分将对此进行介绍。

仅传送一次

仅传送一次 。如果设置了此属性，Pub/Sub 会履行 仅传送一次的保证。 如果未指定，则订阅支持 至少传送一次每条消息。

创建拉取订阅

以下示例演示了如何使用提供的默认设置创建使用拉取传送的订阅。