本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
使用亚马逊管理 SaaS 订阅活动 EventBridge
您可以使用亚马逊 EventBridge 集成和管理 SaaS 产品 AWS Marketplace。系统会针对客户对您产品的订阅和合同权利的变更发送事件。当客户订阅、他们的权利发生变化和取消时，您会收到通知，因此您确切地知道何时授予或撤消访问权限。这些事件起着两个主要作用：
-
制造商 — 这是清单中的原始产品制造商 AWS Marketplace，也称为独立解决方案供应商 (ISV)。
-
提议者 — 这是中列出的产品的购买协议的原始提议者。 AWS Marketplace这可以是独立软件供应商，也可以是获准转售产品的渠道合作伙伴。
两种不同的销售模式决定了您作为 ISV 是充当制造商还是提议者。您的角色决定了您通过哪些通知接收 EventBridge。
| 卖出模式 | 说明 | ISV 的角色 |
|---|---|---|
| AWS Marketplace 公开或私人报价 | 您可以直接向买家提供报价或协议。 | 既是制造商又是提议者 |
| 渠道合作伙伴私人优惠 | 获准转售您的产品的渠道合作伙伴向买家提供报价或协议。 | Manufacturer |
EventBridge SaaS 产品活动
当 AWS Marketplace 交易发生时， EventBridge 将事件发送到您的默认事件总线。您作为制造商或提议者的角色决定了您收到的活动。
| 事件名称 | 发起方 | 响应 | 收件人 |
|---|---|---|---|
|
创建新协议、替换现有协议或续订现有协议。 | 记录购买协议并采取售后行动。DescribeAgreementAPI 用于确定新协议是否为免费试用版。 |
制造商和提议者 |
|
对现有协议进行了修改。 | 修订了购买协议记录。 | 制造商和提议者 |
|
协议已过期、已取消、终止。 | 记录购买协议的终止，协议取消后会采取行动。ISV 开始撤销客户权利。 | 制造商和提议者 |
| 已发布购买协议咨询-制造商 | AWS 已发布公告，可能会使该协议失效。可能触发此警报的条件包括关闭买家账户、泄露、滥用或欺诈。 | AWS 已经发现了一个影响该协议的问题。此问题可能会影响账单或服务访问权限。直接联系买家并评估是否修改其访问权限。 | 仅限制造商 |
| 购买协议咨询已解决-制造商 | AWS 已经解决了影响该协议的问题。 | AWS 已经解决了影响本协议的问题。如果您更改了买家的订阅或访问权限，则可以自行决定将其恢复。 | 仅限制造商 |
| 许可证已更新-制造商 | 买家对产品的权利已更改。 | 使用 GetEntitlements API 检查客户权利，并相应地提供服务。 |
仅限制造商 |
| 许可证已取消-制造商 | 买家对产品的权利已终止。 | 对于基于使用量的产品，此活动标志着 1 小时的最终报告窗口的开始。卖家应使用 BatchMeterUsage API 收集和报告任何未报告的使用情况。此窗口关闭后，客户权利将被完全撤销，并且不再接受使用情况报告。 |
仅限制造商 |
| 已达到支出门槛 | 买家在SaaS即用即付产品上的累计支出达到了支出门槛，并 AWS Marketplace 启动了对买家卡的付款验证（vet）。 | 信息性；无需采取任何行动。 AWS Marketplace 正在验证买家的付款能力。等待 “支出阈值审查成功” 或 “支出阈值审查失败” 事件。 | 制造商和提议者 |
| 支出阈值审核成功 | 买家卡上的付款验证已通过，支出阈值周期重置。 | 信息性；无需采取任何行动。 AWS Marketplace 验证了买家的付款方式。 | 制造商和提议者 |
| 支出门槛审核失败 | 买家卡上的付款验证失败。 | AWS Marketplace 无法验证买家的付款方式。 AWS Marketplace 将重试验证。 | 制造商和提议者 |
已达到支出阈值、成功审核支出阈值和支出阈值审查失败事件仅适用于采用基于使用量（按使用量付费）定价的 SaaS 产品。 AWS Marketplace 不会针对仅限合同或订阅定价的 SaaS 产品发送这些事件。
注意
制造商和提议者的购买协议事件类型几乎相同，唯一的不同是存在转售授权 ID。为避免多余的消息，只有当您既是制造商又是提议者时，才会发送提议者购买协议事件。
有关事件类型的完整列表及其详细架构，请参阅亚马逊 EventBridge 活动《卖家指南》。
基于使用情况的产品的最终使用情况报告窗口
对于具有基于使用量计费的产品， AWS Marketplace会给卖家一小时的时间来为权利已到期的客户提交最终使用记录。在此期限之后，BatchMeterUsageAPI 会拒绝报告的使用情况，您无法向客户开具账单。
AWS Marketplace 发送 “许可证已取消配置-制造商” 事件，以表示最终报告窗口的开始。卖家在收到此事件后有一小时的时间为买家收集任何未报告的使用情况，并使用 BatchMeterUsage API 进行报告。
一小时窗口关闭后， AWS Marketplace 将完全撤销客户的权利，并且不再接受使用情况报告。
EventBridge 与您的 SaaS 产品集成
用于 EventBridge 将租户配置操作与 AWS Marketplace 中的 SaaS 列表集成在一起。
-
事件规则定义如何对事件做出反应。这些规则可以立即做出反应，也可以按设定的时间表做出反应。
-
事件模式在事件规则中定义，允许您筛选发送到默认事件总线的特定事件类型。 EventBridge 控制台中提供了每种事件类型的模式模板。在事件模式配置步骤中，选择 AWS 服务作为事件源，选择 AWS 商城协议和许可证作为 AWS 服务。
-
所有 AWS 商城协议和许可证活动类型均使用以下结构。
{ "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"], "source": ["aws.agreement-marketplace"] } -
-
目标是在与为规则定义的事件模式匹配时接收事件的资源。许多 AWS 服务与 EventBridge Lambda 函数、步进函数和 API 网关集成并可用作目标。
有关设置 EventBridge 规则的更多信息，请参阅入门：创建 Amazon EventBridge 事件总线规则。
