View a markdown version of this page

Mengelola Transfer Family acara menggunakan Amazon EventBridge - AWS Transfer Family

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

Mengelola Transfer Family acara menggunakan Amazon EventBridge

Amazon EventBridge adalah layanan tanpa server yang menggunakan peristiwa untuk menghubungkan komponen aplikasi bersama-sama, yang dapat memudahkan Anda membangun aplikasi berbasis peristiwa yang dapat diskalakan. Event-driven arsitektur adalah gaya membangun sistem perangkat lunak yang digabungkan secara longgar yang bekerja bersama dengan memancarkan dan menanggapi peristiwa. Peristiwa mewakili perubahan dalam sumber daya atau lingkungan.

Seperti banyak AWS layanan, Transfer Family menghasilkan dan mengirim peristiwa ke bus acara EventBridge default. Perhatikan bahwa bus acara default disediakan secara otomatis di setiap AWS akun. Bus acara adalah router yang menerima acara dan mengirimkannya ke nol atau lebih tujuan, atau target. Anda menentukan aturan untuk bus acara yang mengevaluasi peristiwa saat mereka tiba. Setiap aturan memeriksa apakah suatu peristiwa cocok dengan pola peristiwa aturan. Jika acara cocok, bus acara mengirimkan acara ke satu atau lebih target yang ditentukan.

AWS layanan mengirim acara ke bus acara EventBridge default. Jika acara cocok dengan pola peristiwa aturan, EventBridge mengirimkan peristiwa ke target yang ditentukan untuk aturan tersebut.

Transfer Family peristiwa

Transfer Family secara otomatis mengirim acara ke bus EventBridge acara default. Anda dapat membuat aturan pada bus acara di mana setiap aturan menyertakan pola peristiwa dan satu atau lebih target.

Peristiwa yang cocok dengan pola peristiwa aturan dikirimkan ke target yang ditentukan atas dasar upaya terbaik atau tahan lama (perhatikan bahwa beberapa peristiwa mungkin dikirimkan secara tidak sesuai urutan). Tingkat pengiriman ini dijelaskan di Tingkat pengiriman untuk acara AWS layanan di Referensi A EventBridge cara Amazon.

  • Server-level acara untuk server SFTP, FTPS dan FTP disampaikan atas dasar upaya terbaik.

  • Acara konektor SFTP disampaikan secara tahan lama.

  • Acara AS2 disampaikan secara tahan lama.

Peristiwa berikut dihasilkan oleh Transfer Family. Untuk informasi selengkapnya, lihat EventBridge acara di Panduan Amazon EventBridge Pengguna.

Acara server SFTP, FTPS, dan FTP

Tabel berikut mencantumkan acara untuk server SFTP, FTPS, dan FTP, diatur berdasarkan jenis acara.

Acara unggah dan unduh file

Jenis detail acara Deskripsi

Pengunduhan File Server FTP Selesai

File telah berhasil diunduh untuk protokol FTP.

Pengunduhan File Server FTP Gagal

Upaya untuk mengunduh file gagal untuk protokol FTP.

Pengunggahan File Server FTP Selesai

File telah berhasil diunggah untuk protokol FTP.

Pengunggahan File Server FTP Gagal

Upaya untuk mengunggah file gagal untuk protokol FTP.

Pengunduhan File Server FTPS Selesai

File telah berhasil diunduh untuk protokol FTPS.

Pengunduhan File Server FTPS Gagal

Upaya untuk mengunduh file gagal untuk protokol FTPS.

Pengunggahan File Server FTPS Selesai

File telah berhasil diunggah untuk protokol FTPS.

Pengunggahan File Server FTPS Gagal

Upaya untuk mengunggah file gagal untuk protokol FTPS.

Pengunduhan File Server SFTP Selesai

File telah berhasil diunduh untuk protokol SFTP.

Pengunduhan File Server SFTP Gagal

Upaya untuk mengunduh file gagal untuk protokol SFTP.

Unggahan File Server SFTP Selesai

File telah berhasil diunggah untuk protokol SFTP.

Pengunggahan File Server SFTP Gagal

Upaya untuk mengunggah file gagal untuk protokol SFTP.

