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

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

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

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

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

AWS サービスは EventBridge 、デフォルトのイベントバスにイベントを送信します。イベントがルールのイベントパターンと一致する場合、 はそのルールに指定されたターゲットにイベント EventBridge を送信します。

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サーバーからコネクタへのファイル転送に失敗しました。

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ダウンロードと一致します username:

{ "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 を送信するサービスやその他の送信先を指定する方法については、「ターゲット」を参照してください。