Dela via

FTP

File Transfer Protocol (FTP) är ett standardnätverksprotokoll som används för att överföra datorfiler mellan en klient och server i ett datornätverk. FTP bygger på en klient-server-modellarkitektur och använder separata kontroll- och dataanslutningar mellan klienten och servern.

Den här anslutningsappen är tillgänglig i följande produkter och regioner:

Tjänster Class Regioner
Copilot Studio Norm Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC High)
     - US Department of Defense (DoD)
Logiska appar Norm Alla Logic Apps-regioner
Power Apps Norm Alla Power Apps-regioner utom följande:
     - Amerikanska myndigheter (GCC High)
     - US Department of Defense (DoD)
Power Automate Norm Alla Power Automate-regioner utom följande:
     - Amerikanska myndigheter (GCC High)
     - US Department of Defense (DoD)
Metadata för anslutningsprogram
Utgivare Microsoft

Kända problem och begränsningar

  • Den här artikeln beskriver endast åtgärderna för FTP-hanterad anslutningsapp, som är tillgänglig för Azure Logic Apps, Power Automate och Power Apps. Den inbyggda FTP-anslutningsappen är endast tillgänglig för standardarbetsflöden för logikappar i Azure Logic Apps. Mer information om den inbyggda FTP-anslutningsappen i Azure Logic Apps finns i Ansluta till FTP-servrar från arbetsflöden i Azure Logic Apps.

  • FTP-utlösare returnerar nu endast metadata eller egenskaper, inte filinnehåll. Du kan dock följa dessa utlösare med åtgärden Hämta filinnehåll. Se till att utlösaren returnerar en fil i taget i stället för en lista genom att aktivera utlösarens alternativ "Dela på". Mer information om det här alternativet i Azure Logic Apps finns i Utlösa flera körningar.

  • FTP-utlösare fungerar endast på den angivna mappen, inte undermappar. Om du också vill kontrollera en mapps undermappar konfigurerar du ett separat flöde för varje undermapp.

  • Som standard kan FTP-hanterade anslutningsappar läsa eller skriva filer som är 50 MB eller mindre. Om du vill hantera filer som är större än 50 MB kan du använda åtgärden för ftp-hanterad anslutningsapp med namnet Hämta filinnehåll, som implicit använder meddelandesegmentering. Andra FTP-hanterade anslutningsåtgärder stöder också aktivering av meddelandesegmentering.

  • FTP-utlösare kan få fördröjningar eller ofullständiga resultat när du returnerar nyligen skapade, tillagda eller uppdaterade filer.

    När en FTP-utlösare söker efter en nyligen tillagd eller ändrad fil bekräftar utlösaren också att filen är klar. En fil kan till exempel ha ändringar som pågår när utlösaren kontrollerar FTP-servern. För att undvika att returnera en ofullständig fil noterar utlösaren filens tidsstämpel, men returnerar inte filen omedelbart. I stället returnerar utlösaren endast filen när utlösaren kontrollerar servern igen. Ibland kan det här beteendet orsaka en fördröjning som varar upp till två gånger utlösarens avsökningsintervall. På grund av det här beteendet kanske FTP-utlösaren inte returnerar alla filer samtidigt om du inaktiverar ftp-utlösarens delningsinställning.

  • FTP-hanterade anslutningsutlösare kan uppleva saknade, ofullständiga eller fördröjda resultat när tidsstämpeln "senast ändrad" bevaras.

    • Resultat saknas

      FTP-utlösare fungerar genom avsökning eller kontroll av FTP-filsystemet och letar efter filer som har ändrats sedan den senaste avsökningen. Ftp-hanterade anslutningsutlösare jämför filversioner med hjälp av filens senaste ändrade tidsstämpel.

      Om du skapar, lägger till eller uppdaterar en fil med en tidsstämpel som är tidigare än den senast spårade senast ändrade tidsstämpeln identifierar inte utlösaren för FTP-hanterad anslutningsapp den här filen. Å andra sidan har den inbyggda FTP-anslutningsutlösaren i Standard Logic App-arbetsflöden inte den här begränsningen.

      Om du använder ett externt verktyg eller en klient som skapar, lägger till eller uppdaterar filer på FTP-servern ska du därför inaktivera alla funktioner i verktyget eller klienten som bevarar en fils senast ändrade tidsstämpel.

      I följande tabell visas några vanliga verktyg som bevarar den här tidsstämpeln och stegen för att inaktivera den här funktionen:

      FTP-klient Åtgärd
      WinSCP Gå till AlternativInställningar>>Överför Redigera>>Bevara tidsstämpel>Inaktivera.
      FileZilla Gå till Överför>Bevara tidsstämplar för överförda filer>Inaktivera.

    • Ofullständiga eller fördröjda resultat

      När en FTP-utlösare söker efter en nyligen skapad, tillagd eller uppdaterad fil kontrollerar utlösaren även om filen är klar. En fil kan till exempel ha ändringar som pågår när utlösaren kontrollerar FTP-servern. För att undvika att returnera en ofullständig fil noterar utlösaren filens tidsstämpel, men returnerar inte filen omedelbart. I stället returnerar utlösaren endast filen när utlösaren kontrollerar servern igen.

      Ibland kan det här beteendet orsaka en fördröjning som varar så länge som nästan dubbelt så mycket som utlösarens avsökningsintervall. På grund av det här beteendet kanske FTP-utlösaren inte returnerar alla filer samtidigt om du inaktiverar FTP-utlösarens delningsinställning.

