を使用した 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 つ以上のターゲットが含まれるイベントバスにルールを作成できます。

ルールのイベントパターンに一致するイベントは、ベストエフォートベースまたは永続的なベースで指定されたターゲットに配信されます (一部のイベントは順不同で配信される可能性があることに注意してください)。これらの配信レベルについては、「Amazon EventBridge イベントリファレンス」の AWS 「サービスイベントの配信レベル」で説明されています。

  • SFTP、FTPS、FTP サーバーのサーバーレベルのイベントは、ベストエフォートベースで配信されます。

  • SFTP コネクタイベントは永続的に配信されます。

  • AS2 イベントは永続的に配信されます。

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

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

次の表は、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 プロトコルのファイルのアップロードに失敗しました。

その他のファイルオペレーションイベント

イベントの詳細のタイプ 説明

FTP サーバーディレクトリの作成が完了しました

FTP プロトコルのディレクトリが正常に作成されました。

FTP サーバーディレクトリの作成に失敗しました

FTP プロトコルのディレクトリの作成に失敗しました。

FTP サーバーディレクトリの削除が完了しました

FTP プロトコルのディレクトリが正常に削除されました。

FTP サーバーディレクトリの削除に失敗しました

FTP プロトコルのディレクトリの削除に失敗しました。

FTP サーバーファイルの削除が完了しました

FTP プロトコルのファイルが正常に削除されました。

FTP サーバーファイルの削除に失敗しました

FTP プロトコルのファイルの削除に失敗しました。

FTP サーバーファイルの名前変更が完了しました

FTP プロトコルのファイルの名前が正常に変更されました。

FTP サーバーファイルの名前変更に失敗しました

FTP プロトコルでファイルの名前を変更できませんでした。

FTPS サーバーディレクトリの作成が完了しました

FTPS プロトコルのディレクトリが正常に作成されました。

FTPS サーバーディレクトリの作成に失敗しました

FTPS プロトコルのディレクトリの作成に失敗しました。

FTPS サーバーディレクトリの削除が完了しました

FTPS プロトコルのディレクトリが正常に削除されました。

FTPS サーバーディレクトリの削除に失敗しました

FTPS プロトコルのディレクトリの削除に失敗しました。

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 コネクタイベント

注記

これらのイベントは、「Amazon EventBridge イベントリファレンス」のAWS 「サービスイベントの配信レベル」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 EventBridge

イベントの詳細のタイプ 説明

SFTP コネクタファイルの送信が完了しました

コネクタからリモート SFTP サーバーへのファイル転送が正常に完了しました。

SFTP コネクタファイルの送信に失敗しました

コネクタからリモート SFTP サーバーへのファイル転送に失敗しました。

SFTP コネクタファイルの取得が完了しました

リモート SFTP サーバーからコネクタへのファイル転送が正常に完了しました。

SFTP コネクタファイルの取得に失敗しました

リモート SFTP サーバーからコネクタへのファイル転送に失敗しました。

SFTP コネクタディレクトリの一覧表示が完了しました

正常に完了した呼び出しを一覧表示する開始ファイルディレクトリ。

SFTP コネクタディレクトリの一覧表示に失敗しました

失敗した開始ファイルディレクトリのリスト。

SFTP コネクタのリモート移動が完了しました

ファイルまたはディレクトリは、リモートサーバーで正常に移動または名前が変更されました。

SFTP コネクタのリモート移動に失敗しました

ファイルまたはディレクトリをリモートサーバーで移動または名前変更できませんでした。

SFTP コネクタのリモート削除が完了しました

ファイルまたはディレクトリはリモートサーバーで正常に削除されました。

SFTP コネクタのリモート削除に失敗しました

リモートサーバーでファイルまたはディレクトリを削除できませんでした。

AS2 イベント

注記

これらのイベントは、「Amazon EventBridge イベントリファレンス」のAWS 「サービスイベントの配信レベル」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 EventBridge

イベントの詳細のタイプ 説明

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 イベントパターンを含むルールを作成する必要があります。

Amazon EventBridge で AWS Transfer Family イベントをキャプチャするには
  1. にサインイン AWS Management Console し、https://console.aws.amazon.com/events/ で Amazon EventBridge コンソールを開きます。

  2. ナビゲーションペインで、ルールを選択し、ルールの作成を選択します。

  3. ルールのわかりやすい名前を入力し、オプションで説明を入力します。

  4. ルールタイプで、イベントパターンを持つルールを選択し、次へを選択します。

  5. イベントソースセクションで、AWS イベントまたは EventBridge パートナーイベントを選択します。

  6. 作成方法セクションで、パターンフォームの使用を選択します。

  7. イベントパターンセクションで、次の情報を入力します。

    1. [イベントソース] で、[AWS のサービス] を選択してください。

    2. AWS サービスの場合は、転送を選択します。

    3. イベントタイプで、ルールをトリガーする Transfer Family イベントタイプを選択します。

      イベントタイプの選択によっては、イベントタイプの仕様 1 セクションが表示される場合があります。

    4. イベントタイプの仕様 1 セクションが表示された場合は、キャプチャする特定のイベントを選択します (または任意のイベントを選択して、選択したイベントタイプのすべてのイベントをキャプチャします)。

    5. (オプション) イベントパターンエディタを使用して、イベントの詳細のフィルターを指定します。

    6. [次へ] を選択します。

  8. ターゲットの選択で使用可能な選択肢からターゲットを選択します。次の使用可能なターゲットから選択します。

    • AWS サービス。一般的なオプションは、サーバーレスコンピューティング用の Lambda 関数、メッセージ処理用の Amazon SQS キュー、通知用の Amazon SNS トピック、ワークフローのオーケストレーション AWS Step Functions です。

    • EventBridge API の送信先。の外部で HTTP エンドポイントにイベントを送信する場合は AWS、ターゲットとして API 送信先を使用できます。

    • EventBridge イベントバス。イベントは、同じアカウントとリージョン、または別のアカウントまたはリージョンの別のイベントバスに送信できます。

      イベントバスルールの詳細な作成方法については、「Amazon EventBridge ユーザーガイド」の「Creating rules that react to events」を参照してください。

    ターゲットの選択については、「Amazon EventBridge ユーザーガイド」の「ターゲットの選択」を参照してください。

  9. ターゲットに追加のオプションを設定し、次へを選択します。

  10. (オプション) ルールにタグを追加し、次へを選択します。

  11. 確認および作成画面で、すべてが問題なく見える場合は、ルールの作成を選択します。

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