View a markdown version of this page

AWS EventBridge Eventi del Marketplace Agreement - AWS Marketplace
Panoramica diTipi di eventoCampi di eventi comuniRegole di EventBridge impostazione

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

AWS EventBridge Eventi del Marketplace Agreement

AWS Marketplace invia notifiche ad Amazon EventBridge quando si verificano determinati eventi nel ciclo di vita dei tuoi contratti (ad esempio offerte che hai acquistato). Puoi utilizzare questi eventi per automatizzare i flussi di lavoro e tenere traccia degli acquisti sul marketplace.

Nota

Nella AWS Marketplace console, questa data è chiamata scadenza per la decisione di rinnovo, ovvero l'ultimo giorno in cui puoi disattivare (o riattivare) il rinnovo automatico prima della conferma del rinnovo. In questi eventi è rappresentata dai campi di blocco: indica quando termina quel periodo e renewalSummary.lockoutReached indica se il periodo renewalSummary.lockoutStartTime è iniziato.

La tabella seguente elenca gli eventi dell'acquirente che vengono AWS Marketplace inviati a EventBridge:

Event Description
Contratto di acquisto creato - Accettatore Inviato quando un nuovo contratto di acquisto viene creato, rinnovato o sostituito nel tuo account
Contratto di acquisto modificato - Accettatore Inviato quando vengono apportate modifiche a un contratto di acquisto esistente
Contratto di acquisto scaduto - Accettatore Inviato quando un contratto di acquisto viene annullato, scaduto, rinnovato o sostituito
Fine del contratto di acquisto - Accettatore Inviato 180, 120, 90, 60 e 30 giorni prima della scadenza del contratto di acquisto
Termini di rinnovo del contratto di acquisto finalizzati - Accettatore Inviato dopo la scadenza del termine di adeguamento del venditore, per i rinnovi con fasce percentuali, una volta finalizzato l'aumento del prezzo di rinnovo (o dopo l'applicazione dell'aggiornamento predefinito)
Rinnovo del contratto di acquisto imminente - Accettatore Inviato quando viene raggiunta la scadenza della decisione di rinnovo e si conferma che il rinnovo proseguirà

Panoramica di

Gli acquirenti ricevono EventBridge notifiche per i seguenti eventi del ciclo di vita del contratto di acquisto:

  • Creazione del contratto

  • Modifiche all'accordo

  • Fine del contratto (annullamento, scadenza o risoluzione)

  • Fine del contratto

Tutti gli eventi vengono inviati al bus EventBridge eventi predefinito nella us-east-1 regione con la fonte dell'eventoaws.agreement-marketplace.

Tipi di evento

Contratto di acquisto creato - Acceptor

AWS Marketplace invia questo evento quando viene creato un nuovo contratto di acquisto nel tuo account.

Scenari di attivazione:

  • NEW- L'accordo viene creato per la prima volta

  • REPLACE- Una nuova offerta privata deve essere accettata come parte di un' Agreement-Based offerta (ABO)

  • RENEW- Un contratto si rinnova automaticamente alla scadenza (se abilitato)

Schema degli eventi:

{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Created - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "intent": "NEW|RENEW|REPLACE",
      "status": "ACTIVE",
      "acceptanceTime": "2024-06-26T21:36:03Z",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456"
    }
  }
}

Per un rinnovo automatico, AWS Marketplace invia questo evento con intent impostato RENEW su. L'evento includeagreement.previousAgreementId, un product blocco proposer.name eoffer.name.

{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Created - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-05-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-newrenewalagreementid"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-newrenewalagreementid",
      "intent": "RENEW",
      "status": "ACTIVE",
      "startTime": "2025-05-30T21:36:03Z",
      "endTime": "2026-05-30T21:36:03Z",
      "previousAgreementId": "agmt-9xyz8wmklp67rt32nb1qv45ds"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456",
      "name": "Example Offer Name"
    }
  }
}

Contratto di acquisto modificato - Accettatore

AWS Marketplace invia questo evento quando vengono apportate modifiche a un contratto di acquisto esistente, ad esempio modifiche ai termini, ai prezzi o ad altri parametri del contratto.

Schema dell'evento:

{
  "version": "0",
  "id": "12345678-1234-1234-1234-123456789012",
  "detail-type": "Purchase Agreement Amended Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer 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",
      "autoRenewalEnabled": true
    },
    "renewalSummary": {
      "lockoutStartTime": "2025-05-20T21:36:03Z",
      "disabledBy": "ACCEPTOR"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-1234567890123",
      "name": "Example Offer Name"
    }
  }
}

L'opt-in e l'opt-out dell'acquirente e l'opt-out del venditore vengono considerati come modifiche al contratto e vengono rilevati durante questo evento. renewalSummary.disabledByè ACCEPTOR o PROPOSER (PROPOSERse entrambi hanno scelto di non aderire), oppure null quando autoRenewalEnabled esiste o non vi sono termini di true rinnovo. renewalSummary.lockoutStartTimeè null quando il periodo di rinnovo non prevede un periodo di blocco.

Contratto di acquisto scaduto - Accettatore

AWS Marketplace invia questo evento alla scadenza di un contratto di acquisto.

