Partager via

SFTP - SSH

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 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 Department of Defense (DoD)
Power Automate Norme Toutes les régions Power Automate , à l’exception des éléments suivants :
     - 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

Guide pratique du connecteur

Cet article décrit les opérations du connecteur managé SFTP-SSH, qui est disponible pour Azure Logic Apps, Power Automate et Power Apps. Le connecteur intégré SFTP est disponible uniquement pour les flux de travail d’application logique standard dans Azure Logic Apps. Pour plus d’informations, consultez Se connecter à un serveur SFTP à l’aide de SSH dans Azure Logic Apps et de la référence du connecteur intégré SFTP pour Azure Logic Apps.

Différences par rapport au connecteur managé SFTP déprécié

Par rapport au connecteur managé SFTP déconseillé, le connecteur managé SFTP-SSH fournit les fonctionnalités clés suivantes :

  • Utilise la bibliothèque SSH.NET, qui est une bibliothèque SSH (Open Source Secure Shell) qui prend en charge .NET.

  • Fournit l’action Créer un dossier , qui crée un dossier au chemin d’accès spécifié sur le serveur SFTP.

  • Fournit l’action Renommer le fichier , qui renomme un fichier sur le serveur SFTP.

  • Met en cache la connexion au serveur SFTP pendant jusqu’à 1 heure. Cette fonctionnalité améliore les performances et réduit la fréquence à laquelle le connecteur tente de se connecter au serveur. Pour définir la durée de ce comportement de mise en cache, modifiez la propriété ClientAliveInterval dans la configuration SSH sur votre serveur SFTP.

Authentification et autorisations

  • Lorsque vous créez une connexion à votre serveur SFTP, vous devez fournir votre adresse de serveur SFTP, vos informations d’identification de compte, une clé privée SSH et le mot de passe de clé privée SSH. Si votre plateforme prend en charge le chargement de fichiers volumineux à l’aide d’une segmentation, vous avez également besoin d’un accès en lecture et en écriture pour le dossier racine sur votre serveur SFTP.

  • Le connecteur SFTP-SSH prend en charge l’authentification par clé privée et l’authentification par mot de passe. Toutefois, le connecteur SFTP-SSH prend uniquement en charge les formats de clé privée, les algorithmes d’échange de clés, les algorithmes de chiffrement et les empreintes digitales suivants :

    • Formats de clé privée : clés RSA (Rivest Shamir Adleman) et DSA (algorithme de signature numérique) dans les formats OpenSSH et ssh.com. Si votre clé privée est au format de fichier PuTTY (.ppk), commencez par convertir la clé au format de fichier OpenSSH (.pem).
    • Algorithmes d’échange de clés :
      • 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
    • Algorithmes de chiffrement :
      • aes256-ctr
      • 3des-cbc
      • aes128-cbc
      • aes192-cbc
      • aes256-cbc
      • blowfish-cbc
      • twofish-cbc
      • twofish192-cbc
      • twofish128-cbc
      • twofish256-cbc
      • arcfour
      • arcfour128
      • arcfour256
      • cast128-cbc
      • aes128-ctr
      • aes192-ctr
    • Algorithmes de clé d’hôte :
      • ssh-rsa
      • ssh-dss
      • ssh-ed25519
      • ecdsa-sha2-nistp256
      • ecdsa-sha2-nistp384
      • ecdsa-sha2-nistp521
    • Empreinte digitale : MD5. Pour plus d’informations, consultez Rechercher l’empreinte digitale MD5.

  • Lorsque vous fournissez votre clé privée SSH pour votre connexion, n’entrez pas ou modifiez manuellement la clé, ce qui peut entraîner l’échec de la connexion. Au lieu de cela, veillez à copier la clé à partir de votre fichier de clé privée SSH et collez cette clé dans la zone d’informations de connexion.

    Pour copier et coller correctement votre clé privée SSH, procédez comme suit.

    1. Ouvrez votre fichier de clé privée SSH dans n’importe quel éditeur de texte. Ces étapes continuent à utiliser le Bloc-notes comme exemple.

    2. Dans le Bloc-notes, dans le menu Modifier , sélectionnez Tout sélectionner. (Appuyez sur Ctrl + A)

    3. Dans le menu Modifier , sélectionnez Copier.

    4. Dans la zone d’informations de connexion SFTP-SSH, collez la clé copiée complète dans la propriété de clé privée SSH , qui prend en charge plusieurs lignes. N’entrez pas ou modifiez manuellement la clé.

    5. Une fois que vous avez terminé d’entrer les détails de connexion, sélectionnez Créer.

Convertir la clé PuTTY en OpenSSH

