翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Transfer Family イベント詳細リファレンス
<a name="events-detail-reference"></a>

 AWS サービスからのすべてのイベントには、イベントに関するメタデータを含む共通のフィールドセットがあります。これらのメタデータには、イベントのソースである AWS サービス、イベントが生成された時刻、イベントが発生したアカウントとリージョンなどが含まれます。これらの一般的なフィールドの定義については、「*Amazon EventBridge ユーザーガイド*」の「[イベント構造リファレンス](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)」を参照してください。

さらに、各イベントには、その特定のイベントに固有のデータを含む `detail` フィールドがあります。次のリファレンスでは、さまざまな Transfer Family イベントの詳細フィールドを定義します。

 EventBridge を使用して Transfer Family イベントを選択および管理する場合は、次の点を考慮してください。
+ からのすべてのイベントの `source`フィールド Transfer Family は に設定されます`aws.transfer`。
+ `detail-type` フィールドはイベントタイプを指定します。

  例えば、`FTP Server File Download Completed`。
+ `detail` フィールドには、その特定のイベントに固有のデータが含まれます。

 Transfer Family イベントに一致するようにルールを有効化するイベントパターンの作成方法については、「Amazon EventBridge ユーザーガイド」の「[Amazon EventBridge のイベントパターン](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)」を参照してください。

イベントとその EventBridge 処理方法の詳細については、*Amazon EventBridge 「 ユーザーガイド*」の[Amazon EventBridge 「 イベント](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)」を参照してください。

