Envoyer et récupérer des fichiers à l'aide d'un connecteur SFTP

Les connecteurs SFTP étendent les capacités de AWS Transfer Family communication avec des serveurs distants à la fois dans le cloud et sur site. Vous pouvez intégrer les données générées et stockées dans des sources distantes à vos entrepôts de données AWS hébergés à des fins d'analyse, d'applications métier, de reporting et d'audit.

Pour initier un transfert de fichier vers un serveur SFTP distant, vous devez utiliser l'opération StartFileTransferAPI, qui utilise des connecteurs SFTP pour effectuer le transfert. Chaque StartFileTransfer demande peut contenir 10 chemins distincts.

Vous pouvez surveiller vos transferts de fichiers en consultant les journaux de votre serveur. L'activité du connecteur est enregistrée dans des flux de journaux au formataws/transfer/connector-id, par exemple,aws/transfer/c-1234567890abcdef0. Si vous ne voyez aucun journal pour votre connecteur, assurez-vous que vous avez spécifié un rôle de journalisation avec les autorisations appropriées pour votre connecteur.

Pour plus de détails sur la création de connecteurs, voirConfiguration des connecteurs SFTP.

Pour envoyer et récupérer des fichiers à l'aide d'un connecteur SFTP, vous devez utiliser la commande start-file-transfer AWS Command Line Interface (AWS CLI). Vous spécifiez les paramètres suivants, selon que vous envoyez des fichiers (transferts sortants) ou que vous recevez des fichiers (transferts entrants).

• Transferts sortants

  • send-file-pathscontient de un à dix chemins de fichiers sources, pour les fichiers à transférer vers le serveur SFTP du partenaire.

  • remote-directory-pathest le chemin distant vers lequel envoyer un fichier sur le serveur SFTP du client.

• Transferts entrants

  • retrieve-file-pathscontient de un à dix chemins distants. Chaque chemin indique un emplacement pour le transfert des fichiers du serveur SFTP du partenaire vers votre serveur Transfer Family.

  • local-directory-pathest l'emplacement Amazon S3 (compartiment et préfixe facultatif) où vos fichiers sont stockés.

Pour envoyer des fichiers, vous devez spécifier les remote-directory-path paramètres send-file-paths et. Vous pouvez spécifier jusqu'à 10 fichiers pour le send-file-paths paramètre. L'exemple de commande suivant envoie les fichiers nommés /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt et /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt situés dans le stockage Amazon S3 vers le /tmp répertoire du serveur SFTP de votre partenaire. Pour utiliser cet exemple de commande, remplacez le DOC-EXAMPLE-SOURCE-BUCKET par votre propre bucket.

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt /DOC-EXAMPLE-SOURCE-BUCKET/file2.txt \
    --remote-directory-path /tmp --connector-id c-1111AAAA2222BBBB3 --region us-east-2

Pour recevoir des fichiers, vous devez spécifier les local-directory-path paramètres retrieve-file-paths et. L'exemple suivant extrait les fichiers /my/remote/file1.txt et les place /my/remote/file2.txt sur le serveur SFTP du partenaire dans le préfixe /DOC-EXAMPLE-BUCKET/ de l'emplacement Amazon S3. Pour utiliser cet exemple de commande, remplacez user input placeholders par vos propres informations.

aws transfer start-file-transfer --retrieve-file-paths /my/remote/file1.txt  /my/remote/file2.txt \
   --local-directory-path /DOC-EXAMPLE-BUCKET/prefix --connector-id c-2222BBBB3333CCCC4 --region us-east-2

Les exemples précédents spécifient des chemins absolus sur le serveur SFTP. Vous pouvez également utiliser des chemins relatifs, c'est-à-dire des chemins relatifs au répertoire personnel de l'utilisateur SFTP. Par exemple, si l'utilisateur SFTP l'est marymajor et que son répertoire personnel sur le serveur SFTP l'est/users/marymajor/, la commande suivante envoie à /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt /users/marymajor/test-connectors/file1.txt

aws transfer start-file-transfer --send-file-paths /DOC-EXAMPLE-SOURCE-BUCKET/file1.txt \
   --remote-directory-path test-connectors --connector-id c-2222BBBB3333CCCC4 --region us-east-2