本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 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 會在協議到期時傳送購買協議結束事件,並標記最終報告時段的開始。賣方有一小時的時間可收集客戶任何未報告的用量,並使用
BatchMeterUsageAPI 進行報告。 -
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 事件匯流排規則。