Acara operasi file lainnya

Jenis detail acara Deskripsi

Direktori Server FTP Membuat Selesai

Direktori telah berhasil dibuat untuk protokol FTP.

Pembuatan Direktori Server FTP Gagal

Upaya untuk membuat direktori gagal untuk protokol FTP.

Penghapusan Direktori Server FTP Selesai

Direktori telah berhasil dihapus untuk protokol FTP.

Penghapusan Direktori Server FTP Gagal

Upaya untuk menghapus direktori gagal untuk protokol FTP.

Penghapusan File Server FTP Selesai

File telah berhasil dihapus untuk protokol FTP.

Penghapusan File Server FTP Gagal

Upaya untuk menghapus file telah gagal untuk protokol FTP.

Penggantian Nama File Server FTP Selesai

File telah berhasil diganti namanya untuk protokol FTP.

Penggantian Nama File Server FTP Gagal

Upaya untuk mengganti nama file telah gagal untuk protokol FTP.

Direktori Server FTPS Pembuatan Selesai

Direktori telah berhasil dibuat untuk protokol FTPS.

Pembuatan Direktori Server FTPS Gagal

Upaya untuk membuat direktori gagal untuk protokol FTPS.

Penghapusan Direktori Server FTPS Selesai

Direktori telah berhasil dihapus untuk protokol FTPS.

Penghapusan Direktori Server FTPS Gagal

Upaya untuk menghapus direktori gagal untuk protokol FTPS.

Penghapusan File Server FTPS Selesai

File telah berhasil dihapus untuk protokol FTPS.

Penghapusan File Server FTPS Gagal

Upaya untuk menghapus file gagal untuk protokol FTPS.

Penggantian Nama File Server FTPS Selesai

File telah berhasil diganti namanya untuk protokol FTPS.

Penggantian Nama File Server FTPS Gagal

Upaya untuk mengganti nama file telah gagal untuk protokol FTPS.

Direktori Server SFTP Pembuatan Selesai

Sebuah direktori telah berhasil dibuat untuk protokol SFTP.

Pembuatan Direktori Server SFTP Gagal

Upaya untuk membuat direktori gagal untuk protokol SFTP.

Penghapusan Direktori Server SFTP Selesai

Direktori telah berhasil dihapus untuk protokol SFTP.

Penghapusan Direktori Server SFTP Gagal

Upaya untuk menghapus direktori gagal untuk protokol SFTP.

Penghapusan File Server SFTP Selesai

File telah berhasil dihapus untuk protokol SFTP.

Penghapusan File Server SFTP Gagal

Upaya untuk menghapus file telah gagal untuk protokol SFTP.

Penggantian Nama File Server SFTP Selesai

File telah berhasil diganti namanya untuk protokol SFTP.

Penggantian Nama File Server SFTP Gagal

Upaya untuk mengganti nama file telah gagal untuk protokol SFTP.

Peristiwa konektor SFTP

catatan

Acara ini dikirim ke EventBridge tingkat yang tahan lama, seperti yang dijelaskan dalam Tingkat pengiriman untuk acara AWS layanan di Referensi A EventBridge cara Amazon.

Jenis detail acara Deskripsi

Kirim File Konektor SFTP Selesai

Transfer file dari konektor ke server SFTP jarak jauh telah berhasil diselesaikan.

Kirim File Konektor SFTP Gagal

Transfer file dari konektor ke server SFTP jarak jauh gagal.

Pengambilan File Konektor SFTP Selesai

Transfer file dari server SFTP jarak jauh ke konektor telah berhasil diselesaikan.

Pengambilan File Konektor SFTP Gagal

Transfer file dari server SFTP jarak jauh ke konektor gagal.

Daftar Direktori Konektor SFTP Selesai

Panggilan daftar direktori file awal yang telah berhasil diselesaikan.

Daftar Direktori Konektor SFTP Gagal

Daftar direktori file awal yang gagal.

Pemindahan Jarak Jauh Konektor SFTP Selesai

File atau direktori telah dipindahkan atau diganti namanya dengan sukses di server jarak jauh.

Pemindahan Jarak Jauh Konektor SFTP Gagal

