Dela via

Ansluta till en SFTP-filserver från arbetsflöden i Azure Logic Apps

  • Artikel

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

Den här instruktionsguiden visar hur du kommer åt SSH File Transfer Protocol-servern (SFTP) från ett arbetsflöde i Azure Logic Apps. SFTP är ett nätverksprotokoll som ger filåtkomst, filöverföring och filhantering över alla tillförlitliga dataströmmar och använder SSH-protokollet (Secure Shell).

I arbetsflöden för förbrukningslogikapp kan du använda den hanterade SFTP-SSH-anslutningsappen, medan du i standardlogikappens arbetsflöden kan använda den inbyggda SFTP-anslutningsappen eller den SFTP-SSH-hanterade anslutningsappen. Du kan använda dessa anslutningsåtgärder för att skapa automatiserade arbetsflöden som körs när de utlöses av händelser i SFTP-servern eller i andra system och köra åtgärder för att hantera filer på SFTP-servern. Både de hanterade och inbyggda anslutningsprogrammen använder SSH-protokollet.

Kommentar

Den SFTP-hanterade anslutningsappen är inaktuell, så den här anslutningsappens åtgärder visas inte längre i arbetsflödesdesignern.

Ditt arbetsflöde kan till exempel börja med en SFTP-utlösare som övervakar och svarar på händelser på SFTP-servern. Utlösaren gör utdata tillgängliga för efterföljande åtgärder i arbetsflödet. Arbetsflödet kan köra SFTP-åtgärder som hämtar, skapar och hanterar filer via ditt SFTP-serverkonto. Följande lista innehåller fler exempeluppgifter:

  • Övervaka när filer läggs till eller ändras.
  • Hämta, skapa, kopiera, byta namn på, uppdatera, lista och ta bort filer.
  • Skapa mappar.
  • Hämta filinnehåll och metadata.
  • Extrahera arkiv till mappar.

Följande steg använder Azure-portalen, men med lämpligt Azure Logic Apps-tillägg kan du också använda följande verktyg för att skapa och redigera arbetsflöden för logikappar:

Teknisk referens för anslutningsprogram

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

Typ av logikapp (plan) Environment Anslutningsversion
Förbrukning Azure Logic Apps för flera klientorganisationer Hanterad anslutningsapp, som visas i designern under etiketten Standard . Mer information finns i följande dokumentation:

- Referens för SFTP-SSH-hanterad anslutningsapp
- Hanterade anslutningsappar i Azure Logic Apps
Förbrukning Integration Service Environment (ISE) Hanterad anslutningsapp, som visas i designern under etiketten Standard , och ISE-versionen, som visas i designern med ISE-etiketten och har andra meddelandegränser än den hanterade anslutningsappen. Mer information finns i följande dokumentation:

- Referens för SFTP-SSH-hanterad anslutningsapp
- ISE-meddelandegränser
- Hanterade anslutningsappar i Azure Logic Apps
Standard Azure Logic Apps för en klientorganisation och App Service Environment v3 (endast Windows-planer) Hanterad anslutningsapp, som visas i anslutningsgalleriet under Runtime>Shared och den inbyggda anslutningsappen, som visas i anslutningsgalleriet under Runtime>In-App och är tjänstleverantörsbaserad. Den inbyggda anslutningsappen kan ansluta direkt till en SFTP-server och få åtkomst till virtuella Azure-nätverk med hjälp av en niska veze utan en lokal datagateway. Mer information finns i följande dokumentation:

- Referens för SFTP-SSH-hanterad anslutningsapp
- Referens för inbyggd SFTP-anslutningsapp

- Hanterade anslutningsappar i Azure Logic Apps
- Inbyggda anslutningsappar i Azure Logic Apps

Allmänna begränsningar

Kända problem

Som standard har utlösare som returnerar en matris inställningen Dela på som redan är aktiverad. Med den här inställningen aktiverad diskuterar utlösaren automatiskt matrisen 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.

