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. Arsitektur berbasis peristiwa adalah gaya membangun sistem perangkat lunak yang digabungkan secara longgar yang bekerja sama dengan memancarkan dan menanggapi peristiwa. Peristiwa mewakili perubahan dalam sumber daya atau lingkungan.

Seperti banyak AWS layanan, Transfer Family menghasilkan dan mengirim acara ke bus acara EventBridge default. Perhatikan bahwa bus acara default secara otomatis disediakan 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 acara 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 acara aturan, EventBridge kirimkan acara ke target yang ditentukan untuk aturan tersebut.

Transfer Family acara

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

Peristiwa yang cocok dengan pola peristiwa aturan dikirimkan ke target yang ditentukan baik dengan upaya terbaik atau tahan lama (perhatikan bahwa beberapa peristiwa mungkin dikirimkan tidak berurutan). Tingkat pengiriman ini dijelaskan dalam tingkat Pengiriman untuk peristiwa AWS layanan di Referensi EventBridge Acara Amazon.

  • Acara tingkat server untuk server SFTP, FTPS, dan FTP disampaikan dengan upaya terbaik.

  • Acara konektor SFTP dikirimkan secara tahan lama.

  • AS2 Acara disampaikan secara tahan lama.

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

Acara server SFTP, FTPS, dan FTP

Tabel berikut mencantumkan peristiwa untuk server SFTP, FTPS, dan FTP, yang diselenggarakan berdasarkan jenis acara.

Unggah file dan unduh acara

Jenis detail acara Deskripsi

Unduhan File Server FTP Selesai

File telah berhasil diunduh untuk protokol FTP.

Unduhan File Server FTP Gagal

Upaya untuk mengunduh file gagal untuk protokol FTP.

Unggahan File Server FTP Selesai

Sebuah file telah berhasil diunggah untuk protokol FTP.

Unggahan File Server FTP Gagal

Upaya untuk mengunggah file gagal untuk protokol FTP.

Unduhan File Server FTPS Selesai

File telah berhasil diunduh untuk protokol FTPS.

Unduhan File Server FTPS Gagal

Upaya untuk mengunduh file gagal untuk protokol FTPS.

Unggahan File Server FTPS Selesai

Sebuah file telah berhasil diunggah untuk protokol FTPS.

Unggahan File Server FTPS Gagal

Upaya untuk mengunggah file gagal untuk protokol FTPS.

Unduhan File Server SFTP Selesai

File telah berhasil diunduh untuk protokol SFTP.

Unduhan File Server SFTP Gagal

Upaya untuk mengunduh file gagal untuk protokol SFTP.

Unggahan File Server SFTP Selesai

Sebuah file telah berhasil diunggah untuk protokol SFTP.

Unggahan 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.

Membuat 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

Sebuah file telah berhasil dihapus untuk protokol FTP.

Penghapusan File Server FTP Gagal

Upaya untuk menghapus file gagal untuk protokol FTP.

Ganti Nama File Server FTP Selesai

Sebuah file telah berhasil diganti namanya untuk protokol FTP.

Gagal Mengganti Nama File Server FTP

Upaya untuk mengganti nama file telah gagal untuk protokol FTP.

Direktori Server FTPS Membuat 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

Sebuah file telah berhasil dihapus untuk protokol FTPS.

Penghapusan File Server FTPS Gagal

Upaya untuk menghapus file gagal untuk protokol FTPS.

Ganti Nama File Server FTPS Selesai

Sebuah file telah berhasil diganti namanya untuk protokol FTPS.

Gagal Mengganti Nama File Server FTPS

Upaya untuk mengganti nama file telah gagal untuk protokol FTPS.

Direktori Server SFTP Membuat Selesai

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 telah gagal untuk protokol SFTP.

Penghapusan File Server SFTP Selesai

Sebuah file telah berhasil dihapus untuk protokol SFTP.

Penghapusan File Server SFTP Gagal

Upaya untuk menghapus file gagal untuk protokol SFTP.

Ganti Nama File Server SFTP Selesai

