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

# 使用 Amazon EventBridge 管理容器協議事件
<a name="container-eventbridge-integration"></a>

您可以使用 Amazon EventBridge 來接收容器產品的客戶協議變更通知 AWS Marketplace。系統會傳送事件以進行協議生命週期變更，因此您可以追蹤客戶訂閱、修改或取消的時間。這些事件提供兩個主要角色：
+ **製造商** – 管道合作夥伴轉售 (CPPO) 安排中的原始產品製造商 (ISV)。
+ **提案者** – 直接向買方提供優惠的一方。這是直接優惠的 ISV，或 CPPO 優惠的管道合作夥伴。

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


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

## 容器產品的 EventBridge 事件
<a name="container-eventbridge-event-types"></a>

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


| 事件名稱 | 由 啟動 | 回應 | 收件人 | 
| --- | --- | --- | --- | 
| 採購協議已建立 - 製造商/採購協議已建立 - 提案者 | 建立新協議、取代現有協議或續約現有協議。 | 會記錄購買協議並採取售後動作。使用 DescribeAgreement API 擷取完整的協議詳細資訊。 | 製造商和提案者 | 
| 購買協議已修訂 - 製造商/購買協議已修訂 - 提案者 | 現有協議已修訂。 | 購買協議記錄已更新。 | 製造商和提案者 | 
| 購買協議已結束 - 製造商/購買協議已結束 - 提案者 | 協議已過期、已取消或終止。 | 會記錄購買協議關閉。 | 製造商和提案者 | 
| 授權已更新 - 製造商 | 已佈建或更新客戶的產品授權。 | 更新內部記錄以反映客戶的目前授權狀態。 | 僅限製造商 | 
| 已取消佈建授權 - 製造商 | 客戶的產品授權正在撤銷。 | 更新內部記錄，以反映客戶不再擁有作用中的授權。 | 僅限製造商 | 

**注意**  
授權事件只會針對具有相關聯授權的容器協議傳送。  
AWS 會自動處理容器產品的計量 – 您不需要採取任何動作來回應這些事件，以滿足客戶權利。使用授權事件，將您的內部記錄保持為客戶的作用中授權狀態。

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

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

## 將 EventBridge 與您的容器產品整合
<a name="container-eventbridge-using"></a>

使用 EventBridge 追蹤容器清單的協議生命週期事件 AWS Marketplace。
+ **事件規則**定義如何對事件做出反應。
+ **事件模式**是在事件規則中定義，可讓您篩選傳送到預設事件匯流排的特定事件類型。EventBridge 主控台提供每種事件類型的模式範本。在事件模式組態步驟中，選取 AWS 服務做為事件來源，選取 AWS Marketplace 協議，選取 授權做為 AWS 服務。
+ 所有 AWS Marketplace 協議和授權事件類型都使用下列結構：

  ```
  {
    "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"],
    "source": ["aws.agreement-marketplace"]
  }
  ```
+ **目標**是指當事件符合規則定義的事件模式時，接收事件的資源。許多 AWS 服務與 EventBridge 整合 AWS Step Functions，可做為目標，包括 AWS Lambda 函數和 Amazon API Gateway。

如需設定 EventBridge 規則的詳細資訊，請參閱[入門：建立 Amazon EventBridge 事件匯流排規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)。