Nawiązywanie połączenia z plikami na serwerach SFTP za pośrednictwem protokołu Secure Shell (SSH) z przepływów pracy w Azure Logic Apps

Dotyczy: Azure Logic Apps (Consumption + Standard)

Gdy przepływ pracy musi wykonywać zautomatyzowane, bezpieczne zarządzanie plikami na serwerach używających protokołu transferu plików Secure Shell (SSH) (SFTP), należy użyć SFTP-SSH lub SFTP operacji łącznika w przepływach pracy tworzonych za pomocą Azure Logic Apps.

SFTP to protokół sieciowy, który zapewnia dostęp do plików, transfer plików i zarządzanie plikami za pośrednictwem dowolnego niezawodnego strumienia danych. Następnie można monitorować, przesyłać i zarządzać plikami na serwerze SFTP bez konieczności pisania niestandardowego kodu lub zarządzania infrastrukturą. W przeciwnym razie próba ręcznego zarządzania tymi operacjami plików może być czasochłonna, podatna na błędy i trudna do skalowania.

Na przykład przepływ pracy może wykonać następujące zadania:

Monitorowanie i przetwarzanie przychodzących plików danych.
Tworzenie folderów i plików oraz zarządzanie nimi.
Pobieranie zawartości pliku i metadanych. Wyodrębnianie archiwów.
Dystrybuuj raporty.
Synchronizowanie zawartości między środowiskami.

W tym przewodniku pokazano, jak uzyskać dostęp do serwera SFTP z przepływu pracy w Azure Logic Apps.

Aby uzyskać więcej informacji, zobacz:

Dokumentacja techniczna łącznika

Łącznik SFTP-SSH ma różne wersje na podstawie typu aplikacji logiki i środowiska hosta.

Przepływy pracy konsumpcyjne i standardowe mogą używać łącznika SFTP-SSHmanaged, który współdzieli zasoby obliczeniowe z innymi zasobami w środowisku wielodostępnym Azure. Standardowe przepływy pracy mogą również używać natywnego dla środowiska uruchomieniowego lub wbudowanego łącznika SFTP. Obie wersje łącznika używają protokołu SSH.

Typ aplikacji logiki (plan)	Środowisko	Wersja łącznika
Zużycie	Wielodostępna usługa Azure Logic Apps	Łącznik zarządzany, który jest wyświetlany w galerii łączników w obszarze filtra Udostępniony. Aby uzyskać więcej informacji, zobacz dokumentację zarządzanego łącznika SFTP-SSH.
Standard	Azure Logic Apps jednodzierżawowy, App Service Environment w wersji 3 (tylko plan Windows) i hybrydowy	— Zarządzany łącznik, który jest wyświetlany w galerii łączników w ramach filtru Udostępniony. — Wbudowany łącznik, który jest wyświetlany w galerii łączników w obszarze Wbudowany filtr i jest oparty na dostawcy usług. Wbudowany łącznik może łączyć się bezpośrednio z serwerem SFTP i uzyskiwać dostęp do sieci wirtualnych platformy Azure przy użyciu ciągu połączenia bez lokalnej bramy danych. Aby uzyskać więcej informacji, zobacz: - Dokumentacja łącznika zarządzanego SFTP-SSH - Dokumentacja wbudowanego łącznika SFTP

Różne wersje łącznika SFTP oferują różne wstępnie zdefiniowane operacje. Możesz uruchomić pusty przepływ pracy z wyzwalaczem specyficznym dla protokołu SFTP lub wybrać inny wyzwalacz w zależności od scenariusza. Możesz na przykład uruchomić przepływ pracy za pomocą wyzwalacza SFTP, który monitoruje zdarzenia na serwerze SFTP i reaguje na nie. Wyzwalacz zapewnia wyniki do użycia w kolejnych akcjach w przepływie pracy. Różne akcje SFTP wykonują różne zadania, takie jak pobieranie, tworzenie i zarządzanie plikami na serwerze SFTP.

Wymagania wstępne

Konto i subskrypcja platformy Azure. Uzyskaj bezpłatne konto platformy Azure.
Informacje o połączeniu i uwierzytelnianiu serwera SFTP:
- Adres serwera
- Poświadczenia konta
- Dostęp do klucza prywatnego SSH
- Hasło klucza prywatnego SSH
Ważne

Podczas tworzenia połączenia i wprowadzania klucza prywatnego SSH w parametrze klucza prywatnego SSH upewnij się, że należy wykonać kroki zapewniające pełną i poprawną wartość parametru. W przeciwnym razie nieprawidłowy klucz powoduje niepowodzenie połączenia.

Aby uzyskać więcej informacji, zobacz SfTP-SSH managed connector reference - Authentication and permissions (Dokumentacja łącznika zarządzanego SFTP-SSH — Uwierzytelnianie i uprawnienia).
Przepływ pracy, w którym chcesz uzyskać dostęp do serwera SFTP.