Sebuah file telah berhasil diganti namanya untuk protokol SFTP.

Gagal Mengganti Nama File Server SFTP

Upaya untuk mengganti nama file telah gagal untuk protokol SFTP.

Acara konektor SFTP

catatan

Acara ini dikirimkan ke EventBridge tingkat tahan lama, seperti yang dijelaskan dalam tingkat Pengiriman untuk acara AWS layanan di Referensi EventBridge Acara 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 telah 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 mulai yang telah selesai dengan sukses.

Daftar Direktori Konektor SFTP Gagal

Daftar direktori file awal yang gagal.

Konektor SFTP Remote Move Selesai

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

Pindah 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.

AS2 acara

catatan

Acara ini dikirimkan ke EventBridge tingkat tahan lama, seperti yang dijelaskan dalam tingkat Pengiriman untuk acara AWS layanan di Referensi EventBridge Acara Amazon.

Jenis detail acara Deskripsi

AS2 Payload Terima Selesai

Muatan untuk AS2 pesan telah diterima.

AS2 Penerimaan Muatan Gagal

Muatan untuk AS2 pesan belum diterima.

AS2 Muatan Kirim Selesai

Payload untuk AS2 pesan telah berhasil dikirim.

AS2 Kirim Muatan Gagal

Muatan untuk AS2 pesan gagal dikirim.

AS2 MDN Terima Selesai

Pemberitahuan disposisi pesan untuk AS2 pesan telah diterima.

AS2 MDN Menerima Gagal

Pemberitahuan disposisi AS2 pesan untuk pesan belum diterima.

AS2 MDN Kirim Selesai

Pemberitahuan disposisi pesan untuk AS2 pesan telah berhasil dikirim.

AS2 MDN Kirim Gagal

Pemberitahuan disposisi AS2 pesan untuk pesan gagal dikirim.

Mengirim Transfer Family acara dengan menggunakan EventBridge aturan

Jika Anda ingin bus acara EventBridge default mengirim Transfer Family acara 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 peristiwa di Amazon EventBridge
  1. Masuk ke AWS Management Console dan buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.

  2. Di panel navigasi, pilih Aturan, lalu pilih Buat aturan.

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

  4. Untuk jenis Aturan, pilih Aturan dengan pola acara lalu pilih Berikutnya.

  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 memicu aturan Anda.

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

    4. Jika Anda melihat bagian Spesifikasi Jenis Acara 1, pilih peristiwa tertentu yang ingin Anda ambil (atau pilih Setiap peristiwa untuk menangkap semua acara 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 notifikasi, 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 API Destination 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 cara membuat aturan bus acara, lihat Membuat aturan yang bereaksi terhadap peristiwa di Panduan EventBridge Pengguna Amazon.

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

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

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

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

Membuat pola acara untuk Transfer Family acara

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

  • sourceAtribut yang mengidentifikasi layanan yang mengirim acara. Untuk Transfer Family acara, sumbernya adalahaws.transfer.

  • (Opsional) detail-type Atribut yang berisi array jenis acara yang cocok.

  • (Opsional) detail Atribut yang berisi data peristiwa lain yang cocok.

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 acara 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 acara, lihat Pola acara di Panduan EventBridge Pengguna.

Menguji pola acara untuk Transfer Family acara di EventBridge

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

Untuk informasi selengkapnya, lihat Menguji pola peristiwa menggunakan EventBridge Kotak Pasir 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 penggunaan layanan khusus untuk target, lihat Amazon EventBridge target di Panduan Amazon EventBridge Pengguna.

Sumber daya EventBridge tambahan

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

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

  • Untuk informasi tentang struktur acara, lihat Acara.

  • Untuk informasi tentang membuat pola peristiwa untuk EventBridge digunakan saat mencocokkan peristiwa dengan aturan, lihat Pola acara.

  • Untuk informasi tentang membuat aturan untuk menentukan EventBridge proses peristiwa, lihat Aturan.

  • Untuk informasi tentang cara menentukan layanan atau tujuan lain yang EventBridge mengirimkan peristiwa yang cocok, lihat Target.