Stellen Sie eine Verbindung zu Dateien auf SFTP-Servern über Secure Shell (SSH) aus Workflows in Azure Logic Apps her.

Gilt für: Azure Logic Apps (Verbrauch + Standard)

Wenn Ihr Workflow die automatisierte, sichere Dateiverwaltung auf Servern durchführen muss, die das Secure Shell (SSH) File Transfer Protocol (SFTP) verwenden, verwenden Sie die SFTP-SSH oder SFTP Connectorvorgänge in den Workflows, die Sie mit Azure Logic Apps erstellen.

SFTP ist ein Netzwerkprotokoll, das dateizugriff, Dateiübertragung und Dateiverwaltung über jeden zuverlässigen Datenstrom bereitstellt. Anschließend können Sie Dateien auf Ihrem SFTP-Server überwachen, übertragen und verwalten, ohne benutzerdefinierten Code zu schreiben oder Infrastruktur zu verwalten. Andernfalls kann der Versuch, diese Dateivorgänge manuell zu verwalten, zeitaufwendig, fehleranfällig und schwer skaliert werden.

Ihr Workflow kann z. B. die folgenden Aufgaben ausführen:

• Überwachen und Verarbeiten eingehender Datendateien.
• Erstellen und Verwalten von Ordnern und Dateien
• Sie können Dateiinhalte und Metadaten abrufen. Extrahieren von Archiven.
• Verteilen von Berichten.
• Synchronisieren von Inhalten über verschiedene Umgebungen hinweg.

In diesem Handbuch wird gezeigt, wie Sie über einen Workflow in Azure Logic Apps auf Ihren SFTP-Server zugreifen.

Weitere Informationen findest du unter:

• SSH-Dateiübertragungsprotokoll (SFTP)
• Secure Shell (SSH)

Technische Referenz für den Connector

Der SFTP-SSH-Connector verfügt über unterschiedliche Versionen, basierend auf dem Logik-App-Typ und der Hostumgebung.

Für Consumption- und Standard-Workflows kann der SFTP-SSHmanaged Connector verwendet werden, der die Compute-Leistung mit anderen Ressourcen in Multitenant-Azure teilt. Standardworkflows können auch den runtime-nativen oder integriertenSFTP-Connector verwenden. Beide Connectorversionen verwenden das SSH-Protokoll.

Verschiedene SFTP-Connectorversionen bieten unterschiedliche vordefinierte Vorgänge. Sie können einen leeren Workflow mit einem SFTP-spezifischen Trigger starten oder einen anderen Trigger basierend auf Ihrem Szenario auswählen. Sie können ihren Workflow beispielsweise mit einem SFTP-Trigger starten, der Ereignisse auf Ihrem SFTP-Server überwacht und reagiert. Der Trigger stellt Ausgaben bereit, die mit nachfolgenden Aktionen in Ihrem Workflow verwendet werden. Verschiedene SFTP-Aktionen führen unterschiedliche Aufgaben aus, z. B. Abrufen, Erstellen und Verwalten von Dateien auf Ihrem SFTP-Server.

Voraussetzungen

• Ein Azure-Konto und ein Azure-Abonnement. Erhalten Sie ein kostenloses Azure-Konto.

• Informationen zu Ihrer SFTP-Serververbindung und -Authentifizierung:

  • Serveradresse
  • Kontoanmeldeinformationen
  • Zugriff auf einen privaten SSH-Schlüssel
  • SSH-Kennwort für privaten Schlüssel

  Wichtig

  Wenn Sie Ihre Verbindung erstellen und Ihren privaten SSH-Schlüssel in den Parameter für private SSH-Schlüssel eingeben, müssen Sie die Schritte ausführen, um den vollständigen und richtigen Parameterwert bereitzustellen. Andernfalls führt ein ungültiger Schlüssel dazu, dass die Verbindung fehlschlägt.

  Weitere Informationen finden Sie unter Referenz zum verwalteten SFTP-SSH-Connector – Authentifizierung und Berechtigungen.

