SFTP – SSH
SFTP (SSH File Transfer Protocol) ist ein Netzwerkprotokoll, das Dateizugriff, Dateiübertragung und Dateiverwaltung über jeden zuverlässigen Datenstrom ermöglicht. Es wurde von der Internet Engineering Task Force (IETF) als Erweiterung des Secure Shell-Protokolls (SSH) Version 2.0 entwickelt, um sichere Dateiübertragungsfunktionen bereitzustellen.
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 Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen |
| Power Apps | Norm | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Department of Defense (DoD) |
| Power Automate | Norm | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps-Unterstützung Microsoft Power Automate-Support Microsoft Power Apps-Unterstützung |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
Anleitung zum Konnektor
In diesem Artikel werden die Vorgänge für den SFTP-SSH verwalteten Connector beschrieben, der für Azure Logic Apps, Power Automate und Power Apps verfügbar ist. Der integrierte SFTP-Connector ist nur für Standardlogik-App-Workflows in Azure Logic Apps verfügbar. Weitere Informationen finden Sie unter Herstellen einer Verbindung mit einem SFTP-Server mithilfe von SSH in Azure Logic Apps und SFTP, der integrierten Connectorreferenz für Azure Logic Apps verwendet wird.
Unterschiede vom veralteten SFTP-verwalteten Connector
Im Vergleich zum veralteten verwalteten SFTP-Connector bietet der SFTP-SSH verwaltete Connector die folgenden Schlüsselfunktionen:
Verwendet die SSH.NET-Bibliothek, bei der es sich um eine Open Source Secure Shell (SSH)-Bibliothek handelt, die .NET unterstützt.
Stellt die Aktion "Ordner erstellen" bereit, die einen Ordner auf dem angegebenen Pfad auf dem SFTP-Server erstellt.
Stellt die Aktion " Datei umbenennen" bereit, mit der eine Datei auf dem SFTP-Server umbenannt wird.
Speichert die Verbindung mit dem SFTP-Server für bis zu 1 Stunde zwischen. Diese Funktion verbessert die Leistung und reduziert, wie oft der Connector versucht, eine Verbindung mit dem Server herzustellen. Um die Dauer für dieses Zwischenspeicherungsverhalten festzulegen, bearbeiten Sie die ClientAliveInterval-Eigenschaft in der SSH-Konfiguration auf Ihrem SFTP-Server.
Authentifizierung und Berechtigungen
Wenn Sie eine Verbindung mit Ihrem SFTP-Server erstellen, müssen Sie Ihre SFTP-Serveradresse, Kontoanmeldeinformationen, einen privaten SSH-Schlüssel und das Kennwort für privaten SSH-Schlüssel angeben. Wenn Ihre Plattform das Hochladen großer Dateien mithilfe von Blockierung unterstützt, benötigen Sie auch Lese- und Schreibzugriff für den Stammordner auf Ihrem SFTP-Server.
Der SFTP-SSH Connector unterstützt sowohl die Authentifizierung mit privatem Schlüssel als auch die Kennwortauthentifizierung. Der SFTP-SSH Connector unterstützt jedoch nur die folgenden privaten Schlüsselformate, Schlüsselaustauschalgorithmen, Verschlüsselungsalgorithmen und Fingerabdrucke:
- Private Schlüsselformate: RSA (Rivest Shamir Adleman) und DSA (Digital Signature Algorithm) Schlüssel in OpenSSH- und ssh.com-Formaten. Wenn Sich Ihr privater Schlüssel im PuTTY-Dateiformat (PPK) befindet, konvertieren Sie zuerst den Schlüssel in das OpenSSH-Dateiformat (PEM).
- Schlüsselaustauschalgorithmen:
- curve25519-sha256
- curve25519-sha256@libssh.org
- ecdh-sha2-nistp256
- ecdh-sha2-nistp384
- ecdh-sha2-nistp521
- diffie-hellman-group-exchange-sha256
- diffie-hellman-group-exchange-sha1
- diffie-hellman-group16-sha512
- diffie-hellman-group14-sha256
- diffie-hellman-group14-sha1
- diffie-hellman-group1-sha1
- Verschlüsselungsalgorithmen:
- aes256-ctr
- 3des-cbc
- aes128-cbc
- aes192-cbc
- aes256-cbc
- Blowfish-cbc
- Twofish-cbc
- twofish192-cbc
- twofish128-cbc
- twofish256-cbc
- Bogenfour
- Arcfour128
- Arcfour256
- cast128-cbc
- aes128-ctr
- aes192-ctr
- Hostschlüsselalgorithmen:
- ssh-rsa
- ssh-dss
- ssh-ed25519
- ecdsa-sha2-nistp256
- ecdsa-sha2-nistp384
- ecdsa-sha2-nistp521
- Fingerabdruck: MD5. Weitere Informationen finden Sie unter "Finden des MD5-Fingerabdrucks".
Wenn Sie Ihren privaten SSH-Schlüssel für Ihre Verbindung bereitstellen, geben Sie den Schlüssel nicht manuell ein, oder bearbeiten Sie ihn, was dazu führen kann, dass die Verbindung fehlschlägt. Stellen Sie stattdessen sicher, dass Sie den Schlüssel aus der PRIVATEN SSH-Schlüsseldatei kopieren und diesen Schlüssel in das Verbindungsinformationsfeld einfügen.
Führen Sie die folgenden Schritte aus, um Ihren privaten SSH-Schlüssel ordnungsgemäß zu kopieren und einzufügen.
Öffnen Sie Ihre PRIVATE SSH-Schlüsseldatei in einem beliebigen Text-Editor. Diese Schritte setzen die Verwendung von Editor als Beispiel fort.
Wählen Sie im Editor im Menü "Bearbeiten " die Option "Alle auswählen" aus. (Drücken Sie STRG+A)
Wählen Sie im Menü "Bearbeiten " die Option "Kopieren" aus.
Fügen Sie im Feld SFTP-SSH Verbindungsinformationen den vollständigen kopierten Schlüssel in die SSH-Eigenschaft für private Schlüssel ein, die mehrere Zeilen unterstützt. Geben Sie den Schlüssel nicht manuell ein, oder bearbeiten Sie ihn nicht.
Nachdem Sie die Verbindungsdetails eingegeben haben, wählen Sie "Erstellen" aus.
Konvertieren eines puTTY-basierten Schlüssels in OpenSSH
Das PuTTY-Format und das OpenSSH-Format verwenden unterschiedliche Dateinamenerweiterungen. Das PuTTY-Format verwendet die Dateinamenerweiterung ".ppk" oder "PuTTY Private Key". Das OpenSSH-Format verwendet die Erweiterung ".pem" oder "Privacy Enhanced Mail", Dateinamenerweiterung. Wenn Sich Ihr privater Schlüssel im PuTTY-Format befindet und Sie das OpenSSH-Format verwenden müssen, konvertieren Sie zuerst den Schlüssel in das OpenSSH-Format, indem Sie die folgenden Schritte ausführen:
Unixbasiertes Betriebssystem
Wenn Sie die PuTTY-Tools nicht auf Ihrem System installiert haben, führen Sie dies jetzt aus, z. B.:
sudo apt-get install -y puttyFühren Sie den folgenden Befehl aus, der eine Datei erstellt, die Sie mit dem SFTP-SSH Connector verwenden können:
puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>Zum Beispiel:
puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem
Windows-Betriebssystem
Falls noch nicht geschehen, laden Sie den neuesten PuTTY-Generator (puttygen.exe) herunter, und öffnen Sie dann das Tool.
Wählen Sie im PuTTY-Schlüsselgeneratortool (puttygen.exe) unter "Aktionen" die Option "Laden" aus.
Navigieren Sie im PuTTY-Format zu Ihrer Privaten Schlüsseldatei, und wählen Sie "Öffnen" aus.
Wählen Sie im Menü "Konvertierungen " die Option "OpenSSH-Taste exportieren" aus.
Speichern Sie die Datei "Private Key" mit der Dateinamenerweiterung ".pem ".
Suchen des MD5-Fingerabdrucks
Der SFTP-SSH Connector lehnt eine Verbindung ab, wenn sowohl der Fingerabdruck des SFTP-Servers als auch der erwartete Fingerabdruck nicht übereinstimmen. Um den MD5-Fingerabdruck zu erhalten, bei dem es sich um eine Sequenz mit 16 Paar hexadezimierten Ziffern handelt, die durch Doppelpunkte getrennt sind, probieren Sie die folgenden Optionen aus.
Sie haben den Schlüssel
Der MD5-Schlüssel ist eine 47-stellige Zeichenfolge, die durch Doppelpunkte getrennt ist. Um den MD5-Fingerabdruck zu erhalten, wenn Sie über den Schlüssel verfügen, können Sie Tools wie ssh-keygen verwenden.
Geben Sie beispielsweise in einer Bash-Eingabeaufforderung den folgenden Befehl ein:
ssh-keygen -l -f id_rsa.pub -E md5
Sie verfügen nicht über den Schlüssel
Um einen MD5-Fingerabdruck zu erhalten, wenn Sie keinen Schlüssel haben, können Sie das neueste Tool für Server- und Protokollinformationen von WinSCP verwenden oder stattdessen das PuTTY-Konfigurationstool verwenden:
Erweitern Sie im PuTTY-Konfigurationstool (putty.exe) im Fenster "Kategorie" dieVerbindungs-SSH-Hostschlüssel>>.
Öffnen Sie unter der Einstellung des Hostschlüsselalgorithmus die Liste der Algorithmusauswahlrichtlinien , und überprüfen Sie, ob RSA oben angezeigt wird.
Wenn RSA nicht oben angezeigt wird, wählen Sie RSA aus, und wählen Sie dann "Nach oben " aus, bis RSA nach oben verschoben wird.
Stellen Sie eine Verbindung mit Ihrem SFTP-Server mit PuTTY her. Nachdem die Verbindung erstellt wurde, wählen Sie nach dem Anzeigen der PUTTY-Sicherheitswarnung "Weitere Informationen" aus.
Hinweis
Wenn die Sicherheitswarnung nicht angezeigt wird, versuchen Sie, den SshHostKeys-Eintrag zu löschen. Öffnen Sie den Windows-Registrierungs-Editor, und navigieren Sie zum folgenden Eintrag:
Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeysNachdem puTTY: Informationen zum Hostschlüsselfeld des Servers angezeigt werden, suchen Sie die MD5-Fingerabdruckeigenschaft , und kopieren Sie den 47-stelligen Zeichenfolgenwert, der wie im folgenden Beispiel aussieht:
**:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**
Bekannte Probleme und Einschränkungen mit Triggern
SfTP-verwaltete Connectortrigger können fehlende, unvollständige oder verzögerte Ergebnisse aufweisen.
Fehlende Ergebnisse
SFTP löst Arbeit aus, indem das SFTP-Dateisystem abgerufen oder überprüft wird und nach Dateien sucht, die seit der letzten Umfrage geändert wurden. SFTP 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 sfTP-verwaltete Connectortrigger diese Datei nicht.
Wenn Sie also ein externes Tool oder Client verwenden, das Dateien auf dem SFTP-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:
SFTP-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 SFTP-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 SFTP-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 SFTP-Trigger möglicherweise nicht alle Dateien gleichzeitig zurück, wenn Sie die Einstellung " Split On " des SFTP-Triggers deaktivieren.
Allgemeine bekannte Probleme und Einschränkungen
Der SFTP-SSH verwalteter Connector unterstützt derzeit nicht die folgenden SFTP-Server:
- Akamai NetStorage
- FileMage-Gateway
- Globalscape
- IBM DataPower
- MessageWay
- OpenText Secure MFT
- OpenText GXS
- SFTP für Azure Blob Storage
- VShell Secure File Transfer Server
- AWS SFTP
Verwenden Sie separate SFTP-Ordner für die Dateiverarbeitung und das Hochladen.
Stellen Sie sicher, dass Sie separate Ordner auf Ihrem SFTP-Server verwenden, um Dateien zur Verarbeitung und zum Speichern hochgeladener Dateien zu überwachen. Andernfalls wird der Trigger nicht ausgelöst und verhält sich unvorhersehbar. Beispielsweise kann der Trigger eine zufällige Anzahl von Dateien überspringen, die eine Verarbeitung benötigen.
Diese Einschränkung bedeutet, dass Sie eine Möglichkeit zum Verschieben von Dateien zwischen diesen Ordnern benötigen. Wenn dieses Problem auftritt, entfernen Sie die Dateien aus dem überwachten Ordner, und verwenden Sie einen anderen Ordner, um hochgeladene Dateien zu speichern.
Um die Last für gemeinsam genutzte verwaltete Connectordienste mit mehreren Mandanten zu verwalten, kann der verwaltete SFTP-SSH Connector mehrere Verbindungen aus derselben Quell-IP-Adresse erstellen, d. h. die Connector-IP-Adresse, an das Ziel, das Ihr SFTP-Server ist. Einige Regionen mit geringem Datenverkehr verwenden möglicherweise nur drei Instanzen virtueller Computer hinter der IP-Adresse des Connectors, was bedeutet, dass diese Regionen maximal drei Verbindungen erstellen können. Andere Regionen können bis zu 20 Verbindungen verwenden, da sie dieselbe Anzahl virtueller Computer hinter der IP-Adresse des Connectors haben.
Wenn Ihr SFTP-Server die Anzahl der Verbindungen begrenzt, funktioniert ihr Server möglicherweise nicht gut mit dem verwalteten SFTP-SSH Connector. Sie können jedoch einen Standardlogik-App-Workflow erstellen, der stattdessen die integrierten SFTP-Vorgänge verwendet. Sie können die Skalierungsgrenzwerte und dadurch die Anzahl der Verbindungen steuern.
Wenn zwischen dem SFTP-SSH verwalteten Connector und dem SFTP-Server Verschlüsselungssuiteinteroperabilitätsprobleme auftreten, versuchen Sie stattdessen, einen Standardlogik-App-Workflow zu erstellen und stattdessen die integrierten SFTP-Vorgänge zu verwenden. Der integrierte SFTP-Betrieb unterstützt eine breitere Palette von Verschlüsselungssammlungen.
Dieser Connector sendet möglicherweise eine no-op Anforderung an das Back-End.
Segmentierung
In Azure Logic Apps und Power Automate unterstützen die folgenden verwalteten SFTP-SSH Connectoraktionen Blöcke, bei denen eine Aktion das Behandeln großer Dateien in kleineren Teilen ermöglichen kann. Weitere Informationen zum Blockieren in Azure Logic Apps finden Sie unter [Behandeln großer Nachrichten mithilfe von Blöcken]](/azure/logic-apps/logic-apps-handle-large-messages).
Maßnahme Blockierungsunterstützung Unterstützung für Blockgrößen außer Kraft setzen Datei kopieren Nein Nicht anwendbar Datei erstellen Yes Yes Ordner erstellen Nicht anwendbar Nicht anwendbar Datei löschen Nicht anwendbar Nicht anwendbar Archiv in Ordner extrahieren Nicht anwendbar Nicht anwendbar Abrufen von Dateiinhalten Yes Yes Abrufen von Dateiinhalten mithilfe des Pfads Yes Yes Abrufen von Dateimetadaten Nicht anwendbar Nicht anwendbar Abrufen von Dateimetadaten mithilfe des Pfads Nicht anwendbar Nicht anwendbar Auflisten von Dateien im Ordner Nicht anwendbar Nicht anwendbar Datei umbenennen Nicht anwendbar Nicht anwendbar Datei aktualisieren Nein Nicht anwendbar SFTP-SSH Aktionen, die das Blockieren unterstützen, können Dateien bis zu 1 GB verarbeiten, während SFTP-SSH Aktionen, die das Blockieren nicht unterstützen, Dateien bis zu 50 MB verarbeiten können. Die Standardgröße des Blockabschnitts beträgt 15 MB. Diese Größe kann sich jedoch dynamisch ändern, beginnend mit 5 MB und schrittweise auf das Maximum von 50 MB. Die dynamische Größenanpassung basiert auf Faktoren wie Netzwerklatenz, Serverantwortzeit usw.
Sie können dieses adaptive Verhalten außer Kraft setzen, wenn Sie stattdessen eine konstante Blockgröße angeben. Diese Größe kann zwischen 5 MB und 50 MB liegen. Angenommen, Sie haben eine 45 MB-Datei und ein Netzwerk, das diese Dateigröße ohne Latenz unterstützt. Adaptive Blöcke führen zu mehreren Aufrufen, sondern zu einem Aufruf. Um die Anzahl der Anrufe zu verringern, können Sie versuchen, eine Blockgröße von 50 MB festzulegen. Wenn Ihr Logik-App-Workflow in einem anderen Szenario einen Zeitlimit von 15 MB hat, können Sie beispielsweise versuchen, die Größe auf 5 MB zu reduzieren.
Die Blockgröße ist einer Verbindung zugeordnet. Dieses Attribut bedeutet, dass Sie die gleiche Verbindung für beide Aktionen verwenden können, die Blockierung und Aktionen unterstützen, die keine Blockierung unterstützen. In diesem Fall reicht die Blockgröße für Aktionen, die Blöcke unterstützen, von 5 MB bis 50 MB.
Um das standardmäßige adaptive Verhalten außer Kraft zu setzen, das für eine SFTP-SSH-Aktion verwendet wird, können Sie eine konstante Blockgröße von 5 MB bis 50 MB angeben.
Wählen Sie im Designer in der oberen rechten Ecke der SFTP-SSH Aktion die Schaltfläche mit den Auslassungspunkten (...) und dann "Einstellungen" aus.
Geben Sie unter "Inhaltsübertragung" in der Eigenschaft " Blockgröße " einen ganzzahligen Wert von zu " ein
550.Nachdem Sie fertig sind, wählen Sie "Fertig" aus.
SFTP-SSH Trigger unterstützen das Blockieren von Nachrichten nicht. Wenn Der Anforderungsinhalt ausgelöst wird, wählen sie nur Dateien aus, die 15 MB oder kleiner sind. Wenn Sie Dateien mit mehr als 15 MB abrufen möchten, gehen Sie stattdessen wie folgt vor:
Verwenden Sie einen SFTP-SSH Trigger, der nur Dateieigenschaften zurückgibt. Diese Trigger enthalten Namen, die die Beschreibung enthalten (nur Eigenschaften).
Folgen Sie dem Trigger mit der SFTP-SSH Dateiinhaltsaktion abrufen . Diese Aktion liest die vollständige Datei und verwendet implizit den Nachrichtenabschnitt.
Problembehandlung
401-Fehler: "401 Nicht autorisiert"
Dieser Fehler kann auftreten, da Sie nicht über die richtigen Anmeldeinformationen oder Berechtigungen verfügen. Weitere Informationen finden Sie unter Authentifizierung und Berechtigungen.
404-Fehler: "Es wurde auf eine Datei oder einen Ordner verwiesen, die nicht vorhanden ist"
Dieser Fehler kann auftreten, wenn Sie die Aktion "Datei erstellen " verwenden. Wenn die Aktion eine Datei auf Ihrem SFTP-Server erstellt, sendet die Aktion auch automatisch einen Aufruf an Ihren SFTP-Server, um die Metadaten der Datei abzurufen.
Wenn Sie die neu erstellte Datei sofort verschieben, bevor der Aufruf die Metadaten abrufen kann, ist die Datei nicht mehr am erwarteten Speicherort vorhanden, und Sie erhalten eine Fehlermeldung von 404, ein Verweis auf eine Datei oder einen Ordner, die nicht vorhanden ist.
Wenn Sie das Verschieben der Datei nicht vermeiden oder verzögern können, können Sie das Lesen der Metadaten der Datei nach der Dateierstellung überspringen, indem Sie die folgenden Schritte ausführen:
Öffnen Sie in der Aktion " Datei erstellen " die Liste " Neue Parameter hinzufügen ", wählen Sie die Eigenschaft "Alle Dateimetadaten abrufen " aus, und legen Sie den Wert auf "Nein" fest.
Wenn Sie diese Dateimetadaten später benötigen, können Sie die Aktion "Dateimetadaten abrufen " verwenden.
504-Fehler: "Fehler bei einem Verbindungsversuch, weil der verbundene Anbieter nach einem bestimmten Zeitraum nicht ordnungsgemäß reagiert hat oder eine Verbindung hergestellt wurde, weil der verbundene Host nicht reagiert hat" oder "Die Anforderung an den SFTP-Server hat mehr als '00:00:30' Sekunden gedauert"
Dieser Fehler kann auftreten, wenn Sie keine Verbindung mit dem SFTP-Server herstellen können. Es kann verschiedene Ursachen für dieses Problem geben. Probieren Sie daher die folgenden Problembehandlungsoptionen aus:
Das Verbindungstimeout beträgt 20 Sekunden. Überprüfen Sie, ob Ihr SFTP-Server über gute Leistung und Zwischengeräte verfügt, z. B. Firewalls, keinen Zusätzlichen Mehraufwand bieten.
Überprüfen Sie, ob Ihr SFTP-Server die Anzahl der Verbindungen von jeder IP-Adresse begrenzt. Jede solche Beschränkung behindert die Kommunikation zwischen dem Connector und dem SFTP-Server. Stellen Sie sicher, dass Sie diesen Grenzwert entfernen.
Wenn Sie eine Firewall eingerichtet haben, stellen Sie sicher, dass Sie der genehmigten Liste die verwalteten Connector-IP-Adressen für Ihre Region hinzufügen.
Wenn der Fehler zeitweise auftritt, ändern Sie die Richtlinieneinstellung "Wiederholen " für die SFTP-SSH Aktion in eine Wiederholungsanzahl, die höher als die standard vier Wiederholungsversuche ist.
Um die Kosten für die Verbindungseinrichtung zu reduzieren, erhöhen Sie in der SSH-Konfiguration für Ihren SFTP-Server die Eigenschaft "ClientAliveInterval " auf etwa eine Stunde.
Überprüfen Sie das SFTP-Serverprotokoll, um zu überprüfen, ob Aufrufe, die an Ihren SFTP-Server gesendet wurden, erfolgreich eintreffen, um weitere Informationen zum Verbindungsproblem zu erhalten, können Sie auch eine Netzwerkablaufverfolgung auf Ihrer Firewall und Ihrem SFTP-Server ausführen.
Allgemeine Grenzwerte
| Name | Wert |
|---|---|
| Maximale Anzahl von Megabytes, die innerhalb eines Bandbreitenzeitintervalls (pro Verbindung) an/vom Connector übertragen werden | 1.000 |
| Bandbreitenzeitintervall (in Milisekunden) | 60000 |
Erstellen einer Verbindung
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 |
|---|---|---|---|
| Hostserveradresse | Schnur | Hostserveradresse | Richtig |
| Benutzername | Schnur | Benutzername | Richtig |
| Kennwort | securestring | Kennwort | |
| PRIVATER SSH-Schlüssel | securestring | Privater SSH-Schlüssel (der Inhalt der Datei sollte vollständig wie im mehrstufigen Format bereitgestellt werden) | |
| Passphrase eines privaten SSH-Schlüssels | securestring | Passphrase eines privaten SSH-Schlüssels (wenn der private Schlüssel durch eine Passphrase geschützt ist) | |
| Portnummer | INT | SFTP-Portnummer (Beispiel: 22) | |
| Deaktivieren der SSH-Hostschlüsselüberprüfung | Boolesch | SSH-Hostschlüsselüberprüfung deaktivieren? (True/False) | |
| Fingerdruck mit SSH-Hosttasten | Schnur | Fingerdruck mit SSH-Hosttasten | |
| Stammordnerpfad | Schnur | Stammordnerpfad. |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 150 | 60 Sekunden |
Aktionen
| Abrufen von Dateiinhalten mithilfe des Pfads |
Dieser Vorgang ruft Dateiinhalte mithilfe des Dateipfads ab. |
| Abrufen von Dateimetadaten mithilfe des Pfads |
Dieser Vorgang ruft Dateimetadaten 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 Dateien in einem Ordner ab. |
| Auflisten von Dateien im Stammordner |
Dieser Vorgang ruft die Dateien im Stammordner ab. |
| Datei aktualisieren |
Dieser Vorgang aktualisiert den Dateiinhalt. |
| Datei erstellen |
Dieser Vorgang lädt eine Datei hoch. |
| Datei kopieren |
Dieser Vorgang kopiert eine Datei. |
| Datei löschen |
Dieser Vorgang löscht eine Datei. |
| Datei umbenennen |
Dieser Vorgang benennt eine Datei um. |
| Dateiinhalte abrufen |
Dieser Vorgang ruft Dateiinhalte mithilfe der Datei-ID ab. |
| Dateimetadaten abrufen |
Dieser Vorgang ruft Dateimetadaten mithilfe der Datei-ID ab. |
| Erstellen des Ordners |
Dieser Vorgang erstellt einen neuen Ordner. |
Abrufen von Dateiinhalten mithilfe des Pfads
Dieser Vorgang ruft Dateiinhalte mithilfe des Dateipfads ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dateipfad
|
path | True | string |
Eindeutiger Pfad der Datei |
|
Inhaltstyp ableiten
|
inferContentType | boolean |
Abgeleiteter Inhaltstyp basierend auf der Erweiterung |
Gibt zurück
Der Inhalt der Datei.
- Inhalt der Datei
- binary
Abrufen von Dateimetadaten mithilfe des Pfads
Dieser Vorgang ruft Dateimetadaten mithilfe des Dateipfads ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dateipfad
|
path | True | string |
Eindeutiger Pfad der Datei |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Archiv in Ordner extrahieren
Mit diesem Vorgang wird eine Archivdatei in einen Ordner extrahiert (Beispiel: .zip).
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Quellarchivdateipfad
|
source | True | string |
Pfad zur Archivdatei |
|
Zielordnerpfad
|
destination | True | string |
Pfad zum Zielordner |
|
Überschreiben?
|
overwrite | boolean |
Überschreibt die Zieldateien, wenn sie auf "true" festgelegt sind. |
Gibt zurück
- response
- array of BlobMetadata
Auflisten von Dateien im Ordner
Dieser Vorgang ruft Dateien in einem Ordner ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ordner
|
id | True | string |
Angeben des Ordners |
Gibt zurück
- response
- array of BlobMetadata
Auflisten von Dateien im Stammordner
Datei aktualisieren
Dieser Vorgang aktualisiert den Dateiinhalt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben der Datei |
|
Dateiinhalt
|
body | True | binary |
Inhalt der zu aktualisierenden Datei |
|
Abrufen aller Dateimetadaten
|
ReadFileMetadataFromServer | boolean |
Rufen Sie alle Dateimetadaten vom SFTP-Server ab, nachdem die Dateierstellung abgeschlossen ist. Wenn dies "false" ist, werden einige Metadateneigenschaften möglicherweise nicht zurückgegeben, z. B. zeitpunkt der letzten Änderung usw. |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Datei erstellen
Dieser Vorgang lädt eine Datei hoch.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ordnerpfad
|
folderPath | True | string |
Eindeutiger Pfad des Ordners |
|
Dateiname
|
name | True | string |
Name der Datei |
|
Dateiinhalt
|
body | True | binary |
Inhalt der zu erstellenden Datei |
|
Abrufen aller Dateimetadaten
|
ReadFileMetadataFromServer | boolean |
Rufen Sie alle Dateimetadaten vom SFTP-Server ab, nachdem die Dateierstellung abgeschlossen ist. Wenn dies "false" ist, werden einige Metadateneigenschaften möglicherweise nicht zurückgegeben, z. B. zeitpunkt der letzten Änderung usw. |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Datei kopieren
Dieser Vorgang kopiert eine Datei.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Quelldateipfad
|
source | True | string |
Pfad zur Quelldatei |
|
Zieldateipfad
|
destination | True | string |
Pfad zur Zieldatei, einschließlich Des Dateinamens |
|
Überschreiben?
|
overwrite | boolean |
Überschreibt die Zieldatei, wenn sie auf "true" festgelegt ist. |
|
|
Abrufen aller Dateimetadaten
|
ReadFileMetadataFromServer | boolean |
Rufen Sie alle Dateimetadaten vom SFTP-Server ab, nachdem die Dateierstellung abgeschlossen ist. Wenn dies "false" ist, werden einige Metadateneigenschaften möglicherweise nicht zurückgegeben, z. B. zeitpunkt der letzten Änderung usw. |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Datei löschen
Dieser Vorgang löscht eine Datei.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben der Datei |
|
Löschen überspringen, wenn die Datei nicht gefunden wurde
|
SkipDeleteIfFileNotFoundOnServer | boolean |
Überspringt das Löschen, wenn eine Datei nicht gefunden wird, ohne dass eine Aktion fehlschlägt. |
Datei umbenennen
Dieser Vorgang benennt eine Datei um.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Auswählen einer Datei |
|
Neuer Name
|
newName | True | string |
Neuer Name für die Datei |
|
Abrufen aller Dateimetadaten
|
ReadFileMetadataFromServer | boolean |
Rufen Sie alle Dateimetadaten vom SFTP-Server ab, nachdem die Dateierstellung abgeschlossen ist. Wenn dies "false" ist, werden einige Metadateneigenschaften möglicherweise nicht zurückgegeben, z. B. zeitpunkt der letzten Änderung usw. |
Gibt zurück
Stellt die Antwort auf Blob-Datasets-Metadaten dar.
- Body
- BlobMetadataResponse
Dateiinhalte abrufen
Dieser Vorgang ruft Dateiinhalte mithilfe der Datei-ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben der Datei-ID |
|
Inhaltstyp ableiten
|
inferContentType | boolean |
Abgeleiteter Inhaltstyp basierend auf der Erweiterung |
Gibt zurück
Der Inhalt der Datei.
- Inhalt der Datei
- binary
Dateimetadaten abrufen
Dieser Vorgang ruft Dateimetadaten mithilfe der Datei-ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben der Datei-ID |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Erstellen des Ordners
Dieser Vorgang erstellt einen neuen Ordner.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ordner
|
folderPath | True | string |
Auswählen eines Ordners |
|
Name
|
name | True | string |
Name des Ordners |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Auslöser
| Wenn Dateien hinzugefügt oder geändert werden (nur Eigenschaften) |
Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner hinzugefügt oder geändert wird. 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 |
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 Dateien hinzugefügt oder geändert werden (nur Eigenschaften)
Dieser Vorgang löst einen Fluss aus, wenn eine Datei in einem Ordner hinzugefügt oder geändert wird. 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.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ordner
|
folderId | True | string |
Auswählen eines Ordners |
|
Anzahl der zurückzugebenden Dateien
|
maxFileCount | integer |
Anzahl der vom Trigger zurückgegebenen Dateien (1-100) |
Gibt zurück
Blobmetadaten
- Liste der Dateien
- BlobMetadata
Wenn eine Datei hinzugefügt oder geändert wird
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.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Ordner
|
folderId | True | string |
Angeben eines Ordners |
|
Dateiinhalt einschließen
|
includeFileContent | boolean |
Bei Festlegung auf "true" werden Dateiinhalte auch zusammen mit der Triggerantwort abgerufen. |
|
|
Inhaltstyp ableiten
|
inferContentType | boolean |
Abgeleiteter Inhaltstyp basierend auf der Erweiterung |
Gibt zurück
Der Inhalt der Datei.
- Inhalt der Datei
- binary
Definitionen
BlobMetadata
Blobmetadaten
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
Id | string |
Die eindeutige ID der Datei oder des Ordners. |
|
Name
|
Name | string |
Der Name der Datei oder des Ordners. |
|
Anzeigename
|
DisplayName | string |
Der Anzeigename der Datei oder des Ordners. |
|
Pfad
|
Path | string |
Der Pfad der Datei oder des Ordners. |
|
LastModified
|
LastModified | date-time |
Datum und Uhrzeit der letzten Änderung der Datei oder des Ordners. |
|
Größe
|
Size | integer |
Die Größe der Datei oder des Ordners. |
|
Medientyp
|
MediaType | string |
Der Medientyp der Datei oder des Ordners. |
|
IsFolder
|
IsFolder | boolean |
Ein boolescher Wert (true, false), der angibt, ob es sich bei dem Blob um einen Ordner handelt. |
|
ETag
|
ETag | string |
Das Etag der Datei oder des Ordners. |
|
FileLocator
|
FileLocator | string |
Der Filelocator der Datei oder des Ordners. |
BlobMetadataResponse
Stellt die Antwort auf Blob-Datasets-Metadaten dar.
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Id
|
Id | string |
Die eindeutige ID der Datei oder des Ordners. |
|
Name
|
Name | string |
Der Name der Datei oder des Ordners. |
|
Anzeigename
|
DisplayName | string |
Der Anzeigename der Datei oder des Ordners. |
|
Pfad
|
Path | string |
Der Pfad der Datei oder des Ordners. |
|
LastModified
|
LastModified | date-time |
Datum und Uhrzeit der letzten Änderung der Datei oder des Ordners. |
|
Größe
|
Size | integer |
Die Größe der Datei oder des Ordners. |
|
Medientyp
|
MediaType | string |
Der Medientyp der Datei oder des Ordners. |
|
IsFolder
|
IsFolder | boolean |
Ein boolescher Wert (true, false), der angibt, ob es sich bei dem Blob um einen Ordner handelt. |
|
ETag
|
ETag | string |
Das Etag der Datei oder des Ordners. |
|
FileLocator
|
FileLocator | string |
Der Filelocator der Datei oder des Ordners. |
binär
Dies ist der grundlegende Datentyp "binary".