Kravspecifikation

  • FTP-anslutningsappen kräver din FTP-värdserveradress och dina kontoautentiseringsuppgifter.

  • FTP-anslutningsappen kräver åtkomst till FTP-servern från eller via Internet. Mer information om hur du tillåter trafik till FTP-servern med specifika IP-intervall finns i IP-adresser för hanterad anslutningsapp.

  • FTP-anslutningsappen kräver att FTP-servern använder eller accepterar i passivt läge.

  • FTP-anslutningsappen kräver att FTP-servern aktiverar följande kommandon och stöder mappar som innehåller blanksteg så att kommandona kan fungera korrekt. För kommandot LIST kontrollerar du att kommandot returnerar komponenten year för filtidsstämplar som är äldre än 6 månader.

    • APPE
    • DELE
    • LISTA
    • MDTM
    • RENAME
    • RETR
    • STORLEK
    • STOR

  • För säker FTP måste du konfigurera explicita FTPS (File Transfer Protocol Secure) i stället för implicit FTPS. Vissa FTP-servrar, till exempel ProFTPd, kräver också att du aktiverar NoSessionReuseRequired alternativet om du använder TLS-läge (Transport Layer Security), efterföljare till SSL (Secure Socket Layer).

    FTP-anslutningsappen fungerar inte med implicit FTPS och stöder endast explicit FTP via FTPS, vilket är ett tillägg för TLS.

FTP-anslutningar

  • För att förbättra prestanda för både FTP-anslutningsappen och FTP-servern kan du hålla FTP-anslutningen öppen och aktiv när anslutningsappen har slutfört en begäran.

    När du skapar en anslutning till en FTP-server har rutan anslutningsprofil som visas en inställning med namnet Stäng anslutningen efter att begäran har slutförts. Den här inställningen anger om FTP-serveranslutningen ska stängas varje gång en begäran har slutförts. Om du har den här inställningen inaktiverad stängs inte anslutningen när en begäran har slutförts och förblir aktiv för framtida användning.

  • Om dina arbetsflödesinstanser körs parallellt kan det uppstå tillfälliga anslutningsfel. Vissa åtgärder i arbetsflödet kan med två skäl stänga anslutningen även om andra åtgärder i arbetsflödet fortfarande använder den anslutningen.

    Prova följande rekommendationer för att undvika det här scenariot:

    • När du skapar anslutningen aktiverar du inställningen Stäng anslutning efter slutförande av begäran .

    • Inaktivera eventuell parallellisering eller samtidighet som är aktiverad för utlösare eller åtgärder. Mer information om den här lösningen i Azure Logic Apps finns i följande dokumentation:

    • Undvik att köra flera parallella flöden.