• Der Workflow, in dem Sie auf Ihren SFTP-Server zugreifen möchten.

  Um Den Workflow mit einem SFTP-Trigger zu starten, benötigen Sie einen leeren Workflow. Wenn Sie eine SFTP-Aktion verwenden möchten, verwenden Sie jeden Trigger, der für Ihr Szenario am besten geeignet ist. Im Beispiel in dieser Anleitung wird der Wiederholungstrigger verwendet.

Allgemeine Einschränkungen

• Bevor Sie den verwalteten SFTP-SSH-Konnektor verwenden, lesen Sie die Referenz zum verwalteten SFTP-SSH-Konnektor – Bekannte Probleme und Einschränkungen.

• Bevor Sie den integrierten SFTP-Konnektor verwenden, lesen Sie die Referenz zum integrierten SFTP-Konnektor – Bekannte Probleme und Einschränkungen.

Bekannte Probleme

Standardmäßig verfügen Trigger, die Arrays akzeptieren und zurückgeben, in der Regel über eine "Split" -Einstellung, die bereits aktiviert ist. Der Trigger löst ein Array automatisch auf, indem intern eine separate Workflowinstanz erstellt wird, um jedes Arrayelement zu verarbeiten. Alle Workflowinstanzen werden parallel ausgeführt, sodass die Arrayelemente gleichzeitig verarbeitet werden.

Wenn die Einstellung Teilen bei aktiviert ist, geben verwaltete Connectortrigger die Ausgaben für alle Arrayelemente als Listen zurück. Alle nachfolgenden Aktionen, die auf diese Ausgaben verweisen, müssen diese Ausgaben zuerst als Listen behandeln. Um jedes Arrayelement einzeln zu behandeln, können Sie zusätzliche Aktionen hinzufügen. Wenn Sie beispielsweise diese Arrayelemente durchlaufen möchten, können Sie eine For each-Schleife verwenden. Verwenden Sie für Trigger, die nur Metadaten oder Eigenschaften zurückgeben, eine Aktion, die zuerst die Metadaten des Arrayelements abruft, und verwenden Sie dann eine Aktion, um den Inhalt der Elemente abzurufen.

Sie müssen diesen Ansatz nur für verwaltete Connectortrigger anwenden, nicht aber für integrierte Connectortrigger, die Ausgaben jeweils für ein Arrayelement zurückgeben, wenn die Einstellung „Split on“ aktiviert ist.

Angenommen, Sie haben einen verwalteten Connectortrigger namens Beim Hinzufügen oder Ändern einer Datei (nur Eigenschaften), der die Metadaten oder Eigenschaften für die neuen oder aktualisierten Dateien als Arrays zurückgibt. Um die Metadaten für jede Datei separat abzurufen, können Sie eine For each-Schleife verwenden, die das Array durchläuft. Verwenden Sie in dieser Schleife die folgenden verwalteten Connectoraktionen in der angegebenen Reihenfolge:

1. Dateimetadaten abrufen, um die Metadaten der einzelnen Dateien abzurufen.

2. Dateiinhalt abrufen, um den Inhalt der einzelnen Dateien abzurufen.

Segmentierung

Durch das Chunking kann ein Prozess große Dateien verarbeiten, die die Standardgrößenbeschränkungen überschreiten. Weitere Informationen zum verwalteten Connector SFTP-SSH und zur Unterstützung für das Aufteilen in Datenblöcke finden Sie in der SFTP-SSH Connector-Dokumentation – Chunking.

Hinzufügen eines SFTP-Triggers

Führen Sie die entsprechenden Schritte aus, um ihrem leeren Workflow einen SFTP-Trigger hinzuzufügen:

Hinzufügen eines verwalteten SFTP-SSH Triggers (Verbrauch, Standard)

Führen Sie die folgenden Schritte aus, um einen verwalteten oder freigegebenen SFTP-SSH-Connectortrigger hinzuzufügen und einzurichten:

