Auf dieser Seite wird beschrieben, wie Sie Objektdaten aus Ihren Cloud Storage-Buckets direkt in den Arbeitsspeicher der Anwendung oder interaktiv in Ihrem Webbrowser oder Befehlszeilenterminal lesen. Das Lesen von Objekten in den Arbeitsspeicher oder interaktiv wird empfohlen, wenn Sie Daten streamen, untersuchen oder verarbeiten möchten, ohne die CPU-, Datenträger-E/A- und Latenz-Overheads zu verursachen, die mit dem Schreiben von Dateien in ein persistentes lokales Dateisystem verbunden sind.
Eine Anleitung zum Herunterladen von Objekten in den persistenten oder lokalen Speicher finden Sie unter Objekte herunterladen. Einen konzeptionellen Überblick über das Lesen und Herunterladen von Objekten finden Sie unter Objektlesevorgänge und ‑downloads.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zuzuweisen, damit Sie die nötigen Berechtigungen zum Lesen von Objektdaten haben:
- Storage Object Viewer (
roles/storage.objectViewer) für den Bucket - Storage-Administrator (
roles/storage.admin) für das Projekt (nur erforderlich, wenn Objektdaten über die Cloud de Confiance -Konsole gelesen werden)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Die Rolle „Storage-Objekt-Betrachter“ (roles/storage.objectViewer) enthält die Berechtigung storage.objects.get, die zum Lesen von Objekten erforderlich ist. Die Rolle „Storage-Administrator“ (roles/storage.admin) enthält neben der Berechtigung storage.objects.get auch die Berechtigungen storage.buckets.list und storage.buckets.get. Diese Berechtigungen sind erforderlich, um die Buckets in einem Projekt aufzulisten und Informationen zu den Buckets aufzurufen. Die Rolle „Storage-Administrator“ (roles/storage.admin), die diese Berechtigungen enthält, ist nur erforderlich, wenn Sie Objekte interaktiv über die Cloud de Confiance Console lesen möchten.
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Eine Anleitung zum Zuweisen von Rollen für Buckets finden Sie unter IAM-Richtlinien für Buckets festlegen und verwalten.
Objekte programmatisch in den Arbeitsspeicher lesen
In diesem Abschnitt wird beschrieben, wie Sie Objektdaten lesen, indem Sie die Objekt-Bytes direkt in den Anwendungsspeicher streamen.
Clientbibliotheken
C++
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
C#
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
Go
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
Java
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
Node.js
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
PHP
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage PHP API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
Python
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
Ruby
Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.
Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.
Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.
Rust
Objekte interaktiv lesen
In diesem Abschnitt wird beschrieben, wie Sie Objekte interaktiv in IhremCloud de Confiance -Konsolenbrowserfenster oder stdout-Befehlszeilenterminal lesen.
Console
- Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.
Klicken Sie in der Bucket-Liste auf den Namen des Buckets, dessen Inhalt Sie sehen möchten.
Klicken Sie auf dem Tab Objekte auf den Namen des Objekts, das Sie lesen möchten.
Klicken Sie auf der Seite Objektdetails auf die öffentliche URL oder die authentifizierte URL des Objekts, um die zugehörigen Daten zu lesen.
Befehlszeile
Wenn Sie die Byte-Nutzlast eines Objekts direkt in Ihr Terminal stdout streamen möchten, verwenden Sie den Befehl gcloud storage cat:
gcloud storage cat gs://BUCKET_NAME/OBJECT_NAME
Ersetzen Sie Folgendes:
BUCKET_NAME: der Name des Buckets, der das Objekt enthält, das Sie lesen möchten. Beispiel:my-bucket.OBJECT_NAME: Der Name des Objekts, das Sie lesen möchten. Beispiel:dog.png.
REST APIs
Wenn Sie die Bytes eines Objekts lesen und den Ausgabestream an Ihr Terminal stdout weiterleiten möchten, folgen Sie der Anleitung unten.
JSON API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den
Authorization-Header zu generieren.Verwenden Sie
cURL, um die JSON API mit einerobjects.get-Anfrage aufzurufen, die die Option-o -und den Abfrageparameteralt=mediaenthält:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -o - \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME?alt=media"
Ersetzen Sie Folgendes:
BUCKET_NAME: Der Name des Buckets, der das Objekt enthält, das Sie lesen möchten. Beispiel:my-bucketOBJECT_NAME: der URL-codierte Name des Objekts, das Sie lesen möchten. Beispiel:pets/dog.png, URL-codiert alspets%2Fdog.png.
XML API
Die gcloud CLI installieren und initialisieren, um ein Zugriffstoken für den
Authorization-Header zu generieren.Verwenden Sie
cURL, um die XML API mit einerGET-Objektanfrage aufzurufen:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/BUCKET_NAME/OBJECT_NAME"
Ersetzen Sie Folgendes:
BUCKET_NAME: der Name des Buckets mit dem Objekt, das Sie lesen möchten. Beispiel:my-bucketOBJECT_NAME: der URL-codierte Name des Objekts, das Sie lesen möchten. Beispiel:pets/dog.png, URL-codiert alspets%2Fdog.png.