を使用した Transfer Family イベントの管理 Amazon EventBridge

Amazon EventBridge は、イベントを使用してアプリケーションコンポーネントを接続できるサーバーレスサービスです。これにより、スケーラブルなイベント駆動型アプリケーションを簡単に構築できます。イベント駆動型アーキテクチャは、イベントを発行して応答することで連携する疎結合ソフトウェアシステムを構築するスタイルです。イベントとは、リソースまたは環境で発生した変更を指します。

多くの AWS サービスと同様に、 はイベント Transfer Family を生成し、 EventBridge デフォルトのイベントバスに送信します。デフォルトのイベントバスはすべての AWS アカウントで自動的にプロビジョニングされることに注意してください。イベントバスは、イベントを受信するルーターであり、ゼロ個以上の送信先やターゲットに配信します。イベントバスのルールを指定して、イベントが到着したときに評価します。各ルールは、イベントがルールのイベントパターンに一致するかどうかをチェックします。イベントが一致すると、イベントバスは 1 つ以上の指定されたターゲットにイベントを送信します。

トピック

• Transfer Family イベント
• EventBridge ルールを使用した Transfer Family イベントの送信
• Amazon EventBridge アクセス許可
• その他の EventBridge リソース
• Transfer Family イベント詳細リファレンス

Transfer Family イベント

Transfer Family は、デフォルトのイベントバスに EventBridge イベントを自動的に送信します。各ルールにイベントパターンと 1 つ以上のターゲットが含まれるイベントバスにルールを作成できます。ルールのイベントパターンに一致するイベントは、ベストエフォートベースで指定されたターゲットに配信されますが、一部のイベントは順不同で配信される場合があります。

次のイベントは によって生成されます Transfer Family。詳細については、「 ユーザーガイド」の「 EventBridge イベントAmazon EventBridge 」を参照してください。

SFTP、FTPS、および FTP サーバーイベント

イベントの詳細のタイプ	説明
FTP ファイルサーバーのダウンロードが完了しました	FTP プロトコルのファイルが正常にダウンロードされました。
FTP ファイルサーバーのダウンロードに失敗しました	FTP プロトコルでファイルのダウンロードに失敗しました。
FTP ファイルサーバーのアップロードが完了しました	FTP プロトコルのファイルが正常にアップロードされました。
FTP ファイルサーバーのアップロードに失敗しました	FTP プロトコルでファイルのアップロードに失敗しました。
FTPS ファイルサーバーのダウンロードが完了しました	FTPS プロトコルのファイルが正常にダウンロードされました。
FTPS ファイルサーバーのダウンロードに失敗しました	FTPS プロトコルでファイルのダウンロードに失敗しました。
FTPS ファイルサーバーのアップロードが完了しました	FTPS プロトコルのファイルが正常にアップロードされました。
FTPS ファイルサーバーのアップロードに失敗しました	FTPS プロトコルでファイルのアップロードに失敗しました。
SFTP サーバーファイルのダウンロードが完了しました	SFTP プロトコルのファイルが正常にダウンロードされました。
SFTP サーバーファイルのダウンロードに失敗しました	SFTP プロトコルでファイルのダウンロードに失敗しました。
SFTP サーバーファイルのアップロードが完了しました	SFTP プロトコルのファイルが正常にアップロードされました。
SFTP サーバーファイルのアップロードに失敗しました	SFTP プロトコルでファイルのアップロードに失敗しました。

SFTP コネクタイベント

イベントの詳細のタイプ	説明
SFTP コネクタファイルの送信が完了しました	コネクタからリモート SFTP サーバーへのファイル転送が正常に完了しました。
SFTP コネクタファイルの送信に失敗しました	コネクタからリモート SFTP サーバーへのファイル転送が失敗しました。
SFTP コネクタファイルの取得が完了しました	リモート SFTP サーバーからコネクタへのファイル転送が正常に完了しました。
SFTP コネクタファイルの取得に失敗しました	リモート SFTP サーバーからコネクタへのファイル転送が失敗しました。
SFTP コネクタディレクトリの一覧表示が完了しました	正常に完了した呼び出しを一覧表示する開始ファイルディレクトリ。
SFTP コネクタディレクトリの一覧表示に失敗しました	失敗した開始ファイルディレクトリのリスト。

A2S イベント

イベントの詳細のタイプ	説明
AS2 ペイロード受信完了	AS2 メッセージのペイロードが受信されました。
AS2 ペイロード受信失敗	AS2 メッセージのペイロードが受信されていません。
AS2 ペイロードの送信が完了しました	AS2 メッセージのペイロードが正常に送信されました。
AS2 ペイロードの送信に失敗しました	AS2 メッセージのペイロードの送信に失敗しました。
AS2 MDN 受信完了	AS2 メッセージのメッセージ処理通知を受信しました。
AS2 MDN 受信失敗	AS2 メッセージのメッセージ処理通知が受信されていません。
AS2 MDN 送信が完了しました	AS2 メッセージのメッセージ処理通知が正常に送信されました。
AS2 MDN 送信失敗	AS2 メッセージのメッセージ処理通知の送信に失敗しました。

