Koneksi ke server file SFTP dari alur kerja di Azure Logic Apps
Berlaku untuk: Azure Logic Apps (Konsumsi + Standar)
Panduan cara ini menunjukkan cara mengakses server SSH File Transfer Protocol (SFTP) Anda dari alur kerja di Azure Logic Apps. SFTP adalah protokol jaringan yang menyediakan akses file, transfer file, dan manajemen file melalui aliran data yang andal dan menggunakan protokol Secure Shell (SSH ).
Dalam alur kerja aplikasi logika Konsumsi, Anda dapat menggunakan konektor terkelola SFTP-SSH, sementara di alur kerja aplikasi logika Standar, Anda dapat menggunakan konektor bawaan SFTP atau konektor terkelola SFTP-SSH. Anda dapat menggunakan operasi konektor ini untuk membuat alur kerja otomatis yang berjalan saat dipicu oleh peristiwa di server SFTP Anda atau di sistem lain dan menjalankan tindakan untuk mengelola file di server SFTP Anda. Konektor terkelola dan bawaan menggunakan protokol SSH.
Catatan
Konektor terkelola SFTPtidak digunakan lagi, sehingga operasi konektor ini tidak lagi muncul di perancang alur kerja.
Misalnya, alur kerja Anda dapat dimulai dengan pemicu SFTP yang memantau dan merespons peristiwa di server SFTP Anda. Pemicu membuat output tersedia untuk tindakan berikutnya dalam alur kerja Anda. Alur kerja Anda dapat menjalankan tindakan SFTP yang mendapatkan, membuat, dan mengelola file melalui akun server SFTP Anda. Daftar berikut ini menyertakan lebih banyak contoh tugas:
- Memantau ketika file ditambahkan atau diubah.
- Mendapatkan, membuat, menyalin, mengganti nama, memperbarui, membuat daftar, dan menghapus file.
- Membuat folder.
- Dapatkan isi file dan metadatanya.
- Mengekstrak arsip ke folder.
Langkah-langkah berikut menggunakan portal Azure, tetapi dengan ekstensi Azure Logic Apps yang sesuai, Anda juga dapat menggunakan alat berikut untuk membuat dan mengedit alur kerja aplikasi logika:
Alur kerja aplikasi logika konsumsi: Visual Studio atau Visual Studio Code
Alur kerja aplikasi logika standar: Visual Studio Code
referensi teknis Koneksi or
Konektor SFTP memiliki versi yang berbeda, berdasarkan jenis aplikasi logika dan lingkungan host.
| Jenis aplikasi logika (paket) | Lingkungan | Versi konektor |
|---|---|---|
| Consumption | Azure Logic Apps multi-penyewa | Konektor terkelola, yang muncul di perancang di bawah label Standar . Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola SFTP-SSH - Konektor terkelola di Azure Logic Apps |
| Consumption | Lingkungan layanan integrasi (ISE) | Konektor terkelola, yang muncul di perancang di bawah label Standar , dan versi ISE, yang muncul di perancang dengan label ISE dan memiliki batas pesan yang berbeda dari konektor terkelola. Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola SFTP-SSH - Batas pesan ISE - Konektor terkelola di Azure Logic Apps |
| Standard | Azure Logic Apps penyewa tunggal dan Lingkungan App Service v3 (hanya paket Windows) | Konektor terkelola, yang muncul di galeri konektor di bawah Runtime>Shared, dan konektor bawaan, yang muncul di galeri konektor di bawah Runtime>In-App dan berbasis penyedia layanan. Konektor bawaan dapat langsung terhubung ke server SFTP dan mengakses jaringan virtual Azure dengan menggunakan string koneksi tanpa gateway data lokal. Untuk informasi selengkapnya, tinjau dokumentasi berikut: - Referensi konektor terkelola SFTP-SSH - Referensi konektor bawaan SFTP - Konektor terkelola di Azure Logic Apps - Konektor bawaan di Azure Logic Apps |
Batasan umum
Sebelum Anda menggunakan konektor terkelola SFTP-SSH, lihat referensi konektor terkelola SFTP-SSH - masalah dan batasan yang diketahui.
Sebelum Anda menggunakan konektor bawaan SFTP, lihat Referensi konektor bawaan SFTP - masalah dan batasan yang diketahui.
Masalah umum
Secara default, pemicu yang mengembalikan array memiliki pengaturan Split On yang sudah diaktifkan. Dengan mengaktifkan pengaturan ini, pemicu secara otomatis memperdebatkan array dengan membuat instans alur kerja terpisah secara internal untuk memproses setiap item array. Semua instans alur kerja berjalan secara paralel sehingga item array diproses secara bersamaan.
Namun, ketika pengaturan Split On diaktifkan, pemicu konektor terkelola mengembalikan output untuk semua item array sebagai daftar. Setiap tindakan berikutnya yang mereferensikan output ini harus terlebih dahulu menangani output ini sebagai daftar. Untuk menangani setiap item array satu per satu, Anda dapat menambahkan tindakan tambahan. Misalnya, untuk melakukan iterasi melalui item array ini, Anda dapat menggunakan untuk setiap perulangan. Untuk pemicu yang hanya mengembalikan metadata atau properti, gunakan tindakan yang mendapatkan metadata item array terlebih dahulu, lalu gunakan tindakan untuk mendapatkan konten item.
Anda harus menerapkan pendekatan ini hanya untuk pemicu konektor terkelola , bukan pemicu konektor bawaan yang mengembalikan output untuk satu item array pada saat pengaturan Pisahkan Saat diaktifkan.
Misalnya, Anda memiliki pemicu konektor terkelola bernama Saat file ditambahkan atau dimodifikasi (hanya properti) yang mengembalikan metadata atau properti untuk file baru atau yang diperbarui sebagai array. Untuk mendapatkan metadata secara terpisah untuk setiap file, Anda dapat menggunakan untuk setiap perulangan yang berulang melalui array. Dalam perulangan ini, gunakan tindakan konektor terkelola berikut dalam urutan yang ditentukan:
Dapatkan metadata file untuk mendapatkan metadata setiap file.
Dapatkan tindakan konten file untuk mendapatkan konten setiap file.
Chunking
Untuk informasi selengkapnya tentang bagaimana konektor terkelola SFTP-SSH dapat menangani file besar yang melebihi batas ukuran default, lihat Referensi konektor terkelola SFTP-SSH - Penggugusan.
Prasyarat
Akun dan langganan Azure. Jika Anda tidak memiliki langganan Azure, daftar akun Azure gratis.
Koneksi dan informasi autentikasi untuk mengakses server SFTP Anda, seperti alamat server, kredensial akun, akses ke kunci privat SSH, dan kata sandi kunci privat SSH. Untuk informasi selengkapnya, lihat Referensi konektor terkelola SFTP-SSH - Autentikasi dan izin.
Penting
Saat Anda membuat koneksi dan memasukkan kunci privat SSH di properti kunci privat SSH, pastikan untuk mengikuti langkah-langkah untuk memberikan nilai lengkap dan benar untuk properti ini. Jika tidak, kunci yang tidak valid menyebabkan koneksi gagal.
Alur kerja aplikasi logika tempat Anda ingin mengakses akun SFTP Anda. Untuk memulai dengan pemicu SFTP-SSH, Anda harus memulai dengan alur kerja kosong. Untuk menggunakan tindakan SFTP-SSH, mulai alur kerja Anda dengan pemicu lain, seperti pemicu Pengulangan .
Menambahkan pemicu SFTP
Di portal Azure, buka aplikasi logika Konsumsi Anda dengan alur kerja kosong di perancang.
Di perancang, ikuti langkah-langkah umum ini untuk menambahkan pemicu SFTP-SSH yang Anda inginkan.
Jika diminta, berikan informasi koneksi yang diperlukan. Jika sudah selesai, pilih Buat.
Setelah kotak informasi pemicu muncul, berikan detail yang diperlukan untuk pemicu yang Anda pilih. Untuk informasi selengkapnya, lihat Referensi pemicu konektor terkelola SFTP-SSH.
Setelah selesai, simpan alur kerja. Di bar alat perancang, pilih Simpan.
Saat Anda menyimpan alur kerja, langkah ini secara otomatis menerbitkan pembaruan Anda ke aplikasi logika yang disebarkan, yang ditayangkan di Azure. Hanya dengan pemicu, alur kerja Anda hanya memeriksa server FTP berdasarkan jadwal yang Anda tentukan. Anda harus menambahkan tindakan yang merespons pemicu dan melakukan sesuatu dengan output pemicu.
Misalnya, pemicu bernama Saat file ditambahkan atau dimodifikasi memulai alur kerja saat file ditambahkan atau diubah di server SFTP. Sebagai tindakan berikutnya, Anda dapat menambahkan kondisi yang memeriksa apakah konten file memenuhi kriteria yang Anda tentukan. Jika konten memenuhi kondisi, gunakan tindakan bernama Dapatkan konten file untuk mendapatkan konten file, lalu gunakan tindakan lain untuk menempatkan konten file tersebut ke folder lain di server SFTP.
Menambahkan tindakan SFTP
Sebelum Anda dapat menggunakan tindakan SFTP, alur kerja Anda harus sudah dimulai dengan pemicu, yang bisa dalam bentuk apa pun yang Anda pilih. Misalnya, Anda dapat menggunakan pemicu bawaan Pengulangan generik untuk memulai alur kerja Anda pada jadwal tertentu.
Di portal Azure, buka aplikasi logika Konsumsi Anda dengan alur kerja di perancang.
Di perancang, ikuti langkah-langkah umum ini untuk menambahkan tindakan SFTP-SSH yang Anda inginkan.
Jika diminta, berikan informasi koneksi yang diperlukan. Jika sudah selesai, pilih Buat.
Setelah kotak informasi tindakan muncul, berikan detail yang diperlukan untuk tindakan yang Anda pilih. Untuk informasi selengkapnya, lihat Referensi tindakan konektor terkelola SFTP-SSH.
Setelah selesai, simpan alur kerja. Di bar alat perancang, pilih Simpan.
Misalnya, tindakan bernama Dapatkan konten file menggunakan jalur mendapatkan konten dari file di server SFTP dengan menentukan jalur file. Anda dapat menggunakan pemicu dari contoh sebelumnya dan kondisi yang harus dipenuhi konten file. Jika kondisinya benar, tindakan berikutnya bisa mendapatkan konten.
Pemecahan Masalah
Untuk informasi selengkapnya, lihat dokumentasi berikut:
- Referensi konektor terkelola SFTP-SSH - Pemecahan masalah
- Referensi konektor bawaan SFTP - Pemecahan masalah