翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Marketplace 契約 EventBridge イベント
AWS Marketplace は、契約のライフサイクル (つまり、購入したオファー) で特定のイベントが発生すると、Amazon EventBridge に通知を送信します。これらのイベントを使用してワークフローを自動化し、マーケットプレイスの購入を追跡できます。
次の表に、 が EventBridge AWS Marketplace に送信する購入者イベントを示します。
| [Event] (イベント) | 説明 |
|---|---|
| 購入契約の作成 - アクセプタ | アカウントで新しい購入契約を作成、更新、または置き換えたときに送信されます。 |
| 購入契約の修正 - アクセプタ | 既存の購入契約に変更が加えられたときに送信されます |
| 購入契約の終了 - アクセプタ | 購入契約がキャンセル、期限切れ、終了、更新、または置き換えられたときに送信されます |
概要:
購入者は、以下の購入契約のライフサイクルイベントに関する EventBridge 通知を受け取ります。
契約の作成
契約の修正
契約の終了 (キャンセル、有効期限、終了)
すべてのイベントは、イベントソース を使用して us-east-1リージョンのデフォルトの EventBridge イベントバスに送信されますaws.agreement-marketplace。
イベントタイプ
購入契約の作成 - アクセプタ
AWS Marketplace は、アカウントに新しい購入契約が作成されると、このイベントを送信します。
トリガーシナリオ:
NEW- 契約が初めて作成されるREPLACE- 新しいプライベートオファーは、契約ベースのオファー (ABO) の一部として承諾する必要がありますRENEW- 契約の有効期限が切れると自動的に更新されます (有効になっている場合)
イベントスキーマ:
{ "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" } } }
購入契約の修正 - アクセプタ
AWS Marketplace は、条件、料金、その他の契約パラメータの変更など、既存の購入契約に変更が加えられたときに、このイベントを送信します。
イベントスキーマ:
{ "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" }, "acceptor": { "accountId": "<Buyer Account ID>" }, "proposer": { "accountId": "<Proposer Account ID>" }, "offer": { "id": "offer-1234567890123" } } }
購入契約の終了 - アクセプタ
AWS Marketplace 購入契約が終了すると、 はこのイベントを送信します。
トリガーシナリオ:
CANCELLED- 定義された終了日より前に契約を終了したEXPIRED- 契約が定義された終了日に達したTERMINATED- 契約を AWS 終了した (支払いの失敗など)RENEWED- 契約が新しい契約に更新されましたREPLACED- 契約は契約代替オファーを使用して置き換えられました
イベントスキーマ:
{ "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" } } }
一般的なイベントフィールド
すべての購入者イベントには、次の共通フィールドが含まれます。
| フィールド | 説明 |
|---|---|
requestId |
重複イベントの重複排除に使用される UUID |
catalog |
AWS Marketplace カタログ (通常はAWSMarketplace」) |
agreementId |
契約の一意の識別子 |
acceptor.accountId |
AWS アカウント ID |
proposer.accountId |
販売者の AWS アカウント ID |
offer.id |
オファー識別子 |
EventBridge ルールの設定
これらの通知を受信するには、購入者イベントのイベントパターンに一致する EventBridge ルールを作成します。ルールの作成の詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge ルールの作成」を参照してください。 EventBridge