翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon EventBridge によるコンテナ契約イベントの管理
<a name="container-eventbridge-integration"></a>

Amazon EventBridge を使用して、コンテナ製品の顧客契約の変更に関する通知を受け取ることができます AWS Marketplace。イベントは契約ライフサイクルの変更のために送信されるため、顧客がいつサブスクライブ、修正、またはキャンセルするかを追跡できます。これらのイベントは 2 つの主要なロールを提供します。
+ **製造元** – チャネルパートナー再販 (CPPO) 協定の元の製品製造元 (ISV)。
+ **提案者** – 購入者にオファーを直接延長する当事者。これは直接オファーの ISV、または CPPO オファーのチャネルパートナーです。

2 つの異なる販売パターンによって、ISV として製造元または提案者として行動するかどうかが決まります。ロールによって、EventBridge を介して受信する通知が決まります。


| 販売パターン | 説明 | ISV のロール | 
| --- | --- | --- | 
| AWS Marketplace パブリックオファーまたはプライベートオファー | オファーまたは契約を購入者に直接延長します。 | 製造元と提案者の両方 | 
| チャネルパートナーのプライベートオファー | 製品の再販を許可されたチャネルパートナーは、購入者にオファーまたは契約を延長します。 | Manufacturer | 

## コンテナ製品の EventBridge イベント
<a name="container-eventbridge-event-types"></a>

 AWS Marketplace トランザクションが発生すると、EventBridge はデフォルトのイベントバスにイベントを送信します。メーカーまたは提案者としてのロールによって、受け取るイベントが決まります。


| イベント名 | 起動手段 | [応答] | 受取人 | 
| --- | --- | --- | --- | 
| 購入契約の作成 - 製造元/購入契約の作成 - 提案者 | 新しい契約が作成されるか、既存の契約が置き換えられるか、既存の契約が更新されます。 | 購入契約が記録され、販売後のアクションが実行されます。DescribeAgreement API を使用して、完全な契約の詳細を取得します。 | 製造元と提案者 | 
| 購入契約の修正 - 製造元/購入契約の修正 - 提案者 | 既存の契約が修正されました。 | 購入契約レコードが更新されました。 | 製造元と提案者 | 
| 購入契約の終了 - 製造元/購入契約の終了 - 提案者 | 契約の有効期限が切れた、キャンセルされた、または終了された。 | 購入契約の終了が記録されます。 | 製造元と提案者 | 
| ライセンスの更新 - 製造元 | 製品のお客様のライセンスがプロビジョニングまたは更新されました。 | 顧客の現在のライセンス状態を反映するように内部レコードを更新します。 | 製造元のみ | 
| ライセンスのプロビジョニング解除 - 製造元 | 製品のお客様のライセンスが取り消されています。 | 内部レコードを更新して、顧客がアクティブなライセンスを失ったことを反映させます。 | 製造元のみ | 

**注記**  
ライセンスイベントは、ライセンスが関連付けられているコンテナ契約に対してのみ送信されます。  
AWS はコンテナ製品の計測を自動的に処理します。顧客の資格を満たすために、これらのイベントに応じてアクションを実行する必要はありません。ライセンスイベントを使用して、内部レコードを顧客のアクティブなライセンス状態に合わせて最新の状態に保ちます。

**注記**  
製造元と提案者の購入契約イベントタイプは、resaleAuthorization ID の存在を除いてほぼ同じです。冗長なメッセージを避けるために、プロポーサー購入契約イベントは、お客様が製造元とプロポーサーの両方である場合にのみ送信されます。

イベントタイプとその詳細なスキーマの完全なリストについては、「 販売者ガイド[Amazon EventBridge イベント](notifications-eventbridge.md)」の「」を参照してください。

## EventBridge をコンテナ製品と統合する
<a name="container-eventbridge-using"></a>

EventBridge を使用して、コンテナリストの契約ライフサイクルイベントを追跡します AWS Marketplace。
+ **イベントルール**は、イベントへの対応方法を定義します。
+ **イベントパターン**はイベントルールで定義され、デフォルトのイベントバスに送信される特定のイベントタイプをフィルタリングできます。各イベントタイプのパターンテンプレートは、EventBridge コンソールで使用できます。イベントパターン設定ステップで、イベントソースとして AWS サービスを選択し、 AWS サービスとして AWS Marketplace 契約とライセンスを選択します。
+ すべての AWS Marketplace 契約およびライセンスイベントタイプは、次の構造を使用します。

  ```
  {
    "detail-type": ["e.g. Purchase Agreement Ended - Manufacturer"],
    "source": ["aws.agreement-marketplace"]
  }
  ```
+ **ターゲット**は、ルールに定義されたイベントパターンと一致するときにイベントを受信するリソースです。多くの AWS サービスは EventBridge と統合され、 AWS Lambda 関数や AWS Step Functions Amazon API Gateway などのターゲットとして使用できます。

EventBridge ルールの設定の詳細については、[「開始方法: Amazon EventBridge イベントバスルールを作成する](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-get-started.html)」を参照してください。