SFTP — SSH
SFTP (SSH File Transfer Protocol) 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. Został zaprojektowany przez Internet Engineering Task Force (IETF) jako rozszerzenie protokołu Secure Shell (SSH) w wersji 2.0 w celu zapewnienia bezpiecznych możliwości transferu plików.
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: - 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: - Departament Obrony USA (DoD) |
| Power Automate | Standard | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| adres URL |
Obsługa usługi Microsoft LogicApps Pomoc techniczna usługi Microsoft Power Automate Obsługa usługi Microsoft Power Apps |
| Metadane łącznika | |
|---|---|
| Publisher | Microsoft |
Przewodnik z instrukcjami dotyczącymi łącznika
W tym artykule opisano operacje dla łącznika zarządzanego SFTP-SSH, który jest dostępny dla usług Azure Logic Apps, Power Automate i Power Apps. Wbudowany łącznik SFTP jest dostępny tylko dla standardowych przepływów pracy aplikacji logiki w usłudze Azure Logic Apps. Aby uzyskać więcej informacji, zobacz Connect to an SFTP server using SSH in Azure Logic Apps and SFTP built-in connector reference for Azure Logic Apps (Nawiązywanie połączenia z serwerem SFTP przy użyciu protokołu SSH w usłudze Azure Logic Apps i wbudowane informacje o łączniku SFTP dla usługi Azure Logic Apps).
Różnice między przestarzałym łącznikiem zarządzanym SFTP
W porównaniu z przestarzałym łącznikiem zarządzanym SFTP łącznik zarządzany SFTP-SSH zapewnia następujące kluczowe możliwości:
Używa biblioteki SSH.NET, która jest biblioteką Secure Shell (SSH) typu open source, która obsługuje platformę .NET.
Udostępnia akcję Utwórz folder , która tworzy folder w określonej ścieżce na serwerze SFTP.
Zawiera akcję Zmień nazwę pliku , która zmienia nazwę pliku na serwerze SFTP.
Buforuje połączenie z serwerem SFTP przez maksymalnie 1 godzinę. Ta funkcja zwiększa wydajność i zmniejsza częstotliwość próby nawiązania połączenia z serwerem przez łącznik. Aby ustawić czas trwania tego zachowania buforowania, edytuj właściwość ClientAliveInterval w konfiguracji SSH na serwerze SFTP.
Uwierzytelnianie i uprawnienia
Podczas tworzenia połączenia z serwerem SFTP należy podać adres serwera SFTP, poświadczenia konta, klucz prywatny SSH i hasło klucza prywatnego SSH. Jeśli platforma obsługuje przekazywanie dużych plików przy użyciu fragmentowania, potrzebny jest również zarówno dostęp do odczytu, jak i zapisu dla folderu głównego na serwerze SFTP.
Łącznik SFTP-SSH obsługuje zarówno uwierzytelnianie klucza prywatnego, jak i uwierzytelnianie za pomocą hasła. Jednak łącznik SFTP-SSH obsługuje tylko następujące formaty kluczy prywatnych, algorytmy wymiany kluczy, algorytmy szyfrowania i odciski palców:
- Formaty kluczy prywatnych: klucze RSA (Rivest Shamir Adleman) i DSA (Digital Signature Algorithm) zarówno w formatach OpenSSH, jak i ssh.com. Jeśli klucz prywatny jest w formacie pliku PuTTY (ppk), najpierw przekonwertuj klucz na format pliku OpenSSH (pem).
- Algorytmy wymiany kluczy:
- curve25519-sha256
- curve25519-sha256@libssh.org
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
- diffie-hellman-group-exchange-sha256
- diffie-hellman-group-exchange-sha1
- diffie-hellman-group16-sha512
- diffie-hellman-group14-sha256
- diffie-hellman-group14-sha1
- diffie-hellman-group1-sha1
- Algorytmy szyfrowania:
- aes256-ctr
- 3des-cbc
- aes128-cbc
- aes192-cbc
- aes256-cbc
- blowfish-cbc
- twofish-cbc
- twofish192-cbc
- twofish128-cbc
- twofish256-cbc
- arcfour
- arcfour128
- arcfour256
- cast128-cbc
- aes128-ctr
- aes192-ctr
- Algorytmy kluczy hosta:
- ssh-rsa
- ssh-dss
- ssh-ed25519
- ecdsa-sha2-nistp256
- ecdsa-sha2-nistp384
- ecdsa-sha2-nistp521
- Odcisk palca: MD5. Aby uzyskać więcej informacji, zobacz Znajdowanie odcisku palca MD5.
Po podaniu klucza prywatnego SSH dla połączenia nie należy wprowadzać ani edytować klucza ręcznie, co może spowodować niepowodzenie połączenia. Zamiast tego upewnij się, że skopiujesz klucz z pliku klucza prywatnego SSH i wklej ten klucz w polu informacji o połączeniu.
Aby poprawnie skopiować i wkleić klucz prywatny SSH, wykonaj następujące kroki.
Otwórz plik klucza prywatnego SSH w dowolnym edytorze tekstów. Te kroki kontynuują korzystanie z Notatnika jako przykładu.
W Notatniku z menu Edycja wybierz pozycję Wybierz wszystko. (Naciśnij Ctrl + A)
Z menu Edycja wybierz pozycję Kopiuj.
W polu SFTP-SSH informacji o połączeniu wklej pełny skopiowany klucz do właściwości klucza prywatnego SSH , która obsługuje wiele wierszy. Nie wprowadzaj ręcznie ani nie edytuj klucza.
Po zakończeniu wprowadzania szczegółów połączenia wybierz pozycję Utwórz.
Konwertowanie klucza opartego na oprogramowaniu PuTTY na protokół OpenSSH
Format PuTTY i format OpenSSH używają różnych rozszerzeń nazw plików. Format PuTTY używa rozszerzenia nazwy pliku .ppk lub PuTTY Private Key. Format OpenSSH używa rozszerzenia pem lub Privacy Enhanced Mail. Jeśli klucz prywatny jest w formacie PuTTY i musisz użyć formatu OpenSSH, najpierw przekonwertuj klucz do formatu OpenSSH, wykonując następujące kroki:
System operacyjny oparty na systemie Unix
Jeśli nie masz zainstalowanych narzędzi PuTTY w systemie, zrób to teraz, na przykład:
sudo apt-get install -y puttyUruchom następujące polecenie, które tworzy plik, którego można użyć z łącznikiem SFTP-SSH:
puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>Na przykład
puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem
System operacyjny Windows
Jeśli jeszcze tego nie zrobiono, pobierz najnowsze narzędzie PuTTY Generator (puttygen.exe), a następnie otwórz narzędzie.
W narzędziu Generator kluczy PuTTY (puttygen.exe) w obszarze Akcje wybierz pozycję Załaduj.
Przejdź do pliku klucza prywatnego w formacie PuTTY i wybierz pozycję Otwórz.
Z menu Konwersje wybierz pozycję Eksportuj klucz OpenSSH.
Zapisz plik klucza prywatnego za pomocą rozszerzenia nazwy pliku pem .
Znajdowanie odcisku palca MD5
Łącznik SFTP-SSH odrzuca połączenie, jeśli odcisk palca serwera SFTP i oczekiwany odcisk palca nie są zgodne. Aby uzyskać odcisk palca MD5, który jest sekwencją z 16 parami cyfr szesnastkowej rozdzielonych dwukropkami, wypróbuj następujące opcje.
Masz klucz
Klucz MD5 jest ciągiem 47-znakowym rozdzielonym dwukropkami. Aby uzyskać odcisk palca MD5 po utworzeniu klucza, możesz użyć narzędzi, takich jak ssh-keygen.
Na przykład w wierszu polecenia powłoki Bash wprowadź następujące polecenie:
ssh-keygen -l -f id_rsa.pub -E md5
Nie masz klucza
Aby uzyskać odcisk palca MD5, gdy nie masz klucza, możesz użyć najnowszego narzędzia Do obsługi informacji o serwerze i protokole za pomocą narzędzia WinSCP lub zamiast tego możesz użyć narzędzia konfiguracji PuTTY:
W narzędziu do konfiguracji programu PuTTY (putty.exe) w oknie Kategoria rozwiń węzeł KluczehostaSSH>połączenia>.
W obszarze Preferencja algorytmu klucza hosta otwórz listę zasad wyboru algorytmu i sprawdź, czy funkcja RSA jest wyświetlana u góry.
Jeśli funkcja RSA nie jest wyświetlana u góry, wybierz pozycję RSA, a następnie wybierz pozycję Up (Up), aż RSA przejdzie do góry.
Nawiąż połączenie z serwerem SFTP za pomocą programu PuTTY. Po utworzeniu połączenia po wyświetleniu alertu zabezpieczeń PUTTY wybierz pozycję Więcej informacji.
Uwaga / Notatka
Jeśli alert zabezpieczeń nie jest wyświetlany, spróbuj wyczyścić wpis SshHostKeys . Otwórz edytor rejestru systemu Windows i przejdź do następującego wpisu:
Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeysPo pojawieniu się pola PuTTY: informacje o kluczu hosta serwera znajdują właściwość odcisku palca MD5 i skopiuj wartość ciągu 47-znakowego, która wygląda następująco:
**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**
Znane problemy i ograniczenia dotyczące wyzwalaczy
Wyzwalacze łącznika zarządzanego SFTP mogą napotkać brakujące, niekompletne lub opóźnione wyniki.
Brakujące wyniki
Wyzwalacze SFTP działają, sondując lub sprawdzając system plików SFTP i wyszukując wszystkie pliki, które uległy zmianie od ostatniego sondowania. Wyzwalacze łącznika zarządzanego SFTP 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 SFTP nie wykryje tego pliku.
W związku z tym, jeśli używasz zewnętrznego narzędzia lub klienta, który tworzy, dodaje lub aktualizuje pliki na serwerze SFTP, 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 SFTP 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 SFTP 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 SFTP. 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 SFTP, wyzwalacz SFTP może nie zwracać wszystkich plików w tym samym czasie.
Ogólne znane problemy i ograniczenia
Łącznik zarządzany SFTP-SSH obecnie nie obsługuje następujących serwerów SFTP:
- Akamai NetStorage
- Brama FileMage
- Globalny krajobraz
- IBM DataPower
- MessageWay
- OpenText Secure MFT
- OpenText GXS
- SFTP dla usługi Azure Blob Storage
- Serwer bezpiecznego transferu plików programu VShell
- AWS SFTP
Użyj oddzielnych folderów SFTP do przetwarzania i przekazywania plików.
Upewnij się, że używasz oddzielnych folderów na serwerze SFTP, aby wyzwalacz monitorował pliki do przetwarzania i przechowywania przekazanych plików. W przeciwnym razie wyzwalacz nie zostanie wyzwolony i będzie działać nieprzewidywalnie. Na przykład wyzwalacz może pominąć losową liczbę plików, które wymagają przetwarzania.
To ograniczenie oznacza, że potrzebny jest sposób przenoszenia plików między tymi folderami. Jeśli wystąpi ten problem, usuń pliki z monitorowanego folderu i użyj innego folderu do przechowywania przekazanych plików.
Aby zarządzać obciążeniem usług łącznika zarządzanego z wieloma dzierżawami, zarządzany łącznik SFTP-SSH może utworzyć wiele połączeń z tego samego źródłowego adresu IP, czyli adresu IP łącznika do miejsca docelowego, czyli serwera SFTP. Niektóre regiony niskiego ruchu mogą używać tylko trzech wystąpień maszyn wirtualnych za adresem IP łącznika, co oznacza, że te regiony mogą utworzyć maksymalnie trzy połączenia. Inne regiony mogą używać maksymalnie 20 połączeń, ponieważ mają taką samą liczbę maszyn wirtualnych za adresem IP łącznika.
Jeśli serwer SFTP ogranicza liczbę połączeń, serwer może nie działać prawidłowo z zarządzanym łącznikiem SFTP-SSH. Można jednak utworzyć standardowy przepływ pracy aplikacji logiki, który używa wbudowanych operacji SFTP. Możesz kontrolować limity skalowania w poziomie, a w związku z tym liczbę połączeń.
Jeśli wystąpią problemy z współdziałaniem zestawu szyfrowania między łącznikiem zarządzanym SFTP-SSH a serwerem SFTP, spróbuj utworzyć przepływ pracy aplikacji logiki w warstwie Standardowa i użyć wbudowanych operacji SFTP. Wbudowane operacje SFTP obsługują szerszy zakres zestawów szyfrowania.
Ten łącznik może wysłać żądanie no-op do zaplecza.
Chunking
W usługach Azure Logic Apps i Power Automate następujące akcje łącznika zarządzanego SFTP-SSH obsługują fragmentowanie, w których akcja może umożliwić obsługę dużych plików w mniejszych elementach. Aby uzyskać więcej informacji na temat fragmentowania w usłudze Azure Logic Apps, zobacz [Handle large messages using chunking](/azure/logic-apps/logic-apps-handle-large-messages).
Akcja Obsługa fragmentowania Zastępowanie obsługi rozmiaru fragmentu Kopiowanie pliku Nie. Nie dotyczy Tworzenie pliku Tak Tak Utwórz folder Nie dotyczy Nie dotyczy Usuń plik Nie dotyczy Nie dotyczy Wyodrębnianie archiwum do folderu Nie dotyczy Nie dotyczy Pobieranie zawartości pliku Tak Tak Pobieranie zawartości pliku przy użyciu ścieżki Tak Tak Pobieranie metadanych pliku Nie dotyczy Nie dotyczy Pobieranie metadanych pliku przy użyciu ścieżki Nie dotyczy Nie dotyczy Wyświetlanie listy plików w folderze Nie dotyczy Nie dotyczy Zmienianie nazwy pliku Nie dotyczy Nie dotyczy Aktualizowanie pliku Nie. Nie dotyczy SFTP-SSH akcje, które obsługują fragmentowanie, mogą obsługiwać pliki do 1 GB, podczas gdy SFTP-SSH akcje, które nie obsługują fragmentowania, mogą obsługiwać pliki do 50 MB. Domyślny rozmiar fragmentu to 15 MB. Jednak ten rozmiar może się dynamicznie zmieniać, zaczynając od 5 MB i stopniowo zwiększając się do maksymalnej wartości 50 MB. Dynamiczne ustalanie rozmiaru jest oparte na czynnikach, takich jak opóźnienie sieci, czas odpowiedzi serwera itd.
To zachowanie adaptacyjne można zastąpić, określając stały rozmiar fragmentu do użycia. Ten rozmiar może wynosić od 5 MB do 50 MB. Załóżmy na przykład, że masz plik o rozmiarze 45 MB i sieć, która może obsługiwać ten rozmiar pliku bez opóźnień. Adaptacyjne fragmentowanie powoduje kilka wywołań, a nie jedno wywołanie. Aby zmniejszyć liczbę wywołań, możesz spróbować ustawić rozmiar fragmentu 50 MB. W innym scenariuszu, jeśli przepływ pracy aplikacji logiki przekracza limit czasu, na przykład w przypadku korzystania z fragmentów 15 MB, możesz spróbować zmniejszyć rozmiar do 5 MB.
Rozmiar fragmentu jest skojarzony z połączeniem. Ten atrybut oznacza, że można użyć tego samego połączenia dla obu akcji, które obsługują fragmentowanie i akcje, które nie obsługują fragmentowania. W tym przypadku rozmiar fragmentu dla akcji obsługujących fragmentowanie waha się od 5 MB do 50 MB.
Aby zastąpić domyślne zachowanie adaptacyjne używane przez fragmentowanie w akcji SFTP-SSH, można określić stały rozmiar fragmentu z 5 MB do 50 MB.
W projektancie w prawym górnym rogu akcji SFTP-SSH wybierz przycisk wielokropka (...), a następnie wybierz pozycję Ustawienia.
W obszarze Transfer zawartości we właściwości Rozmiar fragmentu wprowadź wartość całkowitą z
5na50.Po zakończeniu wybierz pozycję Gotowe.
wyzwalacze SFTP-SSH nie obsługują fragmentowania komunikatów. Wyzwalacze żądają zawartości pliku, wybierają tylko pliki o rozmiarze 15 MB lub mniejszym. Aby uzyskać pliki większe niż 15 MB, postępuj zgodnie z tym wzorcem:
Użyj wyzwalacza SFTP-SSH, który zwraca tylko właściwości pliku. Te wyzwalacze mają nazwy, które zawierają opis (tylko właściwości).
Postępuj zgodnie z wyzwalaczem z akcją SFTP-SSH Pobierz zawartość pliku . Ta akcja odczytuje pełny plik i niejawnie używa fragmentowania komunikatów.
Rozwiązywanie problemów
Błąd 401: "401 Brak autoryzacji"
Ten błąd może wystąpić, ponieważ nie masz odpowiednich poświadczeń ani uprawnień. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie i uprawnienia.
Błąd 404: "Odwołanie zostało wykonane do pliku lub folderu, który nie istnieje"
Ten błąd może wystąpić, gdy używasz akcji Utwórz plik . Gdy akcja tworzy plik na serwerze SFTP, akcja automatycznie wysyła wywołanie serwera SFTP w celu pobrania metadanych pliku.
Jeśli natychmiast przeniesiesz nowo utworzony plik przed pobraniem metadanych, plik nie istnieje już w oczekiwanej lokalizacji i zostanie wyświetlony komunikat o błędzie 404, odwołanie zostało wykonane do pliku lub folderu, który nie istnieje.
Jeśli nie możesz uniknąć lub opóźnić przenoszenia pliku, możesz pominąć odczytywanie metadanych pliku po utworzeniu pliku, wykonując następujące kroki:
W akcji Utwórz plik otwórz listę Dodaj nowy parametr , wybierz właściwość Pobierz wszystkie metadane pliku i ustaw wartość Nie.
Jeśli te metadane pliku będą potrzebne później, możesz użyć akcji Pobierz metadane pliku .
Błąd 504: "Próba połączenia nie powiodła się, ponieważ połączona strona nie odpowiedziała prawidłowo po upływie określonego czasu lub nawiązano połączenie nie powiodło się, ponieważ połączony host nie odpowiedział" lub "Żądanie do serwera SFTP zajęło więcej niż 00:00:30" sekund"
Ten błąd może wystąpić, gdy nie można pomyślnie nawiązać połączenia z serwerem SFTP. Przyczyną tego problemu może być inna przyczyna, więc wypróbuj następujące opcje rozwiązywania problemów:
Limit czasu połączenia wynosi 20 sekund. Sprawdź, czy serwer SFTP ma dobrą wydajność i urządzenia pośrednie, takie jak zapory, nie dodaje obciążeń.
Sprawdź, czy serwer SFTP ogranicza liczbę połączeń z każdego adresu IP. Każdy taki limit utrudnia komunikację między łącznikiem a serwerem SFTP. Pamiętaj, aby usunąć ten limit.
Jeśli masz skonfigurowaną zaporę, upewnij się, że adresy IP łącznika zarządzanego zostały dodane do listy zatwierdzonych.
Jeśli błąd występuje sporadycznie, zmień ustawienie zasad Ponów próbę dla akcji SFTP-SSH na liczbę ponownych prób większą niż domyślne cztery ponawianie prób.
Aby zmniejszyć koszt ustanowienia połączenia, w konfiguracji SSH dla serwera SFTP zwiększ właściwość ClientAliveInterval do około godziny.
Przejrzyj dziennik serwera SFTP, aby sprawdzić, czy wywołania wysyłane do serwera SFTP docierają pomyślnie, Aby uzyskać więcej informacji na temat problemu z łącznością, możesz również uruchomić śledzenie sieci na zaporze i serwerze SFTP.
Ogólne limity
| Name | Wartość |
|---|---|
| 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 zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Adres serwera hosta | ciąg | Adres serwera hosta | Prawda |
| Nazwa użytkownika | ciąg | Nazwa użytkownika | Prawda |
| Hasło | securestring | Hasło | |
| Klucz prywatny SSH | securestring | Klucz prywatny SSH (zawartość pliku powinna być dostarczana w całości tak, jak w formacie wielowierszowym) | |
| Hasło klucza prywatnego SSH | securestring | Hasło klucza prywatnego SSH (jeśli klucz prywatny jest chroniony przez hasło) | |
| Numer portu | int | Numer portu SFTP (przykład: 22) | |
| Wyłączanie walidacji klucza hosta SSH | bool | Czy wyłączyć walidację klucza hosta SSH? (Prawda/fałsz) | |
| Odcisk palca klucza hosta SSH | ciąg | Odcisk palca klucza hosta SSH | |
| Ścieżka folderu głównego | ciąg | Ścieżka folderu głównego. |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 150 | 60 sekund |
Akcje
| Aktualizowanie pliku |
Ta operacja aktualizuje zawartość pliku. |
| Kopiuj plik |
Ta operacja kopiuje plik. |
| Pobieranie metadanych pliku |
Ta operacja pobiera metadane pliku przy użyciu identyfikatora 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 przy użyciu identyfikatora pliku. |
| Usuń plik |
Ta operacja usuwa plik. |
| Utwórz folder |
Ta operacja tworzy nowy folder. |
| Utwórz plik |
Ta operacja przekazuje plik. |
| 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 pliki zawarte w folderze. |
| Wyświetlanie listy plików w folderze głównym |
Ta operacja pobiera pliki w folderze głównym. |
| Zmienianie nazwy pliku |
Ta operacja zmienia nazwę pliku. |
Aktualizowanie pliku
Ta operacja aktualizuje zawartość pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie pliku |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku do zaktualizowania |
|
Pobieranie wszystkich metadanych pliku
|
ReadFileMetadataFromServer | boolean |
Pobierz wszystkie metadane pliku z serwera SFTP po zakończeniu tworzenia pliku. Jeśli jest to fałsz, niektóre właściwości metadanych mogą nie być zwracane, takie jak czas ostatniej modyfikacji itp. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Kopiuj plik
Ta operacja kopiuje plik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku źródłowego
|
source | True | string |
Ścieżka do pliku źródłowego |
|
Ścieżka pliku docelowego
|
destination | True | string |
Ścieżka do pliku docelowego, w tym nazwa pliku |
|
Zastąpić?
|
overwrite | boolean |
Zastępuje plik docelowy, jeśli jest ustawiony na wartość "true" |
|
|
Pobieranie wszystkich metadanych pliku
|
ReadFileMetadataFromServer | boolean |
Pobierz wszystkie metadane pliku z serwera SFTP po zakończeniu tworzenia pliku. Jeśli jest to fałsz, niektóre właściwości metadanych mogą nie być zwracane, takie jak czas ostatniej modyfikacji itp. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku
Ta operacja pobiera metadane pliku przy użyciu identyfikatora pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie identyfikatora pliku |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku przy użyciu ścieżki
Ta operacja pobiera metadane pliku przy użyciu ścieżki pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku
|
path | True | string |
Unikatowa ścieżka pliku |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie zawartości pliku przy użyciu ścieżki
Ta operacja pobiera zawartość pliku przy użyciu ścieżki pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku
|
path | True | string |
Unikatowa ścieżka pliku |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wnioskowanie typu zawartości na podstawie rozszerzenia |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Pobierz zawartość pliku
Ta operacja pobiera zawartość pliku przy użyciu identyfikatora pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie identyfikatora pliku |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wnioskowanie typu zawartości na podstawie rozszerzenia |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Usuń plik
Ta operacja usuwa plik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie pliku |
|
Pomiń usuwanie, jeśli nie znaleziono pliku
|
SkipDeleteIfFileNotFoundOnServer | boolean |
Pomija usuwanie, jeśli plik nie zostanie znaleziony bez akcji zakończonej niepowodzeniem. |
Utwórz folder
Ta operacja tworzy nowy folder.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderPath | True | string |
Wybieranie folderu |
|
Name
|
name | True | string |
Nazwa folderu |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Utwórz plik
Ta operacja przekazuje plik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka do folderu
|
folderPath | True | string |
Unikatowa ścieżka folderu |
|
Nazwa pliku
|
name | True | string |
Nazwa pliku |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku do utworzenia |
|
Pobieranie wszystkich metadanych pliku
|
ReadFileMetadataFromServer | boolean |
Pobierz wszystkie metadane pliku z serwera SFTP po zakończeniu tworzenia pliku. Jeśli jest to fałsz, niektóre właściwości metadanych mogą nie być zwracane, takie jak czas ostatniej modyfikacji itp. |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Wyodrębnianie archiwum do folderu
Ta operacja wyodrębnia plik archiwum do folderu (na przykład: .zip).
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Ścieżka pliku archiwum źródłowego
|
source | True | string |
Ścieżka do pliku archiwum |
|
Ścieżka folderu docelowego
|
destination | True | string |
Ścieżka do folderu docelowego |
|
Zastąpić?
|
overwrite | boolean |
Zastępuje pliki docelowe, jeśli ustawiono wartość "true" |
Zwraca
- response
- array of BlobMetadata
Wyświetlanie listy plików w folderze
Ta operacja pobiera pliki zawarte w folderze.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
id | True | string |
Określanie folderu |
Zwraca
- response
- array of BlobMetadata
Wyświetlanie listy plików w folderze głównym
Zmienianie nazwy pliku
Ta operacja zmienia nazwę pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Wybierz plik |
|
Nowa nazwa
|
newName | True | string |
Nowa nazwa pliku |
|
Pobieranie wszystkich metadanych pliku
|
ReadFileMetadataFromServer | boolean |
Pobierz wszystkie metadane pliku z serwera SFTP po zakończeniu tworzenia pliku. Jeśli jest to fałsz, niektóre właściwości metadanych mogą nie być zwracane, takie jak czas ostatniej modyfikacji itp. |
Zwraca
Reprezentuje odpowiedź na metadane zestawów danych obiektów blob
- Body
- BlobMetadataResponse
Wyzwalacze
| Gdy pliki są dodawane lub modyfikowane (tylko właściwości) |
Ta operacja wyzwala przepływ po dodaniu lub zmodyfikowaniu pliku 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 |
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. |
Gdy pliki są dodawane lub modyfikowane (tylko właściwości)
Ta operacja wyzwala przepływ po dodaniu lub zmodyfikowaniu pliku 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.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Wybieranie folderu |
|
Liczba plików do zwrócenia
|
maxFileCount | integer |
Liczba plików zwróconych z wyzwalacza (1–100) |
Zwraca
Metadane obiektu blob
- Lista plików
- BlobMetadata
Po dodaniu lub zmodyfikowaniu pliku
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.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Folder
|
folderId | True | string |
Określanie folderu |
|
Dołącz zawartość pliku
|
includeFileContent | boolean |
W przypadku ustawienia wartości true zawartość pliku również zostanie pobrana wraz z odpowiedzią wyzwalacza |
|
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wnioskowanie typu zawartości na podstawie rozszerzenia |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Definicje
BlobMetadata
Metadane obiektu blob
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
Id | string |
Unikatowy identyfikator pliku lub folderu. |
|
Name
|
Name | string |
Nazwa pliku lub folderu. |
|
Nazwa wyświetlana
|
DisplayName | string |
Nazwa wyświetlana pliku lub folderu. |
|
Ścieżka
|
Path | string |
Ścieżka pliku lub folderu. |
|
Ostatnia modyfikacja
|
LastModified | date-time |
Data i godzina ostatniej modyfikacji pliku lub folderu. |
|
Rozmiar
|
Size | integer |
Rozmiar pliku lub folderu. |
|
Typ nośnika
|
MediaType | string |
Typ nośnika pliku lub folderu. |
|
IsFolder
|
IsFolder | boolean |
Wartość logiczna (true, false) wskazująca, czy obiekt blob jest folderem. |
|
ETag
|
ETag | string |
Element etag pliku lub folderu. |
|
FileLocator
|
FileLocator | string |
Filelocator pliku lub folderu. |
BlobMetadataResponse
Reprezentuje odpowiedź na metadane zestawów danych obiektów blob
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Id
|
Id | string |
Unikatowy identyfikator pliku lub folderu. |
|
Name
|
Name | string |
Nazwa pliku lub folderu. |
|
Nazwa wyświetlana
|
DisplayName | string |
Nazwa wyświetlana pliku lub folderu. |
|
Ścieżka
|
Path | string |
Ścieżka pliku lub folderu. |
|
Ostatnia modyfikacja
|
LastModified | date-time |
Data i godzina ostatniej modyfikacji pliku lub folderu. |
|
Rozmiar
|
Size | integer |
Rozmiar pliku lub folderu. |
|
Typ nośnika
|
MediaType | string |
Typ nośnika pliku lub folderu. |
|
IsFolder
|
IsFolder | boolean |
Wartość logiczna (true, false) wskazująca, czy obiekt blob jest folderem. |
|
ETag
|
ETag | string |
Element etag pliku lub folderu. |
|
FileLocator
|
FileLocator | string |
Filelocator pliku lub folderu. |
binarny
Jest to podstawowy typ danych "binary".