SFTP [ZASTARALÉ]
SFTP (SSH File Transfer Protocol) je síťový protokol, který poskytuje přístup k souborům, přenos souborů a správu souborů přes jakýkoli spolehlivý datový proud. Byla navržena protokolem IETF (Internet Engineering Task Force) jako rozšíření protokolu SSH (Secure Shell) verze 2.0, aby poskytovala možnosti zabezpečeného přenosu souborů.
Tento konektor je dostupný v následujících produktech a oblastech:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Standard | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - Ministerstvo obrany USA (DoD) |
| Logic Apps | Standard | Všechny oblasti Logic Apps s výjimkou následujících: - Ministerstvo obrany USA (DoD) |
| Power Apps | Standard | Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC High) - Ministerstvo obrany USA (DoD) |
| Power Automate | Standard | Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - Ministerstvo obrany USA (DoD) |
| Kontakt | |
|---|---|
| Název | Microsoft |
| URL |
Podpora Microsoft LogicApps Podpora microsoft Power Automate Podpora Microsoft Power Apps |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
Tento konektor je na cestě k vyřazení, použijte nový konektor SFTP-SSH . Další informace o použití nového konektoru najdete tady.
Abyste mohli tento konektor použít, budete potřebovat přístup k privátnímu klíči SSH a přístupové frázi privátního klíče SSH.
Podporovány jsou následující formáty privátního klíče:
OpenSSHssh.comPuTTY
Obsah privátního klíče SSH by se měl zkopírovat nebo vložit zcela do pole Privátní klíč SSH ve víceřádkovém formátu. Níže jsou uvedeny ukázkové kroky, jak poskytnout privátní klíč SSH pomocí Notepad.exe:
- Otevřete soubor privátního klíče SSH v Notepad.exe;
- Klikněte na Upravit → Vybrat vše;
- Klikněte na Upravit → Kopírovat;
- V poli Privátní klíč SSH (při vytváření připojení) klikněte pravým tlačítkem myši a klikněte na Vložit. Neupravujte pole privátního klíče SSH ručně.
Limity aktivačních událostí
Triggery fungují dotazováním systému souborů SFTP a vyhledáním libovolného souboru, který byl od posledního hlasování upraven, a porovnává soubory časem úprav. Některé nástroje umožňují zachovat čas úprav souboru. V takových případech je potřeba zakázat funkci, aby trigger fungoval. Tady je několik běžných nastavení:
| Klient SFTP | Činnost |
|---|---|
| WinSCP | Možnosti → Předvolby... → → Upravit →... → Zachovat časové razítko → Zakázat |
| FileZilla | Přenos → Zachovat časová razítka přenesených souborů → Zakázat |
Když triggery narazí na nový soubor, pokusí se zajistit, aby byl nový soubor zcela zapsán. Je například možné, že se soubor zapisuje nebo upravuje a aktualizace se provádějí v době, kdy trigger dotazoval souborový server. Aby se zabránilo vrácení souboru s částečným obsahem, trigger si poznameneje časové razítko těchto souborů, které se nedávno změnily, ale nevrátí tyto soubory okamžitě. Tyto soubory budou vráceny pouze v případech, kdy se trigger znovu dotazuje. Někdy to může vést ke zpoždění až dvakrát intervalu dotazování. To také znamená, že trigger nezaručuje vrácení všech souborů v jediném spuštění, pokud je možnost Rozdělit na zakázaná.
Pokud se zobrazí výzva k zadání obsahu, trigger nepřebírá soubory o více než 50 MB.
Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Konektor do hloubky
Další informace o konektoru najdete v podrobné části.
Známé problémy a omezení
- Tento konektor může odeslat no-op požadavek na back-end.
Obecné limity
| Název | Hodnota |
|---|---|
| Maximální celkový počet požadavků na adresu serveru SFTP za minutu | 600 |
| Maximální počet megabajtů přenášených do/z konektoru v časovém intervalu šířky pásma (na připojení) | 1 000 |
| Časový interval šířky pásma (v milisekundách) | 60000 |
Vytvoření připojení
Konektor podporuje následující typy ověřování:
| výchozí | Parametry pro vytvoření připojení | Všechny oblasti | Nesdílitelné |
Výchozí
Použitelné: Všechny oblasti
Parametry pro vytvoření připojení
Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.
| Název | Typ | Description | Povinné |
|---|---|---|---|
| Adresa hostitelského serveru | řetězec | Adresa hostitelského serveru | Pravdivé |
| Uživatelské jméno | řetězec | Uživatelské jméno | Pravdivé |
| Heslo | securestring | Heslo | |
| Privátní klíč SSH | securestring | Privátní klíč SSH (obsah souboru by měl být poskytován zcela stejně jako ve víceřádkovém formátu). | |
| Heslo privátního klíče SSH | securestring | Heslo privátního klíče SSH (pokud je privátní klíč chráněný heslem) | |
| Číslo portu | int | Číslo portu SFTP (příklad: 22) | |
| Zakázání ověřování klíče hostitele SSH | Booleova hodnota | Chcete zakázat ověřování klíče hostitele SSH? (Pravda nebo nepravda) | |
| Tisk prstem na klíč hostitele SSH | řetězec | Tisk prstem na klíč hostitele SSH | |
| Zakázat funkci obnovení | Booleova hodnota | Zakázat funkci obnovení? (Pravda nebo nepravda) |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 100 | 60 sekund |
Akce
| Aktualizovat soubor [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte soubor Update .
|
| Extrahování archivu do složky [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte extrahovat archiv do složky .
|
| Kopírování souboru [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte kopírovat soubor .
|
| Odstranění souboru [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte odstranit soubor .
|
| Vytvoření souboru [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte příkaz Vytvořit soubor .
|
| Výpis souborů v kořenové složce [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte soubory Seznamu v kořenové složce .
|
| Výpis souborů ve složce [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte soubory Seznamu ve složce .
|
| Získání metadat souboru [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte získat metadata souboru .
|
| Získání metadat souboru pomocí cesty [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte možnost Získat metadata souboru s použitím cesty .
|
| Získání obsahu souboru [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte získat obsah souboru .
|
| Získání obsahu souboru pomocí cesty [ZASTARALÉ] |
Tato akce je zastaralá. Místo toho použijte get file content using path .
|
Aktualizovat soubor [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte soubor Update .
Tato operace aktualizuje obsah souboru. Pokud se soubor odstraňuje nebo přejmenovává na serveru hned po aktualizaci, konektor může v návrhu vrátit chybu HTTP 404. Před odstraněním nebo přejmenováním nedávno aktualizovaného souboru použijte prodlevu 1 minutu.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Zadání souboru |
|
Obsah souboru
|
body | True | binary |
Obsah souboru, který se má aktualizovat |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Extrahování archivu do složky [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte extrahovat archiv do složky .
Tato operace extrahuje soubor archivu do složky (příklad: .zip).
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cesta k souboru zdrojového archivu
|
source | True | string |
Cesta k archivačnímu souboru |
|
Cílová cesta ke složce
|
destination | True | string |
Cesta k cílové složce |
|
Přepsat?
|
overwrite | boolean |
Přepíše cílové soubory, pokud je nastavená hodnota true. |
Návraty
- response
- array of BlobMetadata
Kopírování souboru [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte kopírovat soubor .
Tato operace zkopíruje soubor na server SFTP. Pokud se soubor odstraňuje nebo přejmenovává na serveru hned po zkopírování, konektor může v návrhu vrátit chybu HTTP 404. Před odstraněním nebo přejmenováním nově vytvořeného souboru použijte prodlevu po dobu 1 minuty.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cesta ke zdrojovému souboru
|
source | True | string |
Cesta ke zdrojovému souboru |
|
Cílová cesta k souboru
|
destination | True | string |
Cesta k cílovému souboru včetně názvu souboru |
|
Přepsat?
|
overwrite | boolean |
Přepíše cílový soubor, pokud je nastavený na true. |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Odstranění souboru [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte odstranit soubor .
Tato operace odstraní soubor.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Zadání souboru |
Vytvoření souboru [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte příkaz Vytvořit soubor .
Tato operace nahraje soubor na server SFTP. Pokud se soubor odstraňuje nebo přejmenovává na serveru hned po jeho vytvoření, konektor může v návrhu vrátit chybu HTTP 404. Před odstraněním nebo přejmenováním nově vytvořeného souboru použijte prodlevu po dobu 1 minuty.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cesta ke složce
|
folderPath | True | string |
Jedinečná cesta ke složce |
|
Název souboru
|
name | True | string |
Název souboru |
|
Obsah souboru
|
body | True | binary |
Obsah souboru, který se má vytvořit |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Výpis souborů v kořenové složce [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte soubory Seznamu v kořenové složce .
Tato operace získá soubory v kořenové složce.
Návraty
- response
- array of BlobMetadata
Výpis souborů ve složce [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte soubory Seznamu ve složce .
Tato operace získá soubory obsažené ve složce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Složka
|
id | True | string |
Zadání složky |
Návraty
- response
- array of BlobMetadata
Získání metadat souboru [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte získat metadata souboru .
Tato operace získá metadata souboru pomocí ID souboru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Zadání souboru |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Získání metadat souboru pomocí cesty [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte možnost Získat metadata souboru s použitím cesty .
Tato operace získá metadata souboru pomocí cesty k souboru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cesta k souboru
|
path | True | string |
Jedinečná cesta k souboru |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Získání obsahu souboru [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte získat obsah souboru .
Tato operace získá obsah souboru pomocí ID souboru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Zadání souboru |
|
Odvození typu obsahu
|
inferContentType | boolean |
Odvození typu obsahu na základě rozšíření |
Návraty
Obsah souboru.
- Obsah souboru
- binary
Získání obsahu souboru pomocí cesty [ZASTARALÉ]
Tato akce je zastaralá. Místo toho použijte get file content using path .
Tato operace získá obsah souboru pomocí cesty k souboru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cesta k souboru
|
path | True | string |
Jedinečná cesta k souboru |
|
Odvození typu obsahu
|
inferContentType | boolean |
Odvození typu obsahu na základě rozšíření |
Návraty
Obsah souboru.
- Obsah souboru
- binary
Aktivační události
| Při přidání nebo změně souboru (pouze vlastnosti) [ZASTARALÉ] |
Tato akce je zastaralá. Použijte místo toho soubory, které se přidají nebo upraví (pouze vlastnosti).
|
| Při přidání nebo změně souboru [ZASTARALÉ] |
Tato akce je zastaralá. Použijte místo toho soubor, který přidáte nebo upravíte .
|
Při přidání nebo změně souboru (pouze vlastnosti) [ZASTARALÉ]
Tato akce je zastaralá. Použijte místo toho soubory, které se přidají nebo upraví (pouze vlastnosti).
Tato operace aktivuje tok při přidání nebo změně souboru ve složce. Tento trigger načte pouze metadata souboru. K získání obsahu souboru můžete použít operaci Získat obsah souboru. Trigger spoléhá na čas poslední změny souboru. Pokud soubor vytváří klient třetí strany, zachování času poslední změny by mělo být v klientovi zakázané. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Složka
|
folderId | True | string |
Výběr složky |
|
Počet souborů, které se mají vrátit z triggeru
|
maxFileCount | integer |
Maximální počet souborů, které se mají vrátit jedním spuštěním triggeru (1–100). Všimněte si, že nastavení Split On může vynutit, aby trigger zpracovával jednotlivé položky jednotlivě. |
Návraty
Metadata objektů blob
- Seznam souborů
- BlobMetadata
Při přidání nebo změně souboru [ZASTARALÉ]
Tato akce je zastaralá. Použijte místo toho soubor, který přidáte nebo upravíte .
Tato operace aktivuje tok při přidání nebo změně souboru ve složce. Trigger načte metadata souboru i obsah souboru. Trigger spoléhá na čas poslední změny souboru. Pokud soubor vytváří klient třetí strany, zachování času poslední změny by mělo být v klientovi zakázané. Trigger přeskočí soubory větší než 50 megabajtů. Trigger se neaktivuje, pokud je soubor přidaný nebo aktualizovaný v podsložce. Pokud se vyžaduje k aktivaci v podsložkách, mělo by se vytvořit více aktivačních událostí.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Složka
|
folderId | True | string |
Zadání složky |
|
Zahrnout obsah souboru
|
includeFileContent | boolean |
Pokud je nastavená hodnota true, obsah souboru se také načte spolu s odpovědí triggeru. |
|
|
Odvození typu obsahu
|
inferContentType | boolean |
Odvození typu obsahu na základě rozšíření |
Návraty
Obsah souboru.
- Obsah souboru
- binary
Definice
BlobMetadata
Metadata objektů blob
| Name | Cesta | Typ | Description |
|---|---|---|---|
|
identifikační číslo
|
Id | string |
Jedinečné ID souboru nebo složky. |
|
Název
|
Name | string |
Název souboru nebo složky. |
|
ZobrazovanéJméno
|
DisplayName | string |
Zobrazovaný název souboru nebo složky. |
|
Cesta
|
Path | string |
Cesta k souboru nebo složce. |
|
Naposledy upraveno
|
LastModified | date-time |
Datum a čas poslední změny souboru nebo složky. |
|
Velikost
|
Size | integer |
Velikost souboru nebo složky. |
|
MediaType
|
MediaType | string |
Typ média souboru nebo složky. |
|
IsFolder
|
IsFolder | boolean |
Logická hodnota (true, false) označující, jestli je objekt blob složkou nebo ne. |
|
ETag
|
ETag | string |
Etag souboru nebo složky. |
|
FileLocator
|
FileLocator | string |
Lokátor souboru nebo složky. |
binární
Toto je základní datový typ Binary.