FTP

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung	Class	Regions
Copilot Studio	Norm	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC High)      - US Department of Defense (DoD)
Logik-Apps	Norm	Alle Logik-Apps-Regionen
Power Apps	Norm	Alle Power Apps-Regionen mit Ausnahme der folgenden:      - US Government (GCC High)      - US Department of Defense (DoD)
Power Automate	Norm	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC High)      - US Department of Defense (DoD)

Connectormetadaten
Herausgeber	Microsoft

Bekannte Probleme und Einschränkungen

• In diesem Artikel werden die Vorgänge nur für den FTP-verwalteten Connector beschrieben, der für Azure Logic Apps, Power Automate und Power Apps verfügbar ist. Der integrierte FTP-Connector ist nur für Standardlogik-App-Workflows in Azure Logic Apps verfügbar. Weitere Informationen zum integrierten FTP-Connector in Azure Logic Apps erhalten Sie unter "Verbinden mit FTP-Servern von Workflows in Azure Logic Apps".

• FTP-Trigger geben jetzt nur Metadaten oder Eigenschaften zurück, nicht Dateiinhalte. Sie können diesen Triggern jedoch mit der Aktion namens "Dateiinhalt abrufen" folgen. Um sicherzustellen, dass ein Trigger jeweils eine Datei und nicht eine Liste zurückgibt, stellen Sie sicher, dass die Option "Split On" des Triggers aktiviert wird. Weitere Informationen zu dieser Option in Azure Logic Apps erhalten Sie unter "Trigger multiple runs".

• FTP-Trigger funktionieren nur für den angegebenen Ordner, nicht für Unterordner. Um auch die Unterordner eines Ordners zu überprüfen, richten Sie einen separaten Fluss für jeden Unterordner ein.

• Standardmäßig können von FTP verwaltete Connectoraktionen Dateien lesen oder schreiben, die 50 MB oder kleiner sind. Um Dateien zu verarbeiten, die größer als 50 MB sind, können Sie die Aktion für den FTP-verwalteten Connector mit dem Namen "Dateiinhalt abrufen" verwenden, der implizit Nachrichtenblöcke verwendet. Andere VOM FTP verwaltete Connectoraktionen unterstützen auch das Aktivieren von Nachrichtenblöcken.

• FTP-Trigger können Verzögerungen oder unvollständige Ergebnisse auftreten, wenn neu erstellte, hinzugefügte oder aktualisierte Dateien zurückgegeben werden.

  Wenn ein FTP-Trigger nach einer neu hinzugefügten oder geänderten Datei sucht, bestätigt der Trigger auch, dass die Datei abgeschlossen ist. Beispielsweise kann eine Datei Änderungen in Bearbeitung haben, wenn der Trigger den FTP-Server überprüft. Um zu vermeiden, dass eine unvollständige Datei zurückgegeben wird, notiert der Trigger den Zeitstempel der Datei, gibt die Datei jedoch nicht sofort zurück. Stattdessen gibt der Trigger die Datei nur zurück, wenn der Trigger den Server erneut überprüft. Manchmal kann dieses Verhalten zu einer Verzögerung führen, die bis zu doppelt so lange dauert wie das Abrufintervall des Triggers. Aufgrund dieses Verhaltens gibt der FTP-Trigger möglicherweise nicht alle Dateien gleichzeitig zurück, wenn Sie die Einstellung " Split On " des FTP-Triggers deaktivieren.

