protokol FTP
Protokol FTP (File Transfer Protocol) je standardní síťový protokol používaný k přenosu souborů počítače mezi klientem a serverem v počítačové síti. Protokol FTP je založený na architektuře modelu klientského serveru a používá samostatná řídicí a datová připojení mezi klientem a serverem.
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 |
| 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) |
| Metadata konektoru | |
|---|---|
| Vydavatel | Microsoft |
Známé problémy a omezení
Tento článek popisuje operace pouze pro spravovaný konektor FTP, který je k dispozici pro Azure Logic Apps, Power Automate a Power Apps. Integrovaný konektor FTP je k dispozici pouze pro pracovní postupy standardní aplikace logiky v Azure Logic Apps. Další informace o integrovaném konektoru FTP v Azure Logic Apps najdete v tématu Připojení k serverům FTP z pracovních postupů v Azure Logic Apps.
Triggery FTP teď vrací pouze metadata nebo vlastnosti, nikoli obsah souboru. Tyto triggery však můžete sledovat pomocí akce s názvem Získat obsah souboru. Pokud chcete mít jistotu, že trigger vrací vždy jeden soubor, ne seznam, nezapomeňte povolit možnost Rozdělit na aktivační událost. Další informace o této možnosti v Azure Logic Apps najdete v tématu Aktivace několika spuštění.
Triggery FTP fungují jenom v zadané složce, nikoli v podsložkách. Pokud chcete také zkontrolovat podsložky složky, nastavte pro každou podsložku samostatný tok.
Ve výchozím nastavení můžou akce spravovaného konektoru FTP číst nebo zapisovat soubory, které jsou 50 MB nebo menší. Pokud chcete zpracovat soubory větší než 50 MB, můžete použít akci konektoru spravovaného ftp s názvem Získat obsah souboru, který implicitně používá blok zpráv. Další akce konektoru spravovaného ftp podporují také povolení bloků zpráv.
Triggery FTP můžou mít zpoždění nebo neúplné výsledky při vracení nově vytvořených, přidaných nebo aktualizovaných souborech.
Když trigger FTP zkontroluje nově přidaný nebo změněný soubor, trigger také potvrdí, že je soubor dokončený. Například při kontrole triggeru serveru FTP může dojít ke změnám souboru. Aby se zabránilo vrácení neúplného souboru, aktivační událost zaznamená časové razítko souboru, ale nevrátí soubor okamžitě. Místo toho trigger vrátí soubor pouze tehdy, když trigger znovu zkontroluje server. Někdy toto chování může způsobit zpoždění, které trvá až dvakrát interval dotazování triggeru. Kvůli tomuto chování nemusí trigger FTP vracet všechny soubory najednou, pokud zakážete nastavení Rozdělit na ftp triggeru.
Triggery spravovaného konektoru FTP můžou mít po zachování časového razítka poslední změny chybějící, neúplné nebo zpožděné výsledky.
Chybějící výsledky
Triggery FTP fungují dotazováním nebo kontrolou systému souborů FTP a hledají všechny soubory, které se od posledního hlasování změnily. Spravovaný konektor FTP spouští porovnání verzí souborů pomocí časového razítka poslední změny souboru.
Pokud vytvoříte, přidáte nebo aktualizujete soubor s časovým razítkem, které je dřívější než aktuálně sledované časové razítko poslední změny, trigger spravovaného konektoru FTP tento soubor nerozpozná. Na druhou stranu trigger integrovaného konektoru FTP v pracovních postupech standardní aplikace logiky toto omezení nemá.
Pokud tedy používáte externí nástroj nebo klienta, který vytváří, přidává nebo aktualizuje soubory na serveru FTP, zakažte všechny funkce nástroje nebo klienta, které zachová časové razítko poslední změny souboru.
Následující tabulka uvádí některé běžně používané nástroje, které zachová toto časové razítko, a postup pro zakázání této funkce:
Klient FTP Činnost WinSCP Přejděte na Možnosti>Předvolby>Převést Upravit>Zachovat>časové razítko>Zakázat. FileZilla Přejděte na Možnost Přenést>zachovat časová razítka přenesených souborů>Zakázat. Neúplné nebo zpožděné výsledky
Když trigger FTP zkontroluje nově vytvořený, přidaný nebo aktualizovaný soubor, trigger také zkontroluje, jestli je soubor dokončený. Například při kontrole triggeru serveru FTP může dojít ke změnám souboru. Aby se zabránilo vrácení neúplného souboru, aktivační událost zaznamená časové razítko souboru, ale nevrátí soubor okamžitě. Místo toho trigger vrátí soubor pouze tehdy, když trigger znovu zkontroluje server.
Někdy toto chování může způsobit zpoždění, které trvá téměř dvakrát interval dotazování triggeru. Pokud kvůli tomuto chování zakážete nastavení Split On triggeru FTP, trigger FTP nemusí vrátit všechny soubory najednou.
Požadavky
Konektor FTP vyžaduje adresu hostitelského serveru FTP a přihlašovací údaje účtu.
Konektor FTP vyžaduje přístup k serveru FTP z internetu nebo přes internet. Další informace o povolení provozu na server FTP pomocí konkrétních rozsahů IP adres najdete v tématu IP adresy spravovaného konektoru.
Konektor FTP vyžaduje, aby server FTP fungoval nebo přijímal v pasivním režimu.
Konektor FTP vyžaduje, aby server FTP povolil následující příkazy a podporoval složky, které obsahují prázdné znaky, aby příkazy mohly správně fungovat. V případě příkazu LIST se ujistěte, že příkaz vrátí
yearsoučást pro časová razítka souboru starší než 6 měsíců.- APPE
- DELE
- SEZNAM
- MDTM
- RENAME
- RETR
- VELIKOST
- STOR
Pro zabezpečený protokol FTP nezapomeňte nastavit explicitní protokol FTPS (File Transfer Protocol Secure), a ne implicitní FTPS. Některé servery FTP, například ProFTPd, vyžadují, abyste tuto možnost povolili
NoSessionReuseRequired, pokud používáte režim TLS (Transport Layer Security), následníka protokolu SSL (Secure Socket Layer).Konektor FTP nefunguje s implicitní službou FTPS a podporuje pouze explicitní ftp přes FTPS, což je rozšíření protokolu TLS.
Připojení FTP
Pokud chcete zvýšit výkon konektoru FTP i serveru FTP, můžete po dokončení požadavku ponechat připojení FTP otevřené a aktivní.
Když vytvoříte připojení k serveru FTP, zobrazí se pole profilu připojení s názvem Zavřít připojení po dokončení požadavku. Toto nastavení určuje, jestli se má připojení k serveru FTP zavřít při každém dokončení požadavku. Pokud toto nastavení ponecháte zakázané, připojení se po dokončení požadavku nezavře a zůstane aktivní pro budoucí použití.
Pokud se instance pracovních postupů spouští paralelně, může docházet k občasným chybám připojení. Některé operace v pracovním postupu můžou vynutily ukončení připojení, i když ostatní operace v pracovním postupu toto připojení stále používají.
Pokud se chcete tomuto scénáři vyhnout, vyzkoušejte následující doporučení:
Při vytváření připojení povolte po dokončení požadavku možnost Zavřít připojení .
Vypněte všechny paralelizace nebo souběžnost, které jsou povolené u triggerů nebo akcí. Další informace o tomto řešení v Azure Logic Apps najdete v následující dokumentaci:
Vyhněte se spouštění více paralelních toků.
Použití akce Vytvořit soubor s blokem dat a bez jejich vytváření
U akce Vytvořit soubor toto chování závisí na nastavení Povolit blokování dat akce a velikosti souboru, který se má vytvořit:
Povolit bloky dat :
Velikost souboru je rovna nebo menší než 50 MB: Akce soubor nahraje jedním požadavkem, použije původní název souboru a během nahrávání soubor uzamkne.
Velikost souboru je větší než 50 MB: Akce vytvoří soubor s formátem názvu a názvem souboru.new-GUID.ms.partial a nahraje soubor pomocí více požadavků nebo bloků zpráv. Po nahrání posledního bloku dat akce přejmenuje soubor s původním názvem souboru.
Povolit blokování dat zakázáno: Akce nahraje soubor s jediným požadavkem, použije původní název souboru a během nahrávání soubor zamkne.
Průvodce návodem ke konektoru
Informace o použití spravovaného konektoru FTP a integrovaného konektoru v Azure Logic Apps najdete v tématu Připojení k serverům FTP z pracovních postupů v Azure Logic Apps.
Obecné limity
| Název | Hodnota |
|---|---|
| Maximální počet složek v jednom archivu Tento limit platí jenom v případě, že se vytvářejí složky? je nastavena na Ano. | 16 |
| 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 serveru | řetězec | Adresa serveru | Pravdivé |
| Uživatelské jméno | řetězec | Uživatelské jméno | Pravdivé |
| Heslo | securestring | Heslo | Pravdivé |
| Port serveru FTP | int | Číslo portu FTP (příklad: 21) | |
| Chcete povolit SSL? | Booleova hodnota | Chcete povolit SSL? (Pravda nebo nepravda) | |
| Binární přenos? | Booleova hodnota | Chcete povolit binární přenos? (Pravda nebo nepravda) | |
| Zakázat ověření certifikátu? | Booleova hodnota | Zakázat ověření certifikátu? (Pravda nebo nepravda) | |
| Zavření připojení po dokončení požadavku | Booleova hodnota | Po dokončení požadavku zavřete připojení FTP? (Pravda nebo nepravda) |
Limity omezování
| Name | Volání | Období obnovení |
|---|---|---|
| Volání rozhraní API na připojení | 900 | 60 sekund |
Akce
| Aktualizovat soubor |
Tato operace aktualizuje soubor. 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. |
| Extrahování archivu do složky |
Tato operace extrahuje soubor archivu do složky (příklad: .zip). |
| Kopírování souboru |
Tato operace zkopíruje soubor na server FTP. 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. |
| Odstranit soubor |
Tato operace odstraní soubor. |
| Vytvořit soubor |
Tato operace vytvoří soubor. 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. |
| Výpis souborů v kořenové složce |
Tato operace získá seznam souborů a podsložek v kořenové složce. |
| Výpis souborů ve složce |
Tato operace získá seznam souborů a podsložek ve složce. |
| Získat obsah souboru |
Tato operace získá obsah souboru. |
| Získání metadat souboru |
Tato operace získá metadata pro soubor. |
| Získání metadat souboru pomocí cesty |
Tato operace získá metadata souboru pomocí cesty k souboru. |
| Získání obsahu souboru pomocí cesty |
Tato operace získá obsah souboru pomocí cesty k souboru. |
Aktualizovat soubor
Tato operace aktualizuje soubor. 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 |
Výběr souboru |
|
Obsah souboru
|
body | True | binary |
Obsah souboru |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Extrahování archivu 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. |
|
|
Chcete vytvořit složky?
|
createFolders | boolean |
Extrahuje složky z archivu, pokud je nastavená hodnota true. |
Návraty
- response
- array of BlobMetadata
Kopírování souboru
Tato operace zkopíruje soubor na server FTP. 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 |
|---|---|---|---|---|
|
Zdrojová adresa URL
|
source | True | string |
Adresa URL zdrojového souboru |
|
Cílová cesta k souboru
|
destination | True | string |
Cílová cesta k souboru, včetně cílového 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
Odstranit soubor
Tato operace odstraní soubor.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Výběr souboru |
Vytvořit soubor
Tato operace vytvoří soubor. 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 |
Výběr složky |
|
Název souboru
|
name | True | string |
Název souboru |
|
Obsah souboru
|
body | True | binary |
Obsah souboru |
|
Získání všech metadat souborů
|
ReadFileMetadataFromServer | boolean |
Po vytvoření souboru získejte všechna metadata souborů ze serveru SFTP. Pokud je tato hodnota false, některé vlastnosti metadat nemusí být vráceny, například čas poslední změny atd. |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Výpis souborů v kořenové složce
Tato operace získá seznam souborů a podsložek v kořenové složce.
Návraty
- response
- array of BlobMetadata
Výpis souborů ve složce
Tato operace získá seznam souborů a podsložek ve složce.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Složka
|
id | True | string |
Výběr složky |
Návraty
- response
- array of BlobMetadata
Získat obsah souboru
Tato operace získá obsah souboru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Výběr souboru |
|
Odvození typu obsahu
|
inferContentType | boolean |
Odvození typu obsahu na základě rozšíření |
Návraty
Obsah souboru.
- Obsah souboru
- binary
Získání metadat souboru
Tato operace získá metadata pro soubor.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
File
|
id | True | string |
Výběr souboru |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Získání metadat souboru pomocí 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 |
Výběr souboru |
Návraty
Metadata objektů blob
- Body
- BlobMetadata
Získání obsahu souboru pomocí cesty
Tato operace získá obsah souboru pomocí cesty k souboru.
Parametry
| Name | Klíč | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
Cesta k souboru
|
path | True | string |
Výběr 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) |
Tato operace aktivuje tok při přidání nebo změně jednoho nebo více souborů 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í. |
| Při přidání nebo změně souboru [ZASTARALÉ] |
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í. |
Při přidání nebo změně souboru (pouze vlastnosti)
Tato operace aktivuje tok při přidání nebo změně jednoho nebo více souborů 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
|
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 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 |
Výběr 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.