Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Gestion des événements d'abonnement SaaS avec Amazon EventBridge
Vous pouvez utiliser Amazon EventBridge pour intégrer et gérer des produits SaaS avec AWS Marketplace. Des événements sont envoyés pour signaler les modifications apportées aux abonnements des clients et aux droits contractuels relatifs à vos produits. Vous recevez des notifications lorsque les clients s'abonnent, lorsque leurs droits changent et lorsqu'ils annulent, afin que vous sachiez exactement quand accorder ou révoquer l'accès. Ces événements jouent deux rôles principaux :
-
Fabricant — Il s'agit du fabricant original du produit répertorié dans AWS Marketplace, également connu sous le nom de fournisseur de solutions indépendant (ISV).
-
Proposant — Il s'agit du proposant initial d'un contrat d'achat pour le produit répertorié dans AWS Marketplace. Il peut s'agir de l'ISV ou d'un partenaire de distribution autorisé à revendre le produit.
Deux modèles de vente distincts déterminent si vous, en tant qu'ISV, agissez en tant que fabricant ou en tant que proposant. Votre rôle détermine les notifications que vous recevez EventBridge.
| Schéma de vente | Description | Le rôle de l'ISV |
|---|---|---|
| AWS Marketplace offre publique ou privée | Vous soumettez une offre ou un accord directement à l'acheteur. | À la fois fabricant et proposant |
| Offre privée du partenaire de distribution | Un partenaire de distribution autorisé à revendre votre produit propose une offre ou un accord à l'acheteur. | Fabricant |
EventBridge événements pour les produits SaaS
Lorsqu'une AWS Marketplace transaction a lieu, EventBridge envoie des événements à votre bus d'événements par défaut. Votre rôle en tant que fabricant ou fournisseur détermine les événements que vous recevez.
| Nom de l’événement | Initié par | Réponse | Destinataire |
|---|---|---|---|
|
Un nouvel accord est créé, un accord existant est remplacé ou un accord existant est renouvelé. | Le contrat d'achat est enregistré et des mesures après-vente sont prises. DescribeAgreement L'API est utilisée pour déterminer si le nouvel accord est un essai gratuit. |
Fabricant et proposeur |
|
Un accord existant est modifié. | Le dossier du contrat d'achat est modifié. | Fabricant et proposeur |
|
Un accord a expiré, est annulé, est résilié. | La clôture du contrat d'achat est enregistrée et des actions sont prises après l'annulation du contrat. L'ISV commence à révoquer les droits des clients. Pour les produits basés sur l'utilisation, l'ISV communique les enregistrements d'utilisation finaux avant que l'événement de déprovisionnement des licences ne soit envoyé et que la fenêtre de rapport ne soit fermée. | Fabricant et proposeur |
| Licence mise à jour - Fabricant | Le droit de l'acheteur à un produit a changé. | Les droits des clients sont vérifiés à l'aide de l'GetEntitlementsAPI et les services sont fournis en conséquence. |
Fabricant uniquement |
| Licence déprovisionnée - Fabricant | Le droit de l'acheteur à un produit a pris fin. | Les droits du client sont entièrement révoqués. | Fabricant uniquement |
Note
Les types d'événements liés au contrat d'achat pour le fabricant et le proposant sont presque identiques, à l'exception de la présence d'un identifiant d'autorisation de revente. Pour éviter les messages redondants, seul l'événement du contrat d'achat du proposant est envoyé lorsque vous êtes à la fois le fabricant et le proposant.
Pour plus d'informations sur la manière de répondre à ces notifications, consultez les rubriques suivantes :
Pour obtenir la liste complète des types d'événements et leurs schémas détaillés, consultez EventBridge Événements Amazon le Guide du vendeur.
Signaler l'utilisation finale avant le déprovisionnement de la licence
Pour les produits dotés d'un composant de facturation basé sur l'utilisation, AWS Marketplace donne aux vendeurs une heure pour soumettre les données d'utilisation finales des clients dont le contrat a pris fin. Après cette période, l'BatchMeterUsageAPI rejette l'utilisation signalée et vous ne pouvez pas facturer le client. Les événements suivants définissent le début et la fermeture de cette fenêtre :
-
AWS Marketplace envoie l'événement de fin du contrat d'achat à l'expiration du contrat et marque le début de la fenêtre de reporting final. Les vendeurs disposent d'une heure pour collecter toute utilisation non signalée pour le client et la signaler à l'aide de l'
BatchMeterUsageAPI. -
AWS Marketplace envoie l'événement de déprovisionnement de la licence lorsqu'il a complètement révoqué les droits du client et n'accepte plus les rapports d'utilisation.
Intégrez EventBridge à votre produit SaaS
EventBridge À utiliser pour intégrer vos opérations de provisionnement de locataires à votre annonce SaaS AWS sur Marketplace.
-
Les règles relatives aux événements définissent la manière de réagir à un événement. Ces règles peuvent réagir immédiatement ou selon un calendrier préétabli.
-
Les modèles d'événements sont définis dans les règles des événements et vous permettent de filtrer les types d'événements spécifiques envoyés à votre bus d'événements par défaut. Des modèles de modèles pour chaque type d'événement sont disponibles dans la EventBridge console. À l'étape de configuration du modèle d'événement, sélectionnez AWS services comme source d'événements et AWS Marketplace Agreements and Licenses comme AWS service.
-
Tous les types d'événements AWS Marketplace Agreements and Licenses utilisent la structure suivante.
{ "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"], "source": ["aws.agreement-marketplace"] } -
-
Les cibles sont des ressources qui reçoivent des événements lorsqu'ils correspondent au modèle d'événements défini pour une règle. De nombreux AWS services s'intègrent EventBridge et peuvent servir de cibles, notamment les fonctions Lambda, Step Functions et API Gateway.
Pour plus d'informations sur la configuration EventBridge des règles, consultez Getting started : Create an Amazon EventBridge Event Bus rule.