

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Transfer Family referensi detail acara
<a name="events-detail-reference"></a>

Semua peristiwa dari AWS layanan memiliki seperangkat bidang umum yang berisi metadata tentang acara tersebut. Metadata ini dapat mencakup AWS layanan yang merupakan sumber acara, waktu acara dibuat, akun dan Wilayah tempat acara berlangsung, dan lainnya. Untuk definisi bidang umum ini, lihat [Referensi struktur acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) di *Panduan Amazon EventBridge Pengguna*. 

Selain itu, setiap acara memiliki `detail` bidang yang berisi data khusus untuk peristiwa tertentu. Referensi berikut mendefinisikan bidang detail untuk berbagai Transfer Family acara.

Saat Anda menggunakan EventBridge untuk memilih dan mengelola Transfer Family acara, pertimbangkan hal berikut:
+ `source`Bidang untuk semua acara dari Transfer Family diatur ke`aws.transfer`.
+ `detail-type`Bidang menentukan jenis acara. 

  Misalnya, `FTP Server File Download Completed`.
+ `detail`Bidang berisi data yang spesifik untuk peristiwa tertentu. 

Untuk informasi tentang membuat pola peristiwa yang memungkinkan aturan untuk mencocokkan Transfer Family peristiwa, lihat [Pola acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) di *Panduan Amazon EventBridge Pengguna*.

Untuk informasi selengkapnya tentang peristiwa dan cara EventBridge memprosesnya, lihat [Amazon EventBridge peristiwa](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) di *Panduan Amazon EventBridge Pengguna*.

