本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 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 《 使用者指南*》中的[事件模式](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、FTP 或 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>

**注意**  
這些事件會以耐久層級交付至 EventBridge，如 *Amazon EventBridge Events Reference* 中[AWS 服務事件的交付層級](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)所述。

以下是 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 連接器事件名稱。

`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 伺服器上的檔案目錄。這是`RemoteDirectoryPath`使用者傳遞給`StartFileTransfer`請求的 值。您可以在合作夥伴的 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 連接器檔案傳送失敗的範例事件**  <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 連接器檔案擷取已完成的範例事件**  <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 連接器目錄列出已完成的範例事件**  <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>

**注意**  
這些事件會以耐久的層級交付至 EventBridge，如 *Amazon EventBridge Events Reference* 中[AWS 服務事件的交付層級](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)所述。

以下是 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 事件。

`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>
對於伺服器事件，唯一的 ID 僅適用於 Transfer Family 伺服器。  
`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"
  }
}
```