Cette page explique comment télécharger des objets depuis vos buckets dans Cloud Storage. Pour obtenir une présentation conceptuelle, consultez la page Importations et téléchargements.
Prérequis
Les conditions préalables peuvent varier en fonction de l'outil utilisé :
Console
Pour suivre ce guide à l'aide de Google Cloud Console, vous devez disposer des autorisations IAM appropriées. Si le bucket source pour le téléchargement existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle contenant les autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour Google Cloud Console.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Command line
Pour suivre ce guide à l'aide d'un utilitaire de ligne de commande, vous devez disposer des autorisations IAM appropriées. Si le bucket source pour le téléchargement existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle disposant des autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les commandes gsutil.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Exemples de code
Pour suivre ce guide à l'aide des bibliothèques clientes Cloud Storage, vous devez disposer des autorisations IAM appropriées. Si le bucket source pour le téléchargement existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle disposant des autorisations nécessaires. Sauf indication contraire, les requêtes de bibliothèque cliente sont effectuées via l'API JSON.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les méthodes JSON.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
API REST
API JSON
Pour suivre ce guide à l'aide de l'API JSON, vous devez disposer des autorisations IAM appropriées. Si le bucket source pour le téléchargement existe dans un projet que vous n'avez pas créé, vous devrez peut-être demander au propriétaire du projet qu'il vous attribue un rôle disposant des autorisations nécessaires.
Pour obtenir la liste des autorisations requises pour des actions spécifiques, consultez la page Autorisations IAM pour les méthodes JSON.
Pour obtenir la liste des rôles pertinents, consultez la page Rôles Cloud Storage. Vous pouvez également créer un rôle personnalisé disposant d'autorisations limitées spécifiques.
Télécharger un objet à partir d'un bucket
Pour télécharger un objet à partir d'un bucket, procédez comme suit :
Console
- Dans Google Cloud Console, accédez à la page du Navigateur Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket qui contient l'objet à télécharger.
La page Informations sur le bucket s'ouvre et l'onglet Objets est sélectionné.
Accédez à l'objet, qui peut se trouver dans un dossier.
Cliquez sur l'icône Télécharger associée à l'objet.
Les paramètres de votre navigateur contrôlent l'emplacement de téléchargement de l'objet.
Pour savoir comment obtenir des informations d'erreur détaillées sur les opérations ayant échoué dans le navigateur Cloud Storage, consultez la page Dépannage.
Command line
gcloud
Exécutez la commande gcloud alpha storage cp
:
gcloud alpha storage cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
Où :
BUCKET_NAME
correspond au nom du bucket contenant l'objet que vous téléchargez. Exemple :my-bucket
OBJECT_NAME
correspond au nom de l'objet que vous téléchargez. Exemple :pets/dog.png
SAVE_TO_LOCATION
correspond au chemin d'accès local où vous enregistrez l'objet. Exemple :Desktop/Images
Si l'opération réussit, la réponse se présente comme suit :
Completed files 1/1 | 164.3kiB/164.3kiB
Si votre téléchargement est interrompu avant la fin, exécutez la même commande cp
pour le reprendre là où il s'est arrêté.
gsutil
Exécutez la commande gsutil cp
:
gsutil cp gs://BUCKET_NAME/OBJECT_NAME SAVE_TO_LOCATION
Où :
BUCKET_NAME
correspond au nom du bucket contenant l'objet que vous téléchargez. Exemple :my-bucket
OBJECT_NAME
correspond au nom de l'objet que vous téléchargez. Exemple :pets/dog.png
SAVE_TO_LOCATION
correspond au chemin d'accès local où vous enregistrez l'objet. Exemple :Desktop/Images
Si l'opération réussit, la réponse se présente comme suit :
Operation completed over 1 objects/58.8 KiB.
Si votre téléchargement est interrompu avant la fin, exécutez la même commande cp
pour le reprendre là où il s'est arrêté.
Exemples de code
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
L'exemple suivant lance le téléchargement d'un objet dans un fichier :
L'exemple suivant lance le téléchargement d'un objet dans la mémoire :
API REST
API JSON
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
Exécutez la commande
cURL
pour appeler l'API JSON avec une requêteGET
Object :curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Où :
OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.SAVE_TO_LOCATION
correspond au chemin d'accès de l'emplacement où vous souhaitez enregistrer votre objet. Par exemple,Desktop/dog.png
.BUCKET_NAME
correspond au nom du bucket contenant l'objet que vous téléchargez. Par exemple,my-bucket
.OBJECT_NAME
correspond au nom encodé au format URL de l'objet que vous téléchargez. Par exemple,pets/dog.png
, encodé au format URL :pets%2Fdog.png
.
API XML
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
Utilisez
cURL
pour appeler l'API XML avec une requêteGET
Object :curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Où :
OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.SAVE_TO_LOCATION
correspond au chemin d'accès de l'emplacement où vous souhaitez enregistrer votre objet. Par exemple,Desktop/dog.png
.BUCKET_NAME
correspond au nom du bucket contenant l'objet que vous téléchargez. Par exemple,my-bucket
.OBJECT_NAME
correspond au nom encodé au format URL de l'objet que vous téléchargez. Par exemple,pets/dog.png
, encodé au format URL :pets%2Fdog.png
.
Pour télécharger facilement tous les objets d'un bucket ou d'un sous-répertoire, exécutez la commande
gsutil cp
ou gcloud alpha storage cp
.
Télécharger une partie d'un objet
Si votre téléchargement est interrompu, vous pouvez reprendre là où vous en étiez en demandant uniquement la partie restante de l'objet. Pour télécharger une partie d'un objet, procédez comme suit :
Console
La console ne permet pas de télécharger des parties d'un objet. Utilisez plutôt gsutil.
Ligne de commande
gcloud
gcloud tente automatiquement de reprendre les téléchargements interrompus, sauf lors de transferts en flux continu. Si votre téléchargement est interrompu, un fichier temporaire partiellement téléchargé devient visible dans la hiérarchie de destination. Exécutez la même commande cp
pour reprendre le téléchargement là où il s'est arrêté.
Une fois le téléchargement terminé, le fichier temporaire est supprimé et remplacé par le contenu téléchargé. Les fichiers temporaires sont stockés dans un emplacement configurable, qui se trouve par défaut dans le répertoire d'accueil de l'utilisateur sous .config/gcloud/surface_data/storage/tracker_files
. Vous pouvez modifier ou afficher l'emplacement de stockage des fichiers temporaires en exécutant gcloud config get storage/tracker_files_directory
.
gsutil
gsutil tente automatiquement de reprendre les téléchargements interrompus, sauf lors de transferts en flux continu. Si votre téléchargement est interrompu, un fichier temporaire partiellement téléchargé devient visible dans le répertoire de destination. Exécutez la même commande cp
pour reprendre le téléchargement là où il s'est arrêté.
Une fois le téléchargement terminé, le fichier temporaire est supprimé et remplacé par le contenu téléchargé. Les transferts avec reprise stockent les informations d'état dans des fichiers sous ~/.gsutil
, nommés par l'objet ou le fichier de destination.
Exemples de code
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
API REST
API JSON
Utilisez l'en-tête Range
dans votre requête pour télécharger une partie d'un objet.
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
Exécutez la commande
cURL
pour appeler l'API JSON avec une requêteGET
Object :curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Où :
OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.FIRST_BYTE
correspond au premier octet de la plage d'octets que vous souhaitez télécharger. Par exemple,1000
.LAST_BYTE
correspond au dernier octet de la plage d'octets que vous souhaitez télécharger. Par exemple,1999
.SAVE_TO_LOCATION
correspond au chemin d'accès de l'emplacement où vous souhaitez enregistrer votre objet. Par exemple,Desktop/dog.png
.BUCKET_NAME
correspond au nom du bucket contenant l'objet que vous téléchargez. Par exemple,my-bucket
.OBJECT_NAME
correspond au nom encodé au format URL de l'objet que vous téléchargez. Par exemple,pets/dog.png
, encodé au format URL :pets%2Fdog.png
.
API XML
Utilisez l'en-tête Range
dans votre requête pour télécharger une partie d'un objet.
- Obtenez un jeton d'autorisation d'accès sur la page OAuth 2.0 Playground. Configurez Playground pour utiliser vos propres identifiants OAuth. Pour obtenir des instructions, consultez la page Authentification des API.
Utilisez
cURL
pour appeler l'API XML avec une requêteGET
Object :curl -X GET \ -H "Authorization: Bearer OAUTH2_TOKEN" \ -H "Range: bytes=FIRST_BYTE-LAST_BYTE" \ -o "SAVE_TO_LOCATION" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Où :
OAUTH2_TOKEN
correspond au jeton d'accès que vous avez généré à l'étape 1.FIRST_BYTE
correspond au premier octet de la plage d'octets que vous souhaitez télécharger. Par exemple,1000
.LAST_BYTE
correspond au dernier octet de la plage d'octets que vous souhaitez télécharger. Par exemple,1999
.SAVE_TO_LOCATION
correspond au chemin d'accès de l'emplacement où vous souhaitez enregistrer votre objet. Par exemple,$HOME/Desktop/dog.png
.BUCKET_NAME
correspond au nom du bucket contenant l'objet que vous téléchargez. Par exemple,my-bucket
.OBJECT_NAME
correspond au nom encodé au format URL de l'objet que vous téléchargez. Par exemple,pets/dog.png
, encodé au format URL :pets%2Fdog.png
.
Étape suivante
- Consultez la présentation conceptuelle de l'importation et du téléchargement.
- Découvrez comment effectuer des téléchargements en flux continu.
- Transférez des données depuis des fournisseurs de cloud ou d'autres sources en ligne (par exemple, à l'aide de listes d'URL).
- Transférez des objets vers votre instance Compute Engine.
- Découvrez comment facturer aux demandeurs les frais d'accès liés à Cloud Storage.
- Découvrez comment Cloud Storage peut diffuser des fichiers compressés avec gzip dans un état non compressé.
Faites l'essai
Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud Storage en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits offerts pour exécuter, tester et déployer des charges de travail.
Profiter d'un essai gratuit de Cloud Storage