**Topics**
+ [Acara server SFTP, FTPS, dan FTP](#event-detail-server-events)
+ [Acara konektor SFTP](#event-detail-sftp-connector-events)
+ [Acara AS2](#event-detail-as2-server-events)

## Acara server SFTP, FTPS, dan FTP
<a name="event-detail-server-events"></a>

Berikut ini adalah bidang detail untuk acara server SFTP, FTPS, dan FTP:
+ Direktori Server FTP Membuat Selesai
+ Membuat Direktori Server FTP Gagal
+ Penghapusan Direktori Server FTP Selesai
+ Penghapusan Direktori Server FTP Gagal
+ Penghapusan File Server FTP Selesai
+ Penghapusan File Server FTP Gagal
+ Unduhan File Server FTP Selesai
+ Unduhan File Server FTP Gagal
+ Ganti Nama File Server FTP Selesai
+ Gagal Mengganti Nama File Server FTP
+ Unggahan File Server FTP Selesai
+ Unggahan File Server FTP Gagal
+ Direktori Server FTPS Membuat Selesai
+ Pembuatan Direktori Server FTPS Gagal
+ Penghapusan Direktori Server FTPS Selesai
+ Penghapusan Direktori Server FTPS Gagal
+ Penghapusan File Server FTPS Selesai
+ Penghapusan File Server FTPS Gagal
+ Unduhan File Server FTPS Selesai
+ Unduhan File Server FTPS Gagal
+ Ganti Nama File Server FTPS Selesai
+ Gagal Mengganti Nama File Server FTPS
+ Unggahan File Server FTPS Selesai
+ Unggahan File Server FTPS Gagal
+ Direktori Server SFTP Membuat Selesai
+ Pembuatan Direktori Server SFTP Gagal
+ Penghapusan Direktori Server SFTP Selesai
+ Penghapusan Direktori Server SFTP Gagal
+ Penghapusan File Server SFTP Selesai
+ Penghapusan File Server SFTP Gagal
+ Unduhan File Server SFTP Selesai
+ Unduhan File Server SFTP Gagal
+ Ganti Nama File Server SFTP Selesai
+ Gagal Mengganti Nama File Server SFTP
+ Unggahan File Server SFTP Selesai
+ Unggahan File Server SFTP Gagal

`detail-type`Bidang `source` dan disertakan di bawah ini karena mengandung nilai khusus untuk Transfer Family acara. Untuk definisi bidang metadata lain yang disertakan dalam semua peristiwa, lihat [Referensi struktur acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) di *Amazon EventBridge Panduan Pengguna*.

```
{
  . . .,
  "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>
Mengidentifikasi jenis acara.  
Untuk acara ini, nilainya adalah salah satu nama acara server SFTP, FTPS, atau FTP yang tercantum sebelumnya.

`source`  <a name="event-detail-server-events-source"></a>
Mengidentifikasi layanan yang menghasilkan peristiwa. Untuk acara Transfer Family, nilai ini adalah`aws.transfer`.

`detail`  <a name="sftp-server-detail"></a>
Objek JSON yang berisi informasi tentang peristiwa. Layanan yang menghasilkan acara menentukan konten bidang ini.  
Untuk acara ini, data meliputi yang berikut:    
`failure-code`  <a name="sftp-server-failure-code"></a>
Kategori mengapa transfer gagal. Nilai: `PARTIAL_UPLOAD | PARTIAL_DOWNLOAD | UNKNOWN_ERROR`  
`status-code`  <a name="sftp-server-status-code"></a>
Apakah transfer berhasil. Nilai:`COMPLETED | FAILED`.  
`protocol`  <a name="sftp-server-protocol"></a>
Protokol yang digunakan untuk transfer. Nilai: `SFTP | FTPS | FTP`  
`bytes`  <a name="sftp-server-bytes"></a>
Jumlah byte yang ditransfer.  
`client-ip`  <a name="sftp-server-client-ip"></a>
Alamat IP untuk klien yang terlibat dalam transfer  
`failure-message`  <a name="sftp-server-failure-message"></a>
Untuk transfer yang gagal, detail mengapa transfer gagal.  
`end-timestamp`  <a name="sftp-server-end-timestamp"></a>
Untuk transfer yang berhasil, stempel waktu ketika file selesai diproses.  
`etag`  <a name="sftp-server-etag"></a>
Tag entitas (hanya digunakan untuk file Amazon S3).  
`file-path`  <a name="sftp-server-file-path"></a>
Jalur ke file yang ditransfer, dihapus, atau dioperasikan.  
`original-file-path`  <a name="sftp-server-original-file-path"></a>
Untuk acara ganti nama file, jalur asli file sebelum mengganti nama.  
`renamed-file-path`  <a name="sftp-server-renamed-file-path"></a>
Untuk acara ganti nama file, jalur baru file setelah mengganti nama.  
`directory-path`  <a name="sftp-server-directory-path"></a>
Untuk direktori membuat dan menghapus peristiwa, jalur direktori.  
`server-id`  <a name="sftp-server-server-id"></a>
ID unik untuk server Transfer Family.  
`username`  <a name="sftp-server-username"></a>
Pengguna yang melakukan transfer.  
`session-id`  <a name="sftp-server-session-id"></a>
Pengenal unik untuk sesi transfer.  
`start-timestamp`  <a name="sftp-server-start-timestamp"></a>
Untuk transfer yang berhasil, stempel waktu saat pemrosesan file dimulai.

**Example Unduhan File Server SFTP Gagal contoh peristiwa**  <a name="event-detail-server-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana unduhan gagal di server SFTP (Amazon EFS adalah penyimpanan yang digunakan).  

```
{
    "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 Unggah File Server FTP Contoh acara selesai**  <a name="event-detail-server-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana unggahan berhasil diselesaikan pada server FTP (Amazon S3 adalah penyimpanan yang digunakan).  

```
{
    "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 Hapus File Server SFTP Contoh acara yang lengkap**  <a name="event-detail-server-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana file berhasil dihapus pada server 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 Ganti Nama File Server SFTP Contoh acara yang lengkap**  <a name="event-detail-server-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana file berhasil diganti namanya pada server 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 Direktori Server SFTP Buat contoh acara Selesai**  <a name="event-detail-server-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana direktori berhasil dibuat pada server 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"
    }
}
```

## Acara konektor SFTP
<a name="event-detail-sftp-connector-events"></a>

**catatan**  
Acara ini dikirimkan ke EventBridge tingkat tahan lama, seperti yang dijelaskan dalam [tingkat Pengiriman untuk acara AWS layanan](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) di *Referensi EventBridge Acara Amazon*.

Berikut ini adalah bidang detail untuk acara konektor SFTP:
+ Kirim File Konektor SFTP Selesai
+ Kirim File Konektor SFTP Gagal
+ Pengambilan File Konektor SFTP Selesai
+ Pengambilan File Konektor SFTP Gagal
+ Daftar Direktori Konektor SFTP Selesai
+ Daftar Direktori Konektor SFTP Gagal
+ Konektor SFTP Remote Move Selesai
+ Pindah Jarak Jauh Konektor SFTP Gagal
+ Penghapusan Jarak Jauh Konektor SFTP Selesai
+ Penghapusan Jarak Jauh Konektor SFTP Gagal

`detail-type`Bidang `source` dan disertakan di bawah ini karena mengandung nilai khusus untuk Transfer Family acara. Untuk definisi bidang metadata lain yang disertakan dalam semua peristiwa, lihat [Referensi struktur acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) di *Amazon EventBridge Panduan Pengguna*.

```
{
  . . .,
  "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>
Mengidentifikasi jenis acara.  
Untuk acara ini, nilainya adalah salah satu nama acara konektor SFTP yang tercantum sebelumnya.

`source`  <a name="event-detail-sftp-connector-events-source"></a>
Mengidentifikasi layanan yang menghasilkan peristiwa. Untuk Transfer Family acara, nilai ini adalah`aws.transfer`.

`detail`  <a name="sftp-connector-detail"></a>
Objek JSON yang berisi informasi tentang peristiwa. Layanan yang menghasilkan acara menentukan konten bidang ini.  
Untuk acara ini, data meliputi yang berikut:    
`max-items`  <a name="sftp-connector-max-items"></a>
Jumlah maksimum directory/file nama yang akan dikembalikan.  
`operation`  <a name="sftp-connector-operation"></a>
Apakah `StartFileTransfer` permintaan mengirim atau mengambil file. Nilai:`SEND|RETRIEVE`.  
`connector-id`  <a name="sftp-connector-connector-id"></a>
Pengidentifikasi unik untuk konektor SFTP yang digunakan.  
`output-directory-path`  <a name="sftp-connector-output-directory-path"></a>
Jalur (bucket dan awalan) di Amazon S3 untuk menyimpan hasil listing. file/directory   
`listing-id`  <a name="sftp-connector-listing-id"></a>
Pengenal unik untuk operasi `StartDirectoryListing` API. Pengenal ini dapat digunakan untuk memeriksa CloudWatch log untuk melihat status permintaan daftar.  
`transfer-id`  <a name="sftp-connector-transfer-id"></a>
Pengenal unik untuk acara transfer (`StartFileTransfer`permintaan).  
`file-transfer-id`  <a name="sftp-connector-file-transfer-id"></a>
Pengidentifikasi unik untuk file yang ditransfer.  
`url`  <a name="sftp-connector-url"></a>
URL titik akhir AS2 atau SFTP mitra.  
`file-path`  <a name="sftp-connector-file-path"></a>
Lokasi dan file yang sedang dikirim atau diambil.  
`status-code`  <a name="sftp-connector-status-code"></a>
Apakah transfer berhasil. Nilai:`FAILED | COMPLETED`.   
`failure-code`  <a name="sftp-connector-failure-code"></a>
Untuk transfer yang gagal, kode alasan mengapa transfer gagal.  
`failure-message`  <a name="sftp-connector-failure-message"></a>
Untuk transfer yang gagal, detail mengapa transfer gagal.  
`start-timestamp`  <a name="sftp-connector-start-timestamp"></a>
Untuk transfer yang berhasil, stempel waktu saat pemrosesan file dimulai.  
`end-timestamp`  <a name="sftp-connector-end-timestamp"></a>
Untuk transfer yang berhasil, stempel waktu saat pemrosesan file selesai.  
`local-directory-path`  <a name="sftp-connector-local-directory-path"></a>
Untuk `RETRIEVE` permintaan, lokasi di mana untuk menempatkan file yang diambil.  
`remote-directory-path`  <a name="sftp-connector-remote-directory-path"></a>
Untuk `SEND` permintaan, direktori file tempat menempatkan file di server SFTP mitra. Ini adalah nilai untuk `RemoteDirectoryPath` yang diteruskan pengguna ke `StartFileTransfer` permintaan. Anda dapat menentukan direktori default di server SFTP mitra. Jika demikian, bidang ini kosong.  
`item-count`  <a name="sftp-connector-item-count"></a>
Jumlah item (direktori dan file) yang dikembalikan untuk permintaan daftar.  
`truncated`  <a name="sftp-connector-truncated"></a>
Apakah output daftar berisi semua item yang terkandung dalam direktori jarak jauh atau tidak.  
`bytes`  <a name="sftp-connector-bytes"></a>
Jumlah byte yang ditransfer. Nilainya adalah 0 untuk transfer yang gagal.  
`egress-type`  <a name="sftp-connector-egress-type"></a>
Jenis konfigurasi jalan keluar untuk konektor. Nilai: `SERVICE_MANAGED` atau`VPC_LATTICE`.  
`vpc-lattice-resource-configuration-arn`  <a name="sftp-connector-vpc-lattice-resource-configuration-arn"></a>
ARN dari Konfigurasi Sumber Daya VPC\_LATTICE yang mendefinisikan lokasi server SFTP target. Bidang ini adalah nol untuk konektor yang dikelola layanan.  
`vpc-lattice-port-number`  <a name="sftp-connector-vpc-lattice-port-number"></a>
Nomor port untuk menghubungkan ke server SFTP melalui VPC\_LATTICE.  
`local-file-location`  <a name="sftp-connector-local-file-location"></a>
Parameter ini berisi rincian lokasi file AWS penyimpanan.     
`domain`  <a name="sftp-connector-domain"></a>
Penyimpanan yang digunakan. Saat ini, satu-satunya nilai adalah`S3`.  
`bucket`  <a name="sftp-connector-bucket"></a>
Wadah untuk objek di Amazon S3.  
`key`  <a name="sftp-connector-key"></a>
Nama yang ditetapkan untuk objek di Amazon S3.  
`output-file-location`  <a name="sftp-connector-output-file-location"></a>
Parameter ini berisi rincian lokasi tempat menyimpan hasil daftar direktori dalam AWS penyimpanan.    
`domain`  <a name="sftp-connector-output-domain"></a>
Penyimpanan yang digunakan. Saat ini, satu-satunya nilai adalah`S3`.  
`bucket`  <a name="sftp-connector-output-bucket"></a>
Wadah untuk objek di Amazon S3.  
`key`  <a name="sftp-connector-output-key"></a>
Nama yang ditetapkan untuk objek di Amazon S3.

**Example SFTP Connector File Kirim contoh peristiwa gagal**  <a name="event-detail-sftp-connector-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana konektor SFTP gagal saat mencoba mengirim file ke server SFTP jarak jauh.  

```
{
    "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 File Konektor SFTP Mengambil contoh acara yang lengkap**  <a name="event-detail-sftp-connector-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana konektor SFTP berhasil mengambil file yang dikirim dari server SFTP jarak jauh.  

```
{
    "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 Daftar Direktori Konektor SFTP Contoh acara yang lengkap**  <a name="event-detail-sftp-connector-events.example"></a>
Contoh berikut menunjukkan peristiwa di mana panggilan daftar direktori awal diambil file daftar dari server SFTP jarak jauh.  

```
{
    "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"
        }
    }
}
```

## Acara AS2
<a name="event-detail-as2-server-events"></a>

**catatan**  
Acara ini dikirimkan ke EventBridge tingkat tahan lama, seperti yang dijelaskan dalam [tingkat Pengiriman untuk acara AWS layanan](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html) di *Referensi EventBridge Acara Amazon*.

Berikut ini adalah bidang detail untuk acara AS2:
+ Terima Muatan AS2 Selesai
+ Penerimaan Muatan AS2 Gagal
+ Kirim Muatan AS2 Selesai
+ Kirim Muatan AS2 Gagal
+ AS2 MDN Terima Selesai
+ AS2 MDN Menerima Gagal
+ AS2 MDN Kirim Selesai
+ AS2 MDN Kirim Gagal

`detail-type`Bidang `source` dan disertakan di bawah ini karena mengandung nilai khusus untuk Transfer Family acara. Untuk definisi bidang metadata lain yang disertakan dalam semua peristiwa, lihat [Referensi struktur acara](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) di *Amazon EventBridge Panduan Pengguna*.

```
{
   . . .,
  "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>
Mengidentifikasi jenis acara.  
Untuk acara ini, nilainya adalah salah satu peristiwa AS2 yang tercantum sebelumnya.

`source`  <a name="event-detail-as2-server-events-source"></a>
Mengidentifikasi layanan yang menghasilkan peristiwa. Untuk Transfer Family acara, nilai ini adalah`aws.transfer`.

`detail`  <a name="as2-server-detail"></a>
Objek JSON yang berisi informasi tentang peristiwa. Layanan yang menghasilkan acara menentukan konten bidang ini.    
`s3-attributes`  <a name="as2-server-s3-attributes"></a>
Mengidentifikasi bucket dan kunci Amazon S3 untuk file yang ditransfer. Untuk acara MDN, ini juga mengidentifikasi bucket dan kunci untuk file MDN.    
`file-bucket`  <a name="as2-server-s3-file-bucket"></a>
Wadah untuk objek di Amazon S3.  
`file-key`  <a name="as2-server-s3-file-key"></a>
Nama yang ditetapkan untuk objek di Amazon S3.  
`json-bucket`  <a name="as2-server-s3-json-bucket"></a>
Untuk transfer SELESAI atau GAGAL, wadah untuk file JSON.  
`json-key`  <a name="as2-server-s3-json-key"></a>
Untuk transfer SELESAI atau GAGAL, nama yang ditetapkan ke file JSON di Amazon S3.  
`mdn-bucket`  <a name="as2-server-s3-mdn-bucket"></a>
Untuk acara MDN, wadah untuk file MDN.  
`mdn-key`  <a name="as2-server-s3-mdn-key"></a>
Untuk peristiwa MDN, nama ditetapkan ke file MDN di Amazon S3.   
`mdn-subject`  <a name="as2-server-mdn-subject"></a>
Untuk acara MDN, deskripsi teks untuk disposisi pesan.  
`mdn-message-id`  <a name="as2-server-mdn-message-id"></a>
Untuk acara MDN, ID unik untuk pesan MDN.  
`disposition`  <a name="as2-server-disposition"></a>
Untuk acara MDN, kategori untuk disposisi.  
`bytes`  <a name="as2-server-bytes"></a>
Jumlah byte dalam pesan.  
`as2-from`  <a name="as2-server-as2-from"></a>
Mitra dagang AS2 yang mengirim pesan.  
`as2-message-id`  <a name="as2-server-as2-message-id"></a>
Pengenal unik untuk pesan AS2 yang ditransfer.  
`as2-to`  <a name="as2-server-as2-to"></a>
Mitra dagang AS2 yang menerima pesan.  
`connector-id`  <a name="as2-server-connector-id"></a>
Untuk pesan AS2 yang dikirim dari server Transfer Family ke mitra dagang, pengenal unik untuk konektor AS2 digunakan.  
`client-ip`  <a name="as2-server-client-ip"></a>
Untuk kejadian server (transfer dari mitra dagang ke server Transfer Family), alamat IP untuk klien yang terlibat dalam transfer.   
`agreement-id`  <a name="as2-server-agreement-id"></a>
Untuk peristiwa server, pengenal unik untuk perjanjian AS2.  
`server-id`  <a name="as2-server-server-id"></a>
Untuk kejadian server, ID unik hanya untuk server Transfer Family.  
`requester-file-name`  <a name="as2-server-requester-file-name"></a>
Untuk acara payload, nama asli untuk file yang diterima selama transfer.  
`message-subject`  <a name="as2-server-message-subject"></a>
Deskripsi teks untuk subjek pesan.  
`start-timestamp`  <a name="as2-server-start-timestamp"></a>
Untuk transfer yang berhasil, stempel waktu saat pemrosesan file dimulai.  
`end-timestamp`  <a name="as2-server-end-timestamp"></a>
Untuk transfer yang berhasil, stempel waktu saat pemrosesan file selesai.  
`status-code`  <a name="as2-server-status-code"></a>
Kode yang sesuai dengan keadaan proses transfer pesan AS2. Nilai yang valid:`COMPLETED | FAILED | PROCESSING`.  
`failure-code`  <a name="as2-server-failure-code"></a>
Untuk transfer yang gagal, kategori mengapa transfer gagal.  
`failure-message`  <a name="as2-server-failure-message"></a>
Untuk transfer yang gagal, detail mengapa transfer gagal.  
`transfer-id`  <a name="as2-server-transfer-id"></a>
Pengenal unik untuk acara transfer.

**Example AS2 Payload Receive Contoh acara Selesai**  <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 Menerima contoh peristiwa Gagal**  <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"
  }
}
```