-Übersicht Ereignistypen Allgemeine Ereignisfelder EventBridge Regeln einrichten

AWS EventBridge Veranstaltungen zur Marktplatzvereinbarung

AWS Marketplace sendet Benachrichtigungen an Amazon, EventBridge wenn bestimmte Ereignisse im Lebenszyklus Ihrer Verträge eintreten (d. h. Angebote, die Sie gekauft haben). Sie können diese Ereignisse verwenden, um Arbeitsabläufe zu automatisieren und Ihre Marketplace-Käufe nachzuverfolgen.

Anmerkung

In der AWS Marketplace Konsole wird dieses Datum als Frist für die Verlängerungsentscheidung bezeichnet — der letzte Tag, an dem Sie die automatische Verlängerung aus- (oder wieder einschalten) können, bevor die Verlängerung bestätigt wird. In diesen Fällen wird es durch die Sperrfelder dargestellt: Es renewalSummary.lockoutStartTime ist der Zeitpunkt, an dem dieser Zeitraum endet, und renewalSummary.lockoutReached gibt an, ob der Zeitraum begonnen hat.

In der folgenden Tabelle sind die Käuferereignisse aufgeführt, die AWS Marketplace gesendet werden an EventBridge:

Veranstaltung	Description
Kaufvertrag erstellt — Akzeptor	Wird gesendet, wenn ein neuer Kaufvertrag in Ihrem Konto erstellt, erneuert oder ersetzt wird
Kaufvertrag geändert — Akzeptierer	Wird gesendet, wenn Änderungen an einem bestehenden Kaufvertrag vorgenommen werden
Kaufvertrag beendet — Akzeptor	Wird gesendet, wenn ein Kaufvertrag storniert, abgelaufen, gekündigt, erneuert oder ersetzt wird
Ende des Kaufvertrags — Akzeptor	180, 120, 90, 60 und 30 Tage vor Ablauf eines Kaufvertrags gesendet
Bedingungen für die Verlängerung des Kaufvertrags abgeschlossen — Akzeptor	Wird nach Ablauf der Anpassungsfrist des Verkäufers gesendet, und zwar bei Verlängerungen im Prozentbereich, sobald die Erhöhung des Verlängerungspreises abgeschlossen ist (oder die standardmäßige Preiserhöhung angewendet wurde)
Verlängerung des Kaufvertrags steht bevor — Acceptor	Wird gesendet, wenn die Frist für die Entscheidung über die Verlängerung erreicht ist und bestätigt wurde, dass die Verlängerung fortgesetzt wird

-Übersicht

Käufer erhalten EventBridge Benachrichtigungen über die folgenden Ereignisse im Lebenszyklus eines Kaufvertrags:

Erstellung eines Vertrags
Änderungen der Vereinbarung
Die Vereinbarung endet (Kündigung, Ablauf oder Kündigung)
Ende der Vereinbarung

Alle Ereignisse werden an Ihren EventBridge Standard-Event-Bus in der us-east-1 Region gesendet, in der sich die Ereignisquelle befindetaws.agreement-marketplace.

Ereignistypen

Kaufvertrag erstellt — Akzeptor

AWS Marketplace sendet dieses Ereignis, wenn ein neuer Kaufvertrag in Ihrem Konto erstellt wird.

Auslösende Szenarien:

NEW- Die Vereinbarung wird zum ersten Mal erstellt
REPLACE- Ein neues privates Angebot muss als Teil eines Agreement-Based Angebots (ABO) angenommen werden
RENEW- Eine Vereinbarung wird nach Ablauf automatisch verlängert (falls aktiviert)

Ereignisschema:


{
  "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"
    }
  }
}

AWS Marketplace Sendet dieses Ereignis für eine automatische Verlängerung mit der intent Einstellung aufRENEW. Das Ereignis umfasstagreement.previousAgreementId, einen product Blockproposer.name, undoffer.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"
    }
  }
}

Kaufvertrag geändert — Akzeptor

AWS Marketplace sendet dieses Ereignis, wenn Änderungen an einem bestehenden Kaufvertrag vorgenommen werden, z. B. Änderungen an den Bedingungen, Preisen oder anderen Vertragsparametern.

Ereignisschema:


{
  "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"
    }
  }
}

