SFTP [VERALTET]
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 Government (GCC High) - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: - US Department of Defense (DoD) |
| 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) |
| Kontakt | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps-Unterstützung Microsoft Power Automate-Support Microsoft Power Apps-Unterstützung |
| Connectormetadaten | |
|---|---|
| Herausgeber | Microsoft |
Dieser Connector befindet sich auf seinem veralteten Pfad, verwenden Sie bitte den neuen SFTP-SSH-Connector . Weitere Informationen zur Verwendung des neuen Connectors finden Sie hier.
Um diesen Connector zu verwenden, benötigen Sie Zugriff auf einen privaten SSH-Schlüssel und die PASSphrase des privaten SSH-Schlüssels.
Die folgenden privaten Schlüsselformate werden unterstützt:
OpenSSHssh.comPuTTY
Der Inhalt des privaten SSH-Schlüssels sollte vollständig in das Feld "PRIVATER SSH-Schlüssel" im mehrteiligen Format kopiert/eingefügt werden. Im Folgenden finden Sie Beispielschritte zum Bereitstellen des privaten SSH-Schlüssels mithilfe von Notepad.exe:
- Öffnen Sie die PRIVATE SSH-Schlüsseldatei in Notepad.exe;
- Klicken Sie auf "Bearbeiten" → "Alle auswählen";
- Klicken Sie auf "Bearbeiten" → Kopieren;
- Klicken Sie im Feld "SSH private Schlüssel" (beim Erstellen einer Verbindung) mit der rechten Maustaste, und klicken Sie auf "Einfügen". Bearbeiten Sie das Feld "PRIVATER SSH-Schlüssel" nicht manuell.
Triggergrenzwerte
Die Auslöser funktionieren durch Abfragen des SFTP-Dateisystems und suchen nach einer Datei, die seit der letzten Abfrage geändert wurde, zum Vergleichen von Dateien nach Änderungszeit. Mit bestimmten Tools kann die Dateiänderungszeit beibehalten werden. In solchen Fällen müssen Sie das Feature deaktivieren, damit Ihr Trigger funktioniert. Im Folgenden finden Sie einige allgemeine Einstellungen:
| SFTP-Client | Maßnahme |
|---|---|
| WinSCP | Optionen → Einstellungen... → Übertragung → Bearbeiten... → Zeitstempel beibehalten → Deaktivieren |
| FileZilla | Übertragung → Beibehalten von Zeitstempeln der übertragenen Dateien → Deaktivieren |
Wenn die Trigger auf eine neue Datei stoßen, wird versucht, sicherzustellen, dass die neue Datei vollständig geschrieben ist. Es ist z. B. möglich, dass die Datei geschrieben oder geändert wird und Aktualisierungen zum Zeitpunkt der Abfrage des Dateiservers vorgenommen werden. Um zu vermeiden, dass eine Datei mit teilweisem Inhalt zurückgegeben wird, notiert der Trigger den Zeitstempel solcher Dateien, die kürzlich geändert werden, geben diese Dateien jedoch nicht sofort zurück. Diese Dateien werden nur zurückgegeben, wenn die Trigger-Abrufe erneut erfolgen. Manchmal kann dies zu einer Verzögerung bis zu zweimal dem Triggerabfragungsintervall führen. Dies bedeutet auch, dass der Trigger nicht garantiert, dass alle Dateien in einer einzigen Ausführung zurückgegeben werden, wenn die Option "Teilen bei" deaktiviert ist.
Der Auslöser nimmt dateien nicht über 50 MB auf, wenn der Inhalt gefragt wird.
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.
Verbinder im Detail
Weitere Informationen zum Verbinder finden Sie im ausführlichen Abschnitt.
Bekannte Probleme und Einschränkungen
- Dieser Connector sendet möglicherweise eine no-op Anforderung an das Back-End.
Allgemeine Grenzwerte
| Name | Wert |
|---|---|
| Maximale Gesamtanzahl der Anforderungen pro SFTP-Serveradresse pro Minute | 600 |
| 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 |
|---|---|---|---|
| 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) | |
| SSH Host Key Finger-print | Schnur | SSH Host Key Finger-print | |
| Fortsetzungsfunktion deaktivieren | Boolesch | Fortsetzungsfunktion deaktivieren? (True/False) |
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen von Dateiinhalten [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateiinhalt abrufen ".
|
| Abrufen von Dateiinhalten mithilfe des Pfads [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateiinhalt abrufen" mithilfe des Pfads .
|
| Abrufen von Dateimetadaten [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateimetadaten abrufen ".
|
| Abrufen von Dateimetadaten mithilfe des Pfads [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateimetadaten abrufen" mithilfe des Pfads .
|
| Archiv in Ordner extrahieren [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Archiv extrahieren" als Ordner .
|
| Auflisten von Dateien im Ordner [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen Listendateien im Ordner .
|
| Auflisten von Dateien im Stammordner [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen Listendateien im Stammordner .
|
| Datei aktualisieren [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen die Updatedatei .
|
| Datei erstellen [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Datei erstellen ".
|
| Datei kopieren [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Datei kopieren ".
|
| Datei löschen [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen " Datei löschen ".
|
Abrufen von Dateiinhalten [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateiinhalt abrufen ".
Dieser Vorgang ruft Dateiinhalte mithilfe der Datei-ID ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben 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 Dateiinhalten mithilfe des Pfads [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateiinhalt abrufen" 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 [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "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 |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Abrufen von Dateimetadaten mithilfe des Pfads [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Dateimetadaten abrufen" 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 [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Archiv extrahieren" als Ordner .
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 [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen Listendateien 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 [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen Listendateien im Stammordner .
Dieser Vorgang ruft die Dateien im Stammordner ab.
Gibt zurück
- response
- array of BlobMetadata
Datei aktualisieren [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen die Updatedatei .
Dieser Vorgang aktualisiert den Dateiinhalt. 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.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben der Datei |
|
Dateiinhalt
|
body | True | binary |
Inhalt der zu aktualisierenden Datei |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Datei erstellen [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Datei erstellen ".
Dieser Vorgang lädt eine Datei auf einen SFTP-Server hoch. 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.
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 |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Datei kopieren [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen "Datei kopieren ".
Dieser Vorgang kopiert eine Datei auf einen SFTP-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.
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. |
Gibt zurück
Blobmetadaten
- Body
- BlobMetadata
Datei löschen [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen " Datei löschen ".
Dieser Vorgang löscht eine Datei.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Datei
|
id | True | string |
Angeben der Datei |
Auslöser
| Wenn eine Datei hinzugefügt oder geändert wird (nur Eigenschaften) [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen ", wenn Dateien hinzugefügt oder geändert werden (nur Eigenschaften ).
|
| Wenn eine Datei hinzugefügt oder geändert wird [VERALTET] |
Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, wenn eine Datei hinzugefügt oder geändert wird .
|
Wenn eine Datei hinzugefügt oder geändert wird (nur Eigenschaften) [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen ", 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 Dateien, die vom Trigger zurückgegeben werden sollen
|
maxFileCount | integer |
Maximale Anzahl von Dateien, die von einem einzelnen Triggerlauf zurückgegeben werden sollen (1-100). Beachten Sie, dass die Einstellung "Split On" die Verarbeitung jedes Elements einzeln erzwingen kann. |
Gibt zurück
Blobmetadaten
- Liste der Dateien
- BlobMetadata
Wenn eine Datei hinzugefügt oder geändert wird [VERALTET]
Diese Aktion ist veraltet. Verwenden Sie stattdessen die Verwendung, 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. |
binär
Dies ist der grundlegende Datentyp "binary".