Använd åtgärden "Skapa fil" med och utan segmentering

För åtgärden Skapa fil beror beteendet på åtgärdens inställning Tillåt segmentering och storleken på filen som ska skapas:

  • Tillåt segmentering aktiverat:

    • Filstorleken är lika med eller mindre än 50 MB: Åtgärden laddar upp filen med en enda begäran, använder det ursprungliga filnamnet och låser filen under uppladdningen.

    • Filstorleken är större än 50 MB: Åtgärden skapar filen med namnformatet filnamn.new-GUID.ms.partial och laddar upp filen med flera begäranden eller segmentering av meddelanden. När åtgärden har laddat upp det sista segmentet byter åtgärden namn på filen med det ursprungliga filnamnet.

  • Tillåt segmentering inaktiverad: Åtgärden laddar upp filen med en enda begäran, använder det ursprungliga filnamnet och låser filen under uppladdningen.

Guide för anslutningsprogram

Information om hur du använder den FTP-hanterade anslutningsappen och den inbyggda anslutningsappen i Azure Logic Apps finns i Ansluta till FTP-servrar från arbetsflöden i Azure Logic Apps.

Allmänna gränser

Namn Värde
Maximalt antal mappar i ett enda arkiv. Den här gränsen gäller endast när "Skapa mappar?" är inställt på "Ja". 16
Maximalt antal megabyte som överförs till/från anslutningsappen inom ett bandbreddsintervall (per anslutning) 1 000
Bandbreddstidsintervall (i miliseconds) 60000

Skapa en anslutning

Anslutningsappen stöder följande autentiseringstyper:
Standardinställning Parametrar för att skapa anslutning. Alla regioner Går inte att dela

Standard

Tillämpligt: Alla regioner

Parametrar för att skapa anslutning.

Det här är inte delningsbar anslutning. Om power-appen delas med en annan användare uppmanas en annan användare att skapa en ny anslutning explicit.

Namn Typ Description Krävs
Serveradress snöre Serveradress Sann
Användarnamn snöre Användarnamn Sann
Lösenord securestring Lösenord Sann
FTP-serverport int FTP-portnummer (exempel: 21)
Vill du aktivera SSL? bool Vill du aktivera SSL? (Sant/falskt)
Binär transport? bool Vill du aktivera binär transport? (Sant/falskt)
Inaktivera certifikatverifiering? bool Inaktivera certifikatverifiering? (Sant/falskt)
Stäng anslutningen efter att begäran har slutförts bool Vill du stänga FTP-anslutningen varje gång när begäran har slutförts? (Sant/falskt)

Begränsningsgränser

Name Anrop Förnyelseperiod
API-anrop per anslutning 900 60 sekunder

Åtgärder

Extrahera arkiv till mapp

Den här åtgärden extraherar en arkivfil till en mapp (exempel: .zip).
Hämta filinnehåll

Den här åtgärden hämtar innehållet i en fil.
Hämta filinnehåll med hjälp av sökvägen

Den här åtgärden hämtar innehållet i en fil med hjälp av filsökvägen.
Hämta filmetadata med hjälp av sökvägen

Den här åtgärden hämtar metadata för en fil med hjälp av filsökvägen.
Hämta metadata för filen

Den här åtgärden hämtar metadata för en fil.
Kopiera fil

Den här åtgärden kopierar en fil till en FTP-server. Om en fil tas bort/byt namn på servern direkt efter att den har kopierats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen skapade filen.
Skapa fil

Den här åtgärden skapar en fil. Om en fil tas bort/byt namn på servern direkt efter att den har skapats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen skapade filen.
Ta bort fil

Den här åtgärden tar bort en fil.
Uppdatera fil

Den här åtgärden uppdaterar en fil. Om en fil tas bort/byt namn på servern direkt efter att den har uppdaterats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen uppdaterade filen.
Visa en lista över filer i mappen

Den här åtgärden hämtar listan över filer och undermappar i en mapp.
Visa en lista över filer i rotmappen

Den här åtgärden hämtar listan över filer och undermappar i rotmappen.

Extrahera arkiv till mapp