Le format PuTTY et le format OpenSSH utilisent différentes extensions de nom de fichier. Le format PuTTY utilise l’extension de nom de fichier .ppk ou PuTTY Private Key. Le format OpenSSH utilise l’extension de nom de fichier .pem ou Privacy Enhanced Mail. Si votre clé privée est au format PuTTY et que vous devez utiliser le format OpenSSH, commencez par convertir la clé au format OpenSSH en procédant comme suit :

  • Système d’exploitation unix

    1. Si vous n’avez pas installé les outils PuTTY sur votre système, effectuez-le maintenant, par exemple :

      sudo apt-get install -y putty

    2. Exécutez la commande suivante, qui crée un fichier que vous pouvez utiliser avec le connecteur SFTP-SSH :

      puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

      Par exemple

      puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

  • Système d’exploitation Windows

    1. Si vous ne l’avez pas déjà fait, téléchargez le dernier outil PuTTY Generator (puttygen.exe), puis ouvrez l’outil.

    2. Dans l’outil PuTTY Key Generator (puttygen.exe), sous Actions, sélectionnez Charger.

    3. Accédez à votre fichier de clé privée au format PuTTY, puis sélectionnez Ouvrir.

    4. Dans le menu Conversions , sélectionnez Exporter la touche OpenSSH.

    5. Enregistrez le fichier de clé privée avec l’extension de nom de fichier .pem .

Rechercher l’empreinte digitale MD5

Le connecteur SFTP-SSH rejette une connexion si l’empreinte digitale du serveur SFTP et l’empreinte digitale attendue ne correspondent pas. Pour obtenir l’empreinte digitale MD5, qui est une séquence avec 16 paires de chiffres hexadécimaux délimitées par des deux-points, essayez les options suivantes.

Vous avez la clé

La clé MD5 est une chaîne de 47 caractères délimitée par des points-virgules. Pour obtenir l’empreinte digitale MD5 lorsque vous disposez de la clé, vous pouvez utiliser des outils tels que ssh-keygen.

Par exemple, à partir d’une invite Bash, entrez la commande suivante :

ssh-keygen -l -f id_rsa.pub -E md5

Vous n’avez pas la clé

Pour obtenir une empreinte digitale MD5 lorsque vous n’avez pas de clé, vous pouvez utiliser l’outil de boîte de dialogue d’informations sur le serveur et le protocole le plus récent par WinSCP, ou vous pouvez utiliser l’outil de configuration PuTTY à la place :

  1. Dans l’outil de configuration PuTTY (putty.exe), dans la fenêtre Catégorie, développezles clés d’hôteSSH>de connexion>.

  2. Sous Préférence d’algorithme de clé d’hôte, ouvrez la liste des stratégies de sélection d’algorithme et vérifiez que RSA apparaît en haut.

  3. Si RSA n’apparaît pas en haut, sélectionnez RSA, puis sélectionnez Up jusqu’à ce que RSA passe en haut.

  4. Connectez-vous à votre serveur SFTP avec PuTTY. Une fois la connexion créée, lorsque l’alerte de sécurité PUTTY s’affiche, sélectionnez Plus d’informations.

    Note

    Si l’alerte de sécurité n’apparaît pas, essayez d’effacer l’entrée SshHostKeys . Ouvrez l’éditeur de Registre Windows et accédez à l’entrée suivante :

    Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

  5. Une fois puTTY : informations sur la zone de clé hôte du serveur s’affiche , recherchez la propriété d’empreinte digitale MD5 et copiez la valeur de chaîne de 47 caractères, qui ressemble à l’exemple suivant :

    **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

Problèmes connus et limitations avec les déclencheurs

  • Les déclencheurs de connecteur managé SFTP peuvent rencontrer des résultats manquants, incomplets ou retardés.

    • Résultats manquants

      Les déclencheurs SFTP fonctionnent en interrogeant ou en vérifiant le système de fichiers SFTP et en recherchant les fichiers qui ont changé depuis le dernier sondage. Les déclencheurs du connecteur managé SFTP comparent 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é SFTP ne détecte pas ce fichier.

      Par conséquent, si vous utilisez un outil ou un client externe qui crée, ajoute ou met à jour des fichiers sur le serveur SFTP, 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 SFTP Action
      WinSCP Accédez à Options>Préférences>Transférerl’horodatage>Modifier>> la conservationdésactiver.
      FileZilla Accédez à Transfer>Preserve timestamps of transfered files>Disable.

    • Résultats incomplets ou retardés

      Lorsqu’un déclencheur SFTP 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 SFTP. 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 SFTP, le déclencheur SFTP peut ne pas retourner tous les fichiers en même temps.

