FTP
Le protocole FTP (File Transfer Protocol) est un protocole réseau standard utilisé pour transférer des fichiers ordinateurs entre un client et un serveur sur un réseau d’ordinateurs. FTP repose sur une architecture de modèle client-serveur et utilise des connexions de contrôle et de données distinctes entre le client et le serveur.
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 |
| 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) |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
Problèmes connus et limitations
Cet article décrit les opérations uniquement pour le connecteur managé FTP, qui est disponible pour Azure Logic Apps, Power Automate et Power Apps. Le connecteur intégré FTP est disponible uniquement pour les flux de travail d’application logique standard dans Azure Logic Apps. Pour plus d’informations sur le connecteur intégré FTP dans Azure Logic Apps, consultez Se connecter aux serveurs FTP à partir de flux de travail dans Azure Logic Apps.
Les déclencheurs FTP retournent désormais uniquement les métadonnées ou propriétés, et non le contenu du fichier. Toutefois, vous pouvez suivre ces déclencheurs avec l’action nommée Obtenir le contenu du fichier. Pour vous assurer qu’un déclencheur retourne un fichier à la fois, plutôt qu’une liste, veillez à activer l’option « Fractionner sur » du déclencheur. Pour plus d’informations sur cette option dans Azure Logic Apps, consultez Déclencher plusieurs exécutions.
Les déclencheurs FTP fonctionnent uniquement sur le dossier spécifié, et non sur les sous-dossiers. Pour vérifier également les sous-dossiers d’un dossier, configurez un flux distinct pour chaque sous-dossier.
Par défaut, les actions du connecteur managé FTP peuvent lire ou écrire des fichiers de 50 Mo ou plus petits. Pour gérer les fichiers de plus de 50 Mo, vous pouvez utiliser l’action utiliser l’action de connecteur managé FTP nommée Get file content, qui utilise implicitement la segmentation des messages. D’autres actions de connecteur managé FTP prennent également en charge l’activation de la segmentation des messages.
Les déclencheurs FTP peuvent rencontrer des retards ou des résultats incomplets lors du retour des fichiers nouvellement créés, ajoutés ou mis à jour.
Lorsqu’un déclencheur FTP recherche un fichier nouvellement ajouté ou modifié, le déclencheur confirme également que le fichier est terminé. Par exemple, un fichier peut avoir des modifications en cours lorsque le déclencheur vérifie le serveur FTP. Pour éviter de retourner un fichier incomplet, le déclencheur note l’horodatage du fichier, mais ne retourne pas immédiatement le fichier. Au lieu de cela, le déclencheur retourne le fichier uniquement lorsque le déclencheur vérifie à nouveau le serveur. Parfois, ce comportement peut entraîner un retard qui dure jusqu’à deux fois l’intervalle d’interrogation du déclencheur. En raison de ce comportement, le déclencheur FTP peut ne pas retourner tous les fichiers en même temps si vous désactivez le paramètre Split On du déclencheur FTP,
Les déclencheurs de connecteur managé FTP peuvent rencontrer des résultats manquants, incomplets ou retardés lorsque l’horodatage « dernière modification » est conservé.
Résultats manquants
Les déclencheurs FTP fonctionnent en interrogeant ou en vérifiant le système de fichiers FTP et en recherchant les fichiers modifiés depuis le dernier sondage. Le connecteur managé FTP compare les versions de fichiers à l’aide de la dernière horodatage modifié du fichier.
Si vous créez, ajoutez ou mettez à jour un fichier avec un horodatage antérieur à l’horodatage actuellement suivi, le déclencheur de connecteur managé FTP ne détecte pas ce fichier. Par ailleurs, le déclencheur de connecteur intégré FTP dans des flux de travail d’application logique Standard n’a pas cette limitation.
Par conséquent, si vous utilisez un outil externe ou un client qui crée, ajoute ou met à jour des fichiers sur le serveur FTP, veillez à désactiver toute fonctionnalité de l’outil ou du client qui conserve l’horodatage de dernière modification d’un fichier.
Le tableau suivant répertorie certains outils couramment utilisés qui conservent cet horodatage et les étapes de désactivation de cette fonctionnalité :
Client FTP Action WinSCP Accédez à Options>Préférences>Transférer>>> la conservationdésactiver. FileZilla Accédez à Transfer>Preserve timestamps of transfered files>Disable. Résultats incomplets ou retardés
Lorsqu’un déclencheur FTP recherche un fichier nouvellement créé, ajouté ou mis à jour, le déclencheur vérifie également si le fichier est terminé. Par exemple, un fichier peut avoir des modifications en cours lorsque le déclencheur vérifie le serveur FTP. Pour éviter de retourner un fichier incomplet, le déclencheur note l’horodatage du fichier, mais ne retourne pas immédiatement le fichier. Au lieu de cela, le déclencheur retourne le fichier uniquement lorsque le déclencheur vérifie à nouveau le serveur.
Parfois, ce comportement peut entraîner un délai qui dure tant que presque deux fois l’intervalle d’interrogation du déclencheur. En raison de ce comportement, si vous désactivez le paramètre Split On du déclencheur FTP, le déclencheur FTP risque de ne pas retourner tous les fichiers en même temps.
Spécifications
Le connecteur FTP nécessite l’adresse de votre serveur hôte FTP et les informations d’identification du compte.
Le connecteur FTP nécessite l’accès au serveur FTP à partir ou via Internet. Pour plus d’informations sur l’autorisation du trafic vers votre serveur FTP à l’aide de plages d’adresses IP spécifiques, consultez les adresses IP du connecteur managé.
Le connecteur FTP nécessite que le serveur FTP fonctionne ou accepte en mode passif .
Le connecteur FTP nécessite que le serveur FTP active les commandes suivantes et prend en charge les dossiers contenant des espaces blancs afin que les commandes puissent fonctionner correctement. Pour la commande LIST , vérifiez que la commande retourne le
yearcomposant pour les horodatages de fichiers antérieurs à 6 mois.- APPE
- DELE
- LISTE
- MDTM
- RENAME
- RETR
- TAILLE
- STOR
Pour un FTP sécurisé, veillez à configurer FTPS (File Transfer Protocol Secure) explicite plutôt que FTPS implicite. En outre, certains serveurs FTP, tels que ProFTPd, nécessitent que vous activez l’option si vous utilisez le
NoSessionReuseRequiredmode TLS (Transport Layer Security), le successeur de Secure Socket Layer (SSL).Le connecteur FTP ne fonctionne pas avec FTPS implicite et prend uniquement en charge ftp explicite sur FTPS, qui est une extension de TLS.
Connexions FTP
Pour améliorer les performances du connecteur FTP et du serveur FTP, vous pouvez conserver votre connexion FTP ouverte et active une fois que le connecteur a terminé une demande.
Lorsque vous créez une connexion à un serveur FTP, la zone de profil de connexion qui s’affiche comporte un paramètre nommé Fermer la connexion après l’achèvement de la demande. Ce paramètre spécifie s’il faut fermer la connexion du serveur FTP chaque fois qu’une demande est terminée. Si vous conservez ce paramètre désactivé, la connexion ne se ferme pas une fois qu’une demande est terminée et reste active pour une utilisation ultérieure.
Si vos instances de flux de travail s’exécutent en parallèle, vous pouvez rencontrer des erreurs de connectivité intermittentes. Certaines opérations de votre flux de travail peuvent fermer de force la connexion même si d’autres opérations du flux de travail utilisent toujours cette connexion.
Pour éviter ce scénario, essayez les recommandations suivantes :
Lorsque vous créez la connexion, activez la connexion Fermer après le paramètre d’achèvement de la demande .
Désactivez toute parallélisation ou concurrence activée sur les déclencheurs ou les actions. Pour plus d’informations sur cette solution dans Azure Logic Apps, consultez la documentation suivante :
Évitez d’exécuter plusieurs flux parallèles.
Utilisez l’action « Créer un fichier » avec et sans segmentation
Pour l’action Créer un fichier , le comportement dépend du paramètre Autoriser la segmentation de l’action et de la taille du fichier à créer :
Autoriser la segmentation activée :
La taille du fichier est égale ou inférieure à 50 Mo : l’action charge le fichier avec une seule requête, utilise le nom de fichier d’origine et verrouille le fichier pendant le chargement.
La taille du fichier est supérieure à 50 Mo : l’action crée le fichier avec le format de nom, le nom de fichier.new-GUID.ms.partial, puis charge le fichier à l’aide de plusieurs requêtes ou segmentation de messages. Une fois l’action chargées le dernier bloc, l’action renomme le fichier avec le nom de fichier d’origine.
Autoriser la segmentation désactivée : l’action charge le fichier avec une seule requête, utilise le nom de fichier d’origine et verrouille le fichier pendant le chargement.
Guide pratique du connecteur
Pour plus d’informations sur l’utilisation du connecteur managé FTP et du connecteur intégré dans Azure Logic Apps, passez en revue Se connecter aux serveurs FTP à partir de flux de travail dans Azure Logic Apps.
Limites générales
| Nom | Valeur |
|---|---|
| Nombre maximal de dossiers dans une archive unique. Cette limite s’applique uniquement lorsque « Créer des dossiers ? » est défini sur « Oui ». | 16 |
| 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 | ficelle | Adresse du serveur | Vrai |
| Nom d'utilisateur | ficelle | Nom d'utilisateur | Vrai |
| Mot de passe | securestring | Mot de passe | Vrai |
| Port du serveur FTP | int | Numéro de port FTP (exemple : 21) | |
| Activer SSL ? | bool | Activer SSL ? (True/False) | |
| Transport binaire ? | bool | Activer le transport binaire ? (True/False) | |
| Désactiver la validation de certificat ? | bool | Désactiver la validation de certificat ? (True/False) | |
| Fermer la connexion après l’achèvement de la demande | bool | Fermez chaque fois la connexion FTP une fois la demande terminée ? (True/False) |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 900 | 60 secondes |
Actions
| Copier un fichier |
Cette opération copie un fichier sur un serveur FTP. 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éé. |
| Créer un fichier |
Cette opération crée un fichier. 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éé. |
| Extraire l’archive dans le dossier |
Cette opération extrait un fichier d’archivage dans un dossier (exemple : .zip). |
| Mettre à jour un fichier |
Cette opération met à jour un 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. |
| Obtenir des métadonnées de fichier à l’aide du chemin d’accès |
Cette opération obtient les métadonnées d’un fichier à l’aide du chemin d’accès au fichier. |
| Obtenir du contenu de fichier à l’aide du chemin d’accès |
Cette opération obtient le contenu d’un fichier à l’aide du chemin d’accès au fichier. |
| Obtenir le contenu d’un fichier |
Cette opération obtient le contenu d’un fichier. |
| Obtenir les métadonnées d’un fichier |
Cette opération obtient les métadonnées d’un fichier. |
| Répertorier les fichiers dans le dossier |
Cette opération obtient la liste des fichiers et des sous-dossiers dans un dossier. |
| Répertorier les fichiers dans le dossier racine |
Cette opération obtient la liste des fichiers et sous-dossiers dans le dossier racine. |
| Supprimer un fichier |
Cette opération supprime un fichier. |
Copier un fichier
Cette opération copie un fichier sur un serveur FTP. 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 |
|---|---|---|---|---|
|
URL source
|
source | True | string |
URL du fichier source |
|
Chemin d’accès du fichier de destination
|
destination | True | string |
Chemin d’accès du fichier de destination, y compris le nom de fichier cible |
|
É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
Cette opération crée un fichier. 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 |
Sélectionner un dossier |
|
Nom de fichier
|
name | True | string |
Nom du fichier |
|
Contenu du fichier
|
body | True | binary |
Contenu du fichier |
|
Obtenir toutes les métadonnées de fichier
|
ReadFileMetadataFromServer | boolean |
Obtenez toutes les métadonnées de fichier à partir du serveur SFTP une fois la création de fichier terminée. S’il s’agit de false, certaines propriétés de métadonnées peuvent ne pas être retournées, telles que l’heure de dernière modification, etc. |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
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 » |
|
|
Créer des dossiers ?
|
createFolders | boolean |
Extrait les dossiers de l’archive si la valeur est « true » |
Retours
- response
- array of BlobMetadata
Mettre à jour un fichier
Cette opération met à jour un 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 |
Sélectionner un fichier |
|
Contenu du fichier
|
body | True | binary |
Contenu du fichier |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir des métadonnées de fichier à l’aide du chemin d’accès
Cette opération obtient les métadonnées d’un 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 |
Sélectionner un fichier |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Obtenir du contenu de fichier à l’aide du chemin d’accès
Cette opération obtient le contenu d’un 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 |
Sélectionner un 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 d’un fichier
Cette opération obtient le contenu d’un fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Sélectionner un 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 d’un fichier
Cette opération obtient les métadonnées d’un fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Sélectionner un fichier |
Retours
Métadonnées d'objet blob
- Corps
- BlobMetadata
Répertorier les fichiers dans le dossier
Cette opération obtient la liste des fichiers et des sous-dossiers dans un dossier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Dossier
|
id | True | string |
Sélectionner un dossier |
Retours
- response
- array of BlobMetadata
Répertorier les fichiers dans le dossier racine
Cette opération obtient la liste des fichiers et sous-dossiers dans le dossier racine.
Retours
- response
- array of BlobMetadata
Supprimer un fichier
Cette opération supprime un fichier.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Fichier
|
id | True | string |
Sélectionner un fichier |
Déclencheurs
| Lorsqu’un fichier est ajouté ou modifié (propriétés uniquement) |
Cette opération déclenche un flux quand un ou plusieurs fichiers sont ajoutés ou modifiés 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. |
| Lorsqu’un fichier est ajouté ou modifié [DÉCONSEILLÉ] |
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. |
Lorsqu’un fichier est ajouté ou modifié (propriétés uniquement)
Cette opération déclenche un flux quand un ou plusieurs fichiers sont ajoutés ou modifiés 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
|
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 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 |
Sélectionner 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 « binary ».