

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

# AWS Marketplace 事件的賣方通知
<a name="notifications"></a>

您可以接收與 AWS Marketplace 產品相關的重要事件通知，例如訂閱變更、私有優惠接受和專業服務請求。Amazon EventBridge 是建議用於程式設計整合的方法，同時也提供電子郵件通知。SNS 主題仍可用於現有的整合，但正由 Amazon EventBridge 取代。本主題提供可用通知和事件選項的概觀。
+ **EventBridge** – 您可以使用 EventBridge 接收 中發生之動作的事件， AWS Marketplace例如，建立優惠時。事件包含 ID、過期日期和產品詳細資訊等資訊。如需詳細資訊，請參閱 [Amazon EventBridge 事件](notifications-eventbridge.md) 和《[https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)》。如需 SaaS 產品的詳細資訊，請參閱 [使用 Amazon EventBridge 管理 SaaS 訂閱事件](saas-eventbridge-integration.md)。
+ **電子郵件通知** – 在 中 AWS Marketplace ，賣方、買方和獨立軟體廠商 (ISVs) 可以接收電子郵件通知。 AWS Marketplace 使用您的根帳戶即時將自動電子郵件傳送到您 AWS 帳戶的電子郵件，讓您了解 AWS Marketplace 優惠和協議。您也可以為通知新增自訂電子郵件別名，並取消訂閱電子郵件通知。如需詳細資訊，請參閱[管理 AWS Marketplace 事件的電子郵件通知](email-notifications.md)。
+ **Amazon SNS 主題** – 若要接收有關產品客戶訂閱變更的通知，您可以訂閱產品建立期間 AWS Marketplace 提供給您的 Amazon SNS 主題。例如，您可以知道客戶何時接受私有優惠。如需詳細資訊，請參閱您產品類型的 Amazon SNS 主題：
**重要**  
正在以 Amazon EventBridge 通知取代 AWS Marketplace SaaS 產品的 SNS 通知。如果您有與 SNS 整合的現有 SaaS 產品，它們將繼續運作。新的清單最終將轉換為使用 Amazon EventBridge 而非 SNS。如需詳細資訊，請參閱[使用 Amazon EventBridge 管理 SaaS 訂閱事件](saas-eventbridge-integration.md)。
  + [軟體即服務 (SaaS) 產品](https://docs.aws.amazon.com/marketplace/latest/userguide/saas-notification.html)
  + [Amazon Machine Image (AMI) 產品](https://docs.aws.amazon.com/marketplace/latest/userguide/ami-notification.html)
  + [容器產品](https://docs.aws.amazon.com/marketplace/latest/userguide/container-notification.html)

下列主題提供 中通知和事件的詳細資訊 AWS Marketplace。

**Topics**
+ [管理 AWS Marketplace 事件的電子郵件通知](email-notifications.md)
+ [Amazon EventBridge 事件](notifications-eventbridge.md)

# 管理 AWS Marketplace 事件的電子郵件通知
<a name="email-notifications"></a>

AWS Marketplace 會傳送電子郵件通知優惠、協議、訂閱、產品、安全性、帳單和付款，以及 Private Marketplace 的更新。獨立軟體廠商 ISVs)、 AWS Marketplace 頻道合作夥伴和客戶可以接收電子郵件通知。如需針對優惠和協議更新傳送的電子郵件通知範例和詳細資訊，請參閱 [支援的電子郵件通知](#event-types)。

AWS Marketplace 會將電子郵件通知傳送至與您 AWS 帳戶[根使用者](https://docs.aws.amazon.com/accounts/latest/reference/root-user.html)相關聯的電子郵件地址。若要更新與 AWS 您的帳戶相關聯的電子郵件地址，請參閱[更新 AWS 您帳戶的主要聯絡人](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html)。您也可以為通知[新增自訂電子郵件別名](#adding-updating-email-addresses)，並[取消訂閱](#unsubscribe-notifications)電子郵件通知。

**注意**  
如果您遺失 AWS Marketplace 電子郵件，請檢查您的垃圾郵件資料夾或調整電子郵件設定。來自 的電子郵件通知 AWS Marketplace 會從 傳送`no-reply@marketplace.aws`。Google 和 Yahoo 等供應商可能會篩選這些項目。如需說明，請參閱[防止有效的電子郵件前往 Yahoo Mail 中的垃圾郵件 (Google)](https://support.google.com/mail/answer/1366858?sjid=4026678185875351798-NA#unmark_spam) [或封鎖和解除封鎖電子郵件地址](https://help.yahoo.com/kb/SLN28140.html)。

**Topics**
+ [支援的電子郵件通知](#event-types)
+ [欄位描述](#email-notification-field-descriptions)
+ [管理通知](#manage-notifications)

## 支援的電子郵件通知
<a name="event-types"></a>

除了機器學習產品之外，所有產品和定價類型都支援以下電子郵件通知。

**Topics**
+ [優惠和優惠集](#email-details-offers)
+ [協議](#email-details-agreements)
+ [可變付款](#email-details-variable-payments)
+ [支出](#email-details-disbursements)
+ [新增銀行帳戶詳細資訊](#add-bank-account-details)
+ [取消和帳單調整](#email-details-cancellations-adjustments)

### 優惠和優惠集
<a name="email-details-offers"></a>

下表顯示 優惠和優惠集的事件。優惠是買方使用產品的一組條款。如需詳細資訊，請參閱 [為您的 AWS Marketplace 產品準備私有優惠](private-offers-overview.md)。優惠集可讓您將多個私有優惠合併為一鍵式購買體驗。如需詳細資訊，請參閱 [準備您的多產品解決方案](multi-product-solutions.md)。

**注意**  
當 AWS Marketplace 頻道合作夥伴建立包含 ISV 產品 (SSV) 的優惠集時，將不會通知該 ISV。


| Email | 事件 | 收件人 | Title | 欄位 | 
| --- | --- | --- | --- | --- | 
|  提供已發佈的 CP 通知 CPPO  |   AWS Marketplace 頻道合作夥伴私有優惠的發佈。  |  頻道合作夥伴  |  AWS Marketplace 發佈的頻道合作夥伴私有優惠  |  客戶 AWS 帳戶 ID、ISV 名稱、ISV AWS 帳戶 ID、產品名稱、產品 ID、優惠 ID、機會 ID、優惠發佈日期、優惠過期日期  | 
|  提供發佈的 ISV 通知 CPPO  |   AWS Marketplace 頻道合作夥伴私有優惠的發佈。  |  獨立軟體開發商  |  AWS Marketplace 發佈的頻道合作夥伴私有優惠  |  客戶 AWS 帳戶 IDs、通路合作夥伴、通路合作夥伴 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、機會 ID、優惠發佈日期、優惠過期日期、批發價格  | 
|  OfferPubISVNotificationSCPO-1.0  |  賣方發佈 AWS Marketplace 頻道合作夥伴私有優惠。  |  ISV 或 AWS Marketplace 頻道合作夥伴  |  已發佈的私有優惠  |  客戶 AWS 帳戶 IDs、產品名稱、產品 ID、優惠名稱、優惠 ID、優惠發佈日期、優惠過期日期、合約總價值  | 
|  經銷商機會已過期  |  AWS Marketplace 通路合作夥伴銷售授權過期。  |  AWS Marketplace 頻道合作夥伴  |  優惠：檢視過期的銷售授權  |  ISV、產品名稱、產品 ID  | 
|  已撤銷經銷商機會  |  ISV 撤銷 AWS Marketplace 通路合作夥伴銷售授權。  |  AWS Marketplace 頻道合作夥伴  |  優惠：檢視已停用的銷售授權  |  ISV、產品名稱、產品 ID  | 
|  已建立經銷商機會  |  ISV 會為 AWS Marketplace 通路合作夥伴建立銷售授權或機會。  |  AWS Marketplace 頻道合作夥伴  |  優惠：為新的銷售授權建立私有優惠  |  ISV、產品名稱、產品 ID、銷售授權持續時間  | 
|  已發佈優惠集  |  賣方發佈優惠集。  |  ISV 或 AWS Marketplace 頻道合作夥伴  |  已發佈優惠集  |  優惠集 ID、優惠集名稱、優惠 ID (s)、優惠名稱 (s)  | 

### 協議
<a name="email-details-agreements"></a>

當買方接受公開優惠、私有優惠或 AWS Marketplace 通路合作夥伴私有優惠時，ISVs 和 AWS Marketplace 通路合作夥伴會收到電子郵件通知。接受優惠時會建立協議。也會針對協議生命週期事件傳送電子郵件通知。這些包括買方接受後的協議開始、取消、取代和失敗。下表顯示針對協議事件傳送的電子郵件。電子郵件通知目前適用於特定產品類型。您的特定產品類型可能還沒有此功能。


| Email | 事件 | 收件人 | Title | 欄位 | 
| --- | --- | --- | --- | --- | 
|  已接受優惠 – 私有或公有優惠  |  AWS Marketplace 客戶接受公有或私有優惠。  |  獨立軟體開發商  |  客戶接受了 AWS Marketplace 優惠。  |  客戶公司名稱、客戶 AWS 帳戶 ID、產品名稱、產品 ID、協議 ID、協議開始日期、協議結束日期、協議接受日期、購買金額  | 
|  已接受優惠 – AWS Marketplace 通路合作夥伴私有優惠。  |  AWS Marketplace 客戶接受 AWS Marketplace 頻道合作夥伴私有優惠。  |  獨立軟體開發商  |  客戶接受 AWS Marketplace 了頻道合作夥伴私有優惠。  |  客戶公司名稱、客戶 AWS 帳戶 ID、通路合作夥伴名稱、通路合作夥伴 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期、協議接受日期、批發價格  | 
|  已接受優惠 – AWS Marketplace 通路合作夥伴私有優惠。  |  AWS Marketplace 客戶接受 AWS Marketplace 頻道合作夥伴私有優惠。  |  AWS Marketplace 頻道合作夥伴  |  客戶接受 AWS Marketplace 了頻道合作夥伴私有優惠。  |  客戶公司名稱、客戶 AWS 帳戶 ID、ISV 名稱、ISV AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期、協議接受日期、批發價格、利潤、購買金額  | 
|  協議已開始 – 私有優惠  |  合約或訂閱產品的 AWS Marketplace 協議已從未來開始日期的私有優惠開始。  |  獨立軟體開發商  |   AWS Marketplace 協議已開始  |  客戶 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期、購買金額  | 
|  協議已開始 – AWS Marketplace 通路合作夥伴私有優惠  |  合約或訂閱產品的 AWS Marketplace 協議已從 AWS Marketplace 通路合作夥伴私有優惠開始。  |  獨立軟體開發商  |   AWS Marketplace 協議已開始。  |  客戶 AWS 帳戶 ID、通路合作夥伴名稱、通路合作夥伴 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期、批發價格  | 
|  協議已開始 – 私有優惠  |  接受 AWS Marketplace 通路合作夥伴私有優惠會啟動合約或訂閱產品的協議。  |  AWS Marketplace 頻道合作夥伴  |   AWS Marketplace 協議已開始。  |  客戶 AWS 帳戶 ID、ISV 名稱、ISV AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期、利潤、購買金額  | 
|  協議已取消 – 私有或公有優惠  |  取消私有或公開優惠協議。  |  獨立軟體開發商  |   AWS Marketplace 協議已取消。  |  客戶 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期  | 
|  協議已取消 – AWS Marketplace 通路合作夥伴私有優惠  |  取消 AWS Marketplace 頻道合作夥伴私有優惠協議。  |  獨立軟體開發商  |   AWS Marketplace 協議已取消。  |  客戶 AWS 帳戶 ID、通路合作夥伴、通路合作夥伴 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期  | 
|  協議已取消 – 管道合作夥伴私有優惠  |  取消 AWS Marketplace 頻道合作夥伴私有優惠協議。  |  AWS Marketplace 頻道合作夥伴  |   AWS Marketplace 協議已取消。  |  客戶 AWS 帳戶 ID、ISV、ISV AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID、協議開始日期、協議結束日期  | 
|  合規失敗 – 記錄賣方  |   AWS Marketplace 協議因客戶付款失敗而失敗。  |  建立優惠的 ISV 或 AWS Marketplace 頻道合作夥伴  |  必要動作： AWS Marketplace 協議建立失敗  |  訂閱 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID  | 
|  付款失敗 – 記錄賣方  |   AWS Marketplace 協議因客戶付款失敗而失敗。  |  建立優惠的 ISV 或 AWS Marketplace 頻道合作夥伴  |   AWS Marketplace 協議的付款失敗  |  客戶 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、協議 ID  | 
|  已取代協議 – 私有優惠  |   AWS Marketplace 協議會由另一個協議取代。  |  獨立軟體開發商  |  已取代 AWS Marketplace 協議  |  公司名稱、客戶 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、新協議 ID、協議開始日期、協議結束日期、新購買金額  | 
|  已取代協議 – 管道合作夥伴私有優惠  |   AWS Marketplace 協議會由另一個協議取代。  |  獨立軟體開發商  |  已取代 AWS Marketplace 協議  |  公司名稱、客戶 AWS 帳戶 ID、通路合作夥伴、通路合作夥伴 AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、新協議 ID、協議開始日期、協議結束日期、批發價格  | 
|  已取代協議 – 管道合作夥伴私有優惠  |   AWS Marketplace 協議會由另一個協議取代。  |  AWS Marketplace 頻道合作夥伴  |  已取代 AWS Marketplace 協議  |  公司名稱、客戶 AWS 帳戶 ID、ISV 名稱、ISV AWS 帳戶 ID、產品名稱、產品 ID、優惠名稱、優惠 ID、新協議 ID、協議開始日期、協議結束日期、批發價格、利潤、新購買金額  | 

### 可變付款
<a name="email-details-variable-payments"></a>

賣方和買方將會收到與在專業服務私有優惠上使用可變付款相關的電子郵件通知。如需變數付款的詳細資訊，請參閱 [在 中為專業服務產品定價 AWS Marketplace](proserv-variable-payments.md)。


| Email | 事件 | 收件人 | Title | 欄位 | 
| --- | --- | --- | --- | --- | 
|  付款請求 - 已核准  | 付款核准 | 賣方 | AWS Marketplace 付款請求已核准 |  客戶 AWS 帳戶 ID、付款請求接受日期、優惠 ID、協議 ID、付款請求 ID、付款請求金額、付款請求貨幣代碼  | 
|  付款請求 - 已拒絕  | 拒絕付款 | 賣方 | AWS Marketplace 付款請求遭拒 | 客戶 AWS 帳戶 ID、付款請求拒絕日期、優惠 ID、協議 ID、付款請求 ID、付款請求金額、付款請求貨幣代碼  | 
|  付款請求 - 自動核准  | 自動核准：建立付款 \$1 提醒 （建立付款請求後 1、3、7、9 天傳送的電子郵件） | 買方 | 您收到 AWS Marketplace 付款請求 | 自動核准日期、優惠 ID、協議 ID、付款請求 ID、付款請求建立日期、付款請求金額、付款請求貨幣代碼  | 
|  付款請求 - 手動核准  | 手動核准：建立付款 \$1 提醒 （每 7 天傳送一次電子郵件，直到合約日期） | 買方 | 您收到 AWS Marketplace 付款請求 | 優惠 ID、協議 ID、付款請求 ID、付款請求建立日期、付款請求金額、付款請求貨幣代碼  | 
|  付款請求 - 已取消  | 付款已取消 | 買方 | 您的 AWS Marketplace 付款請求已由賣方取消 | 優惠 ID、協議 ID、付款請求取消日期、付款請求 ID、付款請求金額、付款請求貨幣代碼  | 

### 支出
<a name="email-details-disbursements"></a>

如果 ISVs和頻道合作夥伴的支出因銀行帳戶詳細資訊無效而暫停，則會收到電子郵件通知。


| Email | 事件 | 收件人 | Title | 欄位 | 
| --- | --- | --- | --- | --- | 
|  已暫停支出 – 銀行帳戶資訊無效  | AWS Marketplace 由於銀行帳戶詳細資訊無效， 會暫停向賣方支付款項。 | ISV 和 AWS Marketplace 頻道合作夥伴 | 已暫停支出 | 資源 ARN | 

`Resource ARN` 欄位會顯示無效的銀行帳戶 Amazon Resource Number (ARN)。您可以在 AWS Marketplace 管理入口網站 (AMMP) 中[新增銀行帳戶](#add-bank-account-details)，以修正此問題。

### 新增銀行帳戶詳細資訊
<a name="add-bank-account-details"></a>

在 AWS Marketplace 管理入口網站 (AMMP) 中新增銀行帳戶詳細資訊，以修正付款中的無效銀行帳戶 ARN 錯誤。

`Resource ARN` 欄位會顯示無效銀行帳戶的 ARN。若要修正此問題，請在 AWS Marketplace 管理入口網站中新增銀行帳戶。下列步驟說明作法。<a name="resolve-invalid-bank-account-details"></a>

**新增銀行帳戶詳細資訊**

1. [AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/) 使用您的 AWS Marketplace 賣方帳戶登入 。

1. 在選單列上，選擇**設定**。

1. 選擇**付款資訊**索引標籤。

1. 在**銀行帳戶**區段中，選擇**新增銀行帳戶**。

1. 新增銀行帳戶詳細資訊並檢閱其準確性。如需詳細資訊，請參閱本指南[步驟 3：提供銀行帳戶資訊](provide-bank-information.md)稍早的 。

1. 若要從買方接收付款，請在**付款方法**下，選擇**新增付款方法**。

1. 如果系統提示您驗證了解您的客戶 (KYC) 和銀行帳戶，請遵循驗證步驟。

1. 儲存您的變更。

### 取消和帳單調整
<a name="email-details-cancellations-adjustments"></a>

賣方、買方和 ISVs （適用於 CPPO) 會收到合約取消和帳單調整事件的電子郵件通知。下表顯示針對取消和帳單調整事件傳送的電子郵件。

**取消請求電子郵件**


| 事件 | 收件人 | Title | 欄位 | 
| --- | --- | --- | --- | 
| 已提交取消請求 | 賣方、買方、製造商 (CPPO) | 您已提交協議取消請求 | 買方帳戶 ID、協議 ID、產品 ID、優惠 ID、請求 ID、請求日期、請求過期日期、取消原因、其他詳細資訊、回應表單 URL | 
| 核准取消請求 （由買方或自動核准） | 賣方、買方、製造商 (CPPO) | 協議取消請求已核准 | 協議 ID、產品 ID、優惠 ID、請求 ID、請求日期、取消原因、取消日期 | 
| 取消請求遭拒 | 賣方、買方、製造商 (CPPO) | 協議取消請求遭拒 | 協議 ID、產品 ID、優惠 ID、請求 ID、請求日期、取消原因、拒絕原因、拒絕日期 | 
| 取消請求已撤銷 | 賣方、買方、製造商 (CPPO) | 撤銷協議取消請求 | 協議 ID、產品 ID、優惠 ID、請求 ID、請求日期、撤銷原因 | 
| 取消請求驗證失敗 | 僅限賣方 | 協議取消請求失敗 | 協議 ID、產品 ID、請求 ID、請求日期、取消原因 | 

**帳單調整電子郵件**


| 事件 | 收件人 | Title | 欄位 | 
| --- | --- | --- | --- | 
| 帳單調整已處理 | 賣方、買方、製造商 (CPPO) | 帳單調整已處理 | 協議 ID、產品 ID、優惠 ID、請求 ID、發票 ID、含貨幣代碼的退款金額、請求日期、帳單調整原因 | 
| 帳單調整失敗 | 僅限賣方 | 帳單調整請求失敗 | 協議 ID、產品 ID、請求 ID、發票 ID、請求日期、帳單調整原因 | 

**注意**  
對於 CPPO 協議，ISV （製造商） 會在頻道合作夥伴提交或完成取消和帳單調整請求時收到通知。不過，為了保護頻道合作夥伴利潤資訊，提供給買方的退款金額和訊息**不會**包含在 ISV 通知中。

## 欄位描述
<a name="email-notification-field-descriptions"></a>

下表顯示 [優惠和優惠集](#email-details-offers)和 [協議](#email-details-agreements)資料表中參考的欄位說明。


| 欄位 | Description | 
| --- | --- | 
|  客戶公司名稱  |  訂閱者公司名稱。  | 
|  客戶 AWS 帳戶 ID  |  訂閱產品的 AWS 帳戶 ID。  | 
|  ISV 名稱  |  賣方公司名稱。  | 
|  ISV AWS 帳戶 ID  |  賣方 AWS 帳戶的 ID。  | 
|  產品名稱  |  產品的標題。  | 
|  產品 ID  |  軟體產品的易記唯一識別符。  | 
|  優惠名稱  |  優惠的標題。  | 
|  優惠 ID  |  買方簽署之優惠的識別符。  | 
|  提供可見性  |  優惠是公有、私有或企業合約優惠。  | 
|  協議 ID  |  提案者與接受者之間簽署的協議的唯一協議資料饋送參考，以開始使用產品。  | 
|  協議開始日期  |  客戶產品訂閱的開始日期，格式為 `MM-DD-YYYY`。此日期可以與未來日期協議的接受日期不同。  | 
|  協議接受日期  |  客戶訂閱產品的日期，格式為 `MM-DD-YYYY`。  | 
|  協議結束日期  |  合約到期的日期，格式為 `MM-DD-YYYY`。對於計量或pay-as-you-go訂閱，此日期設定為 `JAN-1-9999`。  | 
|  協議結束日期  |  合約到期的日期，格式為 `MM-DD-YYYY`。對於計量或pay-as-you-go訂閱，此日期設定為 `JAN-1-9999`。  | 
|  購買金額  |  協議的預估成本，也稱為合約總價值。這適用於 SaaS、專業服務和伺服器產品類型，以及合約或年度定價類型。  | 
|  通路合作夥伴公司名稱  |  以批發成本從 ISV 購買產品或服務以向客戶轉售的帳戶名稱。  | 
|  頻道合作夥伴 AWS 帳戶 ID  |  從 ISV 購買產品或服務以向客戶轉售的 AWS Marketplace 通路合作夥伴 AWS 帳戶 ID。  | 
|  批發價格  |  ISV 將產品轉售給 AWS Marketplace 通路合作夥伴的批發成本。  | 
|  貨幣代碼  |  與協議估計成本相關聯的優惠定價貨幣。  | 
|  新協議 ID  |  續約或升級協議的協議 ID。  | 
|  優惠發佈日期  |  賣方發佈優惠的日期。  | 
|  優惠過期日期  |  優惠過期的日期。  | 
|  機會 ID  |  已註冊機會的唯一識別符。  | 
|  銷售授權持續時間  |  經銷商獲授權使用折扣建立優惠的時間長度，如銷售授權中所指定。  | 

## 管理通知
<a name="manage-notifications"></a>

下列主題說明如何管理 事件的電子郵件通知。

### 新增或更新電子郵件地址
<a name="adding-updating-email-addresses"></a>

您可以使用 為自訂電子郵件通知新增最多 10 個電子郵件地址 AWS Marketplace 管理入口網站。

**新增或更新電子郵件地址**

1. 登入[AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/)。

1. 在**設定**中，選擇**通知**索引標籤。

1. 在**自訂通知的電子郵件**下，選擇**新增電子郵件地址**。

1. 如需**收件人詳細資訊，**請在電子郵件地址欄位中輸入自訂**電子郵件地址**。

1. （選用） 選擇**新增收件人**以新增另一個電子郵件地址 （最多共 10 個）。

1. 選擇**提交**。

### 從通知取消訂閱收件人
<a name="unsubscribe-notifications"></a>

您可以移除電子郵件地址，讓收件人取消訂閱自訂電子郵件通知。

**讓收件人取消訂閱事件通知**

1. 登入[AWS Marketplace 管理入口網站](https://aws.amazon.com/marketplace/management/)。

1. 從**設定**選擇**通知**索引標籤。

1. 在**自訂通知的電子郵件**下，選擇**更新電子郵件地址**。

1. 如需**收件人詳細資訊**，請選擇**移除**以移除電子郵件地址。

1. 選擇**提交**。
**注意**  
您也可以使用電子郵件中的連結取消訂閱。

# Amazon EventBridge 事件
<a name="notifications-eventbridge"></a>

身為賣方，您可以使用 Amazon EventBridge 接收其中事件的通知 AWS Marketplace。例如，您可以在建立優惠 AWS Marketplace 時收到來自 *的事件*。*事件*包含 ID、過期日期和產品詳細資訊等詳細資訊。EventBridge 是一種事件匯流排服務，可用來將應用程式與來自各種來源的資料連線。如需詳細資訊，請參閱[https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)。下列各節提供 EventBridge 主控台中 Marketplace Catalog 服務下事件的詳細資訊。

**Topics**
+ [新優惠的事件](#events-offerreleased)
+ [變更集的事件](#events-changesets)
+ [安全性摘要報告的事件](#events-security-report)
+ [支出的事件](#events-for-disbursements)
+ [協議的事件](#events-for-agreements)
+ [授權的事件](#events-for-licenses)
+ [取消的事件](#events-for-cancellations)
+ [帳單調整的事件](#events-for-billing-adjustments)

本主題 


| 賣方的動作 | 已接收的事件 | 相關主題 | 
| --- | --- | --- | 
| 獨立軟體廠商 (ISV) 會建立優惠並使其可供購買 | Offer Released | [新優惠的事件](#events-offerreleased) | 
| 頻道合作夥伴使用 ISV 的產品來建立優惠 | Offer Released | [新優惠的事件](#events-offerreleased) | 
| 管道合作夥伴建立優惠 | Offer Released | [新優惠的事件](#events-offerreleased) | 
| ISV 建立新的優惠集 | OfferSet Released | [新優惠的事件](#events-offerreleased) | 
| 管道合作夥伴建立新的優惠集 | OfferSet Released | [新優惠的事件](#events-offerreleased) | 
| 變更集成功 | Change Set Succeeded | [變更集的事件](#events-changesets) | 
| 變更集失敗 | Change Set Failed | [變更集的事件](#events-changesets) | 
| 變更集已取消 | Change Set Cancelled | [變更集的事件](#events-changesets) | 
| ISV 產品偵測到安全漏洞 | Products Security Report Created | [安全性摘要報告的事件](#events-security-report) | 
| 客戶訂閱 SaaS 產品 | Purchase Agreement Created | [協議的事件](#events-for-agreements) | 
| 客戶的 SaaS 協議已修訂 | Purchase Agreement Amended | [協議的事件](#events-for-agreements) | 
| 客戶取消 SaaS 訂閱 | Purchase Agreement Ended | [協議的事件](#events-for-agreements) | 
| 客戶的 SaaS 權利變更 | License Updated | [授權的事件](#events-for-licenses) | 
| 客戶的 SaaS 權利已撤銷 | License Deprovisioned | [授權的事件](#events-for-licenses) | 
| 賣方提交取消請求 | Agreement Cancellation Request Pending Approval - Proposer | [取消的事件](#events-for-cancellations) | 
| 取消請求已核准或自動核准 | Agreement Cancellation Request Approved - Proposer | [取消的事件](#events-for-cancellations) | 
| 買方拒絕取消請求 | Agreement Cancellation Request Rejected - Proposer | [取消的事件](#events-for-cancellations) | 
| 賣方撤銷取消請求 | Agreement Cancellation Request Cancelled - Proposer | [取消的事件](#events-for-cancellations) | 
| 取消請求驗證失敗 | Agreement Cancellation Request Validation Failed - Proposer | [取消的事件](#events-for-cancellations) | 
| 帳單調整已處理 | Purchase Agreement Billing Adjustment Completed - Proposer | [帳單調整的事件](#events-for-billing-adjustments) | 
| 帳單調整驗證失敗 | Purchase Agreement Billing Adjustment Failed - Proposer | [帳單調整的事件](#events-for-billing-adjustments) | 

## 新優惠的事件
<a name="events-offerreleased"></a>

當賣方建立優惠並可供購買時，他們可以接收具有下列詳細資訊類型的事件：`Offer Released`。

**注意**  
如需建立 EventBridge 規則的資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)*》中的 Amazon EventBridge *規則。

以下是 ISV 所建立新優惠的範例事件內文。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:123456789012:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "123456789012",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": [
      "999988887777",
      "111122223333"
    ]
  }
}
```

以下是頻道合作夥伴使用 ISV 的產品來建立優惠時的範例事件內文。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "987654321098",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": ["999988887777", "111122223333"],
    }
  }
}
```

以下是頻道合作夥伴建立優惠時的範例事件內文。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Offer Released",
  "source": "aws.marketplacecatalog",
  "account": "987654321098",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/Offer/offer-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offer": {
      "id": "offer-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
      "name": "Offer Name",
      "expirationDate": "2025-08-26T00:00:00Z"
    },
    "product": {
      "id": "bbbbaaaa-abcd-1111-abcd-666666666666",
      "arn": "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/SaaSProduct/bbbbaaaa-abcd-1111-abcd-666666666666",
      "title": "Product Title"
    },
    "manufacturer": {
      "accountId": "123456789012",
      "name": "Manufacturer Account Name"
    },
    "sellerOfRecord": {
      "accountId": "987654321098",
      "name": "Seller Account Name"
    },
    "targetedBuyerAccountIds": ["999988887777", "111122223333"],
    }
  }
}
```

以下是合作夥伴 (ISV 或頻道合作夥伴） 發佈的新優惠集的事件內文範例。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "OfferSet Released",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2023-08-26T00:00:00Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:987654321098:AWSMarketplace/OfferSet/offerset-1234567890123"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "offerSet": {
      "id": "offerset-1234567890123",
      "arn": "arn:aws:catalog:us-east-1:987654321098:OfferSet/offerset-1234567890123",
      "name": "Offer Set Name",
    },
    "associatedOffers": [
      {
        "offer": {
          "id": "offer-1234567890123",
          "arn": "arn:aws:catalog:us-east-1:987654321098:Offer/offer-1234567890123",
          "name": "Offer Name",
        }
      },
      ...
    ]
  }
}
```

## 變更集的事件
<a name="events-changesets"></a>

當變更集完成時，賣方、通路合作夥伴和私有市場管理員可以接收事件。當變更集完成且狀態為成功、失敗或取消時， AWS Marketplace 目錄 API 會傳送事件。這些事件的來源為 `aws.marketplacecatalog`，可能的詳細資訊類型值為 `Change Set Succeeded`、 `Change Set Failed`和 `Change Set Cancelled`。

**注意**  
如需變更集的資訊，請參閱《*AWS Marketplace 目錄 API 參考*》中的[使用變更集](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets)。

每個事件都包含變更請求詳細資訊，例如變更集 ID、變更集名稱、事件詳細資訊類型、失敗代碼 （針對失敗的請求），以及請求的開始和結束時間。這可讓您監控變更集，而無需持續查詢`DescribeChangeSet`動作或檢查變更請求 AWS Marketplace 管理入口網站 的狀態。

**注意**  
如需建立 EventBridge 規則的資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)*》中的 Amazon EventBridge *規則。

以下是`Change Set Succeeded`詳細資訊類型的範例事件內文。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Succeeded",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z"
  }
}
```

以下是`Change Set Failed`詳細資訊類型的事件內文範例。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Failed",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z",
    "FailureCode": "CLIENT_ERROR"
  }
}
```

以下是`Change Set Cancelled`詳細資訊類型的事件內文範例。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Change Set Cancelled",
  "source": "aws.marketplacecatalog",
  "account": "123456789012",
  "time": "2022-11-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:us-east-1:123456789012:AWSMarketplace/ChangeSet/76yesvf8y165pa4f98td2crtg"
  ],
  "detail": {
    "requestId" : "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "Catalog": "AWSMarketplace",
    "ChangeSetId": "76yesvf8y165pa4f98td2crtg",
    "ChangeSetName": "Create my product",
    "StartTime": "2018-02-27T13:45:22Z",
    "EndTime": "2018-02-27T14:55:22Z"
  }
}
```

## 安全性摘要報告的事件
<a name="events-security-report"></a>

當在賣方的產品上偵測到安全漏洞時，他們可以收到摘要報告事件，並定期提醒未解決的產品問題。這些事件的來源為 `aws.marketplacecatalog`，詳細資訊類型為 `Products Security Report Created`。

每個事件都包含偵測到問題的產品和版本計數摘要、影響最新版本數量的計數，以及需要解決以避免這些產品或版本的暫時限制的日期。

**注意**  
如需建立 EventBridge 規則的資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)*》中的 Amazon EventBridge *規則。  
如需管理安全事件的詳細資訊，請參閱部落格文章[中的如何改善產品目錄的安全性 AWS Marketplace](https://aws.amazon.com/blogs/awsmarketplace/how-to-improve-security-your-product-catalog-aws-marketplace/)*AWS *。

以下是`Products Security Report Created`詳細資訊類型的範例事件內文。

```
{
  "version": "0",
   "id": "01234567-0123-0123-0123-0123456789ab",
   "detail-type": "Products Security Report Created",
   "source": "aws.marketplacecatalog",
   "account": "123456789012",
   "time": "2023-10-31T00:00:00Z",
   "region": "us-east-1",
   "resources": [],
   "detail": {
     "numberOfProductsWithIssues": 1,
     "numberOfVersionsWithIssues": 1,
     "numberOfLatestVersionsWithIssues": 1,
     "newIssuesFound": true,
     "upcomingResolutionDueDate": "2023-12-01T00:00:00Z",
     "requestId": "533fa17d-3e97-5051-bcaf-1fae45fb3f8b"
   }
  }
```

## 支出的事件
<a name="events-for-disbursements"></a>

當賣方銀行帳戶的支出因銀行帳戶詳細資訊無效而失敗時， AWS Marketplace ISVs和管道合作夥伴可能會收到事件。

在下列 JSON 事件程式碼中，這些事件`source`的值為 `aws.marketplace`，而`detail-type`值為 `Disbursement Paused`。此`resources`值顯示無效的銀行帳戶 Amazon Resource Number (ARN)。

```
{
"version": "0",
"id": "01234567-0123-0123-0123-0123456789ab", 
"detail-type": "Disbursement Paused",
"source": "aws.marketplace",
"account":"<account id of end user>",
"time": "2022-11-01T13:12:22Z",
"region": "us-east-1",
"resources": ["arn:aws:payments:us-east-1:1234567890:paymentinstrument:123"],
"detail": {
"requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
"catalog": "AWSMarketplace"
 }
}
```

若要解決無效的銀行帳戶詳細資訊問題，請在 AWS Marketplace 管理入口網站中新增您的銀行帳戶詳細資訊。如需說明，請參閱[新增銀行帳戶詳細資訊](email-notifications.md#resolve-invalid-bank-account-details)。

如需建立 Amazon EventBridge 規則的詳細資訊，請參閱《[Amazon EventBridge 使用者指南》中的 Amazon EventBridge ](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-rules.html)中的規則。 * EventBridge *

## 協議的事件
<a name="events-for-agreements"></a>

當協議事件發生時，賣方可以接收購買協議生命週期變更的通知。

如需建立 EventBridge 規則的資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)*》中的 Amazon EventBridge *規則。

以下是**已建立購買協議 - 提案者**的範例事件內文。

**注意**  
如果通路合作夥伴私有優惠 (CPPO) 將填入轉售授權 ID，如果是 Marketplace 直接優惠 (MPPO)，則此值將為 null。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Created - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's or CP's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "NEW",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

以下是**已建立購買協議 - 製造商**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Created - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "NEW",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

以下是**採購協議修訂 - 提案者**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Amended - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV or CP's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "AMEND",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

以下是**採購協議修訂 - 製造商**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Amended - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "intent": "AMEND",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

以下是**購買協議結束 - 提案者**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Ended - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "status": "CANCELLED"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

以下是**購買協議結束 - 製造商**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Ended - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV's account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs",
      "status": "CANCELLED"
    },
    "resaleAuthorization": {
      "id": "resaleauthz-yaxjqxiskysxa"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "offer-1234567890123"
    }
  }
}
```

## 授權的事件
<a name="events-for-licenses"></a>

當授權事件發生時，賣方可以接收客戶權利變更的通知。

如需建立 EventBridge 規則的資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)*》中的 Amazon EventBridge *規則。

以下是**授權更新 - 製造商**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "License Updated - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV/CP account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs"
    },
    "product": {
      "code": "aw4fgf5tyo5w2ap6fEXAMPLE",
      "id": "prod-qtwveEXAMPLE"
    },
    "license": {
      "arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "8kkr91jo647j3qxlcjhlqce7y"
    }
  }
}
```

以下是**已佈建授權 - 製造商**的範例事件內文。

```
{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "License Deprovisioned - Manufacturer",
  "source": "aws.agreement-marketplace",
  "account": "<ISV/CP account id>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-4mwg1nevbokzw95eca5797ixs"
  ],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-4mwg1nevbokzw95eca5797ixs"
    },
    "product": {
      "code": "aw4fgf5tyo5w2ap6fEXAMPLE",
      "id": "prod-qtwveEXAMPLE"
    },
    "license": {
      "arn": "aws:license-manager:us-east-1:123456789012:l-e52ca6f38bf84d0fafb8802ca15ac11x"
    },
    "acceptor": {
      "accountId": "845735284135"
    },
    "proposer": {
      "accountId": "123456512334"
    },
    "offer": {
      "id": "8kkr91jo647j3qxlcjhlqce7y"
    }
  }
}
```

## 取消的事件
<a name="events-for-cancellations"></a>

當取消請求狀態變更時，賣方、買方和 ISVs （適用於 CPPO) 會收到事件。每個事件都會以特定角色的詳細資訊類型 （賣方的提案者、買方的接受者、ISVs的製造商） 傳送給相關方。這些事件的來源為 `aws.agreement-marketplace`。

如需建立 EventBridge 規則的資訊，請參閱《[Amazon EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)*》中的 Amazon EventBridge *規則。

以下是**協議取消請求待核准 - 提案者**的範例事件內文。當您提交取消請求並等待買方核准時，會傳送此事件。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Pending Approval - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "",
      "statusCode": "PENDING_APPROVAL",
      "statusMessage": "",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-01T13:12:22Z"
    }
  }
}
```

以下是**協議取消請求已核准 - 提案者**的範例事件內文。此事件會在買方核准您的取消請求，或在 7 天後自動核准時傳送。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Approved - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:16:07Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "The terms accepted in agreement had wrong rate",
      "statusCode": "APPROVED",
      "statusMessage": "",
      "createdAt": "2025-01-03T16:16:22Z",
      "updatedAt": "2025-01-03T16:20:08Z"
    }
  }
}
```

以下是**協議取消請求遭拒 - 提案者**的範例事件內文。當買方拒絕您的取消請求時，會傳送此事件。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Rejected - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-02T10:30:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "",
      "statusCode": "REJECTED",
      "statusMessage": "We still need this product",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-02T10:30:00Z"
    }
  }
}
```

以下是**協議取消請求已取消 - 提案者**的範例事件內文。當您撤銷取消請求時，會傳送此事件。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Cancelled - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-02T08:00:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "",
      "statusCode": "CANCELLED",
      "statusMessage": "Seller withdrew the request",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-02T08:00:00Z"
    }
  }
}
```

以下是**協議取消請求驗證失敗 - 提案者**的範例事件內文。此事件只會在提交後非同步驗證失敗時傳送給賣方。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Agreement Cancellation Request Validation Failed - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:15:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid",
      "acceptorId": "123465789012",
      "productId": "prod-exampleid",
      "offerId": "offer-exampleid"
    },
    "agreementCancellationRequest": {
      "id": "acr-abcdexampleid",
      "reasonCode": "INCORRECT_TERMS_ACCEPTED",
      "reasonMessage": "The terms accepted in agreement had wrong rate",
      "statusCode": "VALIDATION_FAILED",
      "statusMessage": "Agreement has a renewal agreement that must be canceled first",
      "createdAt": "2025-01-01T13:12:22Z",
      "updatedAt": "2025-01-01T13:15:00Z"
    }
  }
}
```

## 帳單調整的事件
<a name="events-for-billing-adjustments"></a>

當帳單調整狀態變更時，賣方、買方和 ISVs （適用於 CPPO) 會收到事件。每個事件都會以特定角色的詳細資訊類型 （賣方的提案者、買方的接受者、ISVs的製造商） 傳送給相關方。這些事件的來源為 `aws.agreement-marketplace`。

以下是**採購協議帳單調整已完成 - 提案者**的範例事件內文。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Purchase Agreement Billing Adjustment Completed - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:12:22Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid"
    },
    "billingAdjustmentRequest": {
      "id": "ba-abcdexampleid",
      "adjustmentAmount": "-100.00",
      "currencyCode": "USD",
      "adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
    },
    "invoice": {
      "originalInvoiceId": "2028746221"
    }
  }
}
```

以下是**購買協議帳單調整失敗 - 提案者**的範例事件內文。只有在帳單調整失敗的非同步驗證時，才會將此事件傳送給賣方。

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-0123456789ab",
  "detail-type": "Purchase Agreement Billing Adjustment Failed - Proposer",
  "source": "aws.agreement-marketplace",
  "account": "123456789012",
  "time": "2025-01-01T13:15:00Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "requestId": "3d4c9f9b-b809-4f5e-9fac-a9ae98b05cbb",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-abcdexampleid"
    },
    "billingAdjustmentRequest": {
      "id": "ba-abcdexampleid",
      "adjustmentAmount": "-1000.00",
      "currencyCode": "USD",
      "adjustmentReasonCode": "INCORRECT_TERMS_ACCEPTED"
    },
    "invoice": {
      "originalInvoiceId": "2028746221"
    }
  }
}
```