FTP

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa	Class	Regions
Copilot Studio	Standard	Wszystkie regiony usługi Power Automate z wyjątkiem następujących:      - Rząd USA (GCC High)      - Departament Obrony USA (DoD)
Logic Apps	Standard	Wszystkie regiony usługi Logic Apps
Power Apps	Standard	Wszystkie regiony usługi Power Apps z wyjątkiem następujących:      - Rząd USA (GCC High)      - Departament Obrony USA (DoD)
Power Automate	Standard	Wszystkie regiony usługi Power Automate z wyjątkiem następujących:      - Rząd USA (GCC High)      - Departament Obrony USA (DoD)

Metadane łącznika
Publisher	Microsoft

Znane problemy i ograniczenia

• W tym artykule opisano operacje tylko dla łącznika zarządzanego FTP, który jest dostępny dla usług Azure Logic Apps, Power Automate i Power Apps. Wbudowany łącznik FTP jest dostępny tylko dla standardowych przepływów pracy aplikacji logiki w usłudze Azure Logic Apps. Aby uzyskać więcej informacji na temat wbudowanego łącznika FTP w usłudze Azure Logic Apps, zobacz Łączenie się z serwerami FTP z przepływów pracy w usłudze Azure Logic Apps.

• Wyzwalacze FTP zwracają teraz tylko metadane lub właściwości, a nie zawartość pliku. Można jednak obserwować te wyzwalacze za pomocą akcji o nazwie Pobierz zawartość pliku. Aby upewnić się, że wyzwalacz zwraca jeden plik naraz, a nie listę, upewnij się, że włączono opcję "Podziel w" wyzwalacza. Aby uzyskać więcej informacji na temat tej opcji w usłudze Azure Logic Apps, zobacz Wyzwalanie wielu przebiegów.

• Wyzwalacze FTP działają tylko w określonym folderze, a nie w podfolderach. Aby również sprawdzić podfoldery folderu, skonfiguruj oddzielny przepływ dla każdego podfolderu.

• Domyślnie akcje łącznika zarządzanego FTP mogą odczytywać lub zapisywać pliki o rozmiarze 50 MB lub mniejszym. Aby obsłużyć pliki większe niż 50 MB, możesz użyć akcji łącznika zarządzanego FTP o nazwie Pobierz zawartość pliku, która niejawnie używa fragmentowania komunikatów. Inne akcje łącznika zarządzanego FTP obsługują również włączanie fragmentowania komunikatów.

• Wyzwalacze FTP mogą powodować opóźnienia lub niekompletne wyniki podczas zwracania nowo utworzonych, dodanych lub zaktualizowanych plików.

  Gdy wyzwalacz FTP sprawdza nowo dodany lub zmieniony plik, wyzwalacz potwierdza również, że plik został ukończony. Na przykład plik może mieć zmiany w toku, gdy wyzwalacz sprawdza serwer FTP. Aby uniknąć zwracania niekompletnego pliku, wyzwalacz zanotuje sygnaturę czasową pliku, ale nie zwraca natychmiast pliku. Zamiast tego wyzwalacz zwraca plik tylko wtedy, gdy wyzwalacz ponownie sprawdzi serwer. Czasami takie zachowanie może spowodować opóźnienie, które trwa do dwóch razy w interwale sondowania wyzwalacza. Ze względu na to zachowanie wyzwalacz FTP może nie zwracać wszystkich plików jednocześnie, jeśli wyłączysz ustawienie Split On wyzwalacza FTP,