Aby uruchomić przepływ pracy za pomocą wyzwalacza SFTP, potrzebny jest pusty przepływ pracy. Aby użyć akcji SFTP, użyj dowolnego wyzwalacza, który działa najlepiej w twoim scenariuszu. W przykładzie w tym przewodniku użyto wyzwalacza Powtarzanie.

Ogólne ograniczenia

Przed rozpoczęciem korzystania z łącznika zarządzanego SFTP-SSH zapoznaj się z dokumentacją łącznika zarządzanego SFTP-SSH — znane problemy i ograniczenia.
Przed użyciem wbudowanego łącznika SFTP zobacz dokumentację wbudowanego łącznika SFTP — znane problemy i ograniczenia.

Znane problemy

Domyślnie wyzwalacze, które akceptują i zwracają tablice, zwykle mają ustawienie Podział w już włączone. Wyzwalacz automatycznie rozdziela tablicę przez wewnętrzne utworzenie oddzielnego wystąpienia przepływu pracy w celu przetworzenia każdego elementu tablicy. Wszystkie wystąpienia przepływu pracy działają równolegle, by elementy tablicy przetwarzane były w tym samym czasie.

Po włączeniu opcji Podziel przy, wyzwalacze zarządzanego łącznika zwracają dane wyjściowe dla wszystkich elementów tablicy w formie listy. Wszelkie kolejne akcje odwołujące się do tych danych wyjściowych muszą najpierw obsługiwać te dane wyjściowe jako listy. Aby obsłużyć każdy element tablicy osobno, możesz dodać dodatkowe działania. Na przykład w celu iterowania tych elementów tablicy można użyć pętli For each . W przypadku wyzwalaczy, które zwracają tylko metadane lub właściwości, użyj akcji, która najpierw pobiera metadane elementu tablicy, a następnie użyj akcji w celu pobrania zawartości elementów.

Należy zastosować to podejście tylko w przypadku wyzwalaczy łącznika zarządzanego, a nie wbudowanych wyzwalaczy łącznika, które zwracają dane wyjściowe dla jednego elementu tablicy na raz, z włączonym ustawieniem Podziel na.

Załóżmy na przykład, że masz zarządzany wyzwalacz łącznika o nazwie Po dodaniu lub zmodyfikowaniu pliku (właściwości wyłącznie), który zwraca metadane lub właściwości nowych lub zaktualizowanych plików w postaci tablic. Aby pobrać metadane oddzielnie dla każdego pliku, możesz użyć pętli Dla każdej, która przechodzi przez tablicę. W tej pętli użyj następujących akcji łącznika zarządzanego w określonej kolejności:

Uzyskaj metadane pliku, aby otrzymać metadane każdego pliku.
Akcja uzyskiwania zawartości pliku do pobierania zawartości każdego pliku.

Dzielenie na segmenty

Fragmentowanie umożliwia operację obsługi dużych plików, które przekraczają domyślne limity rozmiaru. Aby uzyskać więcej informacji na temat łącznika zarządzanego SFTP-SSH i obsługi fragmentowania, zobacz SFTP-SSH dokumentacja łącznika zarządzanego — fragmentowanie.

Dodawanie wyzwalacza SFTP

Aby dodać wyzwalacz SFTP do pustego przepływu pracy, wykonaj odpowiednie kroki:

Dodaj zarządzany wyzwalacz SFTP-SSH (Zużycie, Standard)

Aby dodać i skonfigurować zarządzany lub udostępniony wyzwalacz łącznika SFTP-SSH , wykonaj następujące kroki:

W witrynie Azure Portal otwórz zasób aplikacji logiki. W edytorze projektowania otwórz pusty przepływ pracy.
W projektancie wykonaj ogólne kroki, aby dodać odpowiedni wyzwalacz SFTP-SSH.

Na przykład wyzwalacz SFTP-SSH o nazwie Po dodaniu lub zmodyfikowaniu pliku uruchamia przepływ pracy po dodaniu lub zmianie pliku na serwerze SFTP. Możesz dodać akcję warunku, która sprawdza, czy zawartość pliku spełnia określone kryteria. Jeśli zawartość spełnia kryteria, użyj akcji SFTP o nazwie Pobierz zawartość pliku, a następnie użyj innej akcji, aby zapisać zawartość w innym folderze SFTP.
Jeśli zostanie wyświetlony monit, podaj niezbędne informacje o połączeniu. Po zakończeniu wybierz pozycję Utwórz nową.
W kreatorze wybierz wyzwalacz, jeśli nie został wybrany. W okienku informacji o wyzwalaczu podaj niezbędne szczegóły.

Aby uzyskać więcej informacji, zobacz Dokumentacja wyzwalaczy zarządzanych łącznika SFTP-SSH.
Po zakończeniu zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.
Kontynuuj tworzenie przepływu pracy, dodając akcje.

