Ansluta till filer på SFTP-servrar via Secure Shell (SSH) från arbetsflöden i Azure Logic Apps

Gäller för: Azure Logic Apps (Förbrukning + Standard)

När arbetsflödet behöver utföra automatiserad, säker filhantering på servrar som använder SSH(Secure Shell) File Transfer Protocol (SFTP) använder du SFTP-SSH eller SFTP anslutningsåtgärder i arbetsflödena som du skapar med Azure Logic Apps.

SFTP är ett nätverksprotokoll som ger filåtkomst, filöverföring och filhantering över alla tillförlitliga dataströmmar. Du kan sedan övervaka, överföra och hantera filer på SFTP-servern utan att skriva anpassad kod eller hantera infrastrukturen. Annars kan det vara tidskrävande, felbenäget och svårt att skala om du försöker hantera dessa filåtgärder manuellt.

Arbetsflödet kan till exempel utföra följande uppgifter:

• Övervaka och bearbeta inkommande datafiler.
• Skapa och hantera mappar och filer.
• Hämta filinnehåll och metadata. Extrahera arkiv.
• Distribuera rapporter.
• Synkronisera innehåll mellan miljöer.

Den här guiden visar hur du kommer åt din SFTP-server från ett arbetsflöde i Azure Logic Apps.

Mer information finns i:

• SSH File Transfer Protocol (SFTP)
• Secure Shell (SSH)

Teknisk referens för anslutning

SFTP-SSH-anslutningsappen har olika versioner, baserat på logikapptyp och värdmiljö.

Förbruknings- och standardarbetsflöden kan använda den hanterade anslutaren SFTP-SSHmanaged, som delar beräkningskapacitet med andra resurser i det multitenanta Azure. Standardarbetsflöden kan också använda den runtime-inbyggda eller inbyggda SFTP-kontakten. Båda anslutningsversionerna använder SSH-protokollet.

Olika SFTP-anslutningsversioner erbjuder olika fördefinierade åtgärder. Du kan starta ett tomt arbetsflöde med en SFTP-specifik utlösare eller välja en annan utlösare baserat på ditt scenario. Du kan till exempel starta arbetsflödet med en SFTP-utlösare som övervakar och svarar på händelser på SFTP-servern. Utlösaren ger utdata att använda med efterföljande åtgärder i arbetsflödet. Olika SFTP-åtgärder utför olika uppgifter, till exempel hämta, skapa och hantera filer på SFTP-servern.

Förutsättningar

• Ett Azure-konto och prenumeration. Skaffa ett kostnadsfritt Azure-konto.

• Information om din SFTP-serveranslutning och -autentisering:

  • Serveradress
  • Kontoautentiseringsuppgifter
  • Åtkomst till en privat SSH-nyckel
  • Lösenord för privat SSH-nyckel

  Viktigt!

  När du skapar anslutningen och anger din privata SSH-nyckel i parametern SSH private key (privat SSH-nyckel ) måste du följa stegen för att ange det fullständiga och korrekta parametervärdet. Annars orsakar en ogiltig nyckel att anslutningen misslyckas.

  Mer information finns i Referens för SFTP-SSH-hanterad anslutningsapp – Autentisering och behörigheter.

• Arbetsflödet där du vill komma åt SFTP-servern.

  Om du vill starta arbetsflödet med en SFTP-utlösare behöver du ett tomt arbetsflöde. Om du vill använda en SFTP-åtgärd använder du alla utlösare som fungerar bäst för ditt scenario. Exemplet i den här guiden använder upprepningsutlösaren .

Allmänna begränsningar

• Innan du använder den hanterade SFTP-SSH-anslutningsappen kan du läsa referensen för SFTP-SSH-hanterad anslutningsapp – kända problem och begränsningar.

• Innan du använder den inbyggda SFTP-anslutningsappen kan du läsa SFTP:s inbyggda anslutningsreferens – kända problem och begränsningar.

Kända problem

