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

# Gestione degli eventi di abbonamento SaaS con Amazon EventBridge
<a name="saas-eventbridge-integration"></a>

Puoi usare Amazon EventBridge per integrare e gestire prodotti SaaS con. Marketplace AWS Gli eventi vengono inviati per modificare gli abbonamenti dei clienti e i diritti contrattuali per i tuoi prodotti. Ricevi notifiche quando i clienti si abbonano, quando i loro diritti cambiano e quando annullano, così sai esattamente quando concedere o revocare l'accesso. Questi eventi svolgono due ruoli principali:
+ **Produttore**: si tratta del produttore originale del prodotto indicato nell'inserzione Marketplace AWS, noto anche come Independent Solution Vendor (ISV).
+ **Proponente**: è il proponente originale di un contratto di acquisto per il prodotto elencato in. Marketplace AWS Può trattarsi dell'ISV o di un Channel Partner autorizzato a rivendere il prodotto.

Due modelli di vendita distinti determinano se, in qualità di ISV, agisci come produttore o proponente. Il tuo ruolo determina le notifiche tramite cui ricevere. EventBridge


| Modello di vendita | Description | Il ruolo di ISV | 
| --- | --- | --- | 
| Marketplace AWS offerta pubblica o privata | Estendi un'offerta o un accordo direttamente all'acquirente. | Produttore e proponente | 
| Offerta privata per i partner di canale | Un partner di canale autorizzato a rivendere il prodotto estende un'offerta o un accordo all'acquirente. | Produttore | 

## EventBridge eventi per prodotti SaaS
<a name="saas-eventbridge-event-types"></a>

Quando si verifica una Marketplace AWS transazione, EventBridge invia gli eventi al bus degli eventi predefinito. Il tuo ruolo di produttore o proponente determina quali eventi ricevere.


| Nome evento | Iniziato da | Risposta | Destinatario | 
| --- | --- | --- | --- | 
|  [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/saas-eventbridge-integration.html)  | Viene creato un nuovo accordo, un accordo esistente viene sostituito o un accordo esistente viene rinnovato. | Il contratto di acquisto viene registrato e vengono intraprese le azioni successive alla vendita. DescribeAgreement L'API viene utilizzata per determinare se il nuovo contratto è una prova gratuita. | Produttore e proponente | 
|  [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/saas-eventbridge-integration.html)  | Un contratto esistente viene modificato. | Il record del contratto di acquisto viene modificato. | Produttore e proponente | 
|  [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/marketplace/latest/userguide/saas-eventbridge-integration.html)  | Un contratto è scaduto, è stato annullato, è stato risolto. | La chiusura del contratto di acquisto viene registrata e vengono eseguite le azioni di annullamento successive all'accordo. L'ISV inizia a revocare i diritti dei clienti. | Produttore e proponente | 
| Licenza aggiornata - Produttore | Il diritto dell'acquirente a un prodotto è cambiato. | I diritti dei clienti vengono verificati utilizzando l'GetEntitlementsAPI e i servizi vengono forniti di conseguenza. | Solo produttore | 
| Licenza non fornita - Produttore | Il diritto dell'acquirente a un prodotto è scaduto. | Per i prodotti basati sull'utilizzo, questo evento segna l'inizio di una finestra di segnalazione finale di 1 ora. I venditori devono raccogliere e segnalare qualsiasi utilizzo non segnalato utilizzando l'API. BatchMeterUsage Dopo la chiusura di questa finestra, i diritti dei clienti vengono completamente revocati e i report sull'utilizzo non sono più accettati. | Solo produttore | 

**Nota**  
I tipi di eventi relativi al contratto di acquisto per produttore e proponente sono quasi identici, fatta eccezione per la presenza di un ResaleAuthorization ID. Per evitare messaggi ridondanti, viene inviato solo l'evento del contratto di acquisto del proponente quando l'utente è sia il produttore che il proponente.

Per l'elenco completo dei tipi di eventi e i relativi schemi dettagliati, consulta [EventBridge Eventi Amazon](notifications-eventbridge.md) la Guida al venditore.

## Finestra di report sull'utilizzo finale per i prodotti basati sull'utilizzo
<a name="saas-eventbridge-final-usage"></a>

Per i prodotti con una componente di fatturazione basata sull'utilizzo, AWS Marketplace offre ai venditori un'ora per inviare i record di utilizzo finali per i clienti i cui diritti sono scaduti. Dopo questo periodo, l'`BatchMeterUsage`API rifiuta l'utilizzo segnalato e non puoi fatturare al cliente.

AWS Marketplace invia l'evento License Deprovisioned - Manufacturer per segnalare l'inizio della finestra di segnalazione finale. I venditori hanno un'ora di tempo dopo aver ricevuto questo evento per raccogliere eventuali utilizzi non segnalati per il cliente e segnalarli utilizzando l'API. `BatchMeterUsage`

Dopo la chiusura della finestra di un'ora, AWS Marketplace revoca completamente le autorizzazioni del cliente e non accetta più i report sull'utilizzo.

## Integra EventBridge con il tuo prodotto SaaS
<a name="saas-eventbridge-using"></a>

Utilizzalo EventBridge per integrare le operazioni di provisioning dei tenant con la tua inserzione SaaS nel Marketplace. AWS 
+ Le regole relative agli eventi definiscono come reagire a un evento. Queste regole possono reagire immediatamente o secondo una pianificazione prestabilita.
+ I modelli di eventi sono definiti nelle regole degli eventi e consentono di filtrare in base a tipi di eventi specifici inviati al bus eventi predefinito. I modelli di pattern per ogni tipo di evento sono disponibili nella EventBridge console. Nella fase di configurazione del modello di evento, seleziona AWS i servizi come origine dell'evento e AWS Marketplace Agreements and Licenses come AWS servizio.
  + Tutti i tipi di eventi AWS Marketplace Agreements and Licenses utilizzano la seguente struttura.

  ```
  {
  "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"],
  "source": ["aws.agreement-marketplace"]
  }
  ```
+ Gli obiettivi sono risorse che ricevono eventi quando corrispondono al modello di evento definito per una regola. Molti AWS servizi si integrano EventBridge e possono fungere da obiettivi, tra cui le funzioni Lambda, Step Functions e API Gateway.

Per ulteriori informazioni sulla configurazione EventBridge delle regole, consulta [Getting started: Create an Amazon EventBridge Event Bus rule](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html).