Problèmes et limitations connus généraux

  • Actuellement, le connecteur managé SFTP-SSH ne prend pas en charge les serveurs SFTP suivants :

    • Akamai NetStorage
    • Passerelle FileMage
    • Globalscape
    • IBM DataPower
    • MessageWay
    • OpenText Secure MFT
    • OpenText GXS
    • SFTP pour Stockage Blob Azure
    • Serveur de transfert de fichiers sécurisé VShell
    • AWS SFTP

  • Utilisez des dossiers SFTP distincts pour le traitement et le chargement des fichiers.

    Veillez à utiliser des dossiers distincts sur votre serveur SFTP pour que le déclencheur surveille les fichiers pour le traitement et le stockage des fichiers chargés. Sinon, le déclencheur ne se déclenche pas et se comporte de façon imprévisible. Par exemple, le déclencheur peut ignorer un nombre aléatoire de fichiers qui ont besoin de traitement.

    Cette limitation signifie que vous avez besoin d’un moyen de déplacer des fichiers entre ces dossiers. Si vous rencontrez ce problème, supprimez les fichiers du dossier surveillé et utilisez un autre dossier pour stocker les fichiers chargés.

  • Pour gérer la charge sur les services de connecteurs gérés multilocataires partagés, le connecteur de SFTP-SSH managé peut créer plusieurs connexions à partir de la même adresse IP source, autrement dit, l’adresse IP du connecteur, vers la destination, qui est votre serveur SFTP. Certaines régions à faible trafic peuvent uniquement utiliser trois instances de machine virtuelle derrière l’adresse IP du connecteur, ce qui signifie que ces régions peuvent créer un maximum de trois connexions. D’autres régions peuvent utiliser jusqu’à 20 connexions, car elles ont le même nombre de machines virtuelles derrière l’adresse IP du connecteur.

    Si votre serveur SFTP limite le nombre de connexions, votre serveur peut ne pas fonctionner correctement avec le connecteur de SFTP-SSH managé. Toutefois, vous pouvez créer un flux de travail d’application logique standard qui utilise les opérations SFTP intégrées à la place. Vous pouvez contrôler les limites de scale-out et, par conséquent, le nombre de connexions.

  • Si vous rencontrez des problèmes d’interopérabilité de suite de chiffrement entre le connecteur géré SFTP-SSH et votre serveur SFTP, essayez de créer un flux de travail d’application logique standard et d’utiliser les opérations intégrées SFTP à la place. Les opérations intégrées SFTP prennent en charge un plus large éventail de suites de chiffrement.

  • Ce connecteur peut envoyer une demande de no-op au serveur principal.

