Megosztás:


FTP

A Fájlátviteli protokoll (FTP) egy szabványos hálózati protokoll, amellyel számítógépfájlokat lehet átvinni egy ügyfél és egy számítógép-hálózat kiszolgálója között. Az FTP egy ügyfél-kiszolgáló modell architektúrájára épül, és külön vezérlő- és adatkapcsolatokat használ az ügyfél és a kiszolgáló között.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service Class Régiók
Copilot Studio Standard Az összes Power Automate-régió, kivéve a következőket:
     - Amerikai kormány (GCC High)
     - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások Standard Minden Logic Apps-régió
Power Alkalmazások Standard Az összes Power Apps-régió , kivéve a következőket:
     - Amerikai kormány (GCC High)
     - Amerikai Védelmi Minisztérium (DoD)
Power Automate Standard Az összes Power Automate-régió, kivéve a következőket:
     - Amerikai kormány (GCC High)
     - Amerikai Védelmi Minisztérium (DoD)
Összekötő metaadatai
Kiadó Microsoft

Ismert problémák és korlátozások

  • Ez a cikk csak az Azure Logic Appshez, a Power Automate-hez és a Power Appshez elérhető FTP-felügyelt összekötő műveleteit ismerteti. Az FTP beépített összekötője csak az Azure Logic Apps standard logikai alkalmazás-munkafolyamataihoz érhető el. Az Azure Logic Apps beépített FTP-összekötőjével kapcsolatos további információkért tekintse át a Csatlakozás FTP-kiszolgálókhoz az Azure Logic Apps munkafolyamataiból.

  • Az FTP-eseményindítók mostantól csak metaadatokat vagy tulajdonságokat ad vissza, a fájltartalmakat nem. Ezeket az eseményindítókat azonban a Fájltartalom lekérése művelettel követheti. Ha meg szeretné győződni arról, hogy egy eseményindító egyszerre egy fájlt ad vissza egy lista helyett, engedélyezze az eseményindító "Felosztás bekapcsolva" beállítását. Az Azure Logic Appsben elérhető beállítással kapcsolatos további információkért tekintse át a több futtatásos triggert.

  • Az FTP-eseményindítók csak a megadott mappán működnek, az almappákon nem. A mappa almappáinak ellenőrzéséhez állítson be egy külön folyamatot az egyes almappákhoz.

  • Az FTP által felügyelt összekötőműveletek alapértelmezés szerint 50 MB-os vagy annál kisebb fájlokat tudnak olvasni vagy írni. Az 50 MB-nál nagyobb fájlok kezeléséhez használhatja a Fájltartalom lekérése nevű FTP-felügyelt összekötő műveletet, amely implicit módon üzenettömböt használ. Más FTP által felügyelt összekötőműveletek is támogatják az üzenetek adattömbbe helyezésének engedélyezését.

  • Az FTP-eseményindítók késéseket vagy hiányos eredményeket tapasztalhatnak az újonnan létrehozott, hozzáadott vagy frissített fájlok visszaadásakor.

    Amikor egy FTP-eseményindító egy újonnan hozzáadott vagy módosított fájlt keres, az eseményindító azt is megerősíti, hogy a fájl elkészült. Előfordulhat például, hogy egy fájl módosul, amikor az eseményindító ellenőrzi az FTP-kiszolgálót. A hiányos fájlok visszaadásának elkerülése érdekében az eseményindító megjegyzi a fájl időbélyegét, de nem adja vissza azonnal a fájlt. Ehelyett az eseményindító csak akkor adja vissza a fájlt, ha az eseményindító ismét ellenőrzi a kiszolgálót. Előfordulhat, hogy ez a viselkedés az eseményindító lekérdezési időközének akár kétszeresét is késlelteti. Emiatt előfordulhat, hogy az FTP-eseményindító nem minden fájlt ad vissza egyszerre, ha letiltja az FTP-eseményindító Split On beállítását,

  • Az FTP által felügyelt összekötő eseményindítói hiányzó, hiányos vagy késleltetett eredményeket tapasztalhatnak, ha a "legutóbb módosított" időbélyeg megmarad.

    • Hiányzó eredmények

      Az FTP-eseményindítók az FTP-fájlrendszer lekérdezésével vagy ellenőrzésével működnek, és a legutóbbi szavazás óta megváltozott fájlokat keresik. Az FTP által felügyelt összekötő eseményindítói összehasonlítják a fájlverziókat a fájl utolsó módosított időbélyegével.

      Ha a legutóbb követett időbélyegnél korábbi időbélyeggel hoz létre, vehet fel vagy frissíthet fájlokat, a felügyelt FTP-összekötő eseményindítója nem fogja észlelni ezt a fájlt. Ezzel szemben a Standard logikai alkalmazás munkafolyamataiban az FTP beépített összekötő-eseményindítója nem rendelkezik ezzel a korlátozással.

      Ha tehát olyan külső eszközt vagy ügyfelet használ, amely fájlokat hoz létre, ad hozzá vagy frissít az FTP-kiszolgálón, győződjön meg arról, hogy letiltja az eszköz vagy ügyfél azon funkcióit, amelyek megőrzik a fájl utolsó módosított időbélyegét.

      Az alábbi táblázat felsorol néhány gyakran használt eszközt, amelyek megőrzik ezt az időbélyeget, valamint a funkció letiltásának lépéseit:

      FTP-ügyfél Tevékenység
      WinSCP Nyissa meg a Beállítások>beállítások>átadása –>Szerkesztés>megőrzése időbélyeg>letiltása lehetőséget.
      FileZilla Nyissa meg azátvitt fájlok> időbélyegeinek átvitele>– Letiltás.
    • Hiányos vagy késleltetett eredmények

      Amikor egy FTP-eseményindító egy újonnan létrehozott, hozzáadott vagy frissített fájlt keres, az eseményindító azt is ellenőrzi, hogy a fájl elkészült-e. Előfordulhat például, hogy egy fájl módosul, amikor az eseményindító ellenőrzi az FTP-kiszolgálót. A hiányos fájlok visszaadásának elkerülése érdekében az eseményindító megjegyzi a fájl időbélyegét, de nem adja vissza azonnal a fájlt. Ehelyett az eseményindító csak akkor adja vissza a fájlt, ha az eseményindító ismét ellenőrzi a kiszolgálót.

      Előfordulhat, hogy ez a viselkedés olyan késleltetést okoz, amely akár a trigger lekérdezési időközének majdnem kétszerese is lehet. Emiatt a viselkedés miatt, ha letiltja az FTP-eseményindító Split On beállítását, előfordulhat, hogy az FTP-eseményindító nem minden fájlt ad vissza egyszerre.

