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 la taille de chaque objet peut atteindre 50 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](#download-archived-objects).
Vous pouvez télécharger un seul objet à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) ou de l'API REST Amazon S3. AWS SDKs Pour télécharger un objet d'une capacité maximale de 5 To depuis S3 sans écrire de code ni exécuter de commande, utilisez la console S3. Pour de plus amples informations, veuillez consulter [Téléchargement d’un objet](#download-an-object).
Pour télécharger des objets de plus de 5 To, utilisez des `GetObject` requêtes simultanées avec un en-tête `Range` HTTP pour lire des plages d'octets spécifiques ou `partNumber` pour télécharger une partie spécifique d'un objet. Les demandes GET uniques sont limitées à 5 To, et vous recevrez un `405 - Method Not Allowed` message d'erreur pour les demandes GET supérieures à 5 To.
Pour les téléchargements d'objets volumineux, utilisez le gestionnaire de transfert S3 dans Java v1/v2, Python ou. AWS CLI SDKs Pour des performances optimales, utilisez la dernière version du AWS Common Runtime (CRT) SDKs, qui a été optimisée pour une meilleure utilisation des ressources. Le CRT adapte automatiquement la taille de chaque individu afin d' GETs optimiser le débit. Vous pouvez améliorer le débit de transfert global en allouant davantage de mémoire à l'aide de paramètres de limite de mémoire, comme `maxNativeMemoryLimitInBytes` pour le SDK Java. Vous pouvez désactiver ce comportement en définissant une taille de pièce explicite à l'aide de paramètres de demande tels que `multipart_chunksize` pour AWS CLI et `minimumPartSizeInBytes` pour le SDK Java dans votre demande de téléchargement.
Pour télécharger plusieurs objets AWS CloudShell, utilisez le AWS CLI ou le AWS SDKs. Pour de plus amples informations, veuillez consulter [Téléchargement de plusieurs objets](#download-multiple-objects).
Si vous devez télécharger une partie d'un objet, vous devez utiliser des paramètres supplémentaires avec l'API REST AWS CLI ou 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](#download-objects-parts).
Si vous devez télécharger un objet qui ne vous appartient pas, demandez à son propriétaire de générer une URL présignée 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](#download-objects-from-another-account).
Lorsque vous téléchargez des objets en dehors du AWS réseau, des frais de transfert de données s'appliquent. Le transfert de données au sein du AWS réseau est gratuit 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](https://aws.amazon.com/s3/pricing/).
**Topics**
+ [Téléchargement d’un objet](#download-an-object)
+ [Téléchargement de plusieurs objets](#download-multiple-objects)
+ [Téléchargement d’une partie d’un objet](#download-objects-parts)
+ [Téléchargement d'un objet depuis un autre Compte AWS](#download-objects-from-another-account)
+ [Téléchargement des objets archivés](#download-archived-objects)
+ [Téléchargement d’objets en fonction des métadonnées](#download-objects-based-on-metadata)
+ [Résolution des problèmes de téléchargement d’objets](#download-objects-troubleshooting)
## Téléchargement d’un objet
Vous pouvez télécharger un objet à l'aide de la console Amazon S3 ou de AWS SDKs l'API REST. AWS CLI
### Utilisation de la console S3
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 à la fin du nom de l'objet téléchargé, vous devez utiliser l'API REST AWS Command Line Interface (AWS CLI) ou Amazon S3. AWS SDKs
**Pour télécharger un objet à partir d’un compartiment S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général** ou **Compartiments de répertoires**.
1. Dans la liste des compartiments, choisissez le nom du compartiment à partir duquel vous souhaitez télécharger un objet.
1. 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'aide du AWS CLI
L’exemple de commande `get-object` suivant montre comment utiliser l’interface AWS CLI pour télécharger un objet depuis Amazon S3. Cette commande récupère l’objet `folder/my_image` à partir du compartiment `amzn-s3-demo-bucket1`. Vous devez inclure un `outfile`, qui est le nom de fichier de l’objet téléchargé, par exemple `my_downloaded_image.jpg`.
```
aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_image my_downloaded_image.jpg
```
Pour plus d’informations et des exemples, consultez [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html) dans la *Référence des commandes de l’AWS CLI *.
### En utilisant le AWS SDKs
Pour des exemples de téléchargement d'un objet avec le AWS SDKs, consultez les [exemples de code](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_GetObject_section.html) dans le manuel *Amazon S3 API Reference*.
Pour obtenir des informations générales sur l'utilisation de différents AWS SDKs éléments, consultez la section [Développement avec Amazon S3 AWS SDKs à l'aide](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) du document de *référence sur les API Amazon S3*.
### Utilisation de l'API REST
Vous pouvez utiliser l’API REST pour récupérer des objets depuis Amazon S3. Pour plus d’informations, consultez [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) dans la *Référence d’API Amazon Simple Storage Service*.
## Téléchargement de plusieurs objets
Vous pouvez télécharger plusieurs objets en utilisant le AWS CloudShell AWS CLI, ou le AWS SDKs.
### En utilisant AWS CloudShell dans le AWS Management Console
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 AWS CloudShell, voir [Qu'est-ce que c'est CloudShell ?](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html) dans le *guide de AWS CloudShell 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 compartiments avec des objets dont le total est supérieur à ce montant. Pour plus de restrictions, consultez [Quotas et restrictions des services](https://docs.aws.amazon.com/cloudshell/latest/userguide/limits.html) dans le *Guide de l’utilisateur AWS CloudShell *.
**Pour télécharger des objets en utilisant AWS CloudShell**
1. Connectez-vous à la CloudShell console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudshell/](https://console.aws.amazon.com/cloudshell/).
1. Exécutez la commande suivante pour synchroniser les objets de votre bucket avec CloudShell. La commande suivante synchronise les objets depuis le compartiment nommé `amzn-s3-demo-bucket1` et crée un dossier nommé `temp` dans CloudShell. CloudShell synchronise vos objets dans ce dossier. Pour utiliser cette commande, remplacez les `user input placeholders` par vos propres informations.
```
aws s3 sync s3://amzn-s3-demo-bucket1 ./temp
```
**Note**
La commande `sync` n’est pas compatible avec les compartiments de répertoires.
Pour effectuer une correspondance de modèles afin d’exclure ou d’inclure des objets particuliers, vous pouvez utiliser les paramètres `--exclude "value"` et `--include "value"` avec la commande `sync`.
1. Exécutez la commande suivante pour compresser vos objets dans le dossier nommé `temp` dans un fichier nommé `temp.zip`.
```
zip temp.zip -r temp/
```
1. Choisissez **Actions**, puis choisissez **Télécharger un fichier**.
1. Entrez le nom de fichier `temp.zip`, puis choisissez **Télécharger**.
1. (Facultatif) Supprimez le `temp.zip` fichier et les objets synchronisés avec le `temp` dossier dans CloudShell. Avec AWS CloudShell, vous disposez d’un stockage persistant allant jusqu’à 1 Go pour chaque Région AWS.
Vous pouvez utiliser l’exemple de commande suivant pour supprimer votre fichier `.zip` et votre dossier. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
rm temp.zip && rm -rf temp/
```
### À l'aide du AWS CLI
L'exemple suivant montre comment vous pouvez utiliser le AWS CLI pour télécharger tous les fichiers ou objets du répertoire ou du préfixe spécifié. Cette commande copie tous les objets du compartiment `amzn-s3-demo-bucket1` vers votre répertoire actuel. Pour utiliser cet exemple de commande, utilisez le nom de votre compartiment à la place de `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 `logs` du compartiment `amzn-s3-demo-bucket1` dans votre répertoire actuel. Elle utilise également les paramètres `--exclude` et `--include` pour copier uniquement les objets dotés du suffixe `.log`. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3 cp s3://amzn-s3-demo-bucket1/logs/ . --recursive --exclude "*" --include "*.log"
```
Pour plus d'informations et des exemples, consultez [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html) dans la *Référence des commandes AWS CLI *.
### En utilisant le AWS SDKs
Pour des exemples de téléchargement de tous les objets d'un compartiment Amazon S3 avec le AWS SDKs, consultez les [exemples de code](https://docs.aws.amazon.com/AmazonS3/latest/API/s3_example_s3_DownloadBucketToDirectory_section.html) dans le manuel *Amazon S3 API Reference*.
Pour obtenir des informations générales sur l'utilisation de différents AWS SDKs éléments, consultez la section [Développement avec Amazon S3 AWS SDKs à l'aide](https://docs.aws.amazon.com/AmazonS3/latest/API/sdk-general-information-section.html) du document de *référence sur les API Amazon S3*.
## Téléchargement d’une partie d’un objet
Vous pouvez télécharger une partie d'un objet à l'aide de l' AWS CLI API REST. 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'aide du AWS CLI
L’exemple de commande suivant exécute une demande `GET` pour obtenir une plage d’octets dans l’objet nommé `folder/my_data` dans le compartiment nommé `amzn-s3-demo-bucket1`. Dans cette demande, la plage d’octets doit être préfixée par `bytes=`. L’objet partiel est téléchargé dans le fichier de sortie nommé `my_data_range`. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3api get-object --bucket amzn-s3-demo-bucket1 --key folder/my_data --range bytes=0-500 my_data_range
```
Pour plus d'informations et des exemples, consultez [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/get-object.html) dans la *Référence des commandes AWS CLI *.
Pour plus d’informations sur l’en-tête HTTP `Range`, consultez [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-range) sur le site web RFC Editor.
**Note**
Amazon S3 ne prend pas en charge la récupération de plusieurs plages de données dans une demande `GET` individuelle.
### Utilisation de l'API REST
Vous pouvez utiliser les paramètres `partNumber` et `Range` de l’API REST pour récupérer des parties d’objet depuis Amazon S3. Pour plus d’informations, consultez [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) dans la *Référence d’API Amazon Simple Storage Service*.
## Téléchargement d'un objet depuis un autre Compte AWS
Vous pouvez utiliser une URL présignée pour accorder aux autres un accès limité dans le temps à vos objets sans mettre à jour votre stratégie de compartiment.
L’URL présignée peut être saisie dans un navigateur ou utilisée par un programme pour télécharger un objet. Les informations d'identification utilisées par l'URL sont celles de l' AWS utilisateur qui a généré l'URL. Une fois l’URL créée, toute personne disposant de l’URL présignée peut télécharger l’objet correspondant jusqu’à ce que l’URL expire.
### Utilisation d’une URL présignée dans la console S3
Vous pouvez utiliser la console Amazon S3 pour générer une URL présignée afin de partager un objet d’un compartiment à usage général en suivant ces étapes. Dans la console, le délai d’expiration maximal d’une URL présignée est de 12 heures à compter de la création.
**Pour générer une URL présignée à l’aide de la console Amazon S3**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans le volet de navigation de gauche, choisissez **Compartiments à usage général**.
1. Dans la liste des compartiments, choisissez le nom du compartiment qui contient l’objet pour lequel vous souhaitez une URL présignée.
1. Dans la liste **Objects** (Objets), sélectionnez l’objet pour lequel vous souhaitez créer une URL présignée.
1. Dans le menu **Actions d’objet**, choisissez **Partager avec une URL présignée**.
1. Spécifiez la durée de validité souhaitée pour l’URL présignée.
1. Choisissez **Create presigned URL** (Créer une URL présignée).
1. Lorsqu’un message de confirmation apparaît, l’URL est automatiquement copiée dans votre presse-papier. Un bouton s’affiche pour copier l’URL présignée, si vous devez la copier à nouveau.
1. Pour télécharger l’objet, collez l’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, consultez[Téléchargez et chargez des objets avec une signature préalable URLs](using-presigned-url.md).
## 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, de S3 Batch Operations, de l'API REST Amazon S3 AWS SDKs, du, et du AWS Command Line Interface (AWS CLI).
Pour obtenir des instructions, veuillez consulter [Restauration d’un objet archivé](restoring-objects.md). 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 pour télécharger 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 permet limiter une opération S3 aux objets mis à jour depuis une date spécifiée ou de ne renvoyer qu’une version d’objet spécifique.
Vous pouvez utiliser des écritures conditionnelles pour les demandes [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) ou [https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html).
Pour plus d’informations sur les demandes conditionnelles, consultez [Ajout de conditions préalables aux opérations S3 avec des demandes conditionnelles](conditional-requests.md).
## Résolution des problèmes de téléchargement d’objets
Des autorisations insuffisantes ou des politiques de bucket ou d'utilisateur Gestion des identités et des accès AWS (IAM) incorrectes 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 Forbidden), 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 Forbidden), consultez [Résolution des erreurs d’accès refusé (403 Forbidden) dans Amazon S3](troubleshoot-403-errors.md).
Si vous recevez une NoSuchKey erreur 404 lorsque vous tentez d'accéder à un objet, consultez [Comment puis-je résoudre le problème lié à l' NoSuchKey erreur 404 d'Amazon S3 ?](https://repost.aws/knowledge-center/404-error-nosuchkey-s3) dans le AWS re:Post Knowledge Center.