Amazon EventBridge events
As a seller, you can use Amazon EventBridge to receive notifications for events in AWS Marketplace. For example, you can receive an event from AWS Marketplace when an offer is created. The event contains details like the ID, expiration date, and product details. EventBridge is an event bus service that you can use to connect your applications with data from a variety of sources. For more information, see the Amazon EventBridge User Guide. The following sections provide detailed information about events under the Marketplace Catalog service in the EventBridge console.
This topic
Action by seller | Event received | Related topic |
---|---|---|
Independent software vendor (ISV) creates an offer and makes it available for purchase | Offer Released |
Events for new offers |
ISV's product is used by a channel partner to create an offer | Offer Released |
Events for new offers |
Channel partner creates an offer | Offer Released |
Events for new offers |
Change set succeeds | Change Set Succeeded |
Events for change sets |
Change set fails | Change Set Failed |
Events for change sets |
Change set is cancelled | Change Set Cancelled |
Events for change sets |
Security vulnerabilities were detected on the ISV's product | Products Security Report Created |
Events for security summary report |
Events for new offers
When sellers create an offer and make it available for purchase, they can receive an event
with the following detail type: Offer Released
.
Note
For information on creating EventBridge rules, see Amazon EventBridge rules in the Amazon EventBridge User Guide.
The following is an example event body for a new offer created by an 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" ] } }
The following is an example event body for when an ISV's product is used by a channel partner to create an offer.
{ "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"], } } }
The following is an example event body for when a channel partner creates an offer.
{ "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"], } } }
Events for change sets
When a change set completes, sellers, channel partners, and private marketplace
administrators can receive an event. The AWS Marketplace Catalog API sends an event when a change set
completes with a status of succeeded, failed, or cancelled. The source for these events is
aws.marketplacecatalog
, and the possible detail type values are Change
Set Succeeded
, Change Set Failed
, and Change Set
Cancelled
.
Note
For information on change sets, see Working with change sets in the AWS Marketplace Catalog API Reference.
Each event contains change request details, such as the change set ID, change set name,
event detail type, failure code (for failed requests), and start and end times of the request.
This enables you to monitor your change sets without continuously querying the
DescribeChangeSet
action or checking the AWS Marketplace Management Portal for the status of your
change requests.
Note
For information on creating EventBridge rules, see Amazon EventBridge rules in the Amazon EventBridge User Guide.
The following is an example event body for the Change Set Succeeded
detail
type.
{ "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" } }
The following is an example event body for the Change Set Failed
detail
type.
{ "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" } }
The following is an example event body for the Change Set Cancelled
detail
type.
{ "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" } }
Events for security summary report
When security vulnerabilities are detected on a seller's products, they can receive a
summary report event and periodic reminders for outstanding product issues. The source for
these events is aws.marketplacecatalog
, and the detail type is Products
Security Report Created
.
Each event includes a summary of the count of products and versions with detected issues, a count of how many latest versions are affected, and the date when resolution is required to prevent a temporary restriction of these products or versions.
Note
For information on creating EventBridge rules, see Amazon EventBridge rules in the Amazon EventBridge User Guide.
For details on managing security events, see the How to improve the security of your product catalog in AWS Marketplace
The following is an example event body for the Products Security Report
Created
detail type.
{ "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" } }