• Ftp managed connector triggers might experience missing, unvollständig, or delayed results when the "last modified" timestamp is preserved.

  • Fehlende Ergebnisse

    FTP triggers work by polling, or checking, the FTP file system and looking for any files that changed since the last poll. Der ftp managed connector triggers compare file versions using the last modified timestamp.

    Wenn Sie eine Datei mit einem Zeitstempel erstellen, hinzufügen oder aktualisieren, der vor dem aktuell nachverfolgten Zeitstempel der letzten Änderung liegt, erkennt der FTP-verwaltete Connectortrigger diese Datei nicht. Andererseits besitzt der in Logik-App-Standardworkflows integrierte FTP-Connectortrigger diese Einschränkung nicht.

    Wenn Sie also ein externes Tool oder Client verwenden, das Dateien auf dem FTP-Server erstellt, hinzufügt oder aktualisiert, stellen Sie sicher, dass Sie alle Features im Tool oder Client deaktivieren, die den Zeitstempel der letzten Änderung einer Datei beibehalten.

    In der folgenden Tabelle sind einige häufig verwendete Tools aufgeführt, die diesen Zeitstempel beibehalten, und die Schritte zum Deaktivieren dieses Features:

    FTP-Client	Maßnahme
    WinSCP	Wechseln Sie zu "Optionen>einstellungen">"Transfer Edit>>Preserve timestamp>Disable".
    FileZilla	Wechseln Sie zu "Transfer>Preserve"-Zeitstempel der übertragenen Dateien>deaktivieren.

  • Unvollständige oder verzögerte Ergebnisse

    Wenn ein FTP-Trigger nach einer neu erstellten, hinzugefügten oder aktualisierten Datei sucht, überprüft der Trigger auch, ob die Datei abgeschlossen ist. Beispielsweise kann eine Datei Änderungen in Bearbeitung haben, wenn der Trigger den FTP-Server überprüft. Um zu vermeiden, dass eine unvollständige Datei zurückgegeben wird, notiert der Trigger den Zeitstempel der Datei, gibt die Datei jedoch nicht sofort zurück. Stattdessen gibt der Trigger die Datei nur zurück, wenn der Trigger den Server erneut überprüft.

    Manchmal kann dieses Verhalten zu einer Verzögerung führen, die fast doppelt so lange dauert wie das Abrufintervall des Triggers. Aufgrund dieses Verhaltens gibt der FTP-Trigger möglicherweise nicht alle Dateien gleichzeitig zurück, wenn Sie die Einstellung "Split On " des FTP-Triggers deaktivieren.

Anforderungen

• Der FTP-Connector erfordert Ihre FTP-Hostserveradresse und Kontoanmeldeinformationen.

• Der FTP-Connector erfordert Zugriff auf den FTP-Server von oder über das Internet. Weitere Informationen zum Zulassen des Datenverkehrs zu Ihrem FTP-Server mithilfe bestimmter IP-Bereiche erhalten Sie unter "Verwaltete Connector-IP-Adressen".

• Der FTP-Connector erfordert, dass der FTP-Server im passiven Modus betrieben oder akzeptiert wird.

• Der FTP-Connector erfordert, dass der FTP-Server die folgenden Befehle aktiviert und Ordner unterstützt, die Leerzeichen enthalten, damit die Befehle ordnungsgemäß funktionieren können. Stellen Sie für den Befehl LIST sicher, dass der Befehl die year Komponente für Dateizeitstempel zurückgibt, die älter als 6 Monate sind.

  • APPE
  • DELE
  • LISTE
  • MDTM
  • UMBENENNEN
  • RETR
  • GRÖßE
  • STOR

• Stellen Sie für sicheres FTP sicher, dass Sie anstelle impliziter FTPS explizites File Transfer Protocol Secure (FTPS) einrichten. Außerdem müssen einige FTP-Server, z. B. ProFTPd, die NoSessionReuseRequired Option aktivieren, wenn Sie den TLS-Modus (Transport Layer Security) verwenden, der Nachfolger von Secure Socket Layer (SSL).

  Der FTP-Connector funktioniert nicht mit impliziten FTPS und unterstützt nur explizites FTP über FTPS, das eine Erweiterung von TLS ist.

FTP-Verbindungen

• Um die Leistung sowohl für den FTP-Connector als auch für den FTP-Server zu verbessern, können Sie die FTP-Verbindung geöffnet und aktiv halten, nachdem der Connector eine Anforderung abgeschlossen hat.

  Wenn Sie eine Verbindung mit einem FTP-Server erstellen, enthält das angezeigte Verbindungsprofilfeld eine Einstellung namens "Verbindung schließen", nachdem der Anforderungsabschluss abgeschlossen wurde. Diese Einstellung gibt an, ob die FTP-Serververbindung jedes Mal geschlossen werden soll, nachdem eine Anforderung abgeschlossen wurde. Wenn Sie diese Einstellung deaktiviert lassen, wird die Verbindung nach Abschluss einer Anforderung nicht geschlossen und bleibt für die zukünftige Verwendung aktiv.

