亚马逊 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 管理员会受到一个事件。当更改集完成且状态为 “成功”、“失败” 或 “已取消” 时， AWS Marketplace 目录会API发送一个事件。这些事件的来源是 aws.marketplacecatalog，可能的详细信息类型值包括 Change Set Succeeded、Change Set Failed 和 Change Set Cancelled。

注意

有关变更集的信息，请参阅《AWS Marketplace 目录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 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"
   }
}