Dodaj wbudowany wyzwalacz SFTP (tylko w wersji Standardowej)

Aby dodać i skonfigurować wbudowany wyzwalacz łącznika SFTP , wykonaj następujące kroki:

W witrynie Azure Portal otwórz zasób aplikacji logiki. W edytorze projektowania otwórz pusty przepływ pracy.
W projektancie wykonaj ogólne kroki, aby dodać odpowiedni wbudowany wyzwalacz SFTP.

Na przykład wyzwalacz SFTP o nazwie Po dodaniu lub zmodyfikowaniu pliku uruchamia przepływ pracy po dodaniu lub zmianie pliku na serwerze SFTP. Możesz dodać akcję warunku, która sprawdza, czy zawartość pliku spełnia określone kryteria. Jeśli zawartość spełnia kryteria, użyj akcji SFTP o nazwie Pobierz zawartość pliku, a następnie użyj innej akcji, aby zapisać zawartość w innym folderze SFTP.
Jeśli zostanie wyświetlony monit, podaj niezbędne informacje o połączeniu. Po zakończeniu wybierz pozycję Utwórz nową.
W kreatorze wybierz wyzwalacz, jeśli nie został wybrany. W okienku informacji o wyzwalaczu podaj niezbędne szczegóły.

Aby uzyskać więcej informacji, zobacz Dokumentacja wbudowanego wyzwalacza łącznika SFTP.
Po zakończeniu zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.
Kontynuuj tworzenie przepływu pracy, dodając akcje.

Dodaj akcję SFTP

Przed dodaniem akcji SFTP przepływ pracy wymaga wyzwalacza, który może być najlepszy dla danego scenariusza.

W tym przykładzie użyto ogólnego wbudowanego wyzwalacza recurrence, który uruchamia przepływ pracy wg. określonego harmonogramu. Możesz dodać SFTP

Dodaj zarządzaną akcję SFTP-SSH (Zużycie, Standard)

Aby dodać i skonfigurować akcję zarządzanego łącznika SFTP-SSH , wykonaj następujące kroki:

W portalu Azure otwórz zasób aplikacji logiki. W edytorze otwórz przepływ pracy.
W projektancie wykonaj ogólne kroki, aby dodać akcję SFTP-SSH udostępnioną, którą chcesz.

Na przykład akcja SFTP-SSH o nazwie Pobierz zawartość pliku przy użyciu ścieżki pobiera zawartość pliku z serwera SFTP, określając ścieżkę pliku. Możesz użyć wyzwalacza SFTP-SSH, aby sprawdzić dostępność nowych lub zaktualizowanych plików oraz akcję warunku określającą kryteria, które muszą spełniać zawartość. Jeśli zawartość spełnia kryteria, użyj akcji Pobierz zawartość pliku przy użyciu ścieżki i kolejnej akcji, aby zapisać zawartość w innym folderze SFTP.
Jeśli zostanie wyświetlony monit, podaj niezbędne informacje o połączeniu. Po zakończeniu wybierz pozycję Utwórz nową.
W projektancie wybierz akcję, o ile nie została wybrana. W okienku informacji o akcji podaj niezbędne szczegóły.

Aby uzyskać więcej informacji, zobacz Dokumentację akcji łącznika zarządzanego SFTP-SSH.
Po zakończeniu zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Dodaj wbudowaną akcję SFTP (tylko w planie Standard)

Aby dodać i skonfigurować wbudowaną akcję SFTP , wykonaj następujące kroki:

W portalu Azure otwórz zasób aplikacji logiki. W edytorze otwórz przepływ pracy.
W projektancie postępuj zgodnie z ogólnymi krokami, aby dodać wbudowaną akcję SFTP-SSH.

Na przykład akcja SFTP o nazwie Pobierz zawartość pliku pobiera zawartość pliku na serwerze SFTP. Możesz użyć wyzwalacza SFTP, który sprawdza, czy nie ma nowych lub zaktualizowanych plików, oraz akcji warunku określającej kryteria, które muszą spełniać zawartość pliku. Jeśli zawartość spełnia kryteria, użyj akcji Pobierz zawartość pliku i kolejnej akcji, aby zapisać zawartość w innym folderze SFTP.
Jeśli zostanie wyświetlony monit, podaj niezbędne informacje o połączeniu. Po zakończeniu wybierz pozycję Utwórz nową.
W projektancie wybierz akcję, o ile nie została wybrana. W okienku informacji o akcji podaj niezbędne szczegóły.

Aby uzyskać więcej informacji, zobacz dokumentacja wbudowanych akcji łącznika SFTP.
Po zakończeniu zapisz przepływ pracy. Na pasku narzędzi projektanta wybierz pozycję Zapisz.

Rozwiązywanie problemów