Requirements

  • Az FTP-összekötőnek szüksége van az FTP-gazdakiszolgáló címére és a fiók hitelesítő adataira.

  • Az FTP-összekötőnek hozzáférésre van szüksége az FTP-kiszolgálóhoz az internetről vagy az interneten keresztül. Az FTP-kiszolgálóra irányuló forgalom adott IP-tartományok használatával történő engedélyezésével kapcsolatos további információkért tekintse át a felügyelt összekötő IP-címeit.

  • Az FTP-összekötőnek passzív módban kell működnie vagy fogadnia az FTP-kiszolgálót.

  • Az FTP-összekötőhöz az FTP-kiszolgálónak engedélyeznie kell a következő parancsokat, és támogatnia kell a szóközt tartalmazó mappákat, hogy a parancsok megfelelően működjenek. A LIST parancs esetében győződjön meg arról, hogy a parancs visszaadja az összetevőt a year 6 hónapnál régebbi fájl-időbélyegekhez.

    • APPE
    • DELE
    • LISTA
    • MDTM
    • RENAME
    • RETR
    • MÉRET
    • STOR
  • A biztonságos FTP-hez az implicit FTPS helyett az explicit File Transfer Protocol Secure (FTPS) beállítást kell beállítania. Emellett egyes FTP-kiszolgálóknak, például a ProFTPd-nek engedélyeznie kell a NoSessionReuseRequired beállítást, ha a Transport Layer Security (TLS) módot használja, amely a Secure Socket Layer (SSL) utódja.

    Az FTP-összekötő nem működik implicit FTPS-sel, és csak az FTPS-en keresztüli explicit FTP-t támogatja, amely a TLS kiterjesztése.

