此页面由 Cloud Translation API 翻译。

事件订阅

除了让您在后端执行读写操作外，Integration Connectors 还可以让您可以订阅在后端应用中发生的事件。例如，假设您希望在创建新的 Jira 工单时收到通知。为此，您可以为事件订阅配置 Jira Cloud 连接器。通过使用事件订阅以及利用 Application Integration，您可以创建有用的集成来满足您的业务需求。如需了解详情，请参阅在集成中使用事件订阅

在连接中启用事件订阅

您创建的关联可用于以下任一用途：

仅用于执行连接器操作（实体和操作）
仅适用于事件订阅
用于执行连接器操作和事件订阅

在创建关联时，您可以选择启用事件订阅和配置事件相关详细信息。不过，如果您已经有现有连接，并希望将其用于事件订阅，可以通过修改和重新配置该连接来实现。

以下连接器支持事件订阅：

在活动通知中丰富数据

您可以配置连接，以便在事件通知响应中附加其他信息。这些其他信息仅适用于您为其配置了事件的实体。如需获取更多信息，您必须在关联中启用数据丰富功能。

例如，如果您在 Zendesk 中订阅了工单创建事件，则会在有工单创建时收到通知。不过，事件通知有效载荷只有基本的票券详细信息工单说明、分配者和状态等其他详细信息未包含在载荷中。要获取这些额外的详细信息， ticket 实体，您必须在 Zendesk 连接中启用数据丰富功能。对于请参阅配置事件订阅。通过以下示例显示了使用数据丰富功能和使用数据丰富功能的响应载荷。

未进行数据丰富化的载荷

以下示例显示了没有数据丰富功能的 Zendesk 的 create Ticket 活动响应载荷。

{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }

具有数据丰富功能的载荷

以下示例展示了包含数据丰富功能的 Zendesk“创建工单”事件的响应载荷。

{
    "context-data": {
    "AllowChannelback": false,
    "Assignee": null,
    "AssigneeId": 1.6696812051473E13,
    "Brand": null,
    "BrandId": 1.6696812163985E13,
    "Cc": null,
    "CollaboratorIds": null,
    "Commenter": null,
    "HasAttachment": null,
    "CreatedAt": "2023-07-08 11:37:19.0",
    "CustomFields": null,
    "Description": "Test desc 2",
....
....
    "Status": "open",
    "Subject": "Test Zendesk Ticket Created -2 -DA",
    "Submitter": null,
    "SubmitterId": 1.6696812051473E13,
    "Tags": "tag-changed-after-cache,ticket-created",
....
....
    "ViaChannel": "web",
    "ViaFollowupSourceId": null,
    "ViaSource": "{\r\n  \"from\": null,\r\n  \"to\": null,\r\n  \"rel\": null\r\n}",
    "View_Id": null
  },
   "data":{
  "account_id": 12345,
  "integration_key": "my_integration_key",
  "subdomain": "my_zendesk_subdomain",
  "input": {
    "ticket_event": {
      "meta": {
        "version": "1.0",
....
....
        "position": 1,
          "total": 9
        }
      },
      "type": "Ticket Created",
      "ticket": {
        "id": 35436,
....
....
        "external_id": "TEST1234",
        "tags": [
          "enterprise"
        ],
        "via": {
          "channel": "web"
        }
      }
    }
  }
 }

用于事件订阅的专用连接

为了增强安全性，您可以配置后端应用与连接之间的专用连接。在专用连接中，连接的事件监听器不会直接设为公开。相反，您必须通过集成连接器提供给您的 PSC 服务连接，允许网络流量入站到事件监听器。

在创建连接期间，如果您为事件订阅选择了启用专用连接，集成连接器会创建 PSC 服务附件。您必须使用适合您的任何方法将 PSC 服务连接公开给后端应用。一种可能的方法是在负载均衡器中使用 PSC 服务连接，然后将负载均衡器配置为接受来自后端应用的事件。然后，该连接会在负载均衡器的地址上监听后端的事件。以下简要步骤展示了如何使用负载均衡器来配置专用连接：

转到新创建的连接的连接详情页面。
点击修改 Ingress 端点。系统随即会显示“事件订阅设置”窗格。
复制 PSC 服务连接名称字段中显示的服务连接名称。
创建一个 PSC 网络端点组，指向您在上一步中获得的服务连接。
创建一个外部负载均衡器，并将上一步中创建的 PSC 网络端点组用作后端。
提示：如果您已经有外部负载均衡器，则可以使用它来配置专用连接，而无需创建新的负载均衡器。
将负载均衡器配置为接受来自事件提供方（后端应用）IP 地址的请求。
后续 setps（7 到 11）仅适用于后端支持自动注册事件订阅。例如 Zendesk 和 Jira。
转到新创建的连接的连接详情页面。
点击修改入站端点。系统随即会显示“事件订阅设置”窗格。
在事件监听器入站流量端点字段中输入负载均衡器的地址。
点击完成。
点击保存以保存对连接所做的更改。

在集成中使用事件订阅

将事件订阅与集成结合使用后，您可以创建集成来解决复杂的业务问题。例如，您可以从基于 ServiceNow 事件执行整个集成。 Application Integration 提供以下触发器，监听来自后端应用的事件通知：

HubSpot 触发器 - 监听 HubSpot 事件。
IBM MQ 触发器 - 监听 IBM MQ 事件。
Jira Cloud 触发器 - 监听 Jira Cloud 事件。
Rabbit MQ 触发器 - 监听 Rabbit MQ 事件。
ServiceNow 触发器 - 监听 ServiceNow 事件。
TIBCOEMS 触发器 - 监听 TIBCOEMS 事件。
Webhook 触发器 - 监听通用 webhook 事件。
Zendesk 触发器 - 监听 Zendesk 事件。

如需配置触发器，您必须为连接启用事件订阅。您可以在现有连接中或新连接中启用事件订阅。如需详细了解如何配置这些应用集成触发器，请参阅相应的触发器文档。

查看已启用的订阅

当您在应用集成中使用事件订阅时，Integration Connectors 会创建相应连接中订阅的条目。查看所有订阅对于连接，请执行以下步骤：

打开 Google Cloud 项目的“所有连接”页面。
转到“连接”页面
点击要查看其订阅的连接。
系统随即会打开连接详情页面。
点击订阅标签页。
此操作会显示关联的所有订阅。此页面上列出的订阅可以处于以下任一状态：
- 正在创建 - 订阅正在由集成创建。
- 有效 - 订阅有效且正常运行。
- 暂停 - 连接处于暂停状态。
- 错误 - 创建订阅失败。例如，订阅创建期间身份验证失败。

事件订阅的价格

针对预览触发器中的事件订阅处理的数据（事件载荷）不会产生费用。不过，对于在正式版触发器中处理的事件订阅数据，您需要支付费用。