Vue d’ensemble Types d'événements Champs d'événements courants Configuration des EventBridge règles

AWS EventBridge Événements relatifs aux Marketplace Agreement

AWS Marketplace envoie des notifications à Amazon EventBridge lorsque certains événements se produisent au cours du cycle de vie de vos contrats (c'est-à-dire les offres que vous avez achetées). Vous pouvez utiliser ces événements pour automatiser les flux de travail et suivre vos achats sur le marché.

Note

Dans la AWS Marketplace console, cette date est appelée date limite de décision de renouvellement : le dernier jour où vous pouvez désactiver (ou réactiver) le renouvellement automatique avant que le renouvellement ne soit confirmé. Dans ces cas, il est représenté par les champs de verrouillage : renewalSummary.lockoutStartTime c'est le moment où cette période se termine et renewalSummary.lockoutReached indique si la période a commencé.

Le tableau suivant répertorie les événements destinés aux acheteurs AWS Marketplace envoyés à EventBridge :

Événement	Description
Contrat d'achat créé - Accepteur	Envoyé lorsqu'un nouveau contrat d'achat est créé, renouvelé ou remplacé dans votre compte
Contrat d'achat modifié - Accepteur	Envoyé lorsque des modifications sont apportées à un contrat d'achat existant
Contrat d'achat terminé - Accepteur	Envoyé lorsqu'un contrat d'achat est annulé, expiré, résilié, renouvelé ou remplacé
Fin du contrat d'achat - Accepteur	Envoyé 180, 120, 90, 60 et 30 jours avant l'expiration du contrat d'achat
Modalités de renouvellement du contrat d'achat finalisées - Accepteur	Envoyé après l'expiration de la date limite d'ajustement fixée par le vendeur, pour les renouvellements par fourchette de pourcentages, une fois que l'augmentation du prix de renouvellement est finalisée (ou que la hausse par défaut est appliquée)
Renouvellement du contrat d'achat à venir - Accepteur	Envoyé lorsque la date limite de décision de renouvellement est atteinte et que le renouvellement est confirmé

Vue d’ensemble

Les acheteurs reçoivent des EventBridge notifications concernant les événements suivants relatifs au cycle de vie du contrat d'achat :

Création d'un accord
Modifications de l'accord
Fin du contrat (annulation, expiration ou résiliation)
Fin de l'accord

Tous les événements sont envoyés à votre bus d' EventBridge événements par défaut dans la us-east-1 région où se trouve la source de l'événementaws.agreement-marketplace.

Types d'événements

Contrat d'achat créé - Accepteur

AWS Marketplace envoie cet événement lorsqu'un nouveau contrat d'achat est créé sur votre compte.

Scénarios de déclenchement :

NEW- L'accord est créé pour la première fois
REPLACE- Une nouvelle offre privée doit être acceptée dans le cadre d'une Agreement-Based offre (ABO)
RENEW- Un accord est automatiquement renouvelé à son expiration (s'il est activé)

Schéma d'événement :


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

Pour un renouvellement automatique, AWS Marketplace envoie cet événement avec intent set toRENEW. L'événement inclutagreement.previousAgreementId, un product blocproposer.name, etoffer.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"
    }
  }
}

Contrat d'achat modifié - Accepteur

AWS Marketplace envoie cet événement lorsque des modifications sont apportées à un contrat d'achat existant, telles que des modifications des conditions, des prix ou d'autres paramètres du contrat.

Schéma d'événement :


{
  "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'adhésion et la désinscription de l'acheteur, ainsi que la désinscription du vendeur, sont traitées au fur et à mesure des modifications du contrat et apparaissent au cours de cet événement. renewalSummary.disabledByest ACCEPTOR ou PROPOSER (PROPOSERsi les deux se sont désinscrits), ou null quand autoRenewalEnabled c'est le cas true ou il n'y a pas de conditions de renouvellement. renewalSummary.lockoutStartTimec'est null lorsque la période de renouvellement n'est pas assortie d'une période de verrouillage.

Contrat d'achat terminé - Accepteur

AWS Marketplace envoie cet événement lorsqu'un contrat d'achat prend fin.

Scénarios de déclenchement :

CANCELLED- Vous avez résilié le contrat avant la date de fin définie
EXPIRED- L'accord a atteint sa date de fin définie
TERMINATED- AWS a résilié le contrat (par exemple, en raison d'un échec de paiement)
RENEWED- L'accord a été renouvelé pour devenir un nouvel accord
REPLACED- Le contrat a été remplacé par une offre de remplacement du contrat

Schéma d'événement :


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

Fin du contrat d'achat - Accepteur

AWS Marketplace envoie cet événement 180, 120, 90, 60 et 30 jours avant l'expiration du contrat d'achat.

Cet événement inclut des champs supplémentaires qui ne figurent pas dans les autres événements destinés aux acheteurs :

agreement.daysBeforeEndTime- Le nombre de jours avant la date de fin d'envoi de la notification : 180, 120, 90, 60 ou 30
agreement.autoRenewalEnabled- Indique si le renouvellement automatique est activé pour le contrat
renewalSummary- Détails du verrouillage du renouvellement. renewalSummary.lockoutStartTimec'est null lorsque la période de renouvellement n'a pas de période de verrouillage ; renewalSummary.disabledBy est ACCEPTOR ou PROPOSER (PROPOSERsi les deux se sont désinscrits), ou null lorsque le renouvellement automatique est activé ou qu'il n'y a pas de conditions de renouvellement
product.idet product.title - Informations sur le produit pour le contrat
proposer.nameet offer.name - Human-readable noms du vendeur et de l'offre

Schéma d'événement :


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

Modalités de renouvellement du contrat d'achat finalisées - Accepteur

AWS Marketplace envoie cet événement après l'expiration de la date limite d'ajustement fixée par le vendeur, pour les offres à fourchette de pourcentages uniquement, une fois que l'augmentation du prix de renouvellement est finalisée (ou que la hausse par défaut est appliquée).

Schéma d'événement :


{
  "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.lockoutReachedet c'lockoutStartTimenullest le cas lorsque la durée de renouvellement acceptée n'est pas assortie d'une période de verrouillage.

Renouvellement du contrat d'achat à venir - Accepteur

AWS Marketplace envoie cet événement au début de la période de blocage de la décision de renouvellement, lorsque la date limite de décision de renouvellement est atteinte et que le renouvellement est confirmé.

Schéma d'événement :


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

Champs d'événements courants

Tous les événements destinés aux acheteurs incluent les champs communs suivants :

Champ	Description
`requestId`	UUID utilisé pour dédupliquer les événements dupliqués
`catalog`	Le catalogue AWS Marketplace (généralement « AWSMarketplace »)
`agreementId`	Identifiant unique pour l'accord
`acceptor.accountId`	L'identifiant AWS de votre compte
`proposer.accountId`	L'identifiant du AWS compte du vendeur
`offer.id`	L'identifiant de l'offre

Configuration des EventBridge règles

Pour recevoir ces notifications, créez des EventBridge règles qui correspondent aux modèles d'événements pour les acheteurs. Pour plus d'informations sur la création de règles, consultez la section Création de EventBridge règles Amazon dans le guide de EventBridge l'utilisateur Amazon.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Événements du marché privé

Événements d'annulation et d'ajustement de facturation