Chunking

  • Dans Azure Logic Apps et Power Automate, les actions de connecteur gérées SFTP-SSH suivantes prennent en charge la segmentation où une action peut permettre de gérer des fichiers volumineux en petits morceaux. Pour plus d’informations sur la segmentation dans Azure Logic Apps, consultez [Gérer les messages volumineux à l’aide de la segmentation]](/azure/logic-apps/logic-apps-handle-large-messages).

    Action Prise en charge de la segmentation Remplacer la prise en charge de la taille de bloc
    Copier un fichier Non Sans objet
    Créer un fichier Oui Oui
    Créer un dossier Sans objet Sans objet
    Supprimer un fichier Sans objet Sans objet
    Extraire l’archive dans le dossier Sans objet Sans objet
    Obtenir le contenu du fichier Oui Oui
    Obtenir du contenu de fichier à l’aide du chemin d’accès Oui Oui
    Obtenir les métadonnées de fichier Sans objet Sans objet
    Obtenir des métadonnées de fichier à l’aide du chemin d’accès Sans objet Sans objet
    Répertorier les fichiers dans le dossier Sans objet Sans objet
    Renommer le fichier Sans objet Sans objet
    Mettre à jour le fichier Non Sans objet

    SFTP-SSH actions qui prennent en charge la segmentation peuvent gérer les fichiers jusqu’à 1 Go, tandis que SFTP-SSH actions qui ne prennent pas en charge la segmentation peuvent gérer les fichiers jusqu’à 50 Mo. La taille de bloc par défaut est de 15 Mo. Toutefois, cette taille peut changer dynamiquement, à partir de 5 Mo et augmenter progressivement jusqu’à la taille maximale de 50 Mo. Le dimensionnement dynamique est basé sur des facteurs tels que la latence réseau, le temps de réponse du serveur, etc.

    Vous pouvez remplacer ce comportement adaptatif lorsque vous spécifiez une taille de bloc constante à utiliser à la place. Cette taille peut aller de 5 Mo à 50 Mo. Par exemple, supposons que vous disposez d’un fichier de 45 Mo et d’un réseau qui peut prendre en charge cette taille de fichier sans latence. La segmentation adaptative entraîne plusieurs appels, plutôt qu’un appel. Pour réduire le nombre d’appels, vous pouvez essayer de définir une taille de bloc de 50 Mo. Dans différents scénarios, si votre flux de travail d’application logique expire, par exemple lorsque vous utilisez des blocs de 15 Mo, vous pouvez essayer de réduire la taille à 5 Mo.

    La taille de bloc est associée à une connexion. Cet attribut signifie que vous pouvez utiliser la même connexion pour les deux actions qui prennent en charge la segmentation et les actions qui ne prennent pas en charge la segmentation. Dans ce cas, la taille de bloc pour les actions qui prennent en charge les plages de blocs comprises entre 5 Mo et 50 Mo.

    Pour remplacer le comportement adaptatif par défaut que la segmentation utilise sur une action de SFTP-SSH, vous pouvez spécifier une taille de bloc constante comprise entre 5 Mo et 50 Mo.

    1. Dans le concepteur, dans le coin supérieur droit de l’action SFTP-SSH, sélectionnez le bouton de sélection (...), puis sélectionnez Paramètres.

    2. Sous Transfert de contenu, dans la propriété Taille de bloc, entrez une valeur entière à 50partir de 5 .

    3. Une fois que vous avez terminé, sélectionnez Terminé.

  • SFTP-SSH déclencheurs ne prennent pas en charge la segmentation des messages. Lorsque des déclencheurs demandent du contenu de fichier, ils sélectionnent uniquement les fichiers de 15 Mo ou plus petits. Pour obtenir des fichiers de plus de 15 Mo, suivez ce modèle à la place :

    1. Utilisez un déclencheur SFTP-SSH qui retourne uniquement les propriétés du fichier. Ces déclencheurs ont des noms qui incluent la description (propriétés uniquement).

    2. Suivez le déclencheur avec l’action SFTP-SSH Obtenir le contenu du fichier . Cette action lit le fichier complet et utilise implicitement la segmentation des messages.

Résolution des problèmes

Erreur 401 : « 401 Non autorisé »

Cette erreur peut se produire, car vous n’avez pas les informations d’identification ou les autorisations appropriées. Pour plus d’informations, consultez Authentification et autorisations.

Erreur 404 : « Une référence a été faite à un fichier ou un dossier qui n’existe pas »

Cette erreur peut se produire lorsque vous utilisez l’action Créer un fichier . Lorsque l’action crée un fichier sur votre serveur SFTP, l’action envoie également automatiquement un appel à votre serveur SFTP pour obtenir les métadonnées du fichier.

Si vous déplacez immédiatement le fichier nouvellement créé avant que l’appel puisse obtenir les métadonnées, le fichier n’existe plus à l’emplacement attendu et vous obtenez un message d’erreur 404, une référence a été faite à un fichier ou un dossier qui n’existe pas.

Si vous ne pouvez pas éviter ou retarder le déplacement du fichier, vous pouvez ignorer la lecture des métadonnées du fichier après la création du fichier en procédant comme suit :

  1. Dans l’action Créer un fichier , ouvrez la liste Ajouter un nouveau paramètre , sélectionnez la propriété Obtenir toutes les métadonnées de fichier , puis définissez la valeur Non.

  2. Si vous avez besoin de ces métadonnées de fichier ultérieurement, vous pouvez utiliser l’action Obtenir les métadonnées de fichier .

Erreur 504 : « Une tentative de connexion a échoué, car la partie connectée n’a pas répondu correctement après une période de temps, ou la connexion établie a échoué, car l’hôte connecté n’a pas pu répondre » ou « La demande adressée au serveur SFTP a pris plus de « 00:00:30 » secondes .

