本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 亚马逊 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 规则的信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
以下是 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",
}
},
...
]
}
}
```
## 更改集事件
变更集完成后，卖家、渠道合作伙伴和 Private Marketplace 管理员会受到一个事件。当更改集完成且状态为成功、失败或已取消时，Catalo AWS Marketplace g API 会发送一个事件。这些事件的来源是 `aws.marketplacecatalog`，可能的详细信息类型值包括 `Change Set Succeeded`、`Change Set Failed` 和 `Change Set Cancelled`。
**注意**
有关变更集的信息，请参阅《AWS Marketplace Catalog API 参考》**中的[使用变更集](https://docs.aws.amazon.com/marketplace-catalog/latest/api-reference/welcome.html#working-with-change-sets)。
每个事件都包含更改请求的详细信息，例如更改集 ID、更改集名称、事件详细信息类型、失败代码（对于失败的请求）以及请求的开始和结束时间。这使您无需持续查询`DescribeChangeSet`操作或检查变更请求状态即可监控变更集。 AWS Marketplace 管理门户
**注意**
有关创建 EventBridge 规则的信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
以下是 `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 规则的信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
有关管理安全事件的详细信息，请参阅AWS 博客**上的博客文章：[How to improve the security of your product catalog in AWS Marketplace](https://aws.amazon.com/blogs/awsmarketplace/how-to-improve-security-your-product-catalog-aws-marketplace/)。
以下是 `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 资源编号（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)。
有关创建亚马逊 EventBridge 规则的更多信息，请参阅[亚马逊* EventBridge 用户指南 EventBridge中的亚马逊*规则](https://docs.aws.amazon.com//eventbridge/latest/userguide/eb-rules.html)。
## 协议活动
当协议事件发生时，卖家可以收到有关购买协议生命周期变更的通知。
有关创建 EventBridge 规则的信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
以下是 “已**创建购买协议-投标人**” 的示例事件正文。
**注意**
如果是渠道合作伙伴私人报价 (CPPO)，则将填充转售授权编号；如果是 Mpporkete 直接报价 (MPPO)，则此值将为空。
```
{
"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 规则的信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
以下是 “**许可证已更新-制造商**” 的事件正文示例。
```
{
"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 规则的信息，请参阅[ EventBridge 《亚马逊* EventBridge 用户指南》中的亚马逊*规则](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
以下是 “**待批准的协议取消请求-提案人**” 的示例事件正文。当您提交取消请求且正在等待买家批准时，就会发送此事件。
```
{
"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"
}
}
}
```