Die An- und Abmeldung durch Käufer und Abmeldung durch den Verkäufer werden als Vertragsänderungen behandelt und im Rahmen dieser Veranstaltung veröffentlicht. renewalSummary.disabledByist ACCEPTOR oder PROPOSER (PROPOSERfalls beide sich abmelden), oder null wann autoRenewalEnabled ist true oder es keine Verlängerungsbedingungen gibt. renewalSummary.lockoutStartTimeistnull, wenn für den Verlängerungszeitraum keine Sperrfrist gilt.

Kaufvertrag beendet — Akzeptor

AWS Marketplace sendet dieses Ereignis, wenn ein Kaufvertrag endet.

Auslösende Szenarien:

CANCELLED- Sie haben die Vereinbarung vor dem definierten Enddatum beendet
EXPIRED- Die Vereinbarung hat ihr definiertes Enddatum erreicht
TERMINATED- hat die Vereinbarung AWS gekündigt (z. B. aufgrund eines Zahlungsfehlers)
RENEWED- Die Vereinbarung wurde zu einer neuen Vereinbarung erneuert
REPLACED- Die Vereinbarung wurde durch ein Ersatzangebot ersetzt

Schema des Ereignisses:


{
  "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"
    }
  }
}

Ende des Kaufvertrags — Akzeptor

AWS Marketplace sendet dieses Ereignis 180, 120, 90, 60 und 30 Tage vor Ablauf eines Kaufvertrags.

Dieses Ereignis umfasst zusätzliche Felder, die in anderen Käuferereignissen nicht vorkommen:

agreement.daysBeforeEndTime- Die Anzahl der Tage vor dem Enddatum, an dem die Benachrichtigung gesendet wird: 180, 120, 90, 60 oder 30
agreement.autoRenewalEnabled- Zeigt an, ob die automatische Verlängerung für den Vertrag aktiviert ist
renewalSummary- Einzelheiten zur Sperrung der Verlängerung. renewalSummary.lockoutStartTimeistnull, wenn die Verlängerungslaufzeit keine Sperrfrist hat; renewalSummary.disabledBy ist ACCEPTOR oder PROPOSER (PROPOSERfalls beide sich abmelden), oder null wenn die automatische Verlängerung aktiviert ist oder es keine Verlängerungsbedingungen gibt
product.idund product.title — Produktinformationen für die Vereinbarung
proposer.nameund offer.name - Human-readable Namen für den Verkäufer und das Angebot

Schema der Veranstaltung:


{
  "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"
    }
  }
}

Bedingungen für die Verlängerung des Kaufvertrags abgeschlossen — Acceptor

AWS Marketplace sendet dieses Ereignis nach Ablauf der Anpassungsfrist des Verkäufers (nur bei Angeboten mit prozentualer Preisspanne), sobald die Erhöhung des Verlängerungspreises abgeschlossen ist (oder die standardmäßige Preiserhöhung angewendet wurde).

Schema des Ereignisses:


{
  "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.lockoutReachedund lockoutStartTime sindnull, wenn für den akzeptierten Verlängerungszeitraum keine Sperrfrist vorgesehen ist.

Verlängerung des Kaufvertrags steht bevor — Acceptor

AWS Marketplace sendet dieses Ereignis zu Beginn der Sperrfrist für die Verlängerungsentscheidung, wenn die Frist für die Verlängerungsentscheidung abgelaufen ist und bestätigt wird, dass die Verlängerung fortgesetzt wird.

Schema des Ereignisses:


{
  "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>"
    }
  }
}

Allgemeine Ereignisfelder

Alle Käuferereignisse enthalten die folgenden allgemeinen Felder:

Feld	Description
`requestId`	UUID wird verwendet, um doppelte Ereignisse zu deduplizieren
`catalog`	Der AWS Marketplace-Katalog (normalerweise „AWSMarketplace“)
`agreementId`	Eindeutige Kennung für die Vereinbarung
`acceptor.accountId`	Ihre AWS Konto-ID
`proposer.accountId`	Die AWS Konto-ID des Verkäufers
`offer.id`	Die Angebots-ID

EventBridge Regeln einrichten

Um diese Benachrichtigungen zu erhalten, müssen Sie EventBridge Regeln erstellen, die den Ereignismustern für Käuferereignisse entsprechen. Weitere Informationen zum Erstellen von Regeln finden Sie unter EventBridge Amazon-Regeln erstellen im EventBridge Amazon-Benutzerhandbuch.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Private Marktplatz-Veranstaltungen

Stornierungs- und Abrechnungsanpassungen