Udostępnij przez


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.

    1. Otwórz plik klucza prywatnego SSH w dowolnym edytorze tekstów. Te kroki kontynuują korzystanie z Notatnika jako przykładu.

    2. W Notatniku z menu Edycja wybierz pozycję Wybierz wszystko. (Naciśnij Ctrl + A)

    3. Z menu Edycja wybierz pozycję Kopiuj.

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

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

    1. Jeśli nie masz zainstalowanych narzędzi PuTTY w systemie, zrób to teraz, na przykład:

      sudo apt-get install -y putty

    2. Uruchom 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

    1. Jeśli jeszcze tego nie zrobiono, pobierz najnowsze narzędzie PuTTY Generator (puttygen.exe), a następnie otwórz narzędzie.

    2. W narzędziu Generator kluczy PuTTY (puttygen.exe) w obszarze Akcje wybierz pozycję Załaduj.

    3. Przejdź do pliku klucza prywatnego w formacie PuTTY i wybierz pozycję Otwórz.

    4. Z menu Konwersje wybierz pozycję Eksportuj klucz OpenSSH.

    5. 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:

  1. W narzędziu do konfiguracji programu PuTTY (putty.exe) w oknie Kategoria rozwiń węzeł KluczehostaSSH>połączenia>.

  2. W obszarze Preferencja algorytmu klucza hosta otwórz listę zasad wyboru algorytmu i sprawdź, czy funkcja RSA jest wyświetlana u góry.

  3. Jeśli funkcja RSA nie jest wyświetlana u góry, wybierz pozycję RSA, a następnie wybierz pozycję Up (Up),RSA przejdzie do góry.

  4. 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\SshHostKeys

  5. Po 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.

    1. W projektancie w prawym górnym rogu akcji SFTP-SSH wybierz przycisk wielokropka (...), a następnie wybierz pozycję Ustawienia.

    2. W obszarze Transfer zawartości we właściwości Rozmiar fragmentu wprowadź wartość całkowitą z 5 na 50.

    3. 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:

    1. 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).

    2. 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:

  1. W akcji Utwórz plik otwórz listę Dodaj nowy parametr , wybierz właściwość Pobierz wszystkie metadane pliku i ustaw wartość Nie.

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

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

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

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

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

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

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

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

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

Ta operacja pobiera pliki w folderze głównym.

Zwraca

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

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