翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# を使用した Transfer Family イベントの管理 Amazon EventBridge
Amazon EventBridge は、イベントを使用してアプリケーションコンポーネントを接続するサーバーレスサービスです。これにより、スケーラブルなイベント駆動型アプリケーションを簡単に構築できます。イベント駆動型アーキテクチャとは、イベントの発信と応答によって連携する、ゆるやかに結合されたソフトウェアシステムを構築するスタイルです。イベントとは、リソースまたは環境で発生した変更を指します。
多くの AWS サービスと同様に、 はイベント Transfer Family を生成し、 EventBridge デフォルトのイベントバスに送信します。デフォルトのイベントバスはすべての AWS アカウントで自動的にプロビジョニングされることに注意してください。イベントバスは、イベントを受信して、ゼロ個以上の送信先 (*ターゲット*) に配信するルーターです。到着時にイベントを評価するイベントバスのルールを指定します。各ルールは、イベントがルールの*イベントパターン*に一致するかどうかをチェックします。イベントが一致した場合、イベントバスは 1 つ以上の指定されたターゲットにイベントを送信します。
![\[AWS サービスは EventBridge 、デフォルトのイベントバスにイベントを送信します。イベントがルールのイベントパターンと一致する場合、 はそのルールに指定されたターゲットにイベント EventBridge を送信します。\]](http://docs.aws.amazon.com/ja_jp/transfer/latest/userguide/images/eventbridge-integration-how-it-works.png)
**Topics**
+ [Transfer Family イベント](#supported-events)
+ [EventBridge ルールを使用した Transfer Family イベントの送信](#eventbridge-using-events-rules)
+ [Amazon EventBridge アクセス許可](#eventbridge-permissions)
+ [その他の EventBridge リソース](#eventbridge-additonal-resources)
+ [Transfer Family イベント詳細リファレンス](events-detail-reference.md)
## Transfer Family イベント
Transfer Family は、デフォルトのイベントバスに EventBridge イベントを自動的に送信します。各ルールにイベントパターンと 1 つ以上のターゲットが含まれるイベントバスにルールを作成できます。
ルールのイベントパターンに一致するイベントは、*ベストエフォー*トベースまたは*永続的*なベースで指定されたターゲットに配信されます (一部のイベントは順不同で配信される可能性があることに注意してください）。これらの配信レベルについては、*「Amazon EventBridge イベントリファレンス*」の[AWS 「サービスイベントの配信レベル](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)」で説明されています。
+ SFTP、FTPS、FTP サーバーのサーバーレベルのイベントは、ベストエフォートベースで配信されます。
+ SFTP コネクタイベントは永続的に配信されます。
+ AS2 イベントは永続的に配信されます。
次のイベントは によって生成されます Transfer Family。詳細については、「*Amazon EventBridge ユーザーガイド*」の「[EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。
### SFTP、FTPS、および FTP サーバーイベント
次の表は、SFTP、FTPS、FTP サーバーのイベントをイベントタイプ別にまとめたものです。
**ファイルのアップロードおよびダウンロードイベント**
| イベントの詳細のタイプ | 説明 |
| --- | --- |
| [FTP サーバーファイルのダウンロードが完了しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルの ファイルが正常にダウンロードされました。 |
| [FTP サーバーファイルのダウンロードに失敗しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのファイルのダウンロードに失敗しました。 |
| [FTP サーバーファイルのアップロードが完了しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのファイルが正常にアップロードされました。 |
| [FTP サーバーファイルのアップロードに失敗しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのファイルのアップロードに失敗しました。 |
| [FTPS サーバーファイルのダウンロードが完了しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルが正常にダウンロードされました。 |
| [FTPS サーバーファイルのダウンロードに失敗しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルのダウンロードに失敗しました。 |
| [FTPS サーバーファイルのアップロードが完了しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルが正常にアップロードされました。 |
| [FTPS サーバーファイルのアップロードに失敗しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルのアップロードに失敗しました。 |
| [SFTP サーバーファイルのダウンロードが完了しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルの ファイルが正常にダウンロードされました。 |
| [SFTP サーバーファイルのダウンロードに失敗しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのファイルのダウンロードに失敗しました。 |
| [SFTP サーバーファイルのアップロードが完了しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのファイルが正常にアップロードされました。 |
| [SFTP サーバーファイルのアップロードに失敗しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのファイルのアップロードに失敗しました。 |
**その他のファイルオペレーションイベント**
| イベントの詳細のタイプ | 説明 |
| --- | --- |
| [FTP サーバーディレクトリの作成が完了しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのディレクトリが正常に作成されました。 |
| [FTP サーバーディレクトリの作成に失敗しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのディレクトリの作成に失敗しました。 |
| [FTP サーバーディレクトリの削除が完了しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのディレクトリが正常に削除されました。 |
| [FTP サーバーディレクトリの削除に失敗しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのディレクトリの削除に失敗しました。 |
| [FTP サーバーファイルの削除が完了しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのファイルが正常に削除されました。 |
| [FTP サーバーファイルの削除に失敗しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのファイルの削除に失敗しました。 |
| [FTP サーバーファイルの名前変更が完了しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルのファイルの名前が正常に変更されました。 |
| [FTP サーバーファイルの名前変更に失敗しました](events-detail-reference.md#event-detail-server-events) | FTP プロトコルでファイルの名前を変更できませんでした。 |
| [FTPS サーバーディレクトリの作成が完了しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのディレクトリが正常に作成されました。 |
| [FTPS サーバーディレクトリの作成に失敗しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのディレクトリの作成に失敗しました。 |
| [FTPS サーバーディレクトリの削除が完了しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのディレクトリが正常に削除されました。 |
| [FTPS サーバーディレクトリの削除に失敗しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのディレクトリの削除に失敗しました。 |
| [FTPS サーバーファイルの削除が完了しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルが正常に削除されました。 |
| [FTPS サーバーファイルの削除に失敗しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルの削除に失敗しました。 |
| [FTPS サーバーファイルの名前変更が完了しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルのファイルの名前が正常に変更されました。 |
| [FTPS サーバーファイルの名前変更に失敗しました](events-detail-reference.md#event-detail-server-events) | FTPS プロトコルでファイルの名前を変更できませんでした。 |
| [SFTP サーバーディレクトリの作成が完了しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのディレクトリが正常に作成されました。 |
| [SFTP サーバーディレクトリの作成に失敗しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのディレクトリの作成に失敗しました。 |
| [SFTP サーバーディレクトリの削除が完了しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのディレクトリが正常に削除されました。 |
| [SFTP サーバーディレクトリの削除に失敗しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのディレクトリの削除に失敗しました。 |
| [SFTP サーバーファイルの削除が完了しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのファイルが正常に削除されました。 |
| [SFTP サーバーファイルの削除に失敗しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのファイルの削除に失敗しました。 |
| [SFTP サーバーファイルの名前変更が完了しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルのファイルの名前が正常に変更されました。 |
| [SFTP サーバーファイルの名前変更に失敗しました](events-detail-reference.md#event-detail-server-events) | SFTP プロトコルでファイルの名前を変更できませんでした。 |
### SFTP コネクタイベント
**注記**
これらのイベントは、「Amazon EventBridge イベントリファレンス」の[AWS 「サービスイベントの配信レベル](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 * EventBridge *
| イベントの詳細のタイプ | 説明 |
| --- | --- |
| [SFTP コネクタファイルの送信が完了しました](events-detail-reference.md#event-detail-sftp-connector-events) | コネクタからリモート SFTP サーバーへのファイル転送が正常に完了しました。 |
| [SFTP コネクタファイルの送信に失敗しました](events-detail-reference.md#event-detail-sftp-connector-events) | コネクタからリモート SFTP サーバーへのファイル転送に失敗しました。 |
| [SFTP コネクタファイルの取得が完了しました](events-detail-reference.md#event-detail-sftp-connector-events) | リモート SFTP サーバーからコネクタへのファイル転送が正常に完了しました。 |
| [SFTP コネクタファイルの取得に失敗しました](events-detail-reference.md#event-detail-sftp-connector-events) | リモート SFTP サーバーからコネクタへのファイル転送に失敗しました。 |
| [SFTP コネクタディレクトリの一覧表示が完了しました](events-detail-reference.md#event-detail-sftp-connector-events) | 正常に完了した呼び出しを一覧表示する開始ファイルディレクトリ。 |
| [SFTP コネクタディレクトリの一覧表示に失敗しました](events-detail-reference.md#event-detail-sftp-connector-events) | 失敗した開始ファイルディレクトリのリスト。 |
| [SFTP コネクタのリモート移動が完了しました](events-detail-reference.md#event-detail-sftp-connector-events) | ファイルまたはディレクトリはリモートサーバーで正常に移動または名前が変更されました。 |
| [SFTP コネクタのリモート移動に失敗しました](events-detail-reference.md#event-detail-sftp-connector-events) | ファイルまたはディレクトリをリモートサーバーで移動または名前変更できませんでした。 |
| [SFTP コネクタのリモート削除が完了しました](events-detail-reference.md#event-detail-sftp-connector-events) | ファイルまたはディレクトリはリモートサーバーで正常に削除されました。 |
| [SFTP コネクタのリモート削除に失敗しました](events-detail-reference.md#event-detail-sftp-connector-events) | リモートサーバーでファイルまたはディレクトリを削除できませんでした。 |
### AS2 イベント
**注記**
これらのイベントは、「Amazon EventBridge イベントリファレンス」の[AWS 「サービスイベントの配信レベル](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 * EventBridge *
| イベントの詳細のタイプ | 説明 |
| --- | --- |
| [AS2 ペイロード受信完了](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのペイロードを受信しました。 |
| [AS2 ペイロードの受信に失敗しました](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのペイロードが受信されていません。 |
| [AS2 ペイロードの送信が完了しました](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのペイロードが正常に送信されました。 |
| [AS2 ペイロードの送信に失敗しました](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのペイロードの送信に失敗しました。 |
| [AS2 MDN 受信完了](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのメッセージ処理通知を受信しました。 |
| [AS2 MDN 受信失敗](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのメッセージ処理通知が受信されていません。 |
| [AS2 MDN 送信が完了しました](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのメッセージ処理通知が正常に送信されました。 |
| [AS2 MDN 送信失敗](events-detail-reference.md#event-detail-as2-server-events) | AS2 メッセージのメッセージ処理通知の送信に失敗しました。 |
## EventBridge ルールを使用した Transfer Family イベントの送信
EventBridge デフォルトのイベントバスでターゲットに Transfer Family イベントを送信する場合は、目的のイベントのデータに一致する Transfer Family イベントパターンを含むルールを作成する必要があります。
**Amazon EventBridge で AWS Transfer Family イベントをキャプチャするには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) で Amazon EventBridge コンソールを開きます。
1. ナビゲーションペインで、**ルール**を選択し、**ルールの作成**を選択します。
1. ルールのわかりやすい名前を入力し、オプションで説明を入力します。
1. **ルールタイプ**で、**イベントパターンを持つルール**を選択し、**次へ**を選択します。
1. **イベントソース**セクションで、**AWS イベントまたは EventBridge パートナーイベント**を選択します。
1. **作成方法**セクションで、**パターンフォームの使用**を選択します。
1. **イベントパターン**セクションで、次の情報を入力します。
1. **[イベントソース]** で、**[AWS のサービス]** を選択してください。
1. **AWS サービス**の場合は、**転送**を選択します。
1. **イベントタイプ**で、ルールをトリガーする Transfer Family イベントタイプを選択します。
**イベントタイプの**選択によっては、**イベントタイプの仕様 1 **セクションが表示される場合があります。
1. **イベントタイプの仕様 1 **セクションが表示された場合は、キャプチャする特定のイベントを選択します (または任意のイベントを選択して**、選択したイベント**タイプのすべてのイベントをキャプチャします）。
1. (オプション) **イベントパターン**エディタを使用して、イベントの詳細のフィルターを指定します。
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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください。
ターゲットの選択については、*「Amazon EventBridge ユーザーガイド*」の[「ターゲットの選択](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target)」を参照してください。
1. ターゲットに追加のオプションを設定し、**次へ**を選択します。
1. (オプション) ルールにタグを追加し、**次へ**を選択します。
1. **確認および作成**画面で、すべてが問題なく見える場合は、**ルールの作成**を選択します。
### イベントの 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 ユーザーガイド*」の「[イベントパターン](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)」を参照してください。
### でのイベントの Transfer Family イベントパターンのテスト EventBridge
EventBridge サンドボックスを使用すると、ルールを作成または編集するより広範なプロセスを完了することなく、イベントパターンをすばやく定義してテストできます。サンドボックスを使用すると、イベントパターンを定義し、サンプルイベントを使用して、そのパターンが目的のイベントと一致することを確認できます。 は、サンドボックスから直接そのイベントパターンを使用して新しいルールを作成するオプション EventBridge を提供します。
詳細については、 *EventBridge ユーザーガイド*[の EventBridge 「サンドボックスを使用したイベントパターンのテスト](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html)」を参照してください。
## Amazon EventBridge アクセス許可
Transfer Family では、イベントを配信するための追加のアクセス許可は必要ありません Amazon EventBridge。
指定するターゲットには、特定のアクセス許可または設定が必要になる場合があります。ターゲットに特定のサービスを使用する方法の詳細については、「*Amazon EventBridge ユーザーガイド*」の「[Amazon EventBridge ターゲット](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)」を参照してください。
## その他の EventBridge リソース
EventBridge を使用してイベントを処理および管理する方法の詳細については、 [https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)の以下のトピックを参照してください。
+ イベントバスの仕組みに関する詳細は、「[Amazon EventBridge イベントバス](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)」を参照してください。
+ イベント構造については、「[Amazon EventBridge イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。
+ ルールとイベント EventBridge を照合するときに が使用するイベントパターンの構築については、[「イベントパターン](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)」を参照してください。
+ EventBridge が処理するイベントを指定するルールの作成方法については、「[Amazon EventBridge ルール](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)」を参照してください。
+ が一致するイベント EventBridge を送信するサービスやその他の送信先を指定する方法については、[「ターゲット](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)」を参照してください。