翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
を使用した Transfer Family イベントの管理 Amazon EventBridge
Amazon EventBridge は、イベントを使用してアプリケーションコンポーネントを接続できるサーバーレスサービスです。これにより、スケーラブルなイベント駆動型アプリケーションを簡単に構築できます。イベント駆動型アーキテクチャは、イベントを発信して応答することで連携する、疎結合されたソフトウェアシステムを構築するスタイルです。イベントとは、リソースまたは環境で発生した変更を指します。
多くの AWS サービスと同様に、 はイベント Transfer Family を生成し、 EventBridge デフォルトのイベントバスに送信します。デフォルトのイベントバスは、すべての AWS アカウントで自動的にプロビジョニングされることに注意してください。イベントバスは、イベントを受信するルーターであり、ゼロ個以上の送信先やターゲットに配信します。イベントバスのルールを指定して、イベントが到着したときに評価します。各ルールは、イベントがルールのイベントパターンに一致するかどうかをチェックします。イベントが一致した場合、イベントバスは 1 つ以上の指定されたターゲットにイベントを送信します。
トピック
Transfer Family イベント
Transfer Family は、デフォルトのイベントバスに EventBridge イベントを自動的に送信します。各ルールにイベントパターンと 1 つ以上のターゲットが含まれるイベントバスにルールを作成できます。ルールのイベントパターンに一致するイベントは、ベストエフォートベースで指定されたターゲットに配信されますが、一部のイベントは順序どおりに配信されない場合があります。
次のイベントは によって生成されます Transfer Family。詳細については、「 ユーザーガイド」のEventBridge 「イベント」を参照してください。 Amazon EventBridge
SFTP、FTPS、および FTPサーバーイベント
イベントの詳細のタイプ | 説明 |
---|---|
FTP プロトコルのファイルが正常にダウンロードされました。 |
|
FTP プロトコルのファイルのダウンロードに失敗しました。 |
|
FTP プロトコルのファイルが正常にアップロードされました。 |
|
FTP プロトコルのファイルのアップロードに失敗しました。 |
|
FTPS プロトコルのファイルが正常にダウンロードされました。 |
|
FTPS プロトコルのファイルのダウンロードに失敗しました。 |
|
FTPS プロトコルのファイルが正常にアップロードされました。 |
|
FTPS プロトコルのファイルのアップロードに失敗しました。 |
|
SFTP プロトコルのファイルが正常にダウンロードされました。 |
|
SFTP プロトコルのファイルのダウンロードに失敗しました。 |
|
SFTP プロトコルのファイルが正常にアップロードされました。 |
|
SFTP プロトコルのファイルのアップロードに失敗しました。 |
SFTP コネクタイベント
イベントの詳細のタイプ | 説明 |
---|---|
コネクタからリモートSFTPサーバーへのファイル転送が正常に完了しました。 | |
コネクタからリモートSFTPサーバーへのファイル転送に失敗しました。 | |
リモートSFTPサーバーからコネクタへのファイル転送が正常に完了しました。 | |
リモートSFTPサーバーからコネクタへのファイル転送に失敗しました。 |
A2S イベント
イベントの詳細のタイプ | 説明 |
---|---|
AS2 メッセージのペイロードを受信しました。 | |
AS2 メッセージのペイロードが受信されていません。 | |
AS2 メッセージのペイロードが正常に送信されました。 | |
AS2 メッセージのペイロードの送信に失敗しました。 | |
メッセージのメッセージ処理通知を受信AS2しました。 | |
メッセージのメッセージ処理通知が受信AS2されていません。 | |
メッセージのメッセージ処理通知AS2が正常に送信されました。 | |
メッセージのメッセージ処理通知の送信AS2に失敗しました。 |
EventBridge ルールを使用した Transfer Family イベントの送信
EventBridge デフォルトのイベントバスがターゲットに Transfer Family イベントを送信する場合は、目的の Transfer Family イベントのデータに一致するイベントパターンを含むルールを作成する必要があります。
ルールを作成するには、次の一般的なステップを実行します。
以下を指定するルールのイベントパターンを作成します。
Transfer Family は、ルールによって評価されるイベントのソースです。
(オプション) 照合するその他のイベントデータ。
詳細については、「イベントの Transfer Family イベントパターンの作成」を参照してください。
(オプション) がルールのターゲットに情報 EventBridge を送信する前に、イベントからデータをカスタマイズする入力トランスフォーマーを作成します。
詳細については、「EventBridge ユーザーガイド」の「Amazon EventBridge 入力変換」を参照してください。
イベントパターンに一致するイベント 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 を送信するサービスやその他の送信先を指定する方法については、「ターゲット」を参照してください。