を使用した 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 ダウンロードを照合します。

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