Men när inställningen Dela på är aktiverad returnerar utlösare för hanterad anslutningsapp utdata för alla matrisobjekt 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 utlösare för hanterade anslutningsappar, inte 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 anslutningsapp med namnet När en fil läggs till eller ändras (endast egenskaper) som returnerar metadata eller egenskaper för de nya eller uppdaterade filerna som matriser. 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 anslutningsappar i den angivna ordningen:

  1. Hämta filmetadata för att hämta varje fils metadata.

  2. Hämta filinnehållsåtgärden för att hämta varje fils innehåll.

Spaltning

Mer information om hur den hanterade SFTP-SSH-anslutningsappen kan hantera stora filer som överskrider standardstorleksgränserna finns i Referens för SFTP-SSH-hanterad anslutningsapp – Segmentering.

Förutsättningar

  • Ett Azure-konto och prenumeration. Om du heller inte har någon Azure-prenumeration kan du registrera ett kostnadsfritt Azure-konto.

  • Anslutning och autentiseringsinformation för åtkomst till din SFTP-server, till exempel serveradress, kontoautentiseringsuppgifter, åtkomst till en privat SSH-nyckel och lösenordet för den privata SSH-nyckeln. Mer information finns i Referens för SFTP-SSH-hanterad anslutningsapp – Autentisering och behörigheter.

    Viktigt!

    När du skapar anslutningen och anger din privata SSH-nyckel i egenskapen för den privata SSH-nyckeln ska du följa stegen för att ange det fullständiga och korrekta värdet för den här egenskapen. Annars misslyckas anslutningen med en icke-giltig nyckel.

  • Arbetsflödet för logikappen där du vill komma åt ditt SFTP-konto. För att börja med en SFTP-SSH-utlösare måste du börja med ett tomt arbetsflöde. Om du vill använda en SFTP-SSH-åtgärd startar du arbetsflödet med en annan utlösare, till exempel upprepningsutlösaren.

Lägga till en SFTP-utlösare

  1. Öppna logikappen Förbrukning i Azure-portalen med ett tomt arbetsflöde i designern.

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

  3. Ange nödvändig anslutningsinformation om du uppmanas att göra det. Välj Skapa när du är klar.

  4. När informationsrutan för utlösaren visas anger du nödvändig information för den valda utlösaren. Mer information finns i referens för SFTP-SSH-hanterade anslutningsappar.

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

När du sparar arbetsflödet publicerar det här steget automatiskt dina uppdateringar till din distribuerade logikapp, som finns i Azure. Med bara en utlösare kontrollerar arbetsflödet bara FTP-servern baserat på ditt angivna schema. Du måste lägga till en åtgärd som svarar på utlösaren och gör något med utlösarens utdata.

Utlösaren med namnet När en fil läggs till eller ändras startar till exempel ett arbetsflöde när en fil läggs till eller ändras på en SFTP-server. Som en efterföljande åtgärd kan du lägga till ett villkor som kontrollerar om filinnehållet uppfyller dina angivna villkor. Om innehållet uppfyller villkoret använder du åtgärden Hämta filinnehåll för att hämta filinnehållet och använder sedan en annan åtgärd för att placera filinnehållet i en annan mapp på SFTP-servern.

Lägga till en SFTP-åtgärd

Innan du kan använda en SFTP-åtgärd måste arbetsflödet redan börja med en utlösare, vilket kan vara vilken typ du vill. Du kan till exempel använda den inbyggda utlösaren för allmän upprepning för att starta arbetsflödet enligt ett visst schema.

  1. Öppna logikappen Förbrukning i Azure-portalen med arbetsflödet i designern.

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

  3. Ange nödvändig anslutningsinformation om du uppmanas att göra det. Välj Skapa när du är klar.

  4. När åtgärdsinformationsrutan visas anger du nödvändig information för den valda åtgärden. Mer information finns i referensen för SFTP-SSH-hanterade anslutningsappar.

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

Åtgärden Get file content using path (Hämta filinnehåll med sökvägen ) hämtar till exempel innehållet från en fil på en SFTP-server genom att ange filsökvägen. Du kan använda utlösaren från föregående exempel och ett villkor som filinnehållet måste uppfylla. Om villkoret är sant kan en efterföljande åtgärd hämta innehållet.

Felsökning

Mer information finns i följande dokumentation:

Nästa steg