Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
EventBridge Eventi Amazon
In qualità di venditore, puoi utilizzare Amazon EventBridge per ricevere notifiche relative a eventi in Marketplace AWS. Ad esempio, puoi ricevere un evento dal Marketplace AWS momento in cui viene creata un'offerta. L'evento contiene dettagli come l'ID, la data di scadenza e i dettagli del prodotto. EventBridge è un servizio di bus di eventi che puoi utilizzare per connettere le tue applicazioni con dati provenienti da diverse fonti. Per ulteriori informazioni, consulta la Amazon EventBridge User Guide. Le seguenti sezioni forniscono informazioni dettagliate sugli eventi del servizio Marketplace Catalog nella EventBridge console.
Argomenti
Questo argomento
| Azione del venditore | Evento ricevuto | Argomento correlato |
|---|---|---|
| Un fornitore di software indipendente (ISV) crea un'offerta e la rende disponibile per l'acquisto | Offer Released |
Eventi per nuove offerte |
| Il prodotto ISV viene utilizzato da un partner di canale per creare un'offerta | Offer Released |
Eventi per nuove offerte |
| Il partner di canale crea un'offerta | Offer Released |
Eventi per nuove offerte |
| ISV crea un nuovo set di offerte | OfferSet Released |
Eventi per nuove offerte |
| Il partner di canale crea un nuovo set di offerte | OfferSet Released |
Eventi per nuove offerte |
| Il set di modifiche ha esito positivo | Change Set Succeeded |
Eventi per i set di modifiche |
| Il set di modifiche fallisce | Change Set Failed |
Eventi per i set di modifiche |
| Il set di modifiche viene annullato | Change Set Cancelled |
Eventi per i set di modifiche |
| Sono state rilevate vulnerabilità di sicurezza sul prodotto dell'ISV | Products Security Report Created |
Rapporto di riepilogo sugli eventi per la sicurezza |
| Il cliente si abbona al prodotto SaaS | Purchase Agreement Created |
Eventi per accordi |
| Il contratto SaaS del cliente viene modificato | Purchase Agreement Amended |
Eventi per accordi |
| Il cliente annulla l'abbonamento SaaS | Purchase Agreement Ended |
Eventi per accordi |
| Cambiano i diritti SaaS del cliente | License Updated |
Eventi relativi alle licenze |
| I diritti SaaS del cliente vengono revocati | License Deprovisioned |
Eventi relativi alle licenze |
Eventi per nuove offerte
Quando i venditori creano un'offerta e la rendono disponibile per l'acquisto, possono ricevere un evento con il seguente tipo di dettagli:Offer Released.
Nota
Per informazioni sulla creazione di EventBridge regole, consulta EventBridge le regole di Amazon nella Amazon EventBridge User Guide.
Di seguito è riportato un esempio di corpo evento per una nuova offerta creata da un 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" ] } }
Di seguito è riportato un esempio di corpo evento per quando un prodotto di un ISV viene utilizzato da un partner di canale per creare un'offerta.
{ "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"], } } }
Di seguito è riportato un esempio di corpo evento relativo alla creazione di un'offerta da parte di un partner di canale.
{ "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"], } } }
Di seguito è riportato un esempio di corpo evento per un nuovo set di offerte pubblicato da un partner (ISV o Channel partner).
{ "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", } }, ... ] } }
Eventi per i set di modifiche
Una volta completato un set di modifiche, i venditori, i partner di canale e gli amministratori del marketplace privato possono ricevere un evento. L'API Marketplace AWS Catalog invia un evento quando un set di modifiche viene completato con lo stato di riuscito, non riuscito o annullato. L'origine di questi eventi èaws.marketplacecatalog, e i possibili valori del tipo di dettaglio sonoChange
Set Succeeded, Change Set Failed e. Change Set
Cancelled
Nota
Per informazioni sui set di modifiche, consulta Lavorare con i set di modifiche nel Marketplace AWS Catalog API Reference.
Ogni evento contiene i dettagli della richiesta di modifica, come l'ID del set di modifiche, il nome del set di modifiche, il tipo di dettaglio dell'evento, il codice di errore (per le richieste non riuscite) e gli orari di inizio e fine della richiesta. Ciò consente di monitorare i set di modifiche senza dover interrogare continuamente l'DescribeChangeSetazione o controllare lo stato delle richieste di modifica. Portale di gestione Marketplace AWS
Nota
Per informazioni sulla creazione di EventBridge regole, consulta EventBridge le regole di Amazon nella Amazon EventBridge User Guide.
Di seguito è riportato un esempio di corpo di evento per il tipo di Change Set Succeeded dettaglio.
{ "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" } }
Di seguito è riportato un esempio di corpo evento per il tipo di Change Set Failed dettaglio.
{ "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" } }
Di seguito è riportato un esempio di corpo evento per il tipo di Change Set Cancelled dettaglio.
{ "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" } }
Rapporto di riepilogo sugli eventi per la sicurezza
Quando vengono rilevate vulnerabilità di sicurezza nei prodotti di un venditore, quest'ultimo può ricevere un report di riepilogo e promemoria periodici per i problemi in sospeso relativi ai prodotti. L'origine di questi eventi èaws.marketplacecatalog, e il tipo di dettaglio è. Products
Security Report Created
Ogni evento include un riepilogo del numero di prodotti e versioni con problemi rilevati, un conteggio del numero di versioni più recenti interessate e la data in cui è necessaria la risoluzione per evitare una restrizione temporanea di tali prodotti o versioni.
Nota
Per informazioni sulla creazione di EventBridge regole, consulta EventBridge le regole di Amazon nella Amazon EventBridge User Guide.
Per i dettagli sulla gestione degli eventi di sicurezza, consulta la sezione Come migliorare la sicurezza del tuo catalogo di prodotti nel Marketplace AWS
Di seguito è riportato un esempio di corpo di evento per il tipo di Products Security Report
Created dettaglio.
{ "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" } }
Eventi per gli esborsi
Quando un pagamento sul conto bancario del venditore non va a buon fine a causa di coordinate bancarie non valide Marketplace AWS ISVs e i partner di canale potrebbero ricevere un evento.
Nel seguente codice di evento JSON, il source valore di questi eventi èaws.marketplace, e il valore è. detail-type Disbursement Paused Il resources valore indica il conto bancario Amazon Resource Number (ARN) non valido.
{ "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" } }
Per risolvere il problema relativo alle coordinate bancarie non valide, aggiungi le coordinate bancarie nel Marketplace AWS portale di gestione. Per istruzioni, consulta Per aggiungere i dettagli del conto bancario.
Per ulteriori informazioni sulla creazione di EventBridge regole Amazon, consulta Rules in Amazon EventBridge nella Amazon EventBridge User Guide.
Eventi per accordi
Quando si verificano eventi contrattuali, i venditori possono ricevere notifiche relative alle modifiche del ciclo di vita del contratto di acquisto.
Per informazioni sulla creazione di EventBridge regole, consulta EventBridge le regole di Amazon nella Amazon EventBridge User Guide.
Di seguito è riportato un esempio di corpo evento per Purchase Agreement Created - Proposer.
Nota
L'ID di autorizzazione alla rivendita nel caso di Channel Partner Private Offer (CPPO) verrà compilato e, nel caso dell'offerta diretta Marketplace (MPPO), questo valore sarà nullo.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Created - Proposer", "source": "aws.agreement-marketplace", "account": "<ISV's or CP's account id>", "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" } } }
Di seguito è riportato un esempio di corpo evento per Purchase Agreement Created - Manufacturer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Created - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "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" } } }
Di seguito è riportato un esempio di corpo evento per Purchase Agreement Amended - Proposer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Amended - Proposer", "source": "aws.agreement-marketplace", "account": "<ISV or CP's account id>", "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" } } }
Di seguito è riportato un esempio di corpo evento per Purchase Agreement Amended - Manufacturer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Amended - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "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" } } }
Di seguito è riportato un esempio di corpo evento per Purchase Agreement Ended - Proposer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Ended - Proposer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "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" } } }
Di seguito è riportato un esempio di corpo evento per Purchase Agreement Ended - Manufacturer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "Purchase Agreement Ended - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV's account id>", "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" } } }
Eventi relativi alle licenze
Quando si verificano eventi relativi alle licenze, i venditori possono ricevere notifiche relative alle modifiche ai diritti dei clienti.
Per informazioni sulla creazione di EventBridge regole, consulta EventBridge le regole di Amazon nella Amazon EventBridge User Guide.
Di seguito è riportato un esempio di corpo dell'evento per License Updated - Manufacturer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "License Updated - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV/CP account id>", "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" } } }
Di seguito è riportato un esempio di corpo evento per License Deprovisioned - Manufacturer.
{ "version": "0", "id": "12345678-1234-1234-1234-123456789012", "detail-type": "License Deprovisioned - Manufacturer", "source": "aws.agreement-marketplace", "account": "<ISV/CP account id>", "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" } } }