Åtgärds-ID:
ExtractFolderV2

Den här åtgärden extraherar en arkivfil till en mapp (exempel: .zip).

Parametrar

Name Nyckel Obligatorisk Typ Description
Sökväg till källarkivfil
 source True string

Sökväg till arkivfilen
Sökväg till målmapp
 destination True string

Sökväg till målmappen
Skriver du över?
 overwrite boolean

Skriver över målfilerna om de är inställda på "true"
Vill du skapa mappar?
 createFolders boolean

Extraherar mappar från arkivet om det är inställt på "sant"

Returer

response
array of BlobMetadata

Hämta filinnehåll

Åtgärds-ID:
GetFileContent

Den här åtgärden hämtar innehållet i en fil.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Välj en fil
Härled innehållstyp
 inferContentType boolean

Härled innehållstyp baserat på tillägg

Returer

Innehållet i filen.

Filinnehåll
binary

Hämta filinnehåll med hjälp av sökvägen

Åtgärds-ID:
GetFileContentByPath

Den här åtgärden hämtar innehållet i en fil med hjälp av filsökvägen.

Parametrar

Name Nyckel Obligatorisk Typ Description
Filväg
 path True string

Välj en fil
Härled innehållstyp
 inferContentType boolean

Härled innehållstyp baserat på tillägg

Returer

Innehållet i filen.

Filinnehåll
binary

Hämta filmetadata med hjälp av sökvägen

Åtgärds-ID:
GetFileMetadataByPath

Den här åtgärden hämtar metadata för en fil med hjälp av filsökvägen.

Parametrar

Name Nyckel Obligatorisk Typ Description
Filväg
 path True string

Välj en fil

Returer

Blob-metadata

Body
BlobMetadata

Hämta metadata för filen

Åtgärds-ID:
GetFileMetadata

Den här åtgärden hämtar metadata för en fil.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Välj en fil

Returer

Blob-metadata

Body
BlobMetadata

Kopiera fil

Åtgärds-ID:
CopyFile

Den här åtgärden kopierar en fil till en FTP-server. Om en fil tas bort/byt namn på servern direkt efter att den har kopierats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen skapade filen.

Parametrar

Name Nyckel Obligatorisk Typ Description
Käll-URL
 source True string

Url till källfil
Målfilsökväg
 destination True string

Målfilsökväg, inklusive målfilnamn
Skriver du över?
 overwrite boolean

Skriver över målfilen om den är inställd på "true"

Returer

Blob-metadata

Body
BlobMetadata

Skapa fil

Åtgärds-ID:
CreateFile

Den här åtgärden skapar en fil. Om en fil tas bort/byt namn på servern direkt efter att den har skapats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen skapade filen.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mappsökväg
 folderPath True string

Välj en mapp
Filnamn
 name True string

Filens namn
Filinnehåll
 body True binary

Innehållet i filen
Hämta alla filmetadata
 ReadFileMetadataFromServer boolean

Hämta alla filmetadata från SFTP-servern när filen har skapats. Om detta är falskt kanske vissa metadataegenskaper inte returneras, till exempel senast ändrad tid osv.

Returer

Blob-metadata

Body
BlobMetadata

Ta bort fil

Åtgärds-ID:
DeleteFile

Den här åtgärden tar bort en fil.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Välj en fil

Uppdatera fil

Åtgärds-ID:
UpdateFile

Den här åtgärden uppdaterar en fil. Om en fil tas bort/byt namn på servern direkt efter att den har uppdaterats kan anslutningsappen returnera HTTP 404-fel enligt designen. Använd en fördröjning i 1 minut innan du tar bort eller byter namn på den nyligen uppdaterade filen.

Parametrar

Name Nyckel Obligatorisk Typ Description
File
 id True string

Välj en fil
Filinnehåll
 body True binary

Innehållet i filen

Returer

Blob-metadata

Body
BlobMetadata

Visa en lista över filer i mappen

Åtgärds-ID:
ListFolder

Den här åtgärden hämtar listan över filer och undermappar i en mapp.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 id True string

Välj en mapp

Returer

response
array of BlobMetadata