**Topics**
+ [SFTP、FTPS、および FTP サーバーイベント](#event-detail-server-events)
+ [SFTP コネクタイベント](#event-detail-sftp-connector-events)
+ [AS2 イベント](#event-detail-as2-server-events)

## SFTP、FTPS、および FTP サーバーイベント
<a name="event-detail-server-events"></a>

以下は、SFTP、FTPS、および 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 サーバーファイルのアップロードに失敗しました
+ SFTP サーバーディレクトリの作成が完了しました
+ SFTP サーバーディレクトリの作成に失敗しました
+ SFTP サーバーディレクトリの削除が完了しました
+ SFTP サーバーディレクトリの削除に失敗しました
+ SFTP サーバーファイルの削除が完了しました
+ SFTP サーバーファイルの削除に失敗しました
+ SFTP サーバーファイルのダウンロードが完了しました
+ SFTP サーバーファイルのダウンロードに失敗しました
+ SFTP サーバーファイルの名前変更が完了しました
+ SFTP サーバーファイルの名前変更に失敗しました
+ SFTP サーバーファイルのアップロードが完了しました
+ SFTP サーバーファイルのアップロードに失敗しました

`source` および `detail-type`フィールドは、 Transfer Family イベントの特定の値を含むため、以下に含まれています。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *Amazon EventBridge ユーザーガイド*」の[「イベント構造のリファレンス](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)」を参照してください。

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "failure-code" : "string",
    "status-code" : "string",
    "protocol" : "string",
    "bytes" : "number",
    "client-ip" : "string",
    "failure-message" : "string",
    "end-timestamp" : "string",
    "etag" : "string",
    "file-path" : "string",
    "original-file-path" : "string",
    "renamed-file-path" : "string",
    "directory-path" : "string",
    "server-id" : "string",
    "username" : "string",
    "session-id" : "string",
    "start-timestamp" : "string"
  }
}
```

`detail-type`  <a name="event-detail-server-events-detail-type"></a>
イベントのタイプを示します。  
このイベントの場合、値は前述の SFTP、FTPS、または FTP サーバーイベント名のいずれかです。

`source`  <a name="event-detail-server-events-source"></a>
イベントを発生させたサービスを識別します。Transfer Family イベントの場合、この値は です`aws.transfer`。

`detail`  <a name="sftp-server-detail"></a>
イベントに関する情報を含む JSON オブジェクト。このフィールドの内容は、イベントを生成するサービスによって決まります。  
このイベントでは、データには以下が含まれます。    
`failure-code`  <a name="sftp-server-failure-code"></a>
転送が失敗した理由のカテゴリ。値: `PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR`  
`status-code`  <a name="sftp-server-status-code"></a>
転送が成功したかどうか。値: `COMPLETED | FAILED`。  
`protocol`  <a name="sftp-server-protocol"></a>
転送に使用されるプロトコル。値: `SFTP | FTPS | FTP`  
`bytes`  <a name="sftp-server-bytes"></a>
転送バイト数。  
`client-ip`  <a name="sftp-server-client-ip"></a>
転送に関係するクライアントの IP アドレス  
`failure-message`  <a name="sftp-server-failure-message"></a>
失敗した転送の場合、転送が失敗した理由の詳細。  
`end-timestamp`  <a name="sftp-server-end-timestamp"></a>
転送が成功した場合、ファイルの処理が終了する時刻のタイムスタンプ。  
`etag`  <a name="sftp-server-etag"></a>
エンティティタグ (Amazon S3 ファイルにのみ使用されます）。  
`file-path`  <a name="sftp-server-file-path"></a>
転送、削除、またはその他の方法で操作されるファイルへのパス。  
`original-file-path`  <a name="sftp-server-original-file-path"></a>
ファイルの名前変更イベントの場合、名前変更前のファイルの元のパス。  
`renamed-file-path`  <a name="sftp-server-renamed-file-path"></a>
ファイルの名前変更イベントの場合、名前変更後のファイルの新しいパス。  
`directory-path`  <a name="sftp-server-directory-path"></a>
ディレクトリの作成および削除イベントの場合、ディレクトリのパス。  
`server-id`  <a name="sftp-server-server-id"></a>
Transfer Family サーバーの一意の ID。  
`username`  <a name="sftp-server-username"></a>
転送を実行しているユーザー。  
`session-id`  <a name="sftp-server-session-id"></a>
転送セッションの一意の識別子。  
`start-timestamp`  <a name="sftp-server-start-timestamp"></a>
転送が成功した場合、ファイル処理が開始される時刻のタイムスタンプ。

**Example SFTP サーバーファイルのダウンロード失敗の例イベント**  <a name="event-detail-server-events.example"></a>
次の例は、SFTP サーバー (使用されているストレージAmazon EFS ) でダウンロードが失敗したイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Download Failed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T17:20:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "failure-code": "PARTIAL_DOWNLOAD",
        "status-code": "FAILED",
        "protocol": "SFTP",
        "bytes": 4100,
        "client-ip": "IP-address",
        "failure-message": "File was partially downloaded.",
        "end-timestamp": "2024-01-29T17:20:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2024-01-29T17:20:16.706282454Z"
    }
}
```

**Example FTP サーバーファイルのアップロード完了サンプルイベント**  <a name="event-detail-server-events.example"></a>
次の例は、FTP サーバー (使用されているストレージAmazon S3 ) でアップロードが正常に完了したイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "FTP Server File Upload Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2024-01-29T16:31:43Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1111aaaa2222bbbb3"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "FTP",
        "bytes": 1048576,
        "client-ip": "10.0.0.141",
        "end-timestamp": "2024-01-29T16:31:43.311866408Z",
        "etag": "b6d81b360a5672d80c27430f39153e2c",
        "file-path": "/amzn-s3-demo-bucket/test/1mb_file",
        "server-id": "s-1111aaaa2222bbbb3",
        "username": "test",
        "session-id": "event-ID",
        "start-timestamp": "2024-01-29T16:31:42.462088327Z"
    }
}
```

**Example SFTP サーバーファイルの削除完了サンプルイベント**  <a name="event-detail-server-events.example"></a>
次の例は、SFTP サーバーでファイルが正常に削除されたイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Delete Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T14:30:27Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T14:30:27.749749117Z",
        "file-path": "/fs-1234abcd5678efghi/user0/test-file-to-delete.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T14:30:26.706282454Z"
    }
}
```