• Wenn Ihre Workflowinstanzen parallel ausgeführt werden, treten möglicherweise zeitweilige Konnektivitätsfehler auf. Einige Vorgänge in Ihrem Workflow schließen die Verbindung möglicherweise sogar dann, wenn andere Vorgänge im Workflow diese Verbindung noch verwenden.

  Um dieses Szenario zu vermeiden, probieren Sie die folgenden Empfehlungen aus:

  • Wenn Sie die Verbindung erstellen, aktivieren Sie die Einstellung zum Schließen der Verbindung nach Abschluss der Anforderung .

  • Deaktivieren Sie alle Parallelisierungen oder Parallelität, die für Trigger oder Aktionen aktiviert ist. Weitere Informationen zu dieser Lösung in Azure Logic Apps können Sie in der folgenden Dokumentation lesen:

    • Änderungstrigger-Parallelität
    • Chanage "For each" action concurrency

  • Vermeiden Sie das Ausführen mehrerer paralleler Flüsse.

Verwenden der Aktion "Datei erstellen" mit und ohne Blockierung

Für die Aktion " Datei erstellen " hängt das Verhalten von der Einstellung " Blockierung zulassen " und der Größe der zu erstellenden Datei ab:

• Blockierung zulassen:

  • Die Dateigröße ist gleich oder kleiner als 50 MB: Die Aktion lädt die Datei mit einer einzigen Anforderung hoch, verwendet den ursprünglichen Dateinamen und sperrt die Datei während des Uploads.

  • Die Dateigröße ist größer als 50 MB: Die Aktion erstellt die Datei mit dem Namensformat, dem Dateinamen.new-GUID.ms.partial, and uploads the file using multiple requests, or message chunking. Nachdem die Aktion den letzten Block hochgeladen hat, benennt die Aktion die Datei mit dem ursprünglichen Dateinamen um.

• Blockierung deaktivieren: Die Aktion lädt die Datei mit einer einzigen Anforderung hoch, verwendet den ursprünglichen Dateinamen und sperrt die Datei während des Uploads.

Anleitung zum Konnektor

Informationen zur Verwendung des FTP-verwalteten Connectors und des integrierten Connectors in Azure Logic Apps erhalten Sie unter "Herstellen einer Verbindung mit FTP-Servern von Workflows in Azure Logic Apps".

Allgemeine Grenzwerte

Name	Wert
Maximale Anzahl von Ordnern in einem einzelnen Archiv. Dieser Grenzwert gilt nur, wenn "Ordner erstellen?". ist auf 'Ja' festgelegt.	16
Maximale Anzahl von Megabytes, die innerhalb eines Bandbreitenzeitintervalls (pro Verbindung) an/vom Connector übertragen werden	1.000
Bandbreitenzeitintervall (in Milisekunden)	60000

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe	Parameter zum Erstellen einer Verbindung.	Alle Regionen	Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
Serveradresse	Schnur	Serveradresse	Richtig
Benutzername	Schnur	Benutzername	Richtig
Kennwort	securestring	Kennwort	Richtig
FTP-Serverport	INT	FTP-Portnummer (Beispiel: 21)
SSL aktivieren?	Boolesch	SSL aktivieren? (True/False)
Binärer Transport?	Boolesch	Binärtransport aktivieren? (True/False)
Zertifikatüberprüfung deaktivieren?	Boolesch	Zertifikatüberprüfung deaktivieren? (True/False)
Verbindung nach Abschluss der Anforderung schließen	Boolesch	Ftp-Verbindung jedes Mal schließen, nachdem die Anforderung abgeschlossen wurde? (True/False)

Drosselungsgrenzwerte

Name	Aufrufe	Verlängerungszeitraum
API-Aufrufe pro Verbindung	900	60 Sekunden

Aktionen