Visa en lista över filer i rotmappen

Åtgärds-ID:
ListRootFolder

Den här åtgärden hämtar listan över filer och undermappar i rotmappen.

Returer

response
array of BlobMetadata

Utlösare

När en fil läggs till eller ändras (endast egenskaper)

Den här åtgärden utlöser ett flöde när en eller flera filer läggs till eller ändras i en mapp. Den här utlösaren hämtar endast filmetadata. Om du vill hämta filinnehållet kan du använda åtgärden Hämta filinnehåll. Utlösaren förlitar sig på den senaste ändrade tiden för en fil. Om en fil skapas av en klient från tredje part bör bevarandet av den senaste ändrade tiden inaktiveras i klienten. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.
När en fil läggs till eller ändras [INAKTUELL]

Den här åtgärden utlöser ett flöde när en fil läggs till eller ändras i en mapp. Utlösaren hämtar både filmetadata och innehållet i filen. Utlösaren förlitar sig på den senaste ändrade tiden för en fil. Om en fil skapas av en klient från tredje part bör bevarandet av den senaste ändrade tiden inaktiveras i klienten. Filer som är större än 50 megabyte hoppas över av utlösaren. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

När en fil läggs till eller ändras (endast egenskaper)

Åtgärds-ID:
OnUpdatedFiles

Den här åtgärden utlöser ett flöde när en eller flera filer läggs till eller ändras i en mapp. Den här utlösaren hämtar endast filmetadata. Om du vill hämta filinnehållet kan du använda åtgärden Hämta filinnehåll. Utlösaren förlitar sig på den senaste ändrade tiden för en fil. Om en fil skapas av en klient från tredje part bör bevarandet av den senaste ändrade tiden inaktiveras i klienten. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderId True string

Välj en mapp
Antal filer som ska returneras
 maxFileCount integer

Maximalt antal filer som ska returneras av en utlösarkörning (1–100). Observera att inställningen "Dela på" kan tvinga utlösaren att bearbeta varje objekt individuellt.

Returer

Blob-metadata

Lista över filer
BlobMetadata

När en fil läggs till eller ändras [INAKTUELL]

Åtgärds-ID:
OnUpdatedFile

Den här åtgärden utlöser ett flöde när en fil läggs till eller ändras i en mapp. Utlösaren hämtar både filmetadata och innehållet i filen. Utlösaren förlitar sig på den senaste ändrade tiden för en fil. Om en fil skapas av en klient från tredje part bör bevarandet av den senaste ändrade tiden inaktiveras i klienten. Filer som är större än 50 megabyte hoppas över av utlösaren. Utlösaren utlöses inte om en fil läggs till/uppdateras i en undermapp. Om det krävs för att utlösa på undermappar bör flera utlösare skapas.

Parametrar

Name Nyckel Obligatorisk Typ Description
Mapp
 folderId True string

Välj en mapp
Inkludera filinnehåll
 includeFileContent boolean

Om värdet är true hämtas även filinnehållet tillsammans med utlösarsvaret
Härled innehållstyp
 inferContentType boolean

Härled innehållstyp baserat på tillägg

Returer

Innehållet i filen.

Filinnehåll
binary

Definitioner

BlobMetadata

Blob-metadata

Name Sökväg Typ Description
Id
 Id string

Det unika ID:t för filen eller mappen.
Namn
 Name string

Namnet på filen eller mappen.
visningsnamn
 DisplayName string

Visningsnamnet för filen eller mappen.
Väg
 Path string

Sökvägen till filen eller mappen.
Senast ändrad
 LastModified date-time

Datum och tid då filen eller mappen senast ändrades.
Storlek
 Size integer

Storleken på filen eller mappen.
Mediatyp
 MediaType string

Medietypen för filen eller mappen.
IsFolder
 IsFolder boolean

Ett booleskt värde (sant, falskt) som anger om bloben är en mapp eller inte.
ETag (ETag)
 ETag string

Etag för filen eller mappen.
FileLocator
 FileLocator string

Fillokaliseraren för filen eller mappen.

binär

Det här är den grundläggande datatypen "binär".