Cette page explique comment télécharger des objets depuis vos buckets dans Cloud Storage vers un espace de stockage persistant. Vous pouvez également télécharger des objets en mémoire.
Autorisations requises
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.
Bibliothèques clientes
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 et nécessitent des autorisations, comme indiqué dans la section Autorisations IAM pour les méthodes JSON. Pour savoir quelles méthodes d'API JSON sont appelées lorsque vous envoyez des requêtes à l'aide d'une bibliothèque cliente, consignez les requêtes brutes.
Pour obtenir la liste des rôles IAM 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 la console Google Cloud, accédez à la page Buckets 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étaillées sur les erreurs liées aux opérations Cloud Storage ayant échoué dans la console Google Cloud, consultez la section Dépannage.
Ligne de commande
gcloud
Exécutez la commande gcloud storage cp
:
gcloud 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é.
Bibliothèques clientes
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
- 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 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 Google Cloud ne permet pas de télécharger des parties d'un objet. Utilisez plutôt gcloud CLI.
Ligne de commande
gcloud
gcloud tente automatiquement de reprendre les téléchargements interrompus, sauf lors de téléchargements en streaming. 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 téléchargements en streaming. 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.
Bibliothèques clientes
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
.
Étapes suivantes
- Consultez la présentation conceptuelle de l'importation et du téléchargement, y compris les stratégies de téléchargement avancées.
- Transférez des données depuis des fournisseurs de cloud ou d'autres sources en ligne, telles que des 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