File atau direktori gagal dipindahkan atau diganti namanya di server jarak jauh.

Penghapusan Jarak Jauh Konektor SFTP Selesai

File atau direktori telah berhasil dihapus di server jarak jauh.

Penghapusan Jarak Jauh Konektor SFTP Gagal

File atau direktori gagal dihapus di server jarak jauh.

Acara AS2

catatan

Acara ini dikirim ke EventBridge tingkat yang tahan lama, seperti yang dijelaskan dalam Tingkat pengiriman untuk acara AWS layanan di Referensi A EventBridge cara Amazon.

Jenis detail acara Deskripsi

Penerimaan Payload AS2 Selesai

Payload untuk pesan AS2 telah diterima.

Penerimaan Payload AS2 Gagal

Payload untuk pesan AS2 belum diterima.

AS2 Payload Kirim Selesai

Payload untuk pesan AS2 telah berhasil dikirim.

Kirim Payload AS2 Gagal

Payload untuk pesan AS2 gagal dikirim.

Penerimaan AS2 MDN Selesai

Pemberitahuan disposisi pesan untuk pesan AS2 telah diterima.

Penerimaan AS2 MDN Gagal

Pemberitahuan disposisi pesan untuk pesan AS2 belum diterima.

AS2 MDN Kirim Selesai

Pemberitahuan disposisi pesan untuk pesan AS2 telah berhasil dikirim.

Kirim AS2 MDN Gagal

Pemberitahuan disposisi pesan untuk pesan AS2 gagal dikirim.

Mengirim Transfer Family peristiwa dengan menggunakan EventBridge aturan

Jika Anda ingin bus acara EventBridge default mengirim Transfer Family peristiwa ke target, Anda harus membuat aturan yang berisi pola peristiwa yang cocok dengan data dalam Transfer Family acara yang Anda inginkan.

Untuk menangkap AWS Transfer Family acara di Amazon EventBridge
  1. Masuk ke Konsol Manajemen AWS dan buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.

  2. Di panel navigasi, pilih A turan, lalu pilih Buat aturan.

  3. Masukkan nama deskriptif untuk aturan, dan secara opsional masukkan deskripsi.

  4. Untuk tipe A turan, pilih Aturan dengan pola peristiwa lalu pilih Ber ikutnya.

  5. Di bagian Sumber acara, pilih AWS acara atau acara EventBridge mitra.

  6. Di bagian Metode pembuatan, pilih Gunakan formulir pola.

  7. Di bagian Pola acara, berikan informasi berikut.

    1. Untuk Sumber peristiwa, pilih Layanan AWS .

    2. Untuk AWS layanan, pilih Transfer.

    3. Untuk Jenis acara, pilih jenis acara Transfer Family yang ingin Anda picu aturan.

      Tergantung pada pilihan jenis Acara Anda, Anda mungkin disajikan dengan bagian Spesifikasi Jenis Acara 1.

    4. Jika Anda melihat bagian Spesifikasi Jenis Per istiwa 1, pilih peristiwa tertentu yang ingin Anda tangkap (atau pilih Acara apa saja untuk menangkap semua peristiwa untuk jenis acara yang Anda pilih).

    5. (Opsional) Gunakan editor pola acara untuk menentukan filter untuk detail acara.

    6. Pilih Berikutnya.

  8. Pilih target dari pilihan yang tersedia di Pilih target. Pilih dari target yang tersedia berikut.

    • AWS layanan. Opsi populer adalah fungsi Lambda untuk komputasi tanpa server, antrian Amazon SQS untuk pemrosesan pesan, topik Amazon SNS untuk pemberitahuan, dan untuk mengatur alur kerja. AWS Step Functions

    • EventBridge Tujuan API. Jika Anda ingin mengirim peristiwa ke titik akhir HTTP di luar AWS, Anda dapat menggunakan Tujuan API sebagai target Anda.

    • EventBridge bus acara. Anda dapat mengirim acara ke bus acara lain, baik di akun dan wilayah yang sama atau di akun atau wilayah yang berbeda.

      Untuk petunjuk komprehensif tentang membuat aturan bus acara, lihat Membuat aturan yang bereaksi terhadap peristiwa di Panduan EventBridge Pengguna Amazon.

    Untuk bantuan dalam memilih target, lihat Memilih target di Panduan EventBridge Pengguna Amazon.

  9. Konfigurasikan opsi tambahan apa pun untuk target Anda lalu pilih Ber ikutnya.

  10. (Opsional) Tambahkan tag ke aturan Anda dan pilih Ber ikutnya.

  11. Di layar Tinjau dan buat, jika semuanya terlihat bagus, pilih Buat aturan.

