本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
AWS Marketplace 目錄 API Amazon EventBridge 事件
本主題提供主控台中「Marketplace 目錄」服務下事件的詳細資 EventBridge 訊。
賣家採取的動作 | 收到的事件 | 相關主題 |
---|---|---|
獨立軟體廠商 (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 規則的相關資訊,請參閱 Amazon EventBridge 使用者指南中的 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"], } } }
變更集的事件
變更集完成後,賣家、通路合作夥伴和私人市集管理員都可以收到活動。當變更集完成且狀態為「成功」、「失敗」或「已取消」時,「 AWS Marketplace 目錄 API」會傳送事件。這些事件的來源為aws.marketplacecatalog
,可能的詳細資料類型值為Change
Set Succeeded
Change Set Failed
、和Change Set
Cancelled
。
注意
如需有關變更集的資訊,請參閱使用AWS Marketplace 目錄 API 參考中的變更集。
每個事件都包含變更請求詳細資訊,例如變更集 ID、變更集名稱、事件詳細資料類型、失敗代碼 (針對失敗請求),以及請求的開始和結束時間。這可讓您監視變更集,而無需持續查詢DescribeChangeSet
動作或檢 AWS Marketplace 管理入口網站 查變更請求的狀態。
注意
如需建立 EventBridge 規則的相關資訊,請參閱 Amazon EventBridge 使用者指南中的 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 使用者指南中的 Amazon EventBridge 規則。
如需管理安全性事件的詳細資訊,請參閱 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" } }