Abrufen von Dateiinhalten mithilfe des Pfads	Dieser Vorgang ruft den Inhalt einer Datei mithilfe des Dateipfads ab.
Abrufen von Dateimetadaten mithilfe des Pfads	Dieser Vorgang ruft die Metadaten einer Datei mithilfe des Dateipfads ab.
Archiv in Ordner extrahieren	Mit diesem Vorgang wird eine Archivdatei in einen Ordner extrahiert (Beispiel: .zip).
Auflisten von Dateien im Ordner	Dieser Vorgang ruft die Liste der Dateien und Unterordner in einem Ordner ab.
Auflisten von Dateien im Stammordner	Dieser Vorgang ruft die Liste der Dateien und Unterordner im Stammordner ab.
Datei aktualisieren	Dieser Vorgang aktualisiert eine Datei. Wenn eine Datei direkt nach der Aktualisierung auf dem Server gelöscht/umbenannt wird, gibt connector möglicherweise DEN HTTP 404-Fehler durch den Entwurf zurück. Verwenden Sie eine Verzögerung von 1 Minute, bevor Sie die kürzlich aktualisierte Datei löschen oder umbenennen.
Datei erstellen	Dieser Vorgang erstellt eine Datei. Wenn eine Datei direkt nach der Erstellung auf dem Server gelöscht/umbenannt wird, gibt Connector möglicherweise DEN HTTP 404-Fehler durch den Entwurf zurück. Verwenden Sie eine Verzögerung von 1 Minute, bevor Sie die neu erstellte Datei löschen oder umbenennen.
Datei kopieren	Dieser Vorgang kopiert eine Datei auf einen FTP-Server. Wenn eine Datei direkt nach dem Kopieren auf dem Server gelöscht/umbenannt wird, kann der Connector den HTTP 404-Fehler durch den Entwurf zurückgeben. Verwenden Sie eine Verzögerung von 1 Minute, bevor Sie die neu erstellte Datei löschen oder umbenennen.
Datei löschen	Dieser Vorgang löscht eine Datei.
Dateiinhalte abrufen	Dieser Vorgang ruft den Inhalt einer Datei ab.
Dateimetadaten abrufen	Dieser Vorgang ruft die Metadaten für eine Datei ab.

Abrufen von Dateiinhalten mithilfe des Pfads

Abrufen von Dateimetadaten mithilfe des Pfads

Archiv in Ordner extrahieren

Auflisten von Dateien im Ordner

Auflisten von Dateien im Stammordner

Datei aktualisieren

Datei erstellen

Datei kopieren

Datei löschen

Dateiinhalte abrufen

Dateimetadaten abrufen

Auslöser

Wenn eine Datei hinzugefügt oder geändert wird (nur Eigenschaften)

Dieser Vorgang löst einen Fluss aus, wenn eine oder mehrere Dateien in einem Ordner hinzugefügt oder geändert werden. Dieser Trigger ruft nur die Dateimetadaten ab. Um den Dateiinhalt abzurufen, können Sie den Vorgang "Dateiinhalt abrufen" verwenden. Der Trigger basiert auf dem Zeitpunkt der letzten Änderung einer Datei. Wenn eine Datei von einem Drittanbieterclient erstellt wird, sollte die Erhaltung der letzten Änderungszeit im Client deaktiviert werden. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Wenn eine Datei hinzugefügt oder geändert wird [VERALTET]

Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner hinzugefügt oder geändert wird. Der Trigger ruft sowohl die Dateimetadaten als auch den Inhalt der Datei ab. Der Trigger basiert auf dem Zeitpunkt der letzten Änderung einer Datei. Wenn eine Datei von einem Drittanbieterclient erstellt wird, sollte die Erhaltung der letzten Änderungszeit im Client deaktiviert werden. Dateien, die größer als 50 MB sind, werden vom Trigger übersprungen. Der Trigger wird nicht ausgelöst, wenn eine Datei in einem Unterordner hinzugefügt/aktualisiert wird. Wenn sie für Unterordner ausgelöst werden muss, sollten mehrere Trigger erstellt werden.

Wenn eine Datei hinzugefügt oder geändert wird (nur Eigenschaften)

Wenn eine Datei hinzugefügt oder geändert wird [VERALTET]

Definitionen

BlobMetadata

binär