翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 は顧客エンタイトルメントの取り消しを開始します。 | 製造元と提案者 |
| 購入契約アドバイザリ発行 - 製造元 | AWS は、本契約を無効にする可能性のあるアドバイザリを発行しました。このアラートをトリガーできる条件には、購入者アカウントの閉鎖、侵害、不正使用、または不正が含まれます。 | AWS は、この契約に影響する問題を特定しました。この問題は、請求またはサービスへのアクセスに影響する可能性があります。購入者に直接連絡し、アクセスを変更するかどうかを評価します。 | 製造元のみ |
| 購入契約アドバイザリの解決 - 製造元 | AWS は、この契約に影響を与えていた問題を解決しました。 | AWS は、この契約に影響する問題を解決しました。購入者のサブスクリプションまたはアクセスに変更を加えた場合は、任意で復元できます。 | 製造元のみ |
| ライセンスの更新 - 製造元 | 購入者の製品の使用権限が変更されました。 | お客様の使用権限は GetEntitlements API を使用してチェックされ、サービスはそれに応じてプロビジョニングされます。 |
製造元のみ |
| ライセンスのプロビジョニング解除 - 製造元 | 製品に対する購入者の使用権限が終了しました。 | 使用量ベースの製品の場合、このイベントは 1 時間の最終レポートウィンドウの開始をマークします。販売者は、 BatchMeterUsage API を使用して未報告の使用状況を収集して報告する必要があります。このウィンドウが終了すると、顧客エンタイトルメントは完全に取り消され、使用状況レポートは受け入れられなくなります。 |
製造元のみ |
| 支出しきい値に達しました | SaaS pay-as-you-go制製品に対する購入者の累積支出が支出しきい値に達し、購入者のカードで支払い検証 (獣医) AWS Marketplace を開始しました。 | 情報。アクションは必要ありません。 AWS Marketplace は購入者の支払い能力を検証しています。Spend Threshold Vet Succeeded または Spend Threshold Vet Failed イベントを待機します。 | 製造元と提案者 |
| 支出しきい値の獣医が成功しました | 購入者のカードの支払い検証に合格し、支出しきい値サイクルがリセットされました。 | 情報。アクションは必要ありません。購入者の支払い方法 AWS Marketplace を検証しました。 | 製造元と提案者 |
| 支出しきい値獣医の失敗 | 購入者のカードの支払い検証に失敗しました。 | AWS Marketplace は購入者の支払い方法を検証できませんでした。 AWS Marketplace は検証を再試行します。 | 製造元と提案者 |
Spend Threshold Reached、Spend Threshold Vet Succeeded、Spend Threshold Vet Failed イベントは、使用量ベースの (pay-as-you-go) 料金の SaaS 製品にのみ適用されます。 AWS Marketplace は、契約のみまたはサブスクリプション料金の SaaS 製品に対してこれらのイベントを送信しません。
注記
製造元と提案者の購入契約イベントタイプは、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 イベントバスルールを作成する」を参照してください。