Som standard har utlösare som accepterar och returnerar matriser vanligtvis en delningsinställning som redan är aktiverad. Utlösaren diskuterar automatiskt en matris genom att internt skapa en separat arbetsflödesinstans för att bearbeta varje matrisobjekt. Alla arbetsflödesinstanser körs parallellt så att matrisobjekten bearbetas samtidigt.

När inställningen Dela på är aktiverad returnerar hanterade anslutningsutlösare utdata för alla objekt i matrisen som listor. Alla efterföljande åtgärder som refererar till dessa utdata måste först hantera dessa utdata som listor. Om du vill hantera varje matrisobjekt individuellt kan du lägga till extra åtgärder. Om du till exempel vill iterera genom dessa matrisobjekt kan du använda en För varje loop. För utlösare som endast returnerar metadata eller egenskaper använder du en åtgärd som hämtar matrisobjektets metadata först och sedan använder en åtgärd för att hämta objektinnehållet.

Du måste endast använda den här metoden för hanterade anslutningsutlösare, inte för inbyggda anslutningsutlösare som returnerar utdata för ett matrisobjekt i taget när inställningen Dela på är aktiverad.

Anta till exempel att du har en utlösare för hanterad anslutning med namnet När en fil läggs till eller ändras (endast egenskaper) som returnerar metadata eller egenskaper för den nya eller uppdaterade filen som arrayer. Om du vill hämta metadata separat för varje fil kan du använda en För varje loop som itererar genom matrisen. I den här loopen använder du följande åtgärder för hanterade anslutningar i den angivna ordningen:

1. Hämta filmetadata för att få metadata för varje fil.

2. Hämta filinnehåll för att hämta innehållet i varje fil.

Indelning i delar

Med segmentering kan en åtgärd hantera stora filer som överskrider standardstorleksgränserna. Mer information om den hanterade SFTP-SSH-kontakten och stöd för segmentering finns i SFTP-SSH hanterad kontaktreferens – Segmentering.

Lägga till en SFTP-utlösare

Följ motsvarande steg för att lägga till en SFTP-utlösare i ditt tomma arbetsflöde:

Lägg till en hanterad SFTP-SSH utlösare (Förbrukning, Standard)

Följ dessa steg för att lägga till och konfigurera en hanterad eller delad SFTP-SSH-anslutningsutlösare :

1. Öppna logikappresursen i Azure-portalen. Öppna det tomma arbetsflödet i designern.

2. I designern följer du de allmänna stegen för att lägga till den deladeSFTP-SSH-utlösaren som du vill använda.

   Till exempel startar den SFTP-SSH utlösaren med namnet När en fil läggs till eller ändras arbetsflödet när en fil på SFTP-servern läggs till eller ändras. Du kan lägga till en villkorsåtgärd som kontrollerar om filinnehållet uppfyller angivna villkor. Om innehållet uppfyller kriterierna använder du SFTP-åtgärden med namnet Hämta filinnehåll och använder sedan en annan åtgärd för att spara innehållet i en annan SFTP-mapp.

3. Ange nödvändig anslutningsinformation om du uppmanas att göra det. När du är klar väljer du Skapa ny.

4. I designern väljer du utlösaren, om den inte är markerad. Ange nödvändig information i utlösarfönstret.

   Mer information finns i dokumentationen för SFTP-SSH-hanterade anslutningsutlöstare.

5. Spara arbetsflödet när du är klar. I verktygsfältet för designern väljer du Spara.

6. Fortsätt att skapa arbetsflödet genom att lägga till åtgärder.

Lägga till en inbyggd SFTP-utlösare (endast standard)

Följ dessa steg för att lägga till och konfigurera en inbyggd SFTP-anslutningsutlösare :

1. Öppna logikappresursen i Azure-portalen. Öppna det tomma arbetsflödet i designern.

2. I designern följer du de allmänna stegen för att lägga till den inbyggdaSFTP-utlösare som du vill använda.

   Till exempel startar SFTP-utlösaren med namnet När en fil läggs till eller ändras arbetsflödet när en fil på SFTP-servern läggs till eller ändras. Du kan lägga till en villkorsåtgärd som kontrollerar om filinnehållet uppfyller angivna villkor. Om innehållet uppfyller kriterierna använder du SFTP-åtgärden med namnet Hämta filinnehåll och använder sedan en annan åtgärd för att spara innehållet i en annan SFTP-mapp.

