API 送信先への CloudEvents イベントの送信

CloudEvents は、サービス、プラットフォーム、システム間の相互運用性を提供することを目的に、イベントフォーマットのベンダーに依存しない仕様です。を使用して EventBridge 、API送信先などのターゲットに送信される CloudEvents 前に、 AWS サービスイベントをに変換できます。

注記

次の手順では、ソースイベントを構造化モード CloudEventsに変換する方法について説明します。 CloudEvents 仕様では、構造化モードメッセージは、イベント全体 (属性とデータ) がイベントのペイロードにエンコードされるメッセージです。

CloudEvents 仕様の詳細については、cloudevents.io を参照してください。

コンソールを使用して AWS イベントを CloudEvents 形式に変換するには

イベントをターゲットへの配信前の CloudEvents 形式に変換するには、まずイベントバスルールを作成します。ルールの定義の一環として、指定したターゲットに送信する前に、入力トランスフォーマーを使用して EventBridge 変換イベントを設定します。

「Amazon のイベントに反応するルールの作成 EventBridge」のステップに従います。
ターゲットを選択するステップで、ターゲットタイプとしてAPI送信先を選択するように求められた場合：
1. EventBridge API 送信先 を選択します。
2. 次のいずれかを行います。
  - 既存のAPI送信先を使用 を選択し、既存のAPI送信先を選択します。
  - 新しいAPI送信先の作成を選択し、新しいAPI送信先を定義するために必要な設定を指定します。
    
    必要な設定の指定の詳細については、「」を参照してくださいAmazon でAPI送信先を作成する EventBridge。
3. CloudEvents イベントに必要な Content-Type ヘッダーパラメータを指定します。
  - 「ヘッダーパラメータ」で「ヘッダーパラメータを追加」を選択します。
  - キーには、を指定しますContent-Type。
    
    値には、を指定しますapplication/cloudevents+json; charset=UTF-8。
ターゲットの実行ロールを指定します。
ソースイベントデータを CloudEvents 形式に変換する入力トランスフォーマーを定義します。
1. 「追加設定」の「ターゲット入力の設定」で、「入力トランスフォーマー」を選択します。
  
  次に、入力トランスフォーマーの設定 を選択します。
2. ターゲット入力トランスフォーマー で、入力パス を指定します。
  
  以下の入力パスでは、region 属性は CloudEvents 形式のカスタム拡張属性です。そのため、 CloudEvents 仕様に準拠する必要はありません。
  
  CloudEvents では、コア仕様で定義されていない拡張属性を使用および作成できます。既知の拡張属性のリストを含む詳細については、「」のCloudEvents 仕様ドキュメントのCloudEvents 「拡張属性」を参照してください GitHub。
```
{
  "detail": "$.detail",
  "detail-type": "$.detail-type",
  "id": "$.id",
  "region": "$.region",
  "source": "$.source",
  "time": "$.time"
}
```
3. テンプレートには、ソースイベントデータを CloudEvents 形式に変換するテンプレートを入力します。
  
  以下のテンプレートでは、入力パスの region 属性regionは CloudEvents 仕様の拡張属性であるため、は厳密に必須ではありません。
```
{
  "specversion":"1.0",
  "id":<id>,
  "source":<source>,
  "type":<detail-type>,
  "time":<time>,
  "region":<region>,
  "data":<detail>
}
```
手順のステップに従ってルールの作成を完了します。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

API 送信先ターゲットを使用したルールの作成

API 送信先パートナー