EventBridge Eventi Amazon - Marketplace AWS
Eventi per nuove offerteEventi per i set di modificheRapporto di riepilogo sugli eventi per la sicurezzaEventi per gli esborsi

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.

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
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

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"],
    }
  }
}

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 post del AWS blog.

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.