Scenari di attivazione:

  • CANCELLED- Hai concluso il contratto prima della data di fine definita

  • EXPIRED- L'accordo ha raggiunto la data di fine definita

  • TERMINATED- AWS ha risolto il contratto (ad esempio, a causa di un mancato pagamento)

  • RENEWED- L'accordo è stato rinnovato in un nuovo accordo

  • REPLACED- L'accordo è stato sostituito utilizzando un'offerta sostitutiva del contratto

Schema dell'evento:

{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Ended - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "987654321098",
  "time": "2024-08-30T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace:aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "status": "CANCELLED|EXPIRED|RENEWED|REPLACED|TERMINATED"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456"
    }
  }
}

Fine del contratto di acquisto - Accettatore

AWS Marketplace invia questo evento 180, 120, 90, 60 e 30 giorni prima della scadenza del contratto di acquisto.

Questo evento include campi aggiuntivi non presenti in altri eventi per acquirenti:

  • agreement.daysBeforeEndTime- Il numero di giorni prima della data di fine dell'invio della notifica: 180, 120, 90, 60 o 30

  • agreement.autoRenewalEnabled- Indica se il rinnovo automatico è abilitato per l'accordo

  • renewalSummary- Dettagli del blocco del rinnovo. renewalSummary.lockoutStartTimeè null quando il periodo di rinnovo non prevede un periodo di blocco; renewalSummary.disabledBy è ACCEPTOR o PROPOSER (PROPOSERse entrambi hanno disattivato), o null quando il rinnovo automatico è abilitato o non ci sono termini di rinnovo

  • product.ide product.title - Informazioni sul prodotto relative al contratto

  • proposer.namee offer.name - Human-readable nomi del venditore e dell'offerta

Schema degli eventi:

{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Ending - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-03-31T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z",
      "daysBeforeEndTime": 180,
      "autoRenewalEnabled": true,
      "status": "ACTIVE"
    },
    "renewalSummary": {
      "lockoutStartTime": "2025-05-20T21:36:03Z",
      "disabledBy": "ACCEPTOR"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    },
    "offer": {
      "id": "offer-abcdef123456",
      "name": "Example Offer Name"
    }
  }
}

Termini di rinnovo del contratto di acquisto finalizzati - Accettatore

AWS Marketplace invia questo evento dopo la scadenza del termine di adeguamento stabilito dal venditore, solo per le offerte con fasce percentuali, una volta finalizzato l'aumento del prezzo di rinnovo (o applicato l'aggiornamento predefinito).

Schema degli eventi:

{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Renewal Terms Finalized - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-05-15T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "renewalSummary": {
      "tcv": "105000.00",
      "currency": "USD",
      "termsFinalizedTime": "2025-05-15T21:36:03Z",
      "lockoutReached": false,
      "lockoutStartTime": "2025-05-20T21:36:03Z"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    }
  }
}

renewalSummary.lockoutReachede lockoutStartTime si verificano null quando il periodo di rinnovo accettato non prevede un periodo di blocco.

Rinnovo del contratto di acquisto imminente - Acceptor

AWS Marketplace invia questo evento all'inizio del periodo di blocco della decisione di rinnovo, quando viene raggiunta la scadenza per la decisione di rinnovo e si conferma che il rinnovo proseguirà.

Schema dell'evento:

{
  "version": "0",
  "id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
  "detail-type": "Purchase Agreement Renewal Upcoming - Acceptor",
  "source": "aws.agreement-marketplace",
  "account": "<Buyer Account ID>",
  "time": "2025-05-20T21:36:03Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:aws-marketplace::aws:agreement:agmt-9xyz8wmklp67rt32nb1qv45ds"
  ],
  "detail": {
    "requestId": "7f3e2d1c-a9b8-4f5e-6d7c-1234567890ab",
    "catalog": "AWSMarketplace",
    "agreement": {
      "id": "agmt-9xyz8wmklp67rt32nb1qv45ds",
      "startTime": "2024-08-30T21:36:03Z",
      "endTime": "2025-05-30T21:36:03Z"
    },
    "renewalSummary": {
      "lockoutReached": true,
      "tcv": "105000.00",
      "currency": "USD"
    },
    "product": {
      "id": "prod-abc123xyz456",
      "title": "Example Product Title"
    },
    "acceptor": {
      "accountId": "<Buyer Account ID>"
    },
    "proposer": {
      "name": "Example Seller Name",
      "accountId": "<Proposer Account ID>"
    }
  }
}

Campi di eventi comuni

Tutti gli eventi per gli acquirenti includono i seguenti campi comuni:

Campo Description
requestId UUID utilizzato per deduplicare gli eventi duplicati
catalog Il catalogo AWS Marketplace (in genere «AWS Marketplace»)
agreementId Identificatore univoco per l'accordo
acceptor.accountId L'ID del tuo AWS account
proposer.accountId L'ID dell' AWS account del venditore
offer.id L'identificatore dell'offerta

Regole di EventBridge impostazione

Per ricevere queste notifiche, crea EventBridge regole che corrispondano agli schemi degli eventi per gli acquirenti. Per ulteriori informazioni sulla creazione di regole, consulta Creating Amazon EventBridge rules nella Amazon EventBridge User Guide.