使用 Amazon EventBridge 管理 SaaS 訂閱事件 - AWS Marketplace

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

使用 Amazon EventBridge 管理 SaaS 訂閱事件

您可以使用 Amazon EventBridge 來整合和管理 SaaS 產品 AWS Marketplace。系統會傳送事件,以變更您產品的客戶訂閱和合約權利。當客戶訂閱、權利變更以及取消時,您會收到通知,讓您確切知道何時授予或撤銷存取權。這些事件提供兩個主要角色:

  • 製造商 – 這是 中清單的原始產品製造商 AWS Marketplace,也稱為獨立解決方案廠商 (ISV)。

  • 提案者 – 這是中所列產品的購買協議的原始提案者 AWS Marketplace。這可以是 ISV 或經授權可轉售產品的通路合作夥伴。

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

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

SaaS 產品的 EventBridge 事件

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

事件名稱 由 啟動 回應 收件人
  • 已建立購買協議 - 製造商

  • 已建立購買協議 - 提案者

建立新協議、取代現有協議或續約現有協議。 會記錄購買協議並採取售後動作。 DescribeAgreementAPI 用於判斷新協議是否為免費試用。 製造商和提案者
  • 購買協議已修訂 - 製造商

  • 購買協議已修訂 - 提案者

現有協議已修訂。 已修改購買協議記錄。 製造商和提案者
  • 購買協議已結束 - 製造商

  • 購買協議已結束 - 提案者

協議已過期、已取消、已終止。 會記錄購買協議關閉,並發生協議後取消動作。ISV 開始撤銷客戶權利。對於以用量為基礎的產品,ISV 會在傳送授權取消佈建事件並關閉報告視窗之前報告最終用量記錄。 製造商和提案者
授權已更新 - 製造商 買方對產品的權利已變更。 系統會使用 GetEntitlements API 檢查客戶權利,並據此佈建 服務。 僅限製造商
已取消佈建授權 - 製造商 買方對產品的權利已結束。 客戶權利已完全撤銷。 僅限製造商
注意

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

如需如何回應這些通知的資訊,請參閱下列主題:

如需事件類型及其詳細結構描述的完整清單,請參閱《 賣方指南Amazon EventBridge 事件》中的 。

在取消佈建授權之前報告最終用量

對於具有用量型帳單元件的產品, AWS Marketplace 為賣方提供一小時的時間,以提交其協議已結束之客戶的最終用量記錄。在此期間之後,BatchMeterUsageAPI 會拒絕報告的用量,而且您無法向客戶收費。下列事件定義該視窗的開始和結束:

  • AWS Marketplace 會在協議到期時傳送購買協議結束事件,並標記最終報告時段的開始。賣方有一小時的時間可收集客戶任何未報告的用量,並使用 BatchMeterUsage API 進行報告。

  • AWS Marketplace 會在完全撤銷客戶的權利且不再接受用量報告時,傳送授權取消佈建的事件。

將 EventBridge 與您的 SaaS 產品整合

使用 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 事件匯流排規則