**Example SFTP サーバーファイルの名前変更完了の例のイベント**  <a name="event-detail-server-events.example"></a>
次の例は、SFTP サーバーでファイルの名前が正常に変更されたイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server File Rename Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T15:45:12Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T15:45:12.749749117Z",
        "original-file-path": "/fs-1234abcd5678efghi/user0/old-filename.txt",
        "renamed-file-path": "/fs-1234abcd5678efghi/user0/new-filename.txt",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T15:45:11.706282454Z"
    }
}
```

**Example SFTP サーバーディレクトリの作成完了サンプルイベント**  <a name="event-detail-server-events.example"></a>
次の例は、SFTP サーバーでディレクトリが正常に作成されたイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Server Directory Create Completed",
    "source": "aws.transfer",
    "account": "958412138249",
    "time": "2025-05-15T16:20:05Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:958412138249:server/s-1234abcd5678efghi"
    ],
    "detail": {
        "status-code": "COMPLETED",
        "protocol": "SFTP",
        "client-ip": "IP-address",
        "end-timestamp": "2025-05-15T16:20:05.749749117Z",
        "directory-path": "/fs-1234abcd5678efghi/user0/new-directory",
        "server-id": "s-1234abcd5678efghi",
        "username": "test",
        "session-id": "session-ID",
        "start-timestamp": "2025-05-15T16:20:04.706282454Z"
    }
}
```

## SFTP コネクタイベント
<a name="event-detail-sftp-connector-events"></a>