FTP-kapcsolatok

  • Az FTP-összekötő és az FTP-kiszolgáló teljesítményének javítása érdekében az FTP-kapcsolat nyitva és aktív marad, miután az összekötő teljesítette a kérést.

    Amikor ftp-kiszolgálóval hoz létre kapcsolatot, a megjelenő kapcsolatprofil-mező a kérelem befejezése után a Kapcsolat bezárása nevű beállítással rendelkezik. Ez a beállítás azt határozza meg, hogy egy kérés befejeződése után minden alkalommal be kell-e zárni az FTP-kiszolgálókapcsolatot. Ha letiltja ezt a beállítást, a kapcsolat nem záródik be a kérés befejeződése után, és a jövőben is aktív marad.

  • Ha a munkafolyamat-példányok párhuzamosan futnak, időszakos csatlakozási hibákat tapasztalhat. Előfordulhat, hogy a munkafolyamat egyes műveletei kényszerítetten lezárják a kapcsolatot, még akkor is, ha a munkafolyamat más műveletei még ezt a kapcsolatot használják.

    A forgatókönyv elkerülése érdekében próbálkozzon a következő javaslatokkal:

    • A kapcsolat létrehozásakor engedélyezze a kapcsolat bezárását a kérelem befejezési beállítása után .

    • Kapcsolja ki az eseményindítókon vagy műveleteken engedélyezett párhuzamosságot vagy egyidejűséget. A megoldással kapcsolatos további információkért tekintse át az alábbi dokumentációt az Azure Logic Appsben:

    • Kerülje több párhuzamos folyamat futtatását.

A "Fájl létrehozása" művelet használata adattömb használatával és nélkül

A Fájl létrehozása művelet viselkedése a művelet Engedélyezési adattömb-beállításától és a létrehozandó fájl méretétől függ:

  • Engedélyezett adattömb-készítés engedélyezése:

    • A fájlméret legalább 50 MB: A művelet egyetlen kéréssel tölti fel a fájlt, az eredeti fájlnevet használja, és a feltöltés során zárolja a fájlt.

    • A fájlméret nagyobb, mint 50 MB: A művelet a fájlt névformátummal, fájlnévvel hozza létre.new-GUID.ms.partial, és több kérés vagy üzenettömb használatával tölti fel a fájlt. Miután a művelet feltöltötte az utolsó adattömbet, a művelet átnevezi a fájlt az eredeti fájlnévvel.

  • Az adattömb letiltásának engedélyezése : A művelet egyetlen kéréssel tölti fel a fájlt, az eredeti fájlnevet használja, és a feltöltés során zárolja a fájlt.

Útmutató az összekötőkhöz

Az FTP által felügyelt összekötő és az Azure Logic Apps beépített összekötőjének használatáról az Azure Logic Apps munkafolyamataiból származó Csatlakozás FTP-kiszolgálókhoz című témakörben olvashat.

Általános korlátok

Név Érték
Mappák maximális száma egyetlen archívumban. Ez a korlát csak a mappák létrehozásakor érvényes. értéke "Igen". 16
Az összekötőbe/onnan átvitt megabájtok maximális száma sávszélesség-időintervallumon belül (kapcsolatonként) 1000
Sávszélesség időintervalluma (ezredmásodpercben) 60000

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Alapértelmezett A kapcsolat létrehozásának paraméterei. Minden régió Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név Típus Description Kötelező
Kiszolgáló címe karakterlánc Kiszolgáló címe True
Felhasználónév karakterlánc Felhasználónév True
Jelszó securestring Jelszó True
FTP-kiszolgáló portja int FTP-port száma (példa: 21)
Engedélyezi az SSL-t? bool Engedélyezi az SSL-t? (Igaz/Hamis)
Bináris átvitel? bool Engedélyezi a bináris átvitelt? (Igaz/Hamis)
Letiltja a tanúsítványérvényesítést? bool Letiltja a tanúsítványérvényesítést? (Igaz/Hamis)
Kapcsolat bezárása a kérelem befejezése után bool A kérés befejeződése után minden alkalommal zárja be az FTP-kapcsolatot? (Igaz/Hamis)

Szabályozási korlátok

Name Hívások Megújítási időszak
API-hívások kapcsolatonként 900 60 másodperc

Műveletek

Archívum kinyerés mappába

Ez a művelet kinyer egy archív fájlt egy mappába (például: .zip).

Fájl frissítése

Ez a művelet frissíti a fájlt. Ha egy fájlt közvetlenül a frissítés után törölnek/átneveznek a kiszolgálón, az összekötő a terv szerint HTTP 404-et ad vissza. A legutóbb frissített fájl törlése vagy átnevezése előtt használjon 1 perces késést.

Fájl létrehozása

Ez a művelet létrehoz egy fájlt. Ha egy fájlt közvetlenül a létrehozása után törölnek/átneveznek a kiszolgálón, az összekötő a terv szerint HTTP 404-et ad vissza. Az újonnan létrehozott fájl törlése vagy átnevezése előtt használjon 1 perces késést.

Fájl metaadatainak beolvasása

Ez a művelet lekéri egy fájl metaadatait.

Fájl metaadatainak lekérése elérési úttal