3. Ange nödvändig anslutningsinformation om du uppmanas att göra det. När du är klar väljer du Skapa ny.

4. I designern väljer du utlösaren, om den inte är markerad. Ange nödvändig information i fönstret utlösarinformation.

   Mer information finns i den inbyggda SFTP-anslutningsutlösarreferensen.

5. Spara arbetsflödet när du är klar. I verktygsfältet för designern väljer du Spara.

6. Fortsätt att skapa arbetsflödet genom att lägga till åtgärder.

Lägga till en SFTP-åtgärd

Innan du lägger till en SFTP-åtgärd kräver arbetsflödet en utlösare, vilket kan vara det som fungerar bäst för ditt scenario.

I det här exemplet används den inbyggda utlösaren Återkommande, som kör ditt arbetsflöde utifrån ett angivet schema. Du kan lägga till en SFTP

Lägg till en hanterad SFTP-SSH åtgärd (Förbrukning, Standard)

Följ dessa steg för att lägga till och konfigurera en hanterad SFTP-SSH-anslutningsåtgärd :

1. Öppna logikappresursen i Azure-portalen. Öppna arbetsflödet i designern.

2. I designern följer du de allmänna stegen för att lägga till den delade SFTP-SSH åtgärd som du vill använda.

   Till exempel hämtar åtgärden SFTP-SSH med namnet Hämta filinnehåll med sökvägen filinnehåll från en SFTP-server genom att ange filsökvägen. Du kan använda utlösaren SFTP-SSH för att söka efter nya eller uppdaterade filer och en villkorsåtgärd som anger villkor som innehållet måste uppfylla. Om innehållet uppfyller kriterierna använder du åtgärden Hämta filinnehåll med sökväg och en efterföljande åtgärd för att spara innehållet i en annan SFTP-mapp.

3. Ange nödvändig anslutningsinformation om du uppmanas att göra det. När du är klar väljer du Skapa ny.

4. I designern väljer du åtgärden, om den inte är markerad. Ange nödvändig information i åtgärdsinformationsfönstret.

   Mer information finns i referensen för SFTP-SSH-hanterade anslutningskopplingar.

5. Spara arbetsflödet när du är klar. I verktygsfältet för designern väljer du Spara.

Lägga till en inbyggd SFTP-åtgärd (endast standard)

Följ dessa steg för att lägga till och konfigurera en inbyggd SFTP-åtgärd :

1. Öppna logikappresursen i Azure-portalen. Öppna arbetsflödet i designern.

2. I designern följer du de allmänna stegen för att lägga till den inbyggda SFTP-SSH åtgärd som du vill använda.

   Till exempel hämtar SFTP-åtgärden med namnet Hämta filinnehåll filinnehållet på en SFTP-server. Du kan använda SFTP-utlösaren som söker efter nya eller uppdaterade filer och en villkorsåtgärd som anger villkor som filinnehållet måste uppfylla. Om innehållet uppfyller kriterierna använder du åtgärden Hämta filinnehåll och en efterföljande åtgärd för att spara innehållet i en annan SFTP-mapp.

3. Ange nödvändig anslutningsinformation om du uppmanas att göra det. När du är klar väljer du Skapa ny.

4. I designern väljer du åtgärden, om den inte är markerad. Ange nödvändig information i åtgärdsinformationsfönstret.

   För mer information, se referensen för inbyggda åtgärder för SFTP-anslutningar.

5. Spara arbetsflödet när du är klar. I verktygsfältet för designern väljer du Spara.

Åtgärda problem

Mer information finns i:

• SFTP-SSH hanterad anslutningsreferens – Felsökning
• Inbyggd SFTP-anslutningsreferens – Felsökning

Relaterat innehåll

• Hanterade anslutningar för Azure Logic Apps
• Inbyggda anslutningar för Azure Logic Apps