• Wyzwalacze łącznika zarządzanego FTP mogą napotkać brakujące, niekompletne lub opóźnione wyniki po zachowaniu znacznika czasu "ostatniej modyfikacji".

  • Brakujące wyniki

    Wyzwalacze FTP działają przez sondowanie lub sprawdzanie systemu plików FTP i wyszukiwanie wszelkich plików, które uległy zmianie od ostatniego sondowania. Wyzwalacze łącznika zarządzanego FTP porównują wersje plików przy użyciu ostatniej zmodyfikowanej sygnatury czasowej pliku.

    W przypadku tworzenia, dodawania lub aktualizowania pliku ze znacznikiem czasu, który jest wcześniejszy niż aktualnie śledzony znacznik czasu ostatniej modyfikacji, wyzwalacz łącznika zarządzanego FTP nie wykryje tego pliku. Z drugiej strony wbudowany łącznik FTP w przepływach pracy aplikacji logiki w warstwie Standardowa nie ma tego ograniczenia.

    Dlatego jeśli używasz zewnętrznego narzędzia lub klienta, który tworzy, dodaje lub aktualizuje pliki na serwerze FTP, upewnij się, że wyłączysz dowolną funkcję w narzędziu lub kliencie, który zachowuje ostatnio zmodyfikowany znacznik czasu pliku.

    W poniższej tabeli wymieniono niektóre powszechnie używane narzędzia, które zachowują ten znacznik czasu, oraz kroki wyłączania tej funkcji:

    Klient FTP	Akcja
    WinSCP	Przejdź do pozycji Preferencje opcji>>Przenieś edytuj>>zachowaj sygnaturę czasowa>Wyłącz.
    FileZilla	Przejdź do pozycji Transfer>Zachowaj znaczniki czasu przetransferowanych plików>Wyłącz.

  • Niekompletne lub opóźnione wyniki

    Gdy wyzwalacz FTP sprawdza nowo utworzony, dodany lub zaktualizowany plik, wyzwalacz sprawdza również, czy plik został ukończony. Na przykład plik może mieć zmiany w toku, gdy wyzwalacz sprawdza serwer FTP. Aby uniknąć zwracania niekompletnego pliku, wyzwalacz zanotuje sygnaturę czasową pliku, ale nie zwraca natychmiast pliku. Zamiast tego wyzwalacz zwraca plik tylko wtedy, gdy wyzwalacz ponownie sprawdzi serwer.

    Czasami to zachowanie może spowodować opóźnienie, które trwa tak długo, jak prawie dwa razy w interwale sondowania wyzwalacza. Ze względu na to zachowanie, jeśli wyłączysz ustawienie Split On wyzwalacza FTP, wyzwalacz FTP może nie zwracać wszystkich plików w tym samym czasie.

Requirements

• Łącznik FTP wymaga poświadczeń serwera hosta FTP i konta.

• Łącznik FTP wymaga dostępu do serwera FTP z internetu lub przez Internet. Aby uzyskać więcej informacji na temat zezwalania na ruch do serwera FTP przy użyciu określonych zakresów adresów IP, zobacz Adresy IP łącznika zarządzanego.

• Łącznik FTP wymaga, aby serwer FTP działał lub akceptował w trybie pasywnym .

• Łącznik FTP wymaga, aby serwer FTP włączył następujące polecenia i obsługiwał foldery zawierające białe znaki, aby polecenia mogły działać poprawnie. W przypadku polecenia LIST upewnij się, że polecenie zwraca year składnik dla sygnatur czasowych pliku starszych niż 6 miesięcy.

  • APPE
  • DELE
  • LISTA
  • MDTM
  • RENAME
  • RETR
  • ROZMIAR
  • STOR

• W przypadku bezpiecznego protokołu FTP upewnij się, że skonfigurować jawny protokół transferu plików Secure (FTPS), a nie niejawny protokół FTPS. Ponadto niektóre serwery FTP, takie jak ProFTPd, wymagają włączenia NoSessionReuseRequired opcji w przypadku korzystania z trybu Transport Layer Security (TLS), następcy protokołu Secure Socket Layer (SSL).

  Łącznik FTP nie działa z niejawnym protokołem FTPS i obsługuje tylko jawny protokół FTP za pośrednictwem protokołu FTPS, który jest rozszerzeniem protokołu TLS.

Połączenia FTP

• Aby zwiększyć wydajność zarówno łącznika FTP, jak i serwera FTP, możesz zachować otwarte i aktywne połączenie FTP po zakończeniu żądania przez łącznik.

  Po utworzeniu połączenia z serwerem FTP zostanie wyświetlone pole profilu połączenia o nazwie Zamknij połączenie po zakończeniu żądania. To ustawienie określa, czy należy zamknąć połączenie serwera FTP za każdym razem po zakończeniu żądania. Jeśli to ustawienie zostanie wyłączone, połączenie nie zostanie zamknięte po zakończeniu żądania i pozostanie aktywne do użycia w przyszłości.