1. Öffnen Sie im Azure-Portal die Logik-App-Ressource. Öffnen Sie im Designer den leeren Workflow.

2. Führen Sie im Designer die allgemeinen Schritte aus, um den gewünschten freigegebenenSFTP-SSH-Trigger hinzuzufügen.

   Beispielsweise startet der SFTP-SSH-Trigger namens "Wenn eine Datei hinzugefügt oder geändert wird" den Workflow, wenn eine Datei auf Ihrem SFTP-Server hinzugefügt oder geändert wird. Sie können eine Bedingungsaktion hinzufügen, die überprüft, ob der Dateiinhalt den angegebenen Kriterien entspricht. Wenn der Inhalt den Kriterien entspricht, verwenden Sie die SFTP-Aktion namens "Dateiinhalt abrufen", und verwenden Sie dann eine weitere Aktion, um den Inhalt in einem anderen SFTP-Ordner zu speichern.

3. Wenn Sie dazu aufgefordert werden, geben Sie die notwendigen Verbindungsinformationen an. Wählen Sie abschließend Neu erstellen aus.

4. Wählen Sie im Designer den Trigger aus, wenn dieser nicht ausgewählt ist. Geben Sie im Bereich "Triggerinformationen" die erforderlichen Details an.

   Weitere Informationen finden Sie unter Referenz zu Triggern für verwaltete SFTP-SSH-Connectors.

5. Speichern Sie Ihren Workflow, wenn Sie fertig sind. Wählen Sie auf der Symbolleiste des Designers Speichern aus.

6. Fahren Sie mit dem Erstellen Ihres Workflows fort, indem Sie Aktionen hinzufügen.

Hinzufügen eines integrierten SFTP-Triggers (nur Standard)

Führen Sie die folgenden Schritte aus, um einen integrierten SFTP-Connectortrigger hinzuzufügen und einzurichten:

1. Öffnen Sie im Azure-Portal die Logik-App-Ressource. Öffnen Sie im Designer den leeren Workflow.

2. Führen Sie im Designer die allgemeinen Schritte aus, um den gewünschten SFTP-Trigger hinzuzufügen.

   Der SFTP-Trigger mit dem Namen "Wenn eine Datei hinzugefügt oder geändert wird " startet beispielsweise den Workflow, wenn eine Datei auf Ihrem SFTP-Server hinzugefügt oder geändert wird. Sie können eine Bedingungsaktion hinzufügen, die überprüft, ob der Dateiinhalt den angegebenen Kriterien entspricht. Wenn der Inhalt den Kriterien entspricht, verwenden Sie die SFTP-Aktion namens "Dateiinhalt abrufen", und verwenden Sie dann eine weitere Aktion, um den Inhalt in einem anderen SFTP-Ordner zu speichern.

3. Wenn Sie dazu aufgefordert werden, geben Sie die notwendigen Verbindungsinformationen an. Wählen Sie abschließend Neu erstellen aus.

4. Wählen Sie im Designer den Trigger aus, wenn dieser nicht ausgewählt ist. Geben Sie im Bereich "Triggerinformationen" die erforderlichen Details an.

   Weitere Informationen finden Sie unter Referenz für den Trigger des integrierten SFTP-Connector.

5. Speichern Sie Ihren Workflow, wenn Sie fertig sind. Wählen Sie auf der Symbolleiste des Designers Speichern aus.

6. Fahren Sie mit dem Erstellen Ihres Workflows fort, indem Sie Aktionen hinzufügen.

Hinzufügen einer SFTP-Aktion

Bevor Sie eine SFTP-Aktion hinzufügen, erfordert Ihr Workflow einen Trigger, der für Ihr Szenario am besten geeignet sein kann.

In diesem Beispiel wird der generische integrierte Recurrence-Trigger verwendet, der den Workflow basierend auf einem angegebenen Zeitplan ausführt. Sie können ein SFTP hinzufügen

