翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した Transfer Family イベントの管理 Amazon EventBridge
Amazon EventBridge は、イベントを使用してアプリケーションコンポーネントを接続するサーバーレスサービスです。これにより、スケーラブルなイベント駆動型アプリケーションを簡単に構築できます。イベント駆動型アーキテクチャは、イベントを出力して応答することで連携する疎結合ソフトウェアシステムを構築するスタイルです。イベントとは、リソースまたは環境で発生した変更を指します。
多くの AWS サービスと同様に、 はイベント Transfer Family を生成し、 EventBridge デフォルトのイベントバスに送信します。デフォルトのイベントバスはすべての AWS アカウントで自動的にプロビジョニングされることに注意してください。イベントバスは、イベントを受信するルーターであり、ゼロ個以上の送信先やターゲットに配信します。到着時にイベントを評価するイベントバスのルールを指定します。各ルールは、イベントがルールのイベントパターンに一致するかどうかをチェックします。イベントが一致した場合、イベントバスは 1 つ以上の指定されたターゲットにイベントを送信します。
トピック
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 プロトコルのファイルのアップロードに失敗しました。 |
|
|
FTPS プロトコルのファイルが正常にダウンロードされました。 |
|
|
FTPS プロトコルのファイルのダウンロードに失敗しました。 |
|
|
FTPS プロトコルのファイルが正常にアップロードされました。 |
|
|
FTPS プロトコルのファイルのアップロードに失敗しました。 |
|
|
SFTP プロトコルの ファイルが正常にダウンロードされました。 |
|
|
SFTP プロトコルのファイルのダウンロードに失敗しました。 |
|
|
SFTP プロトコルのファイルが正常にアップロードされました。 |
|
|
SFTP プロトコルのファイルのアップロードに失敗しました。 |
その他のファイルオペレーションイベント
| イベントの詳細のタイプ | 説明 |
|---|---|
|
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 コネクタイベント
注記
これらのイベントは、「Amazon EventBridge イベントリファレンス」のAWS 「サービスイベントの配信レベル」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 EventBridge
| イベントの詳細のタイプ | 説明 |
|---|---|
| コネクタからリモート SFTP サーバーへのファイル転送が正常に完了しました。 | |
| コネクタからリモート SFTP サーバーへのファイル転送に失敗しました。 | |
| リモート SFTP サーバーからコネクタへのファイル転送が正常に完了しました。 | |
| リモート SFTP サーバーからコネクタへのファイル転送に失敗しました。 | |
| 正常に完了した呼び出しを一覧表示する開始ファイルディレクトリ。 | |
| 失敗した開始ファイルディレクトリのリスト。 | |
| ファイルまたはディレクトリは、リモートサーバーで正常に移動または名前が変更されました。 | |
| ファイルまたはディレクトリをリモートサーバーで移動または名前変更できませんでした。 | |
| ファイルまたはディレクトリはリモートサーバーで正常に削除されました。 | |
| リモートサーバーでファイルまたはディレクトリを削除できませんでした。 |
AS2 イベント
注記
これらのイベントは、「Amazon EventBridge イベントリファレンス」のAWS 「サービスイベントの配信レベル」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 EventBridge
| イベントの詳細のタイプ | 説明 |
|---|---|
| AS2 メッセージのペイロードを受信しました。 | |
| AS2 メッセージのペイロードが受信されていません。 | |
| AS2 メッセージのペイロードが正常に送信されました。 | |
| AS2 メッセージのペイロードの送信に失敗しました。 | |
| AS2 メッセージのメッセージ処理通知を受信しました。 | |
| AS2 メッセージのメッセージ処理通知が受信されていません。 | |
| AS2 メッセージのメッセージ処理通知が正常に送信されました。 | |
| AS2 メッセージのメッセージ処理通知の送信に失敗しました。 |
EventBridge ルールを使用した Transfer Family イベントの送信
EventBridge デフォルトのイベントバスでターゲットに Transfer Family イベントを送信する場合は、目的のイベントのデータに一致する Transfer Family イベントパターンを含むルールを作成する必要があります。
Amazon EventBridge で AWS Transfer Family イベントをキャプチャするには
-
にサインイン AWS Management Console し、https://console.aws.amazon.com/events/
で Amazon EventBridge コンソールを開きます。 -
ナビゲーションペインで、ルールを選択し、ルールの作成を選択します。
-
ルールのわかりやすい名前を入力し、オプションで説明を入力します。
-
ルールタイプで、イベントパターンを持つルールを選択し、次へを選択します。
-
イベントソースセクションで、AWS イベントまたは EventBridge パートナーイベントを選択します。
-
作成方法セクションで、パターンフォームの使用を選択します。
-
イベントパターンセクションで、次の情報を入力します。
-
[イベントソース] で、[AWS のサービス] を選択してください。
-
AWS サービスの場合は、転送を選択します。
-
イベントタイプで、ルールをトリガーする Transfer Family イベントタイプを選択します。
イベントタイプの選択によっては、イベントタイプの仕様 1 セクションが表示される場合があります。
-
イベントタイプの仕様 1 セクションが表示された場合は、キャプチャする特定のイベントを選択します (または任意のイベントを選択して、選択したイベントタイプのすべてのイベントをキャプチャします)。
-
(オプション) イベントパターンエディタを使用して、イベントの詳細のフィルターを指定します。
-
[次へ] を選択します。
-
-
ターゲットの選択で使用可能な選択肢からターゲットを選択します。次の使用可能なターゲットから選択します。
-
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 ユーザーガイド」の「ターゲットの選択」を参照してください。
-
-
ターゲットに追加のオプションを設定し、次へを選択します。
-
(オプション) ルールにタグを追加し、次へを選択します。
-
確認および作成画面で、すべてが問題なく見える場合は、ルールの作成を選択します。
イベントの 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 を送信するサービスやその他の送信先を指定する方法については、「ターゲット」を参照してください。