Réaliser un premier transfert

Ce guide vous accompagne pour envoyer un fichier vers S3, puis le récupérer sur votre ordinateur. Vous utiliserez une copie : le fichier source reste à son emplacement.

Préparer votre accès et votre fichier#

Vous devez disposer d’un compte configuré dans S3Client et d’un bucket existant dans lequel vous pouvez envoyer et lire des fichiers. Pour ajouter votre accès, suivez la création d’un compte depuis File > Accounts… > New…. Utilisez Test connection, enregistrez avec OK, puis fermez Accounts avec Close. Le compte doit être activé pour apparaître dans la navigation.

Le test de connexion vérifie une requête de lecture. Sa réussite ne garantit pas que vous pouvez envoyer ou télécharger un fichier : ces actions nécessitent leurs propres permissions.

Pour ce parcours, vos identifiants doivent permettre d’afficher le contenu du bucket, d’envoyer le fichier et de le télécharger. Pour un bucket Amazon S3 à usage général, ces actions nécessitent s3:ListBucket, s3:PutObject et s3:GetObject. Des permissions supplémentaires peuvent être nécessaires selon la configuration du bucket, par exemple son chiffrement. Voir les permissions des opérations Amazon S3.

Préparez un petit fichier local, par exemple test-s3client.txt, et un autre dossier local pour le téléchargement. Choisissez un nom qui n’existe pas déjà dans le dossier S3 de destination. Un remplacement peut écraser un fichier existant ou créer une nouvelle version si le bucket est versionné. Le service peut facturer le stockage, les requêtes et les transferts selon ses tarifs.

Ouvrir la source et la destination#

1. Dans la fenêtre principale, choisissez View > Left view > List view, puis View > Right view > List view pour afficher une liste dans chaque panneau.
2. Dans le panneau gauche, ouvrez Root et choisissez le lecteur contenant votre fichier.
3. Ouvrez les dossiers par double-clic jusqu’à voir test-s3client.txt.
4. Dans le panneau droit, ouvrez Root et choisissez votre bucket sous le compte voulu. Vous pouvez aussi choisir le compte, puis ouvrir son bucket par double-clic.
5. Si le bouton Show versions de la barre d’outils est coché, cliquez dessus pour revenir aux fichiers courants du bucket.
6. Si vous souhaitez envoyer le fichier dans un dossier du bucket, ouvrez ce dossier.
7. Vérifiez Address dans chaque panneau : à gauche, le dossier local source ; à droite, le bucket ou le dossier S3 de destination.

Si aucun bucket n’apparaît, vérifiez l’activation du compte et sa configuration. Lorsque vos identifiants ne permettent pas de lister tous les buckets, vous pouvez renseigner les noms accessibles dans l’onglet Buckets du compte. Cette liste ne crée pas les buckets et ne donne pas de permission. Consultez la liste explicite de buckets.

Envoyer le fichier vers S3#

1. Dans la liste de gauche, cliquez sur test-s3client.txt pour le sélectionner.
2. Choisissez Edit > Copy, ou appuyez sur Ctrl+C.
3. Cliquez dans la liste de droite pour activer le panneau de destination.
4. Choisissez Edit > Paste, ou appuyez sur Ctrl+V.

Le transfert apparaît dans la liste des opérations, en bas de la fenêtre. Paste utilise les options par défaut du transfert. Pour cet envoi, S3Client utilise les réglages du service pour la classe de stockage, le chiffrement et les permissions de l’objet. Si votre bucket exige des paramètres particuliers, consultez les options de transfert et utilisez Edit > Paste with options….

Si Confirm overwrite s’affiche, vérifiez le fichier concerné. Pour ce premier essai, cliquez sur No afin de ne pas le remplacer, puis recommencez avec un nom libre. Le même dialogue peut apparaître si le service refuse de vérifier la présence d’un fichier ; cela ne garantit pas que la destination est libre.

Vérifier que l’envoi a réussi#

Attendez la fin du transfert et vérifiez ses erreurs avant de télécharger le fichier.

1. Survolez la colonne Operation du transfert dans la liste des opérations pour consulter son état. Pending signifie en attente, Running en cours et Finished terminée. Aborted indique une interruption.
2. Si une erreur est signalée, sélectionnez la ligne en erreur, puis choisissez Show error message dans son menu contextuel. Développez l’opération si l’erreur concerne une sous-opération. Corrigez la cause avant de recommencer.
3. Dans le panneau droit, utilisez Refresh dans le menu contextuel de la liste pour relire le contenu du dossier S3.
4. Vérifiez que test-s3client.txt apparaît, avec la taille attendue.

Une opération Finished peut contenir une erreur. Consultez le suivi des opérations si le résultat ne correspond pas à ce que vous attendiez.

Télécharger le fichier sur votre ordinateur#

1. Dans le panneau gauche, ouvrez le dossier local préparé pour le téléchargement. Utilisez un dossier différent de celui du fichier original.
2. Dans la liste de droite, sélectionnez le fichier envoyé.
3. Choisissez Edit > Copy (Ctrl+C).
4. Cliquez dans la liste de gauche, puis choisissez Edit > Paste (Ctrl+V).
5. Attendez la fin de l’opération et vérifiez ses éventuelles erreurs comme pour l’envoi.
6. Actualisez le dossier local avec Refresh dans le menu contextuel de la liste. Vérifiez que le fichier est présent, puis ouvrez-le depuis Windows pour contrôler son contenu.

Vous avez maintenant le fichier original, le fichier envoyé dans le bucket et la copie téléchargée. Pour transférer plusieurs fichiers ou des dossiers, consultez Copier, déplacer et renommer.