本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon EventBridge 管理 SaaS 訂閱事件
<a name="saas-eventbridge-integration"></a>

您可以使用 Amazon EventBridge 來整合和管理 SaaS 產品 AWS Marketplace。系統會傳送事件，以變更您產品的客戶訂閱和合約權利。客戶訂閱、權利變更以及取消時，您會收到通知，讓您確切知道何時授予或撤銷存取權。這些事件提供兩個主要角色：
+ **製造商** – 這是 中清單的原始產品製造商 AWS Marketplace，也稱為獨立解決方案廠商 (ISV)。
+ **提案者** – 這是 中所列產品的購買協議的原始提案者 AWS Marketplace。這可以是 ISV 或經授權可轉售產品的通路合作夥伴。

兩種不同的銷售模式決定您是擔任 ISV 的製造商還是提案者。您的角色會決定您透過 EventBridge 收到哪些通知。


| 銷售模式 | Description | ISV 的角色 | 
| --- | --- | --- | 
| AWS Marketplace 公有或私有優惠 | 您可以將優惠或協議直接提供給買方。 | 製造商和提案者 | 
| 管道合作夥伴私有優惠 | 授權轉售您產品的通路合作夥伴會將優惠或協議延伸至買方。 | 製造商 | 

## SaaS 產品的 EventBridge 事件
<a name="saas-eventbridge-event-types"></a>

 AWS Marketplace 交易發生時，EventBridge 會將事件傳送至您的預設事件匯流排。您身為製造商或提案者的角色會決定您收到的事件。


| 事件名稱 | 由 啟動 | 回應 | 收件人 | 
| --- | --- | --- | --- | 
|  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/saas-eventbridge-integration.html)  | 建立新協議、取代現有協議或續約現有協議。 | 會記錄購買協議並採取售後動作。 DescribeAgreementAPI 用於判斷新協議是否為免費試用。 | 製造商和提案者 | 
|  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/saas-eventbridge-integration.html)  | 現有協議已修訂。 | 已修改購買協議記錄。 | 製造商和提案者 | 
|  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/marketplace/latest/userguide/saas-eventbridge-integration.html)  | 協議已過期、已取消、已終止。 | 會記錄購買協議關閉，並發生協議後取消動作。ISV 開始撤銷客戶權利。 | 製造商和提案者 | 
| 授權已更新 - 製造商 | 買方對產品的權利已變更。 | 系統會使用 GetEntitlements API 檢查客戶權利，並據此佈建 服務。 | 僅限製造商 | 
| 已取消佈建授權 - 製造商 | 買方對產品的權利已結束。 | 對於以用量為基礎的產品，此事件會標記 1 小時最終報告時段的開始。賣方應使用 BatchMeterUsage API 收集和報告任何未報告的用量。此時段關閉後，客戶權利會完全撤銷，而且不再接受用量報告。 | 僅限製造商 | 

**注意**  
製造商和提案者的購買協議事件類型幾乎相同，但存在 resaleAuthorization ID 除外。為了避免多餘的訊息，當您同時是製造商和提案者時，只會傳送提案者購買協議事件。

如需事件類型及其詳細結構描述的完整清單，請參閱《 賣方指南[Amazon EventBridge 事件](notifications-eventbridge.md)》中的 。

## 以用量為基礎的產品的最終用量報告時段
<a name="saas-eventbridge-final-usage"></a>

對於具有用量型帳單元件的產品， AWS Marketplace 為賣方提供一小時的時間，為權利已結束的客戶提交最終用量記錄。在此期間之後，`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)。