Hinzufügen einer verwalteten SFTP-SSH Aktion (Verbrauch, Standard)

Führen Sie die folgenden Schritte aus, um eine verwaltete SFTP-SSH-Connectoraktion hinzuzufügen und einzurichten:

1. Öffnen Sie Ihre Logik-App-Ressource im Azure-Portal. Öffnen Sie im Designer Ihren Workflow.

2. Führen Sie im Designer die allgemeinen Schritte aus, um die gewünschte freigegebene SFTP-SSH Aktion hinzuzufügen.

   Die SFTP-SSH Aktion mit dem Namen "Dateiinhalt mithilfe des Pfads abrufen" ruft z. B. Dateiinhalte von einem SFTP-Server ab, indem der Dateipfad angegeben wird. Sie können den SFTP-SSH Trigger verwenden, um nach neuen oder aktualisierten Dateien zu suchen, und eine Bedingungsaktion, die Kriterien angibt, die der Inhalt erfüllen muss. Wenn der Inhalt den Kriterien entspricht, verwenden Sie die Aktion Dateiinhalt über einen Pfad abrufen und eine nachfolgende Aktion, um den Inhalt in einem anderen SFTP-Ordner zu speichern.

3. Wenn Sie dazu aufgefordert werden, geben Sie die notwendigen Verbindungsinformationen an. Wählen Sie abschließend Neu erstellen aus.

4. Wählen Sie im Designer die Aktion aus, wenn sie nicht ausgewählt ist. Geben Sie im Aktionsinformationsbereich die erforderlichen Details an.

   Weitere Informationen finden Sie unter Referenz zu Aktionen für verwaltete SFTP-SSH-Connectors.

5. Speichern Sie Ihren Workflow, wenn Sie fertig sind. Wählen Sie auf der Symbolleiste des Designers Speichern aus.

Hinzufügen einer integrierten SFTP-Aktion (nur Standard)

Führen Sie die folgenden Schritte aus, um eine integrierte SFTP-Aktion hinzuzufügen und einzurichten:

1. Öffnen Sie Ihre Logik-App-Ressource im Azure-Portal. Öffnen Sie im Designer Ihren Workflow.

2. Führen Sie im Designer die allgemeinen Schritte aus, um die gewünschte integrierte SFTP-SSH Aktion hinzuzufügen.

   Die SFTP-Aktion mit dem Namen "Dateiinhalt abrufen " ruft beispielsweise den Dateiinhalt auf einem SFTP-Server ab. Sie können den SFTP-Trigger verwenden, der nach neuen oder aktualisierten Dateien sucht, und eine Bedingungsaktion, die Kriterien angibt, die der Dateiinhalt erfüllen muss. Wenn der Inhalt die Kriterien erfüllt, verwenden Sie die Aktion "Dateiinhalt abrufen " und eine nachfolgende Aktion, um den Inhalt in einem anderen SFTP-Ordner zu speichern.

3. Wenn Sie dazu aufgefordert werden, geben Sie die notwendigen Verbindungsinformationen an. Wählen Sie abschließend Neu erstellen aus.

4. Wählen Sie im Designer die Aktion aus, wenn sie nicht ausgewählt ist. Geben Sie im Aktionsinformationsbereich die erforderlichen Details an.

   Weitere Informationen finden Sie unter Referenz zu den Aktionen für integrierte SFTP-Connectors.

5. Speichern Sie Ihren Workflow, wenn Sie fertig sind. Wählen Sie auf der Symbolleiste des Designers Speichern aus.

Probleme beheben

Weitere Informationen findest du unter:

• Referenz zum verwalteten SFTP-SSH-Connector – Problembehandlung
• Referenz zum integrierten SFTP-Connector – Problembehandlung

Verwandte Inhalte

• Integrierte Trigger und Aktionen für Azure Logic Apps
• Integrierte Connectors in Azure Logic Apps