SFTP [DÉCONSEILLÉ]
SFTP (SSH File Transfer Protocol) est un protocole réseau qui fournit l’accès aux fichiers, le transfert de fichiers et la gestion des fichiers sur n’importe quel flux de données fiable. Elle a été conçue par internet Engineering Task Force (IETF) en tant qu’extension du protocole SECURE Shell (SSH) version 2.0 pour fournir des fonctionnalités de transfert de fichiers sécurisées.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC High) - Us Department of Defense (DoD) |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Us Department of Defense (DoD) |
| Power Apps | Norme | Toutes les régions Power Apps , à l’exception des suivantes : - Us Government (GCC High) - Us Department of Defense (DoD) |
| Power Automate | Norme | Toutes les régions Power Automate , à l’exception des éléments suivants : - Us Government (GCC High) - Us Department of Defense (DoD) |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL |
Microsoft LogicApps Support Prise en charge de Microsoft Power Automate Prise en charge de Microsoft Power Apps |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
Ce connecteur se trouve sur son chemin d’accès de dépréciation, veuillez utiliser le nouveau connecteur SFTP-SSH . Pour plus d’informations sur l’utilisation du nouveau connecteur , consultez cette page.
Pour utiliser ce connecteur, vous devez accéder à une clé privée SSH et à la phrase secrète de clé privée SSH.
Les formats de clé privée suivants sont pris en charge :
OpenSSHssh.comPuTTY
Le contenu de la clé privée SSH doit être copié/collé entièrement dans le champ « Clé privée SSH » au format multiligne. Vous trouverez ci-dessous des exemples d’étapes pour fournir la clé privée SSH à l’aide de Notepad.exe:
- Ouvrez le fichier de clé privée SSH dans Notepad.exe;
- Cliquez sur Modifier → sélectionner tout ;
- Cliquez sur Modifier → Copier ;
- Dans le champ « Clé privée SSH » (lors de la création d’une connexion), cliquez sur le bouton droit de la souris, puis cliquez sur Coller. Ne modifiez pas manuellement le champ « Clé privée SSH ».
Limites du déclencheur
Les déclencheurs fonctionnent en interrogeant le système de fichiers SFTP et en recherchant un fichier qui a été modifié depuis le dernier sondage, comparant les fichiers par heure de modification. Certains outils permettent la conservation du temps de modification du fichier. Dans ce cas, vous devez désactiver la fonctionnalité pour que votre déclencheur fonctionne. Voici quelques paramètres courants :
| Client SFTP | Action |
|---|---|
| WinSCP | Options → Préférences... → Transférer → Modifier... → Conserver l’horodatage → Désactiver |
| FileZilla | Transférer → conserver les horodatages des fichiers transférés → Désactiver |
Lorsque les déclencheurs rencontrent un nouveau fichier, il tente de s’assurer que le nouveau fichier est entièrement écrit. Par exemple, il est possible que le fichier soit écrit ou modifié et que les mises à jour soient effectuées au moment où le déclencheur a interrogé le serveur de fichiers. Pour éviter de retourner un fichier avec du contenu partiel, le déclencheur prend note de l’horodatage de ces fichiers modifiés récemment, mais ne retourne pas immédiatement ces fichiers. Ces fichiers ne seront retournés que lorsque le déclencheur interroge à nouveau. Parfois, cela peut entraîner un retard jusqu’à deux fois l’intervalle d’interrogation du déclencheur. Cela signifie également que le déclencheur ne garantit pas de retourner tous les fichiers dans une seule exécution lorsque l’option « Fractionner sur » est désactivée.
Le déclencheur ne récupère pas de fichiers de plus de 50 Mo si le contenu est demandé.
Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Connecteur en profondeur
Pour plus d’informations sur le connecteur, consultez la section détaillée.
Problèmes connus et limitations
- Ce connecteur peut envoyer une demande de no-op au serveur principal.
Limites générales
| Nom | Valeur |
|---|---|
| Nombre maximal de requêtes par adresse de serveur SFTP par minute | 600 |
| Nombre maximal de mégaoctets transférés vers/depuis le connecteur dans un intervalle de temps de bande passante (par connexion) | 1 000 |
| Intervalle de temps de bande passante (en milisecondes) | 60000 |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Non partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Adresse du serveur hôte | ficelle | Adresse du serveur hôte | Vrai |
| Nom d'utilisateur | ficelle | Nom d'utilisateur | Vrai |
| Mot de passe | securestring | Mot de passe | |
| Clé privée SSH | securestring | Clé privée SSH (le contenu du fichier doit être fourni entièrement comme c’est le cas, au format multiligne) | |
| Phrase secrète de clé privée SSH | securestring | Phrase secrète de clé privée SSH (si la clé privée est protégée par une phrase secrète) | |
| Numéro de port | int | Numéro de port SFTP (exemple : 22) | |
| Désactiver la validation de la clé d’hôte SSH | bool | Désactiver la validation de la clé d’hôte SSH ? (True/False) | |
| Empreinte de clé d’hôte SSH | ficelle | Empreinte de clé d’hôte SSH | |
| Désactiver la fonctionnalité reprendre | bool | Désactiver la fonctionnalité reprendre ? (True/False) |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 100 | 60 secondes |
Actions
| Copier le fichier [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt copier le fichier .
|
| Créer un fichier [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Créer un fichier .
|
| Extraire l’archive dans le dossier [DÉPRÉCIÉ] |
Cette action a été déconseillée. Utilisez plutôt Extraire l’archive dans le dossier .
|
| Fichier de mise à jour [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt le fichier Update .
|
| Obtenir des métadonnées de fichier à l’aide du chemin d’accès [DÉPRÉCIÉ] |
Cette action a été déconseillée. Utilisez plutôt Obtenir des métadonnées de fichier à l’aide du chemin d’accès .
|
| Obtenir du contenu de fichier à l’aide du chemin d’accès [DÉPRÉCIÉ] |
Cette action a été déconseillée. Utilisez plutôt Obtenir le contenu du fichier à l’aide du chemin d’accès .
|
| Obtenir le contenu du fichier [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Obtenir le contenu du fichier .
|
| Obtenir les métadonnées de fichier [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Obtenir les métadonnées du fichier .
|
| Répertorier les fichiers dans le dossier [DÉPRÉCIÉ] |
Cette action a été déconseillée. Utilisez plutôt des fichiers de liste dans le dossier .
|
| Répertorier les fichiers dans le dossier racine [DÉPRÉCIÉ] |
Cette action a été déconseillée. Utilisez plutôt les fichiers List dans le dossier racine .
|
| Supprimer le fichier [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt Supprimer le fichier .
|
Copier le fichier [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt copier le fichier .
Cette opération copie un fichier sur un serveur SFTP. Si un fichier est supprimé/renommé sur le serveur juste après sa copie, le connecteur peut retourner une erreur HTTP 404 par sa conception. Veuillez utiliser un délai de 1 minute avant de supprimer ou de renommer le fichier nouvellement créé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin d’accès au fichier source
|
source | True | string |
Chemin d’accès au fichier source |
|
Chemin d’accès du fichier de destination
|
destination | True | string |
Chemin d’accès au fichier de destination, y compris le nom de fichier |
|
Écraser?
|
overwrite | boolean |
Remplace le fichier de destination s’il est défini sur « true » |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Créer un fichier [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Créer un fichier .
Cette opération charge un fichier sur un serveur SFTP. Si un fichier est supprimé/renommé sur le serveur juste après sa création, le connecteur peut renvoyer une erreur HTTP 404 par sa conception. Veuillez utiliser un délai de 1 minute avant de supprimer ou de renommer le fichier nouvellement créé.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin du dossier
|
folderPath | True | string |
Chemin unique du dossier |
|
Nom de fichier
|
name | True | string |
Nom du fichier |
|
Contenu du fichier
|
body | True | binary |
Contenu du fichier à créer |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Extraire l’archive dans le dossier [DÉPRÉCIÉ]
Cette action a été déconseillée. Utilisez plutôt Extraire l’archive dans le dossier .
Cette opération extrait un fichier d’archivage dans un dossier (exemple : .zip).
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemin d’accès au fichier d’archivage source
|
source | True | string |
Chemin d’accès au fichier d’archivage |
|
Chemin du dossier de destination
|
destination | True | string |
Chemin d’accès au dossier de destination |
|
Écraser?
|
overwrite | boolean |
Remplace les fichiers de destination si la valeur est « true » |
Retours
- response
- array of BlobMetadata
Fichier de mise à jour [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt le fichier Update .
Cette opération met à jour le contenu du fichier. Si un fichier est supprimé/renommé sur le serveur juste après sa mise à jour, le connecteur peut renvoyer une erreur HTTP 404 par sa conception. Veuillez utiliser un délai de 1 minute avant de supprimer ou de renommer le fichier récemment mis à jour.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Spécifier le fichier |
|
Contenu du fichier
|
body | True | binary |
Contenu du fichier à mettre à jour |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir des métadonnées de fichier à l’aide du chemin d’accès [DÉPRÉCIÉ]
Cette action a été déconseillée. Utilisez plutôt Obtenir des métadonnées de fichier à l’aide du chemin d’accès .
Cette opération obtient les métadonnées de fichier à l’aide du chemin d’accès au fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemins d'accès au fichier
|
path | True | string |
Chemin d’accès unique du fichier |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir du contenu de fichier à l’aide du chemin d’accès [DÉPRÉCIÉ]
Cette action a été déconseillée. Utilisez plutôt Obtenir le contenu du fichier à l’aide du chemin d’accès .
Cette opération obtient le contenu du fichier à l’aide du chemin d’accès au fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Chemins d'accès au fichier
|
path | True | string |
Chemin d’accès unique du fichier |
|
Déduire le type de contenu
|
inferContentType | boolean |
Déduire le type de contenu basé sur l’extension |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Obtenir le contenu du fichier [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Obtenir le contenu du fichier .
Cette opération obtient le contenu du fichier à l’aide de l’ID de fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Spécifier le fichier |
|
Déduire le type de contenu
|
inferContentType | boolean |
Déduire le type de contenu basé sur l’extension |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Obtenir les métadonnées de fichier [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Obtenir les métadonnées du fichier .
Cette opération obtient les métadonnées de fichier à l’aide de l’ID de fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Spécifier le fichier |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Répertorier les fichiers dans le dossier [DÉPRÉCIÉ]
Cette action a été déconseillée. Utilisez plutôt des fichiers de liste dans le dossier .
Cette opération obtient les fichiers contenus dans un dossier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
id | True | string |
Spécifier le dossier |
Retours
- response
- array of BlobMetadata
Répertorier les fichiers dans le dossier racine [DÉPRÉCIÉ]
Cette action a été déconseillée. Utilisez plutôt les fichiers List dans le dossier racine .
Cette opération obtient les fichiers dans le dossier racine.
Retours
- response
- array of BlobMetadata
Supprimer le fichier [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt Supprimer le fichier .
Cette opération supprime un fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Spécifier le fichier |
Déclencheurs
| Lorsqu’un fichier est ajouté ou modifié (propriétés uniquement) [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez à la place Lorsque les fichiers sont ajoutés ou modifiés (propriétés uniquement).
|
| Lorsqu’un fichier est ajouté ou modifié [DÉCONSEILLÉ] |
Cette action a été déconseillée. Utilisez plutôt quand un fichier est ajouté ou modifié .
|
Lorsqu’un fichier est ajouté ou modifié (propriétés uniquement) [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez à la place Lorsque les fichiers sont ajoutés ou modifiés (propriétés uniquement).
Cette opération déclenche un flux lorsqu’un fichier est ajouté ou modifié dans un dossier. Ce déclencheur récupère uniquement les métadonnées du fichier. Pour obtenir le contenu du fichier, vous pouvez utiliser l’opération « Obtenir le contenu du fichier ». Le déclencheur s’appuie sur l’heure de dernière modification d’un fichier. Si un fichier est créé par un client tiers, la conservation de la dernière heure de modification doit être désactivée dans le client. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
folderId | True | string |
Sélectionner un dossier |
|
Nombre de fichiers à retourner à partir du déclencheur
|
maxFileCount | integer |
Nombre maximal de fichiers à retourner par exécution de déclencheur unique (1 à 100). Notez que le paramètre « Fractionner sur » peut forcer le déclencheur à traiter chaque élément individuellement. |
Retours
Métadonnées d'objet blob
- Liste des fichiers
- BlobMetadata
Lorsqu’un fichier est ajouté ou modifié [DÉCONSEILLÉ]
Cette action a été déconseillée. Utilisez plutôt quand un fichier est ajouté ou modifié .
Cette opération déclenche un flux lorsqu’un fichier est ajouté ou modifié dans un dossier. Le déclencheur récupère les métadonnées du fichier ainsi que le contenu du fichier. Le déclencheur s’appuie sur l’heure de dernière modification d’un fichier. Si un fichier est créé par un client tiers, la conservation de la dernière heure de modification doit être désactivée dans le client. Les fichiers de plus de 50 mégaoctets sont ignorés par le déclencheur. Le déclencheur ne se déclenche pas si un fichier est ajouté/mis à jour dans un sous-dossier. S’il est nécessaire de déclencher sur les sous-dossiers, plusieurs déclencheurs doivent être créés.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
folderId | True | string |
Spécifier un dossier |
|
Inclure le contenu du fichier
|
includeFileContent | boolean |
Si la valeur est true, le contenu du fichier est également récupéré avec la réponse du déclencheur |
|
|
Déduire le type de contenu
|
inferContentType | boolean |
Déduire le type de contenu basé sur l’extension |
Retours
Contenu du fichier.
- Contenu du fichier
- binary
Définitions
BlobMetadata
Métadonnées d'objet blob
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Id
|
Id | string |
ID unique du fichier ou du dossier. |
|
Nom
|
Name | string |
Nom du fichier ou du dossier. |
|
DisplayName
|
DisplayName | string |
Nom complet du fichier ou du dossier. |
|
Chemin
|
Path | string |
Chemin d’accès du fichier ou du dossier. |
|
Dernière modification
|
LastModified | date-time |
Date et heure de la dernière modification du fichier ou du dossier. |
|
Taille
|
Size | integer |
Taille du fichier ou du dossier. |
|
Type de Média
|
MediaType | string |
Type de média du fichier ou du dossier. |
|
IsFolder
|
IsFolder | boolean |
Valeur booléenne (true, false) pour indiquer si l’objet blob est un dossier ou non. |
|
ETag
|
ETag | string |
Etag du fichier ou du dossier. |
|
FileLocator
|
FileLocator | string |
Filelocator du fichier ou du dossier. |
binaire
Il s’agit du type de données de base "binaire".