**注記**  
これらのイベントは、「Amazon EventBridge イベントリファレンス」の[AWS 「サービスイベントの配信レベル](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 * EventBridge *

SFTP コネクタイベントの詳細フィールドは次のとおりです。
+ SFTP コネクタファイルの送信が完了しました
+ SFTP コネクタファイルの送信に失敗しました
+ SFTP コネクタファイルの取得が完了しました
+ SFTP コネクタファイルの取得に失敗しました
+ SFTP コネクタディレクトリの一覧表示が完了しました
+ SFTP コネクタディレクトリの一覧表示に失敗しました
+ SFTP コネクタのリモート移動が完了しました
+ SFTP コネクタのリモート移動に失敗しました
+ SFTP コネクタのリモート削除が完了しました
+ SFTP コネクタのリモート削除に失敗しました

`source` および `detail-type`フィールドは、 Transfer Family イベントの特定の値を含むため、以下に含まれています。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *Amazon EventBridge ユーザーガイド*」の[「イベント構造のリファレンス](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)」を参照してください。

```
{
  . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {
    "operation" : "string",
    "max-items" : "number",
    "connector-id" : "string",
    "output-directory-path" : "string",
    "listing-id" : "string",
    "transfer-id" : "string",
    "file-transfer-id" : "string",
    "url" : "string",
    "file-path" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "local-directory-path" : "string",
    "remote-directory-path" : "string"
    "item-count" : "number"
    "truncated" : "boolean"
    "bytes" : "number",
    "egress-type" : "string",
    "vpc-lattice-resource-configuration-arn" : "string",
    "vpc-lattice-port-number" : "number",
    "local-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    },
    "output-file-location" : {
      "domain" : "string",
      "bucket" : "string",
      "key" : "string"
    }
  }
}
```

`detail-type`  <a name="event-detail-sftp-connector-events-detail-type"></a>
イベントのタイプを示します。  
このイベントの場合、値は前述の SFTP コネクタイベント名の 1 つです。

`source`  <a name="event-detail-sftp-connector-events-source"></a>
イベントを発生させたサービスを識別します。 Transfer Family イベントの場合、この値は です`aws.transfer`。

`detail`  <a name="sftp-connector-detail"></a>
イベントに関する情報を含む JSON オブジェクト。イベントを生成するサービスは、このフィールドの内容を決定します。  
このイベントでは、データには以下が含まれます。    
`max-items`  <a name="sftp-connector-max-items"></a>
返されるディレクトリ/ファイル名の最大数。  
`operation`  <a name="sftp-connector-operation"></a>
`StartFileTransfer` リクエストがファイルを送信または取得しているかどうか。値: `SEND|RETRIEVE`。  
`connector-id`  <a name="sftp-connector-connector-id"></a>
使用されている SFTP コネクタの一意の識別子。  
`output-directory-path`  <a name="sftp-connector-output-directory-path"></a>
ファイル/ディレクトリのリスト結果を保存する Amazon S3 のパス (バケットとプレフィックス）。  
`listing-id`  <a name="sftp-connector-listing-id"></a>
`StartDirectoryListing` API オペレーションの一意の識別子。この識別子を使用して、CloudWatch ログをチェックし、リストリクエストのステータスを確認できます。  
`transfer-id`  <a name="sftp-connector-transfer-id"></a>
転送イベント (`StartFileTransfer`リクエスト) の一意の識別子。  
`file-transfer-id`  <a name="sftp-connector-file-transfer-id"></a>
転送されるファイルの一意の識別子。  
`url`  <a name="sftp-connector-url"></a>
パートナーの AS2 または SFTP エンドポイントの URL。  
`file-path`  <a name="sftp-connector-file-path"></a>
送信または取得される場所とファイル。  
`status-code`  <a name="sftp-connector-status-code"></a>
転送が成功したかどうか。値: `FAILED | COMPLETED`。  
`failure-code`  <a name="sftp-connector-failure-code"></a>
失敗した転送の場合、転送が失敗した理由の理由コード。  
`failure-message`  <a name="sftp-connector-failure-message"></a>
失敗した転送の場合、転送が失敗した理由の詳細。  
`start-timestamp`  <a name="sftp-connector-start-timestamp"></a>
転送が成功した場合、ファイル処理が開始される時刻のタイムスタンプ。  
`end-timestamp`  <a name="sftp-connector-end-timestamp"></a>
転送が成功した場合、ファイル処理が完了したときのタイムスタンプ。  
`local-directory-path`  <a name="sftp-connector-local-directory-path"></a>
`RETRIEVE` リクエストの場合、取得したファイルを配置する場所。  
`remote-directory-path`  <a name="sftp-connector-remote-directory-path"></a>
`SEND` リクエストの場合、パートナーの SFTP サーバーにファイルを配置するファイルディレクトリ。これは、ユーザーが`StartFileTransfer`リクエストに渡`RemoteDirectoryPath`した の値です。パートナーの SFTP サーバーでデフォルトのディレクトリを指定できます。その場合は、このフィールドは空です。  
`item-count`  <a name="sftp-connector-item-count"></a>
出品リクエストに対して返された項目 (ディレクトリとファイル) の数。  
`truncated`  <a name="sftp-connector-truncated"></a>
リスト出力にリモートディレクトリに含まれるすべての項目が含まれているかどうか。  
`bytes`  <a name="sftp-connector-bytes"></a>
転送されるバイト数。失敗した転送の値は 0 です。  
`egress-type`  <a name="sftp-connector-egress-type"></a>
コネクタの出力設定のタイプ。値: `SERVICE_MANAGED`または `VPC_LATTICE`。  
`vpc-lattice-resource-configuration-arn`  <a name="sftp-connector-vpc-lattice-resource-configuration-arn"></a>
ターゲット SFTP サーバーの場所を定義する VPC\_LATTICE リソース設定の ARN。サービスマネージドコネクタの場合、このフィールドは null です。  
`vpc-lattice-port-number`  <a name="sftp-connector-vpc-lattice-port-number"></a>
VPC\_LATTICE 経由で SFTP サーバーに接続するためのポート番号。  
`local-file-location`  <a name="sftp-connector-local-file-location"></a>
このパラメータには、 AWS ストレージファイルの場所の詳細が含まれます。    
`domain`  <a name="sftp-connector-domain"></a>
使用されているストレージ。現在、唯一の値は です`S3`。  
`bucket`  <a name="sftp-connector-bucket"></a>
Amazon S3 のオブジェクトのコンテナ。  
`key`  <a name="sftp-connector-key"></a>
Amazon S3 のオブジェクトに割り当てられた名前。  
`output-file-location`  <a name="sftp-connector-output-file-location"></a>
このパラメータには、ディレクトリリストの結果をストレージに AWS 保存する場所の詳細が含まれます。    
`domain`  <a name="sftp-connector-output-domain"></a>
使用されているストレージ。現在、唯一の値は です`S3`。  
`bucket`  <a name="sftp-connector-output-bucket"></a>
Amazon S3 のオブジェクトのコンテナ。  
`key`  <a name="sftp-connector-output-key"></a>
Amazon S3 のオブジェクトに割り当てられた名前。

**Example SFTP Connector File Send Failed サンプルイベント**  <a name="event-detail-sftp-connector-events.example"></a>
次の例は、リモート SFTP サーバーにファイルを送信しようとしたときに SFTP コネクタが失敗したイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Send Failed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T19:30:45Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "SEND",
        "connector-id": "c-f1111aaaa2222bbbb3",
        "transfer-id": "transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "/amzn-s3-demo-bucket/testfile.txt",
        "status-code": "FAILED",
        "failure-code": "CONNECTION_ERROR",
        "failure-message": "Unknown Host",
        "remote-directory-path": "",
        "bytes": 0,
        "start-timestamp": "2024-01-24T18:29:33.658729Z",
        "end-timestamp": "2024-01-24T18:29:33.993196Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example SFTP Connector File Retrieve Completed サンプルイベント**  <a name="event-detail-sftp-connector-events.example"></a>
次の例は、SFTP コネクタがリモート SFTP サーバーから送信されたファイルを正常に取得するイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector File Retrieve Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "operation": "RETRIEVE",
        "connector-id": "c-fc68000012345aa18",
        "transfer-id": "file-transfer-ID",
        "file-transfer-id": "file-transfer-ID",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",
        "file-path": "testfile.txt",
        "status-code": "COMPLETED",
        "local-directory-path": "/amzn-s3-demo-bucket",
        "bytes": 63533,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "local-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "testfile.txt"
        }
    }
}
```

**Example SFTP Connector Directory Listing Completed サンプルイベント**  <a name="event-detail-sftp-connector-events.example"></a>
次の例は、スタートディレクトリリスト呼び出しがリモート SFTP サーバーからリストファイルを取得するイベントを示しています。  

```
{
    "version": "0",
    "id": "event-ID",
    "detail-type": "SFTP Connector Directory Listing Completed",
    "source": "aws.transfer",
    "account": "123456789012",
    "time": "2024-01-24T18:28:08Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:transfer:us-east-1:123456789012:connector/c-f1111aaaa2222bbbb3"
    ],
    "detail": {
        "max-items": 10000,
        "connector-id": "c-fc68000012345aa18",
        "output-directory-path": "/amzn-s3-demo-bucket/example/file-listing-output",
        "listing-id": "123456-23aa-7980-abc1-1a2b3c4d5e",
        "url": "sftp://s-21a23456789012a.server.transfer.us-east-1.amazonaws.com",        
        "status-code": "COMPLETED",
        "remote-directory-path": "/home",
        "item-count": 10000,
        "truncated": true,
        "start-timestamp": "2024-01-24T18:28:07.632388Z",
        "end-timestamp": "2024-01-24T18:28:07.774898Z",
        "output-file-location": {
            "domain": "S3",
            "bucket": "amzn-s3-demo-bucket",
            "key": "c-fc1ab90fd0d047e7a-70987273-49nn-4006-bab1-1a7290cc412ba.json"
        }
    }
}
```

## AS2 イベント
<a name="event-detail-as2-server-events"></a>

**注記**  
これらのイベントは、「Amazon EventBridge イベントリファレンス」の[AWS 「サービスイベントの配信レベル](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)」で説明されているように、耐久性のあるレベルで EventBridge に配信されます。 * EventBridge *

AS2 イベントの詳細フィールドは次のとおりです。
+ AS2 ペイロード受信完了
+ AS2 ペイロードの受信に失敗しました
+ AS2 ペイロードの送信が完了しました
+ AS2 ペイロードの送信に失敗しました
+ AS2 MDN 受信完了
+ AS2 MDN 受信失敗
+ AS2 MDN 送信が完了しました
+ AS2 MDN 送信失敗

`source` および `detail-type`フィールドは、 Transfer Family イベントの特定の値を含むため、以下に含まれています。すべてのイベントに含まれる他のメタデータフィールドの定義については、「 *Amazon EventBridge ユーザーガイド*」の[「イベント構造のリファレンス](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)」を参照してください。

```
{
   . . .,
  "detail-type": "string",
  "source": "aws.transfer",
  . . .,
  "detail": {    
    "s3-attributes" : {
      "file-bucket" : "string",
      "file-key" : "string",
      "json-bucket" : "string",
      "json-key" : "string", 
      "mdn-bucket" : "string",
      "mdn-key" : "string"
      }
    "mdn-subject" : "string",
    "mdn-message-id" : "string",
    "disposition" : "string",
    "bytes" : "number",
    "as2-from" : "string",
    "as2-message-id" : "string",
    "as2-to" : "string",
    "connector-id" : "string",
    "client-ip" : "string",
    "agreement-id" : "string",
    "server-id" : "string",
    "requester-file-name" : "string",
    "message-subject" : "string",
    "start-timestamp" : "string",
    "end-timestamp" : "string",
    "status-code" : "string",
    "failure-code" : "string",
    "failure-message" : "string",
    "transfer-id" : "string"
  }
}
```

`detail-type`  <a name="event-detail-as2-server-events-detail-type"></a>
イベントのタイプを示します。  
このイベントの場合、値は前述の AS2 イベントの 1 つです。

`source`  <a name="event-detail-as2-server-events-source"></a>
イベントを発生させたサービスを識別します。 Transfer Family イベントの場合、この値は です`aws.transfer`。

`detail`  <a name="as2-server-detail"></a>
イベントに関する情報を含む JSON オブジェクト。このフィールドの内容は、イベントを生成するサービスによって決まります。    
`s3-attributes`  <a name="as2-server-s3-attributes"></a>
転送されるファイルの Amazon S3 バケットとキーを識別します。MDN イベントの場合、MDN ファイルのバケットとキーも識別されます。    
`file-bucket`  <a name="as2-server-s3-file-bucket"></a>
Amazon S3 のオブジェクトのコンテナ。  
`file-key`  <a name="as2-server-s3-file-key"></a>
Amazon S3 のオブジェクトに割り当てられた名前。  
`json-bucket`  <a name="as2-server-s3-json-bucket"></a>
COMPLETED 転送または FAILED 転送の場合、JSON ファイルのコンテナ。  
`json-key`  <a name="as2-server-s3-json-key"></a>
COMPLETED 転送または FAILED 転送の場合、Amazon S3 の JSON ファイルに割り当てられた名前。  
`mdn-bucket`  <a name="as2-server-s3-mdn-bucket"></a>
MDN イベントの場合、MDN ファイルのコンテナ。  
`mdn-key`  <a name="as2-server-s3-mdn-key"></a>
MDN イベントの場合、Amazon S3 の MDN ファイルに割り当てられた名前。  
`mdn-subject`  <a name="as2-server-mdn-subject"></a>
MDN イベントの場合、メッセージ処理のテキスト説明。  
`mdn-message-id`  <a name="as2-server-mdn-message-id"></a>
MDN イベントの場合、MDN メッセージの一意の ID。  
`disposition`  <a name="as2-server-disposition"></a>
MDN イベントの場合、処理のカテゴリ。  
`bytes`  <a name="as2-server-bytes"></a>
メッセージ内のバイト数。  
`as2-from`  <a name="as2-server-as2-from"></a>
メッセージを送信する AS2 取引相手。  
`as2-message-id`  <a name="as2-server-as2-message-id"></a>
転送される AS2 メッセージの一意の識別子。  
`as2-to`  <a name="as2-server-as2-to"></a>
メッセージを受信している AS2 取引相手。  
`connector-id`  <a name="as2-server-connector-id"></a>
Transfer Family サーバーから取引先に送信される AS2 メッセージの場合、使用されている AS2 コネクタの一意の識別子。  
`client-ip`  <a name="as2-server-client-ip"></a>
サーバーイベント (取引相手から Transfer Family サーバーへの転送) の場合、転送に関係するクライアントの IP アドレス。  
`agreement-id`  <a name="as2-server-agreement-id"></a>
サーバーイベントの場合、AS2 契約の一意の識別子。  
`server-id`  <a name="as2-server-server-id"></a>
サーバーイベントの場合、Transfer Family サーバー専用の一意の ID。  
`requester-file-name`  <a name="as2-server-requester-file-name"></a>
ペイロードイベントの場合、転送中に受信したファイルの元の名前。  
`message-subject`  <a name="as2-server-message-subject"></a>
メッセージの件名のテキスト説明。  
`start-timestamp`  <a name="as2-server-start-timestamp"></a>
転送が成功した場合、ファイル処理が開始される時刻のタイムスタンプ。  
`end-timestamp`  <a name="as2-server-end-timestamp"></a>
転送が成功した場合、ファイル処理が完了したときのタイムスタンプ。  
`status-code`  <a name="as2-server-status-code"></a>
AS2 メッセージ転送プロセスの状態に対応するコード。有効な値: `COMPLETED | FAILED | PROCESSING`。  
`failure-code`  <a name="as2-server-failure-code"></a>
失敗した転送の場合、転送が失敗した理由のカテゴリ。  
`failure-message`  <a name="as2-server-failure-message"></a>
失敗した転送の場合、転送が失敗した理由の詳細。  
`transfer-id`  <a name="as2-server-transfer-id"></a>
転送イベントの一意の識別子。

**Example AS2 ペイロード受信完了サンプルイベント**  <a name="event-detail-as2-server-events.example"></a>

```
{
    "version": "0",
     "id": "event-ID",
    "detail-type": "AS2 Payload Receive Completed",
    "source": "aws.transfer",
    "account": "076722215406",
    "time": "2024-02-07T06:47:05Z",
    "region": "us-east-1",
    "resources": ["arn:aws:transfer:us-east-1:076722215406:connector/c-1111aaaa2222bbbb3"],
    "detail": {
        "s3-attributes": {
            "file-key": "/inbound/processed/testAs2Message.dat",
            "file-bucket": "amzn-s3-demo-bucket"
        },
        "client-ip": "client-IP-address",
        "requester-file-name": "testAs2MessageVerifyFile.dat",
        "end-timestamp": "2024-02-07T06:47:06.040031Z",
        "as2-from": "as2-from-ID",
        "as2-message-id": "as2-message-ID",
        "message-subject": "Message from AS2 tests",
        "start-timestamp": "2024-02-07T06:47:05.410Z",
        "status-code": "PROCESSING",
        "bytes": 63,
        "as2-to": "as2-to-ID",
        "agreement-id": "a-1111aaaa2222bbbb3",
        "server-id": "s-1234abcd5678efghi"
    }
}
```

**Example AS2 MDN 受信失敗イベントの例**  <a name="event-detail-as2-server-events.example"></a>

```
{
  "version": "0",
  "id": "event-ID",
  "detail-type": "AS2 MDN Receive Failed",
  "source": "aws.transfer",
  "account": "889901007463",
  "time": "2024-02-06T22:05:09Z",
  "region": "us-east-1",
  "resources": ["arn:aws:transfer:us-east-1:076722215406:server/s-1111aaaa2222bbbb3"],
  "detail": {      
      "mdn-subject": "Your Requested MDN Response re: Test run from Id 123456789abcde to partner ijklmnop987654",
      "s3-attributes": {
          "json-bucket": "amzn-s3-demo-bucket1",
          "file-key": "/as2Integ/TestOutboundWrongCert.dat",
          "file-bucket": "amzn-s3-demo-bucket2",
          "json-key": "/as2Integ/failed/TestOutboundWrongCert.dat.json"
      },
      "mdn-message-id": "MDN-message-ID",
      "end-timestamp": "2024-02-06T22:05:09.479878Z",
      "as2-from": "PartnerA",
      "as2-message-id": "as2-message-ID",
      "connector-id": "c-1234abcd5678efghj",
      "message-subject": "Test run from Id 123456789abcde to partner ijklmnop987654",
      "start-timestamp": "2024-02-06T22:05:03Z",
      "failure-code": "VERIFICATION_FAILED_NO_MATCHING_KEY_FOUND",
      "status-code": "FAILED",
      "as2-to": "MyCompany",
      "failure-message": "No public certificate matching message signature could be found in profile: p-1234abcd5678efghj",
      "transfer-id": "transfer-ID"
  }
}
```