Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Téléchargement d'objets
Cette section explique comment télécharger des objets depuis un compartiment Amazon S3. Avec Amazon S3, vous pouvez stocker des objets dans un ou plusieurs compartiments, et chaque objet peut atteindre une taille de 5 To. Tout objet Amazon S3 non archivé est accessible en temps réel. Les objets archivés doivent toutefois être restaurés avant de pouvoir être téléchargés. Pour obtenir des informations sur le téléchargement des objets archivés, consultez Téléchargement des objets archivés.
Vous pouvez télécharger un seul objet à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI), AWS SDKs, ou Amazon S3 RESTAPI. Pour télécharger un objet depuis S3 sans écrire de code ni exécuter aucune commande, utilisez la console S3. Pour de plus amples informations, veuillez consulter Téléchargement d'un objet.
Pour télécharger plusieurs objets, utilisez AWS CloudShell, le AWS CLI, ou le AWS SDKs. Pour de plus amples informations, veuillez consulter Téléchargement de plusieurs objets.
Si vous devez télécharger une partie d'un objet, vous devez utiliser des paramètres supplémentaires avec AWS CLI ou REST API pour spécifier uniquement les octets que vous souhaitez télécharger. Pour de plus amples informations, veuillez consulter Téléchargement d'une partie d'un objet.
Si vous devez télécharger un objet qui ne vous appartient pas, demandez à son propriétaire de générer un présigné URL qui vous permettra de télécharger l'objet. Pour de plus amples informations, veuillez consulter Téléchargement d'un objet depuis un autre Compte AWS.
Lorsque vous téléchargez des objets en dehors du AWS réseau, des frais de transfert de données s'appliquent. Transfert de données au sein du AWS le réseau est gratuit au sein du même Région AWS, mais toute GET
demande vous sera facturée. Pour plus d'informations sur les coûts de transfert de données et les frais de récupération de données, consultez Tarification Amazon S3
Rubriques
Téléchargement d'un objet
Vous pouvez télécharger un objet à l'aide de la console Amazon S3, AWS CLI, AWS SDKs, ou RESTAPI.
Cette section explique comment utiliser la console Amazon S3 pour télécharger un objet depuis un compartiment S3.
Note
-
Vous ne pouvez télécharger qu'un seul objet à la fois.
-
Si vous utilisez la console Amazon S3 pour télécharger un objet dont le nom de clé se termine par un point (
.
), celui-ci est supprimé du nom de clé de l'objet téléchargé. Pour conserver le délai indiqué à la fin du nom de l'objet téléchargé, vous devez utiliser le AWS Command Line Interface (AWS CLI), AWS SDKs, ou Amazon S3 RESTAPI.
Pour télécharger un objet à partir d'un compartiment S3
-
Connectez-vous au AWS Management Console et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/
. -
Dans la liste Buckets (Compartiments), choisissez le nom du compartiment à partir duquel vous souhaitez télécharger un objet.
-
Vous pouvez télécharger un objet à partir d'un compartiment S3 de l'une des façons suivantes :
-
Cochez la case à côté de l'objet et choisissez Télécharger. Si vous souhaitez télécharger l'objet dans un dossier spécifique, dans le menu Actions, choisissez Télécharger en tant que.
-
Si vous souhaitez télécharger une version spécifique de l'objet, activez Afficher les versions (en regard de la zone de recherche). Cochez la case à côté de la version de l'objet de votre choix, puis choisissez Télécharger. Si vous souhaitez télécharger l'objet dans un dossier spécifique, dans le menu Actions, choisissez Télécharger en tant que.
-
L'get-object
exemple de commande suivant montre comment utiliser AWS CLI
pour télécharger un objet depuis Amazon S3. Cette commande récupère l'objet
à partir du compartiment folder/my_image
. L'objet sera téléchargé dans un fichier nommé amzn-s3-demo-bucket1
.my_downloaded_image
aws s3api get-object --bucket
--key
amzn-s3-demo-bucket1
folder/my_image
my_downloaded_image
Pour plus d'informations et des exemples, voir get-object
Pour des exemples de téléchargement d'un objet à l'aide du AWS SDKs, voirÀ utiliser GetObject avec un AWS SDKou CLI.
Pour des informations générales sur l'utilisation de différents AWS SDKs, voirDéveloppement avec Amazon S3 à l'aide des AWS SDK.
Vous pouvez utiliser le REST API pour récupérer des objets depuis Amazon S3. Pour plus d’informations, consultez .GetObjectdans le Amazon Simple Storage Service API Reference.
Téléchargement de plusieurs objets
Vous pouvez télécharger plusieurs objets en utilisant AWS CloudShell, le AWS CLI, ou le AWS SDKs.
AWS CloudShell est un shell pré-authentifié basé sur un navigateur que vous pouvez lancer directement depuis le AWS Management Console.
Pour plus d'informations sur AWS CloudShell, voir Qu'est-ce que c'est CloudShell ? dans le AWS CloudShell Guide de l'utilisateur.
Important
Avec AWS CloudShell, votre répertoire personnel dispose d'un espace de stockage allant jusqu'à 1 Go par Région AWS. Par conséquent, vous ne pouvez pas synchroniser les buckets avec des objets dont le total est supérieur à ce montant. Pour plus de restrictions, consultez la section Quotas et restrictions de service dans le AWS CloudShell Guide de l'utilisateur.
Pour télécharger des objets en utilisant AWS CloudShell
-
Connectez-vous au AWS Management Console et ouvrez la CloudShell console à l'adresse https://console.aws.amazon.com/cloudshell/
. -
Exécutez la commande suivante pour synchroniser les objets de votre bucket avec CloudShell. La commande suivante synchronise les objets depuis le compartiment nommé
et crée un dossier nomméamzn-s3-demo-bucket1
dans CloudShell. CloudShell synchronise vos objets dans ce dossier. Pour utiliser cette commande, remplaceztemp
par vos propres informations.user input placeholders
aws s3 sync s3://
amzn-s3-demo-bucket1
./temp
Note
Pour effectuer une correspondance de modèles afin d'exclure ou d'inclure des objets particuliers, vous pouvez utiliser les paramètres
--exclude "
etvalue
"--include "
avec la commandevalue
"sync
. -
Exécutez la commande suivante pour compresser vos objets dans le dossier nommé
dans un fichier nommétemp
.temp.zip
zip
temp.zip
-rtemp
/ -
Choisissez Actions, puis choisissez Télécharger un fichier.
-
Entrez le nom de fichier
, puis choisissez Télécharger.temp.zip
-
(Facultatif) Supprimez le
fichier et les objets synchronisés avec letemp.zip
dossier dans CloudShell. Avec AWS CloudShell, vous disposez d'un espace de stockage persistant d'une capacité maximale de 1 Go pour chaque Région AWS.temp
Vous pouvez utiliser l'exemple de commande suivant pour supprimer votre fichier
.zip
et votre dossier. Pour utiliser cet exemple de commande, remplacez
par vos propres informations.user input placeholders
rm
temp.zip
&& rm -rftemp
/
L'exemple suivant montre comment vous pouvez utiliser le AWS CLI pour télécharger tous les fichiers ou objets situés dans le répertoire ou le préfixe spécifié. Cette commande copie tous les objets du compartiment
vers votre répertoire actuel. Pour utiliser cet exemple de commande, utilisez le nom de votre compartiment à la place de amzn-s3-demo-bucket1
. amzn-s3-demo-bucket1
aws s3 cp s3://
amzn-s3-demo-bucket1
. --recursive
La commande suivante télécharge tous les objets situés sous le préfixe
du compartiment logs
dans votre répertoire actuel. Elle utilise également les paramètres amzn-s3-demo-bucket1
--exclude
et --include
pour copier uniquement les objets dotés du suffixe
. Pour utiliser cet exemple de commande, remplacez .log
par vos propres informations.user input placeholders
aws s3 cp s3://
amzn-s3-demo-bucket1
/logs
/ . --recursive --exclude "*
" --include "*.log
"
Pour plus d'informations et des exemples, voir cp
Pour des exemples de téléchargement de tous les objets d'un compartiment Amazon S3 à l'aide du AWS SDKs, voirTéléchargez tous les objets d'un compartiment Amazon Simple Storage Service (Amazon S3) dans un répertoire local..
Pour des informations générales sur l'utilisation de différents AWS SDKs, voirDéveloppement avec Amazon S3 à l'aide des AWS SDK.
Téléchargement d'une partie d'un objet
Vous pouvez télécharger une partie d'un objet à l'aide du AWS CLI ou RESTAPI. Pour ce faire, vous devez utiliser des paramètres supplémentaires pour spécifier la partie d'un objet que vous souhaitez télécharger.
L'exemple de commande suivant exécute une demande GET
pour obtenir une plage d'octets dans l'objet nommé
dans le compartiment nommé folder/my_data
. Dans cette demande, la plage d'octets doit être préfixée par amzn-s3-demo-bucket1
bytes=
. L'objet partiel est téléchargé dans le fichier de sortie nommé
. Pour utiliser cet exemple de commande, remplacez my_data_range
par vos propres informations.user input placeholders
aws s3api get-object --bucket
amzn-s3-demo-bucket1
--keyfolder/my_data
--range bytes=0-500
my_data_range
Pour plus d'informations et des exemples, voir get-object
Pour plus d'informations sur l'HTTPRange
en-tête, consultez RFC9110
Note
Amazon S3 ne prend pas en charge la récupération de plusieurs plages de données dans une demande GET
individuelle.
Vous pouvez utiliser les Range
paramètres partNumber
et du REST API pour récupérer des parties d'objets depuis Amazon S3. Pour plus d’informations, consultez .GetObjectdans le Amazon Simple Storage Service API Reference.
Téléchargement d'un objet depuis un autre Compte AWS
Vous pouvez utiliser un présigné URL pour accorder à d'autres utilisateurs un accès limité dans le temps à vos objets sans mettre à jour votre politique de compartiment.
Le présigné URL peut être saisi dans un navigateur ou utilisé par un programme pour télécharger un objet. Les informations d'identification utilisées par le URL sont celles du AWS utilisateur qui a généré leURL. Une fois URL le présigné, toute personne possédant le présigné URL peut télécharger l'objet correspondant jusqu'à URL son expiration.
Vous pouvez utiliser la console Amazon S3 pour générer un présigné URL pour le partage d'un objet en suivant ces étapes. Lorsque vous utilisez la console, le délai d'expiration maximal d'un présigné URL est de 12 heures à compter de sa création.
Pour générer un présigné à URL l'aide de la console Amazon S3
Connectez-vous au AWS Management Console et ouvrez la console Amazon S3 à l'adresse https://console.aws.amazon.com/s3/
. -
Dans le panneau de navigation de gauche, choisissez Compartiments.
-
Dans la liste des compartiments, choisissez le nom du compartiment contenant l'objet pour lequel vous souhaitez un présignéURL.
-
Dans la liste Objets, sélectionnez l'objet URL pour lequel vous souhaitez créer un présigné.
-
Dans le menu Actions relatives à l'objet, choisissez Partager avec un présigné URL.
-
Spécifiez la durée pendant laquelle vous souhaitez que le présigné URL soit valide.
-
Choisissez Create presigned URL.
-
Lorsqu'un message de confirmation apparaît, il URL est automatiquement copié dans votre presse-papiers. Vous verrez un bouton pour copier le présigné URL si vous devez le copier à nouveau.
-
Pour télécharger l'objet, collez-le URL dans n'importe quel navigateur et l'objet tentera de se télécharger.
Pour plus d'informations sur les méthodes présignées URLs et les autres méthodes permettant de les créer, consultezTravailler avec Presigned URLs.
Téléchargement des objets archivés
Pour réduire vos coûts de stockage pour les objets rarement consultés, vous pouvez archiver ces objets. Lorsque vous archivez un objet, il est placé dans un espace de stockage à faible coût, ce qui signifie que vous ne pouvez pas y accéder en temps réel. Pour télécharger un objet archivé, vous devez d'abord le restaurer.
Vous pouvez restaurer les objets archivés en quelques minutes ou quelques heures, selon la classe de stockage. Vous pouvez restaurer un objet archivé à l'aide de la console Amazon S3, S3 Batch Operations, Amazon S3 RESTAPI, AWS SDKs, et le AWS Command Line Interface (AWS CLI).
Pour obtenir des instructions, consultez Restauration d'un objet archivé. Après avoir restauré l'objet archivé, vous pouvez le télécharger.
Téléchargement d'objets en fonction des métadonnées
Vous pouvez ajouter des conditions préalables au téléchargement d'un objet en fonction de ses métadonnées à l'aide d'une demande de lecture conditionnelle. Vous pouvez renvoyer un objet en fonction de sa balise Entity (ETag) ou de sa date de dernière modification. Cela peut limiter une opération S3 aux objets mis à jour depuis une date spécifiée ou renvoyer uniquement une version d'objet spécifique.
Vous pouvez utiliser des écritures conditionnelles pour GetObject ou HeadObjectdemandes.
Pour plus d'informations sur les demandes conditionnelles, voir,Ajoutez des conditions préalables aux opérations S3 avec des requêtes conditionnelles.
Résolution des problèmes de téléchargement d'objets
Autorisations insuffisantes ou compartiment incorrect ou AWS Identity and Access Management (IAM) les politiques utilisateur peuvent provoquer des erreurs lorsque vous essayez de télécharger des objets depuis Amazon S3. Ces problèmes peuvent souvent provoquer des erreurs d'accès refusé (403 Interdit), quand Amazon S3 ne parvient pas à autoriser l'accès à une ressource.
Pour connaître les causes courantes des erreurs d'accès refusé (403 – Interdit), consultez Résoudre les problèmes d'accès refusé (403 Forbidden) erreurs dans Amazon S3.