Ez a művelet lekéri egy fájl metaadatait a fájl elérési útján.

Fájl másolása

Ez a művelet fájlokat másol egy FTP-kiszolgálóra. Ha egy fájlt közvetlenül a másolás után törölnek/átneveznek a kiszolgálón, az összekötő a terv szerint HTTP 404-et ad vissza. Az újonnan létrehozott fájl törlése vagy átnevezése előtt használjon 1 perces késést.

Fájl törlése

Ez a művelet töröl egy fájlt.

Fájlok listázása a gyökérmappában

Ez a művelet lekéri a gyökérmappában található fájlok és almappák listáját.

Fájlok listázása a mappában

Ez a művelet lekéri a fájlok és almappák listáját egy mappában.

Fájltartalom lekérése

Ez a művelet lekéri egy fájl tartalmát.

Fájltartalom lekérése elérési úttal

Ez a művelet lekéri egy fájl tartalmát a fájl elérési útján.

Archívum kinyerés mappába

Ez a művelet kinyer egy archív fájlt egy mappába (például: .zip).

Paraméterek

Name Kulcs Kötelező Típus Description
Forrásarchívum fájl elérési útja
source True string

Az archív fájl elérési útja

Célmappa elérési útja
destination True string

A célmappa elérési útja

Felülírja?
overwrite boolean

Felülírja a célfájlokat, ha igaz értékre van állítva

Mappákat hoz létre?
createFolders boolean

Kinyeri a mappákat az archívumból, ha "true" (igaz) értékre van állítva

Válaszok

Fájl frissítése

Ez a művelet frissíti a fájlt. Ha egy fájlt közvetlenül a frissítés után törölnek/átneveznek a kiszolgálón, az összekötő a terv szerint HTTP 404-et ad vissza. A legutóbb frissített fájl törlése vagy átnevezése előtt használjon 1 perces késést.

Paraméterek

Name Kulcs Kötelező Típus Description
File
id True string

Fájl kiválasztása

Fájltartalom
body True binary

A fájl tartalma

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl létrehozása

Ez a művelet létrehoz egy fájlt. Ha egy fájlt közvetlenül a létrehozása után törölnek/átneveznek a kiszolgálón, az összekötő a terv szerint HTTP 404-et ad vissza. Az újonnan létrehozott fájl törlése vagy átnevezése előtt használjon 1 perces késést.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa útvonal
folderPath True string

Mappa kiválasztása

Fájlnév
name True string

A fájl neve

Fájltartalom
body True binary

A fájl tartalma

Az összes fájl metaadatainak lekérése
ReadFileMetadataFromServer boolean

A fájllétrehozás befejezése után kérje le az összes fájl metaadatait az SFTP-kiszolgálóról. Ha ez hamis, előfordulhat, hogy egyes metaadat-tulajdonságok nem lesznek visszaadva, például az utolsó módosítás időpontja stb.

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl metaadatainak beolvasása

Ez a művelet lekéri egy fájl metaadatait.

Paraméterek

Name Kulcs Kötelező Típus Description
File
id True string

Fájl kiválasztása

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl metaadatainak lekérése elérési úttal

Ez a művelet lekéri egy fájl metaadatait a fájl elérési útján.

Paraméterek

Name Kulcs Kötelező Típus Description
Fájl elérési útja
path True string

Fájl kiválasztása

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl másolása

Ez a művelet fájlokat másol egy FTP-kiszolgálóra. Ha egy fájlt közvetlenül a másolás után törölnek/átneveznek a kiszolgálón, az összekötő a terv szerint HTTP 404-et ad vissza. Az újonnan létrehozott fájl törlése vagy átnevezése előtt használjon 1 perces késést.

Paraméterek

Name Kulcs Kötelező Típus Description
Forrás URL-címe
source True string

A forrásfájl URL-címe

Célfájl elérési útja
destination True string

Célfájl elérési útja, beleértve a célfájlnevet

Felülírja?
overwrite boolean

Felülírja a célfájlt, ha igaz értékre van állítva

Válaszok

Blob metaadatai

Törzs
BlobMetadata

Fájl törlése

Ez a művelet töröl egy fájlt.

Paraméterek

Name Kulcs Kötelező Típus Description
File
id True string

Fájl kiválasztása

Fájlok listázása a gyökérmappában

Ez a művelet lekéri a gyökérmappában található fájlok és almappák listáját.

Válaszok

Fájlok listázása a mappában

Ez a művelet lekéri a fájlok és almappák listáját egy mappában.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
id True string