• Jeśli wystąpienia przepływu pracy działają równolegle, mogą wystąpić sporadyczne błędy łączności. Niektóre operacje w przepływie pracy mogą wymuszać zamknięcie połączenia nawet wtedy, gdy inne operacje w przepływie pracy nadal używają tego połączenia.

  Aby uniknąć tego scenariusza, wypróbuj następujące zalecenia:

  • Po utworzeniu połączenia włącz ustawienie Zamknij połączenie po zakończeniu żądania .

  • Wyłącz wszelkie równoległe lub współbieżność włączone dla wyzwalaczy lub akcji. Aby uzyskać więcej informacji na temat tego rozwiązania w usłudze Azure Logic Apps, zapoznaj się z następującą dokumentacją:

    • Zmiana współbieżności wyzwalacza
    • Chanage "Dla każdego" współbieżności akcji

  • Unikaj uruchamiania wielu przepływów równoległych.

Używanie akcji "Utwórz plik" z fragmentowaniem i bez niego

W przypadku akcji Utwórz plik zachowanie zależy od ustawienia Zezwalaj na fragmentowanie akcji i rozmiaru pliku do utworzenia:

• Zezwalaj na włączanie fragmentowania :

  • Rozmiar pliku jest równy lub mniejszy niż 50 MB: akcja przekazuje plik z pojedynczym żądaniem, używa oryginalnej nazwy pliku i blokuje plik podczas przekazywania.

  • Rozmiar pliku jest większy niż 50 MB: Akcja tworzy plik z formatem nazwy, nazwą pliku.new-GUID.ms.partial i przekazuje plik przy użyciu wielu żądań lub fragmentów komunikatów. Po przekazaniu ostatniego fragmentu akcja zmienia nazwę pliku na oryginalną nazwę pliku.

• Zezwalaj na fragmentowanie wyłączone: akcja przekazuje plik z jednym żądaniem, używa oryginalnej nazwy pliku i blokuje plik podczas przekazywania.

Przewodnik z instrukcjami dotyczącymi łącznika

Aby uzyskać informacje o sposobie korzystania z łącznika zarządzanego FTP i wbudowanego łącznika w usłudze Azure Logic Apps, zobacz Łączenie się z serwerami FTP z przepływów pracy w usłudze Azure Logic Apps.

Ogólne limity

Name	Wartość
Maksymalna liczba folderów w jednym archiwum. Ten limit ma zastosowanie tylko wtedy, gdy "Utwórz foldery?". jest ustawiona na wartość "Tak".	16
Maksymalna liczba megabajtów przesyłanych do/z łącznika w przedziale czasu przepustowości (na połączenie)	1000
Interwał czasu przepustowości (w milisekundach)	60000

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna	Parametry tworzenia połączenia.	Wszystkie regiony	Nie można udostępniać

Domyślny

Dotyczy: Wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja Power App zostanie udostępniona innemu użytkownikowi, inny użytkownik zostanie poproszony o jawne utworzenie nowego połączenia.

Name	Typ	Description	Wymagane
Adres serwera	ciąg	Adres serwera	Prawda
Nazwa użytkownika	ciąg	Nazwa użytkownika	Prawda
Hasło	securestring	Hasło	Prawda
Port serwera FTP	int	Numer portu FTP (przykład: 21)
Czy włączyć protokół SSL?	bool	Czy włączyć protokół SSL? (Prawda/fałsz)
Transport binarny?	bool	Czy włączyć transport binarny? (Prawda/fałsz)
Czy wyłączyć walidację certyfikatu?	bool	Czy wyłączyć walidację certyfikatu? (Prawda/fałsz)
Zamknij połączenie po zakończeniu żądania	bool	Czy zamknąć połączenie FTP za każdym razem po zakończeniu żądania? (Prawda/fałsz)

Limity ograniczania

Nazwa	Wywołania	Okres odnowienia
Wywołania interfejsu API na połączenie	900	60 sekund