Cette erreur peut se produire lorsque vous ne pouvez pas établir une connexion avec le serveur SFTP. Il peut y avoir différentes raisons pour ce problème. Essayez donc ces options de résolution des problèmes :

  • Le délai d’expiration de la connexion est de 20 secondes. Vérifiez que votre serveur SFTP présente de bonnes performances et des appareils intermédiaires, tels que des pare-feu, n’ajoutent pas de surcharge.

  • Vérifiez si votre serveur SFTP place une limite sur le nombre de connexions de chaque adresse IP. Toute telle limite empêche la communication entre le connecteur et le serveur SFTP. Veillez à supprimer cette limite.

  • Si vous avez configuré un pare-feu, veillez à ajouter les adresses IP du connecteur managé pour votre région à la liste approuvée.

  • Si l’erreur se produit par intermittence, remplacez le paramètre de stratégie Nouvelle tentative sur l’action SFTP-SSH par un nombre de nouvelles tentatives supérieur aux quatre nouvelles tentatives par défaut.

  • Pour réduire le coût d’établissement de la connexion, dans la configuration SSH de votre serveur SFTP, augmentez la propriété ClientAliveInterval à environ une heure.

  • Passez en revue le journal du serveur SFTP pour vérifier si les appels envoyés à votre serveur SFTP arrivent correctement. Pour obtenir plus d’informations sur le problème de connectivité, vous pouvez également exécuter une trace réseau sur votre pare-feu et votre serveur SFTP.

Limites générales

Nom Valeur
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é hôte SSH bool Désactiver la validation de la clé hôte SSH ? (True/False)
Empreinte de touche d’hôte SSH ficelle Empreinte de touche d’hôte SSH
Chemin d’accès au dossier racine ficelle Chemin du dossier racine.

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 150 60 secondes

Actions

Copier un fichier

Cette opération copie un fichier.
Créer un dossier

Cette opération crée un dossier.
Créer un fichier

Cette opération charge un fichier.
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 le contenu du fichier.
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.
Obtenir du contenu de 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.
Obtenir le contenu d’un fichier

Cette opération obtient le contenu du fichier à l’aide de l’ID de fichier.
Obtenir les métadonnées d’un fichier

Cette opération obtient les métadonnées de fichier à l’aide de l’ID de fichier.
Renommer un fichier

Cette opération renomme un fichier.
Répertorier les fichiers dans le dossier

Cette opération obtient les fichiers contenus dans un dossier.
Répertorier les fichiers dans le dossier racine

Cette opération obtient les fichiers dans le dossier racine.
Supprimer un fichier

Cette opération supprime un fichier.

Copier un fichier

ID d’opération :
CopyFile

Cette opération copie un fichier.

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 »
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

Créer un dossier

ID d’opération :
CreateFolder

Cette opération crée un dossier.

Paramètres

Nom Clé Obligatoire Type Description
Dossier
 folderPath True string

Sélectionner un dossier
Nom
 name True string

Nom du dossier

Retours

Métadonnées d'objet blob

Corps
BlobMetadata

Créer un fichier

ID d’opération :
CreateFile

Cette opération charge un fichier.

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
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

ID d’opération :
ExtractFolderV2

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

Mettre à jour un fichier

ID d’opération :
UpdateFile

Cette opération met à jour le contenu du fichier.

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
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

Obtenir des métadonnées de fichier à l’aide du chemin d’accès

ID d’opération :
GetFileMetadataByPath

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

ID d’opération :
GetFileContentByPath

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 d’un fichier

ID d’opération :
GetFileContent

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 l’ID de 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

ID d’opération :
GetFileMetadata

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 l’ID de fichier

Retours

Métadonnées d'objet blob

Corps
BlobMetadata

Renommer un fichier

ID d’opération :
RenameFile

Cette opération renomme un fichier.

Paramètres

Nom Clé Obligatoire Type Description
Fichier
 id True string

Sélectionner un fichier
Nouveau nom
 newName True string

Nouveau nom pour le 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

Représente la réponse des métadonnées des jeux de données d’objets blob

Corps
BlobMetadataResponse

Répertorier les fichiers dans le dossier

ID d’opération :
ListFolder

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

ID d’opération :
ListRootFolder

Cette opération obtient les fichiers dans le dossier racine.

Retours

response
array of BlobMetadata

Supprimer un fichier

ID d’opération :
DeleteFile

Cette opération supprime un fichier.

Paramètres

Nom Clé Obligatoire Type Description
Fichier
 id True string

Spécifier le fichier
Ignorer la suppression si le fichier est introuvable
 SkipDeleteIfFileNotFoundOnServer boolean

Ignore la suppression si un fichier n’est pas trouvé sans action défaillante.

Déclencheurs

Lorsque des 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.
Lorsqu’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.

Lorsque des fichiers sont ajoutés ou modifiés (propriétés uniquement)

ID d’opération :
OnUpdatedFiles

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
 maxFileCount integer

Nombre de fichiers retournés par le déclencheur (1 à 100)

Retours

Métadonnées d'objet blob

Liste des fichiers
BlobMetadata

Lorsqu’un fichier est ajouté ou modifié

ID d’opération :
OnUpdatedFile

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.

BlobMetadataResponse

Représente la réponse des métadonnées des jeux de données d’objets 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 ».