SFTP [PRZESTARZAŁE]
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: - Rząd USA (GCC High) - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: - Departament Obrony USA (DoD) |
| 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) |
| 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 |
Ten łącznik znajduje się w ścieżce wycofania. Użyj nowego łącznika SFTP-SSH . Więcej informacji na temat korzystania z nowego łącznika można znaleźć tutaj.
Aby użyć tego łącznika, musisz mieć dostęp do klucza prywatnego SSH i hasła klucza prywatnego SSH.
Obsługiwane są następujące formaty kluczy prywatnych:
OpenSSHssh.comPuTTY
Zawartość klucza prywatnego SSH należy skopiować/wkleić w całości do pola "Klucz prywatny SSH" w formacie wielowierszowym. Poniżej przedstawiono przykładowe kroki udostępniania klucza prywatnego SSH przy użyciu Notepad.exe:
- Otwórz plik klucza prywatnego SSH w Notepad.exe;
- Kliknij pozycję Edytuj → zaznacz wszystko;
- Kliknij pozycję Edytuj → kopię;
- W polu "Klucz prywatny SSH" (podczas tworzenia połączenia) kliknij prawym przyciskiem myszy i kliknij przycisk Wklej. Nie edytuj pola "Klucz prywatny SSH" ręcznie.
Limity wyzwalaczy
Wyzwalacze działają, sondując system plików SFTP i wyszukując dowolny plik, który został zmodyfikowany od ostatniego sondowania, porównując pliki z czasem modyfikacji. Niektóre narzędzia umożliwiają zachowanie czasu modyfikacji pliku. W takich przypadkach należy wyłączyć funkcję, aby wyzwalacz działał. Oto kilka typowych ustawień:
| Klient SFTP | Akcja |
|---|---|
| WinSCP | Opcje → Preferencje... → → → Edytuj... → Zachowaj znacznik czasu → Wyłącz |
| FileZilla | Transfer → zachowywanie sygnatur czasowych przetransferowanych plików → wyłącz |
Gdy wyzwalacze napotkają nowy plik, spróbuje się upewnić, że nowy plik zostanie całkowicie zapisany. Na przykład istnieje możliwość, że plik jest zapisywany lub modyfikowany, a aktualizacje są wprowadzane w czasie wyzwalacza sondowanego serwera plików. Aby uniknąć zwracania pliku z częściową zawartością, wyzwalacz zanotuje sygnaturę czasową takich plików, które są ostatnio modyfikowane, ale nie zwróci natychmiast tych plików. Te pliki zostaną zwrócone tylko wtedy, gdy wyzwalacz ponownie sonduje. Czasami może to prowadzić do opóźnienia do dwukrotnego interwału sondowania wyzwalacza. Oznacza to również, że wyzwalacz nie gwarantuje zwrócenia wszystkich plików w jednym uruchomieniu, gdy opcja "Podziel włączone" jest wyłączona.
Wyzwalacz nie pobiera plików ponad 50 MB, jeśli zostanie wyświetlony monit o zawartość.
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.
Szczegółowe informacje o konektorze
Aby uzyskać więcej informacji na temat łącznika, zobacz szczegółową sekcję.
Znane problemy i ograniczenia
- Ten łącznik może wysłać żądanie no-op do zaplecza.
Ogólne limity
| Name | Wartość |
|---|---|
| Maksymalna łączna liczba żądań na adres serwera SFTP na minutę | 600 |
| 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 | |
| Wyłącz możliwość wznawiania | bool | Czy wyłączyć możliwość wznawiania? (Prawda/fałsz) |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizuj plik [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj pliku Aktualizacji .
|
| Kopiowanie pliku [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Kopiuj plik .
|
| Pobieranie metadanych pliku [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz metadane pliku .
|
| Pobieranie metadanych pliku przy użyciu ścieżki [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz metadane pliku przy użyciu ścieżki .
|
| Pobieranie zawartości pliku [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz zawartość pliku .
|
| Pobieranie zawartości pliku przy użyciu ścieżki [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz zawartość pliku przy użyciu ścieżki .
|
| Tworzenie pliku [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz plik .
|
| Usuń plik [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Usuń plik .
|
| Wyodrębnianie archiwum do folderu [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyodrębnij archiwum do folderu .
|
| Wyświetlanie listy plików w folderze [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyświetl pliki w folderze .
|
| Wyświetlanie listy plików w folderze głównym [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyświetl pliki w folderze głównym .
|
Aktualizuj plik [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj pliku Aktualizacji .
Ta operacja aktualizuje zawartość pliku. 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.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie pliku |
|
Zawartość pliku
|
body | True | binary |
Zawartość pliku do zaktualizowania |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Kopiowanie pliku [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Kopiuj plik .
Ta operacja kopiuje plik na serwer SFTP. 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.
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" |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz metadane pliku .
Ta operacja pobiera metadane pliku przy użyciu identyfikatora pliku.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie pliku |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Pobieranie metadanych pliku przy użyciu ścieżki [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz metadane 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 [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia 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 pliku |
|
Wnioskowanie typu zawartości
|
inferContentType | boolean |
Wnioskowanie typu zawartości na podstawie rozszerzenia |
Zwraca
Zawartość pliku.
- Zawartość pliku
- binary
Pobieranie zawartości pliku przy użyciu ścieżki [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Pobierz zawartość 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
Tworzenie pliku [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Utwórz plik .
Ta operacja przekazuje plik do serwera SFTP. 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.
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 |
Zwraca
Metadane obiektu blob
- Body
- BlobMetadata
Usuń plik [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia Usuń plik .
Ta operacja usuwa plik.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
File
|
id | True | string |
Określanie pliku |
Wyodrębnianie archiwum do folderu [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyodrębnij 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 [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyświetl pliki 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 [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj opcji Wyświetl pliki w folderze głównym .
Ta operacja pobiera pliki w folderze głównym.
Zwraca
- response
- array of BlobMetadata
Wyzwalacze
| Po dodaniu lub zmodyfikowaniu pliku (tylko właściwości) [PRZESTARZAŁE] |
Ta akcja została przestarzała. Zamiast tego użyj polecenia Gdy pliki są dodawane lub modyfikowane (tylko właściwości).
|
| Po dodaniu lub zmodyfikowaniu pliku [PRZESTARZAŁE] |
Ta akcja została przestarzała. Użyj polecenia Po dodaniu lub zmodyfikowaniu pliku .
|
Po dodaniu lub zmodyfikowaniu pliku (tylko właściwości) [PRZESTARZAŁE]
Ta akcja została przestarzała. Zamiast tego użyj polecenia 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, które mają być zwracane z wyzwalacza
|
maxFileCount | integer |
Maksymalna liczba plików zwracanych przez uruchomienie pojedynczego wyzwalacza (1–100). Należy pamiętać, że ustawienie "Split On" może wymusić wyzwalanie przetwarzania poszczególnych elementów osobno. |
Zwraca
Metadane obiektu blob
- Lista plików
- BlobMetadata
Po dodaniu lub zmodyfikowaniu pliku [PRZESTARZAŁE]
Ta akcja została przestarzała. Użyj polecenia 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. |
binarny
Jest to podstawowy typ danych "binary".