翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
Amazon EventBridge を使用した SaaS サブスクリプションイベントの管理
Amazon EventBridge を使用して、SaaS 製品を と統合および管理できます AWS Marketplace。イベントは、製品の顧客のサブスクリプションと契約エンタイトルメントの変更のために送信されます。顧客がサブスクライブしたとき、使用権限が変更されたとき、キャンセルしたときに通知を受け取るため、アクセスを許可または取り消すタイミングを正確に把握できます。これらのイベントは 2 つの主要なロールを提供します。
-
製造元 – これは、独立系ソリューションベンダー (ISV) とも呼ばれ AWS Marketplaceる、 のリストの元の製品製造元です。
-
提案者 – これは、リストされている製品の購入契約の元の提案者です AWS Marketplace。これは、ISV または製品の再販を認可されたチャネルパートナーのいずれかです。
2 つの異なる販売パターンによって、ISV として製造元または提案者として行動するかどうかが決まります。ロールによって、EventBridge を介して受信する通知が決まります。
| 販売パターン | 説明 | ISV のロール |
|---|---|---|
| AWS Marketplace パブリックオファーまたはプライベートオファー | オファーまたは契約を購入者に直接延長します。 | 製造元と提案者の両方 |
| チャネルパートナーのプライベートオファー | 製品の再販を許可されたチャネルパートナーは、購入者にオファーまたは契約を延長します。 | Manufacturer |
SaaS 製品の EventBridge イベント
AWS Marketplace トランザクションが発生すると、EventBridge はデフォルトのイベントバスにイベントを送信します。メーカーまたは提案者としてのロールによって、受け取るイベントが決まります。
| イベント名 | によって開始 | 応答 | 受取人 |
|---|---|---|---|
|
新しい契約が作成されるか、既存の契約が置き換えられるか、既存の契約が更新されます。 | 購入契約が記録され、販売後のアクションが実行されます。 DescribeAgreementAPI は、新しい契約が無料トライアルかどうかを判断するために使用されます。 |
製造元と提案者 |
|
既存の契約が修正されました。 | 購入契約レコードが修正されました。 | 製造元と提案者 |
|
契約の有効期限が切れ、キャンセルされ、終了します。 | 購入契約の終了が記録され、契約後のキャンセルアクションが発生します。ISV は顧客エンタイトルメントの取り消しを開始します。 | 製造元と提案者 |
| ライセンスの更新 - 製造元 | 購入者の製品の使用権限が変更されました。 | お客様の使用権限は GetEntitlements API を使用してチェックされ、サービスはそれに応じてプロビジョニングされます。 |
製造元のみ |
| ライセンスのプロビジョニング解除 - 製造元 | 製品に対する購入者の使用権限が終了しました。 | 使用量ベースの製品の場合、このイベントは 1 時間の最終レポートウィンドウの開始をマークします。販売者は、 BatchMeterUsage API を使用して未報告の使用状況を収集して報告する必要があります。このウィンドウが終了すると、顧客エンタイトルメントは完全に取り消され、使用状況レポートは受け入れられなくなります。 |
製造元のみ |
注記
製造元と提案者の購入契約イベントタイプは、resaleAuthorization ID の存在を除いてほぼ同じです。冗長なメッセージを避けるために、プロポーサー購入契約イベントは、お客様が製造元とプロポーサーの両方である場合にのみ送信されます。
イベントタイプとその詳細なスキーマの完全なリストについては、「 販売者ガイドAmazon EventBridge イベント」の「」を参照してください。
使用状況ベースの製品の最終使用状況レポートウィンドウ
使用量ベースの請求コンポーネントを持つ製品の場合、 AWS Marketplace は、使用権限が終了した顧客の最終的な使用記録を送信する 1 時間を販売者に提供します。この期間を過ぎると、BatchMeterUsageAPI は報告された使用量を拒否し、顧客に請求することはできません。
AWS Marketplace は、ライセンスのプロビジョニング解除 - 製造元イベントを送信して、最終レポートウィンドウの開始を通知します。販売者は、このイベントを受け取ってから 1 時間後に、顧客の未報告の使用状況を収集し、 BatchMeterUsage API を使用して報告します。
1 時間のウィンドウが終了すると、 AWS Marketplace はお客様の使用権限を完全に取り消し、使用状況レポートを受け入れなくなります。
EventBridge を SaaS 製品と統合する
EventBridge を使用して、テナントプロビジョニングオペレーションを AWS Marketplace の SaaS 出品と統合します。
-
イベントルールは、イベントへの対応方法を定義します。これらのルールは、すぐに、または設定されたスケジュールで対応できます。
-
イベントパターンはイベントルールで定義され、デフォルトのイベントバスに送信される特定のイベントタイプをフィルタリングできます。各イベントタイプのパターンテンプレートは、EventBridge コンソールで使用できます。イベントパターン設定ステップで、イベントソースとして AWS サービスを選択し、 AWS サービスとして AWS Marketplace 契約とライセンスを選択します。
-
すべての AWS Marketplace 契約およびライセンスイベントタイプは、次の構造を使用します。
{ "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"], "source": ["aws.agreement-marketplace"] } -
-
ターゲットは、ルールに定義されたイベントパターンと一致するときにイベントを受信するリソースです。多くの AWS サービスは EventBridge と統合され、Lambda 関数、Step Functions、API Gateway などのターゲットとして機能します。
EventBridge ルールの設定の詳細については、「開始方法: Amazon EventBridge イベントバスルールを作成する」を参照してください。