Mappa kiválasztása

Válaszok

Fájltartalom lekérése

Ez a művelet lekéri egy fájl tartalmát.

Paraméterek

Name Kulcs Kötelező Típus Description
File
id True string

Fájl kiválasztása

Tartalomtípus következtetése
inferContentType boolean

Tartalomtípus következtetése bővítmény alapján

Válaszok

A fájl tartalma.

Fájl tartalma
binary

Fájltartalom lekérése elérési úttal

Ez a művelet lekéri egy fájl tartalmát a fájl elérési útján.

Paraméterek

Name Kulcs Kötelező Típus Description
Fájl elérési útja
path True string

Fájl kiválasztása

Tartalomtípus következtetése
inferContentType boolean

Tartalomtípus következtetése bővítmény alapján

Válaszok

A fájl tartalma.

Fájl tartalma
binary

Triggerek

Fájl hozzáadásakor vagy módosításakor (csak tulajdonságok)

Ez a művelet elindít egy folyamatot, amikor egy vagy több fájlt adnak hozzá vagy módosítanak egy mappában. Ez az eseményindító csak a fájl metaadatait fogja lekérni. A fájltartalom lekéréséhez használhatja a "Fájltartalom lekérése" műveletet. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Fájl hozzáadásakor vagy módosításakor [ELAVULT]

Ez a művelet elindít egy folyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy mappában. Az eseményindító lekéri mind a fájl metaadatait, mind a fájl tartalmát. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító kihagyja az 50 megabájtnál nagyobb fájlokat. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Fájl hozzáadásakor vagy módosításakor (csak tulajdonságok)

Ez a művelet elindít egy folyamatot, amikor egy vagy több fájlt adnak hozzá vagy módosítanak egy mappában. Ez az eseményindító csak a fájl metaadatait fogja lekérni. A fájltartalom lekéréséhez használhatja a "Fájltartalom lekérése" műveletet. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
folderId True string

Mappa kiválasztása

Visszaadandó fájlok száma
maxFileCount integer

Egyetlen trigger futtatásával visszaadandó fájlok maximális száma (1–100). Vegye figyelembe, hogy a "Felosztás" beállítás kényszerítheti az eseményindítót az egyes elemek egyenkénti feldolgozására.

Válaszok

Blob metaadatai

Fájlok listája
BlobMetadata

Fájl hozzáadásakor vagy módosításakor [ELAVULT]

Ez a művelet elindít egy folyamatot, amikor egy fájlt hozzáadnak vagy módosítanak egy mappában. Az eseményindító lekéri mind a fájl metaadatait, mind a fájl tartalmát. Az eseményindító a fájl utolsó módosított időpontjára támaszkodik. Ha egy harmadik féltől származó ügyfél hoz létre egy fájlt, az utolsó módosítási idő megőrzését le kell tiltani az ügyfélben. Az eseményindító kihagyja az 50 megabájtnál nagyobb fájlokat. Az eseményindító nem aktiválódik, ha egy fájl hozzá van adva/frissítve van egy almappában. Ha almappákon kell aktiválni, több eseményindítót kell létrehozni.

Paraméterek

Name Kulcs Kötelező Típus Description
Mappa
folderId True string

Mappa kiválasztása

Fájltartalom belefoglalása
includeFileContent boolean

Ha igaz értékre van állítva, a rendszer a fájltartalmat is lekéri az eseményindító válaszával együtt

Tartalomtípus következtetése
inferContentType boolean

Tartalomtípus következtetése bővítmény alapján

Válaszok

A fájl tartalma.

Fájl tartalma
binary

Definíciók

BlobMetadata

Blob metaadatai

Name Elérési út Típus Description
Azonosító
Id string

A fájl vagy mappa egyedi azonosítója.

Név
Name string

A fájl vagy mappa neve.

Megjelenítendő név
DisplayName string

A fájl vagy mappa megjelenítendő neve.

Útvonal
Path string

A fájl vagy mappa elérési útja.

Utolsó módosítás
LastModified date-time

A fájl vagy mappa utolsó módosításának dátuma és időpontja.

Méret
Size integer

A fájl vagy mappa mérete.

Médiatípus
MediaType string

A fájl vagy mappa médiatípusa.

IsFolder
IsFolder boolean

Logikai érték (igaz, hamis), amely jelzi, hogy a blob mappa-e.

ETag
ETag string

A fájl vagy mappa etagje.

FileLocator
FileLocator string

A fájl vagy mappa fájlkeresője.

bináris

Ez a bináris alapszintű adattípus.