管理订阅

作为 Analytics Hub 订阅者,您可以执行以下任务:

  • 订阅清单。
  • 列出给定项目中的当前订阅。
  • 删除订阅。

作为 Analytics Hub 发布者,您可以执行以下任务:

  • 查看清单的所有订阅。
  • 撤销对特定订阅的访问权限。

订阅是位于订阅者项目中的区域化资源。订阅存储有关订阅者的信息,并代表发布者和订阅者之间的合约。

须知事项

要开始使用 Analytics Hub,您需要在 Google Cloud 项目中启用 Analytics Hub API。

所需权限

要启用 Analytics Hub API,您需要以下 Identity and Access Management (IAM) 权限:

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

以下预定义 IAM 角色可提供启用 Analytics Hub API 所需的权限:

  • roles/serviceusage.serviceUsageAdmin

如需详细了解 BigQuery 中的 IAM 角色,请参阅预定义的角色和权限

启用 Analytics Hub API

如需启用 Analytics Hub API,请执行以下操作:

控制台

转到 Google Cloud 项目的 Analytics Hub API 并启用。

启用 Analytics Hub API

gcloud

运行 gcloud services enable 命令:

gcloud services enable analyticshub.googleapis.com

所需权限

如需管理订阅,您必须拥有以下 Analytics Hub 角色之一:

  • Analytics Hub Subscription Owner 角色 (roles/analyticshub.subscriptionOwner),该角色允许您管理您创建的订阅。

如需了解详情,请参阅 Analytics Hub 用户角色

订阅者工作流

订阅者可以对订阅执行以下操作。

订阅清单

如需订阅清单,请按照订阅清单中的步骤操作。

列出订阅

如需列出所有订阅,请按照以下步骤操作。

API

如需查看给定项目中的当前订阅,请使用 projects.locations.subscriptions.list 方法。

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

请替换以下内容:

  • PROJECT_ID:包含您要列出的订阅的项目 ID。

  • LOCATION:您要列出现有订阅的位置。

发布者工作流

发布者可以对订阅执行以下操作。如需详细了解如何管理清单的订阅,请参阅管理清单

列出订阅

如需列出所有订阅,请按照以下步骤操作。

  1. 在 Google Cloud 控制台中,转到 Analytics Hub 页面。

    转到 Analytics Hub

    此时会显示一个页面,其中列出了您可以访问的所有数据交换。

  2. 点击要列出订阅的数据交换名称。

  3. 点击订阅标签页,以查看数据交换中清单的所有订阅。

移除订阅

控制台

  1. 在 Google Cloud 控制台中,转到 Analytics Hub 页面。

    转到 Analytics Hub

    此时会显示一个页面,其中列出了您可以访问的所有数据交换。

  2. 点击要在其中创建清单的数据交换名称。

  3. 点击订阅标签页,以查看数据交换的所有订阅。

  4. 选中要移除的订阅旁边的复选框,或选择所有订阅。

  5. 点击移除订阅

API

如需删除订阅,请使用 projects.locations.subscriptions.delete 方法。

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID

请替换以下内容:

  • PROJECT_ID:您要删除的订阅的项目 ID。
  • LOCATION:订阅的位置。
  • SUBSCRIPTION_ID:您要删除的订阅的 ID。

限制

订阅受限于以下限制:

  • 2023 年 7 月 25 日之前创建的关联数据集不会回填。只有在 2023 年 7 月 25 日之后创建的订阅才适用 API 方法。

后续步骤