EventBridge ルールを使用した Transfer Family イベントの送信

EventBridge デフォルトのイベントバスでターゲットに Transfer Family イベントを送信する場合は、目的のイベント内のデータに一致する Transfer Family イベントパターンを含むルールを作成する必要があります。

ルールを作成するには、以下の一般的なステップに従います。

1. 以下を指定するルールのイベントパターンを作成します。

   • Transfer Family は、ルールによって評価されるイベントのソースです。

   • （オプション) 照合するその他のイベントデータ。

   詳細については、「イベントの Transfer Family イベントパターンの作成」を参照してください。

2. （オプション) がルールのターゲットに情報 EventBridge を送信する前に、イベントからのデータをカスタマイズする入力トランスフォーマーを作成します。

   詳細については、「EventBridge ユーザーガイド」の「Amazon EventBridge 入力変換」を参照してください。

3. イベントパターンに一致するイベントを配信 EventBridge するターゲットを指定します。

   ターゲットは、他の AWS のサービス、Software as a Service (SaaS) アプリケーション、API 送信先、またはその他のカスタムエンドポイントです。詳細については、EventBridge ユーザーガイドのターゲットを参照してください。

イベントバスルールの詳細な作成方法については、「EventBridge ユーザーガイド」の「イベントに反応する Amazon EventBridge ルールの作成」を参照してください。

イベントの Transfer Family イベントパターンの作成

Transfer Family がデフォルトのイベントバスにイベントを配信する場合、 は各ルールに定義されたイベントパターン EventBridge を使用して、イベントをルールのターゲットに配信する必要があるかどうかを判断します。イベントパターンは、目的の Transfer Family イベントのデータに一致します。各イベントパターンは、以下を含む JSON オブジェクトです。

• イベントを送信するサービスを識別する source 属性。 Transfer Family イベントの場合、ソースは ですaws.transfer。

• （オプション) 一致するイベントタイプの配列を含むdetail-type属性。

• （オプション) 一致する他のイベントデータを含むdetail属性。

例えば、次のイベントパターンは、 からのすべてのイベントに一致します Transfer Family。

{
  "source": ["aws.transfer"]
}

次のイベントパターンの例は、すべての SFTP コネクタイベントに一致します。

{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed",
                  "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"]
}

次のイベントパターンの例では、Transfer Family で失敗したすべてのイベントに一致します。

{
  "source": ["aws.transfer"],
  "detail-type": [{"wildcard", "*Failed"}]
}

次のイベントパターンの例では、ユーザーユーザー名 の正常な SFTP ダウンロードに一致します。

{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Server File Download Completed"],
  "detail": {
    "username": [username]
  }
}

詳細については、「EventBridge ユーザーガイド」の「Amazon EventBridge のイベントパターン」を参照してください。

でのイベントの Transfer Family イベントパターンのテスト EventBridge

EventBridge サンドボックスを使用すると、ルールを作成または編集するより広範なプロセスを完了することなく、イベントパターンをすばやく定義してテストできます。サンドボックスを使用すると、イベントパターンを定義し、サンプルイベントを使用して、そのパターンが目的のイベントと一致することを確認できます。 は、サンドボックスから直接そのイベントパターンを使用して新しいルールを作成するオプション EventBridge を提供します。

詳細については、「 ユーザーガイド」の EventBridge 「サンドボックスを使用したイベントパターンのテストEventBridge 」を参照してください。

Amazon EventBridge アクセス許可

Transfer Family は、 にイベントを配信するための追加のアクセス許可を必要としません Amazon EventBridge。

指定するターゲットには、特定のアクセス許可または設定が必要になる場合があります。ターゲットに特定のサービスを使用する方法の詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge ターゲット」を参照してください。

その他の EventBridge リソース

EventBridge を使用してイベントを処理および管理する方法の詳細については、Amazon EventBridge 「 ユーザーガイド」の以下のトピックを参照してください。

• イベントバスの仕組みに関する詳細は、「Amazon EventBridge イベントバス」を参照してください。

• イベント構造については、「Amazon EventBridge イベント」を参照してください。

• ルールとイベントを照合するときに EventBridge 使用する のイベントパターンの構築については、「イベントパターン」を参照してください。

• EventBridge が処理するイベントを指定するルールの作成方法については、「Amazon EventBridge ルール」を参照してください。

• が一致するイベント EventBridge を送信するサービスやその他の送信先を指定する方法については、「ターゲット」を参照してください。