本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon EventBridge 事件
身為賣方，您可以使用 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) |
## 新優惠的事件
當賣方建立優惠並可供購買時，他們可以接收具有下列詳細資訊類型的事件：`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",
}
},
...
]
}
}
```
## 變更集的事件
當變更集完成時，賣方、通路合作夥伴和私有市場管理員可以接收事件。當變更集完成且狀態為成功、失敗或取消時， 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"
}
}
```
## 安全性摘要報告的事件
當在賣方的產品上偵測到安全漏洞時，他們可以收到摘要報告事件，並定期提醒未解決的產品問題。這些事件的來源為 `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"
}
}
```
## 支出的事件
當賣方銀行帳戶的支出因銀行帳戶詳細資訊無效而失敗時， 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":"",
"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 *
## 協議的事件
當協議事件發生時，賣方可以接收購買協議生命週期變更的通知。
如需建立 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": "",
"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": "",
"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": "",
"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": "",
"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": "",
"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": "",
"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"
}
}
}
```
## 授權的事件
當授權事件發生時，賣方可以接收客戶權利變更的通知。
如需建立 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": "",
"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": "",
"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"
}
}
}
```
## 取消的事件
當取消請求狀態變更時，賣方、買方和 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"
}
}
}
```
## 帳單調整的事件
當帳單調整狀態變更時，賣方、買方和 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"
}
}
}
```