Membuat pola acara untuk Transfer Family peristiwa

Saat Transfer Family mengirimkan peristiwa ke bus acara default, EventBridge menggunakan pola peristiwa yang ditentukan untuk setiap aturan untuk menentukan apakah acara harus dikirimkan ke target aturan. Pola peristiwa cocok dengan data dalam Transfer Family peristiwa yang diinginkan. Setiap pola peristiwa adalah objek JSON yang berisi berikut ini:

  • A source tribut yang mengidentifikasi layanan yang mengirim acara. Untuk Transfer Family acara, sumbernya adalahaws.transfer.

  • (Opsional) A detail-type tribut yang berisi array jenis peristiwa yang akan dicocokkan.

  • (Opsional) A detail tribut yang berisi data peristiwa lain yang akan dicocokkan.

Misalnya, pola acara berikut cocok dengan semua peristiwa dari Transfer Family:

{ "source": ["aws.transfer"] }

Contoh pola peristiwa berikut cocok dengan semua peristiwa konektor 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"] }

Contoh pola peristiwa berikut cocok dengan semua peristiwa gagal Transfer Family:

{ "source": ["aws.transfer"], "detail-type": [{"wildcard", "*Failed"}] }

Contoh pola peristiwa berikut cocok dengan unduhan SFTP yang berhasil untuk pengguna: username

{ "source": ["aws.transfer"], "detail-type": ["SFTP Server File Download Completed"], "detail": { "username": [username] } }

Untuk informasi selengkapnya tentang penulisan pola peristiwa, lihat P ola peristiwa di Panduan EventBridge Pengguna.

Menguji pola acara untuk Transfer Family acara di EventBridge

Anda dapat menggunakan EventBridge Sandbox untuk menentukan dan menguji pola peristiwa dengan cepat, tanpa harus menyelesaikan proses pembuatan atau pengeditan aturan yang lebih luas. Dengan menggunakan Sandbox, Anda dapat menentukan pola peristiwa dan menggunakan contoh peristiwa untuk mengonfirmasi bahwa pola tersebut cocok dengan peristiwa yang diinginkan. EventBridge memberi Anda opsi untuk membuat aturan baru dengan menggunakan pola peristiwa itu langsung dari kotak pasir.

Untuk informasi selengkapnya, lihat Menguji pola peristiwa menggunakan EventBridge Sandbox di Panduan EventBridge Pengguna.

Amazon EventBridge izin

Transfer Family tidak memerlukan izin tambahan untuk mengirimkan acara ke Amazon EventBridge.

Target yang Anda tentukan mungkin memerlukan izin atau konfigurasi tertentu. Untuk detail selengkapnya tentang menggunakan layanan tertentu untuk target, lihat Amazon EventBridge target di Panduan Amazon EventBridge Pengguna.

Tambahan EventBridge sumber daya

Lihat topik berikut di Panduan Amazon EventBridge Pengguna untuk informasi selengkapnya tentang cara menggunakan EventBridge untuk memproses dan mengelola acara.

  • Untuk informasi terperinci tentang cara kerja bus acara, lihat bus Amazon EventBridge acara.

  • Untuk informasi tentang struktur acara, lihat A cara.

  • Untuk informasi tentang membangun pola peristiwa EventBridge untuk digunakan saat mencocokkan peristiwa dengan aturan, lihat P ola peristiwa.

  • Untuk informasi tentang membuat aturan untuk menentukan EventBridge proses peristiwa mana, lihat A turan.

  • Untuk informasi tentang cara menentukan layanan atau tujuan lain yang EventBridge mengirimkan acara yang cocok, lihat Tar get.