亚马逊 EventBridge 活动 - AWS Marketplace
新优惠事件更改集事件安全摘要报告事件付款活动

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

亚马逊 EventBridge 活动

作为卖家，您可以使用 Amazon EventBridge 接收活动通知 AWS Marketplace。例如，您可以在创建优惠 AWS Marketplace 时收到一个事件。该活动包含诸如 ID、有效期和产品详情之类的详细信息。 EventBridge 是一项事件总线服务，可用于将应用程序与来自各种来源的数据连接起来。有关更多信息，请参阅 Amazon EventBridge 用户指南。以下部分提供有关 EventBridge控制台中 Marketplace Catalog 服务下的事件的详细信息。

本主题内容

卖家操作 收到的事件 相关主题
独立软件供应商 (ISV) 创建优惠并使其可供购买 Offer Released 新优惠事件
渠道合作伙伴使用 ISV 的产品来创建优惠 Offer Released 新优惠事件
渠道合作伙伴创建优惠 Offer Released 新优惠事件
更改集成功 Change Set Succeeded 更改集事件
更改集失败 Change Set Failed 更改集事件
更改集取消 Change Set Cancelled 更改集事件
在 ISV 的产品上检测到安全漏洞 Products Security Report Created 安全摘要报告事件

新优惠事件

当卖家创建优惠并使其可供购买时，他们会收到一个包含以下详细信息类型的事件：Offer Released。

注意

有关创建 EventBridge 规则的信息，请参阅亚马逊 EventBridge 用户指南中的亚马逊 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"],
    }
  }
}

更改集事件

变更集完成后，卖家、渠道合作伙伴和 Private Marketplace 管理员会受到一个事件。当更改集完成且状态为成功、失败或已取消时，Catalo AWS Marketplace g API 会发送一个事件。这些事件的来源是 aws.marketplacecatalog，可能的详细信息类型值包括 Change Set Succeeded、Change Set Failed 和 Change Set Cancelled。

注意

有关变更集的信息，请参阅《AWS Marketplace Catalog API 参考》中的使用变更集。

每个事件都包含更改请求的详细信息，例如更改集 ID、更改集名称、事件详细信息类型、失败代码（对于失败的请求）以及请求的开始和结束时间。这使您无需持续查询DescribeChangeSet操作或检查变更请求状态即可监控变更集。 AWS Marketplace 管理门户

注意

有关创建 EventBridge 规则的信息，请参阅亚马逊 EventBridge 用户指南中的亚马逊 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 规则的信息，请参阅亚马逊 EventBridge 用户指南中的亚马逊 EventBridge 规则。

有关管理安全事件的详细信息，请参阅AWS 博客上的博客文章：How to improve the security of your product catalog in 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值显示无效的银行账户亚马逊资源编号 (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 管理门户中添加您的银行账户详细信息。有关说明，请参阅 添加银行账户详情。

有关创建亚马逊 EventBridge 规则的更多信息，请参阅亚马逊 EventBridge 用户指南 EventBridge中的亚马逊规则。