本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 通过亚马逊管理 SaaS 订阅事件 EventBridge
<a name="saas-eventbridge-integration"></a>

您可以使用 Amazon EventBridge 与集成和管理 SaaS 产品 AWS Marketplace。如果客户对您的产品订阅和合同权利进行更改，则会发送事件。当客户订阅、权利更改以及取消时，您都会收到通知，因此您可以确切地知道何时授予或撤销访问权限。这些事件起到两个主要作用：
+ **制造商** — 这是列表中的原始产品制造商 AWS Marketplace，也称为独立解决方案供应商 (ISV)。
+ **投标人** — 这是中列出的产品的购买协议的原始提议人。 AWS Marketplace这可以是 ISV，也可以是授权转售产品的渠道合作伙伴。

两种不同的销售模式决定了您作为独立软件供应商是制造商还是提议者。您的角色决定了您通过哪些接收通知 EventBridge。


| 卖出模式 | 说明 | ISV 的角色 | 
| --- | --- | --- | 
| AWS Marketplace 公开或私人报价 | 您直接向买家提供报价或协议。 | 既是制造商又是提议者 | 
| 渠道合作伙伴私享优惠 | 获准转售您的产品的渠道合作伙伴会向买家提供报价或协议。 | Manufacturer | 

## EventBridge SaaS 产品活动
<a name="saas-eventbridge-event-types"></a>

当 AWS Marketplace 交易发生时， EventBridge 会将事件发送到您的默认事件总线。您作为制造商或提案人的角色决定了您收到哪些活动。


| 事件名称 | 发起者 | 响应 | 收件人 | 
| --- | --- | --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/marketplace/latest/userguide/saas-eventbridge-integration.html)  | 创建新协议、替换现有协议或续订现有协议。 | 记录购买协议并采取售后行动。 DescribeAgreementAPI 用于确定新协议是否为免费试用版。 | 制造商和提案人 | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/marketplace/latest/userguide/saas-eventbridge-integration.html)  | 对现有协议进行了修改。 | 购买协议记录已修改。 | 制造商和提案人 | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/marketplace/latest/userguide/saas-eventbridge-integration.html)  | 协议已过期、已取消、终止。 | 将记录购买协议的终止情况，并进行协议后的取消行动。ISV 开始撤销客户权利。 | 制造商和提案人 | 
| 许可证已更新-制造商 | 买家对产品的权利已发生变化。 | 使用 GetEntitlements API 检查客户权利，并相应地配置服务。 | 仅限制造商 | 
| 许可证已取消配置-制造商 | 买家对产品的权利已终止。 | 对于基于使用情况的产品，此事件标志着 1 小时的最终报告窗口的开始。卖家应使用 BatchMeterUsage API 收集并报告任何未报告的使用情况。此窗口关闭后，客户权利将被完全撤销，并且不再接受使用情况报告。 | 仅限制造商 | 

**注意**  
除了存在转售授权 ID 之外，制造商和投标人的购买协议事件类型几乎相同。为了避免多余的消息，只有当你既是制造商又是投标人时，才会发送投标人购买协议事件。

有关事件类型的完整列表及其详细架构，请参阅[亚马逊 EventBridge 活动](notifications-eventbridge.md)《卖家指南》。

## 基于使用量的产品的最终使用情况报告窗口
<a name="saas-eventbridge-final-usage"></a>

对于具有基于使用量计费的商品，Marketpl AWS ace 会为卖家提供一小时的时间来为其权利已终止的客户提交最终使用记录。在此期限之后，`BatchMeterUsage`API 会拒绝报告的使用量，并且您无法向客户开具账单。

AWS Marketplace 会发送 “许可证已取消配置-制造商” 事件，以表示最终报告窗口的开始。卖家在收到此事件后有一小时的时间来收集买家未报告的使用情况，并使用 `BatchMeterUsage` API 进行报告。

一小时窗口关闭后， AWS Marketplace 将完全撤销客户的权利，不再接受使用情况报告。

## EventBridge 与你的 SaaS 产品集成
<a name="saas-eventbridge-using"></a>

用于 EventBridge 将租户配置操作与 AWS Marketplace 中的 SaaS 列表集成。
+ 事件规则定义了如何对事件做出反应。这些规则可以立即做出反应，也可以按设定的时间表做出反应。
+ 事件模式在事件规则中定义，允许您筛选发送到默认事件总线的特定事件类型。 EventBridge 控制台中提供了每种事件类型的模式模板。在事件模式配置步骤中，选择 AWS 服务作为事件源，选择 AWS Marketplace 协议和许可作为 AWS 服务。
  + 所有 AWS Marketplace 协议和许可事件类型均使用以下结构。

  ```
  {
  "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"],
  "source": ["aws.agreement-marketplace"]
  }
  ```
+ 目标是在事件与为规则定义的事件模式相匹配时接收事件的资源。许多 AWS 服务都集成 EventBridge 并可以用作目标，包括 Lambda 函数、Step Functions 和 API Gateway。

有关设置 EventBridge 规则的更多信息，请参阅[入门：创建 Amazon EventBridge 事件总线规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)。