Akcje

Aktualizowanie pliku	Ta operacja aktualizuje plik. Jeśli plik jest usuwany/zmieniany na serwerze bezpośrednio po jego zaktualizowaniu, łącznik może zwrócić błąd HTTP 404 zgodnie z jego projektem. Użyj opóźnienia przez 1 minutę przed usunięciem lub zmianą nazwy ostatnio zaktualizowanego pliku.
Kopiuj plik	Ta operacja kopiuje plik na serwer FTP. Jeśli plik jest usuwany/zmieniany na serwerze bezpośrednio po jego skopiowaniu, łącznik może zwrócić błąd HTTP 404 zgodnie z jego projektem. Użyj opóźnienia przez 1 minutę przed usunięciem lub zmianą nazwy nowo utworzonego pliku.
Pobieranie metadanych pliku	Ta operacja pobiera metadane dla pliku.
Pobieranie metadanych pliku przy użyciu ścieżki	Ta operacja pobiera metadane pliku przy użyciu ścieżki pliku.
Pobieranie zawartości pliku przy użyciu ścieżki	Ta operacja pobiera zawartość pliku przy użyciu ścieżki pliku.
Pobierz zawartość pliku	Ta operacja pobiera zawartość pliku.
Usuń plik	Ta operacja usuwa plik.
Utwórz plik	Ta operacja tworzy plik. Jeśli plik jest usuwany/zmieniany na serwerze bezpośrednio po jego utworzeniu, łącznik może zwrócić błąd HTTP 404 zgodnie z jego projektem. Użyj opóźnienia przez 1 minutę przed usunięciem lub zmianą nazwy nowo utworzonego pliku.
Wyodrębnianie archiwum do folderu	Ta operacja wyodrębnia plik archiwum do folderu (na przykład: .zip).
Wyświetlanie listy plików w folderze	Ta operacja pobiera listę plików i podfolderów w folderze.
Wyświetlanie listy plików w folderze głównym	Ta operacja pobiera listę plików i podfolderów w folderze głównym.

Aktualizowanie pliku

Kopiuj plik

Pobieranie metadanych pliku

Pobieranie metadanych pliku przy użyciu ścieżki

Pobieranie zawartości pliku przy użyciu ścieżki

Pobierz zawartość pliku

Usuń plik

Utwórz plik

Wyodrębnianie archiwum do folderu

Wyświetlanie listy plików w folderze

Wyświetlanie listy plików w folderze głównym

Wyzwalacze

Po dodaniu lub zmodyfikowaniu pliku (tylko właściwości)

Ta operacja wyzwala przepływ, gdy co najmniej jeden plik zostanie dodany lub zmodyfikowany w folderze. Ten wyzwalacz pobierze tylko metadane pliku. Aby uzyskać zawartość pliku, możesz użyć operacji "Pobierz zawartość pliku". Wyzwalacz opiera się na ostatniej modyfikacji czasu pliku. Jeśli plik jest tworzony przez klienta innej firmy, zachowanie czasu ostatniej modyfikacji powinno zostać wyłączone w kliencie. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy.

Po dodaniu lub zmodyfikowaniu pliku [PRZESTARZAŁE]

Ta operacja wyzwala przepływ po dodaniu lub zmodyfikowaniu pliku w folderze. Wyzwalacz pobierze zarówno metadane pliku, jak i zawartość pliku. Wyzwalacz opiera się na ostatniej modyfikacji czasu pliku. Jeśli plik jest tworzony przez klienta innej firmy, zachowanie czasu ostatniej modyfikacji powinno zostać wyłączone w kliencie. Pliki większe niż 50 megabajtów są pomijane przez wyzwalacz. Wyzwalacz nie jest uruchamiany, jeśli plik zostanie dodany/zaktualizowany w podfolderze. Jeśli jest to wymagane do wyzwolenia w podfolderach, należy utworzyć wiele wyzwalaczy.

Po dodaniu lub zmodyfikowaniu pliku (tylko właściwości)

Po dodaniu lub zmodyfikowaniu pliku [PRZESTARZAŁE]

Definicje

BlobMetadata

binarny