Cette page explique comment lire les données d'objet depuis vos buckets Cloud Storage directement dans la mémoire de l'application ou de manière interactive dans votre navigateur Web ou votre terminal de ligne de commande. Il est recommandé de lire les objets en mémoire ou de manière interactive lorsque vous souhaitez diffuser, inspecter ou traiter des données d'une manière qui évite la surcharge du processeur, les E/S disque et la latence associées à l'écriture de fichiers dans un système de fichiers local persistant.
Pour savoir comment télécharger des objets dans un espace de stockage persistant ou local, consultez Télécharger des objets. Pour obtenir une présentation des concepts liés aux lectures et aux téléchargements d'objets, consultez Lectures et téléchargements d'objets.
Rôles requis
Pour obtenir les autorisations nécessaires pour lire les données d'objet, demandez à votre administrateur de vous accorder les rôles IAM suivants :
- Lecteur des objets Storage (
roles/storage.objectViewer) on the bucket - Administrateur de l'espace de stockage (
roles/storage.admin) sur le projet (uniquement requis pour lire les données d'objet à l'aide de la Google Cloud console)
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Le rôle Lecteur des objets de l'espace de stockage (roles/storage.objectViewer) contient l'autorisation storage.objects.get, qui est requise pour lire les objets. Le rôle Administrateur de l'espace de stockage (roles/storage.admin) contient les autorisations storage.buckets.list et storage.buckets.get, en plus de l'autorisation storage.objects.get. Ces autorisations sont requises pour répertorier les buckets d'un projet et afficher des informations à leur sujet. Le rôle Administrateur de l'espace de stockage
(roles/storage.admin) qui inclut ces autorisations n'est requis que
lorsque vous souhaitez lire des objets de manière interactive à l'aide de la Google Cloud console.
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Pour savoir comment attribuer des rôles aux buckets, consultez la section Définir et gérer des stratégies IAM sur des buckets.
Lire des objets en mémoire par programmation
Cette section explique comment lire les données d'objet en diffusant les octets de l'objet directement dans la mémoire de l'application.
Bibliothèques clientes
C++
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C++.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
C#
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage C#.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
Go
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Go.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
Java
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Java.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Node.js.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage PHP.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Python.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
Ruby
Pour en savoir plus, consultez la documentation de référence de l'API Cloud Storage en langage Ruby.
Pour vous authentifier auprès de Cloud Storage, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour les bibliothèques clientes.
Rust
Lire des objets de manière interactive
Cette section explique comment lire des objets de manière interactive dans la
Google Cloud fenêtre de votre navigateur de console ou dans le stdout de votre terminal de ligne de commande.
Console
- Dans la Google Cloud console, accédez à la page Buckets de Cloud Storage.
Dans la liste des buckets, cliquez sur le nom du bucket dont vous souhaitez afficher le contenu.
Dans l'onglet Objets, cliquez sur le nom de l'objet que vous souhaitez lire.
Sur la page Détails de l'objet, cliquez sur l'URL publique ou l'URL authentifiée de l'objet pour lire ses données.
Ligne de commande
Pour diffuser la charge utile d'octets d'un objet directement dans le stdout de votre terminal
, utilisez la commande gcloud storage cat :
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
Remplacez les éléments suivants :
BUCKET_NAME: nom du bucket contenant l'objet que vous souhaitez lire. Exemple :my-bucket.OBJECT_NAME: nom de l'objet que vous souhaitez lire. Exemple :dog.png.
API REST
Pour lire les octets d'un objet et diriger le flux de sortie vers le stdout de votre terminal, suivez les instructions ci-dessous.
API JSON
Vous devez installer et initialiser la gcloud CLI installée et initialisée, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization.Utilisez
cURLpour appeler l'API JSON avec une requêteobjects.getincluant l'option-o -et le paramètre de requêtealt=media:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o - \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Remplacez les éléments suivants :
BUCKET_NAME: nom du bucket contenant l'objet que vous souhaitez lire. Exemple :my-bucket.OBJECT_NAME: nom encodé en URL de l'objet que vous souhaitez lire. Par exemple,pets/dog.png, encodé au format URL :pets%2Fdog.png.
API XML
Vous devez installer et initialiser la gcloud CLI installée et initialisée, ce qui vous permet de générer un jeton d'accès pour l'en-tête
Authorization.Utilisez
cURLpour appeler l'API XML avec une requêteGETObject :curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Remplacez les éléments suivants :
BUCKET_NAME: nom du bucket contenant l'objet que vous souhaitez lire. Exemple :my-bucket.OBJECT_NAME: nom encodé en URL de l'objet que vous souhaitez lire. Par exemple,pets/dog.png, encodé au format URL :pets%2Fdog.png.
Étape suivante
- Transférez des données depuis des fournisseurs de services cloud ou d'autres sources en ligne, telles que des listes d'URL